Re: [PATCH 0/3] capebus moving omap_devices to mach-omap2

From: Pantelis Antoniou
Date: Thu Nov 01 2012 - 06:39:30 EST

Hi Benoit,

On Nov 1, 2012, at 12:23 PM, Cousson, Benoit wrote:

> On 11/1/2012 8:02 AM, Pantelis Antoniou wrote:
>> Hi Felibe,
>>
>> On Nov 1, 2012, at 12:14 AM, Felipe Balbi wrote:
>>
>>> Hi,
>>>
>>> On Wed, Oct 31, 2012 at 11:36:25PM +0200, Pantelis Antoniou wrote:
>>>>> * Pantelis Antoniou <panto@xxxxxxxxxxxxxxxxxxxxxxx> [121031 13:14]:
>>>>>> On Oct 31, 2012, at 9:55 PM, Benoit Cousson wrote:
>>>>>>>
>>>>>>> Yeah, I do agree. I'm confused as well. Only OMAP IPs under PRCM control
>>>>>>> could have an hwmod and thus must be handled by an omap_device.
>>>>>>>
>>>>>>> Any devices that is created later cannot be omap_device. The DT core
>>>>>>> will create regular platform_device for them.
>>>>>>>
>>>>>>> Since cape is an external board, it should have nothing to do with
>>>>>>> omap_device.
>>>>>>>
>>>>>>> Looking at your patch:
>>>>>>> da8xx-dt: Create da8xx DT adapter device
>>>>>>>
>>>>>>> I understand why you do that, but in fact that patch does not make sense
>>>>>>> to me :-(
>>>>>>>
>>>>>>> Why do you have to create an omap_device from the driver probe?
>>>>>>>
>>>>>>
>>>>>> The problem is that capes are not external boards in the normal sense
>>>>>> as a PCI board is. In the PCI case the hardware that implements the
>>>>>> desired functionality is on the PCI board, while in the cape case the
>>>>>> hardware module is in the SoC. The cape most of the times is quite
>>>>>> simple and contains passive components, leds or some kind of I2C/SPI devices.
>>>>>
>>>>> Ah now I see, you're talking about the beaglebone extension
>>>>> boards :)
>>>>>
>>>>> The way to deal with those properly is to just edit the
>>>>> board .dts entry to include omap-beaglebone-cape-xyz.dtsi
>>>>> whatever.
>>>>>
>>>>
>>>> That is what is being done...
>>>> This is the fallout.
>>>>
>>>>>> You can't instantiate the omap_device early in the boot process like it was done up to
>>>>>> now in the board file. You can only do that later in the boot process (for built-in
>>>>>> cape drivers), or even after user-space has booted and the matching cape driver module
>>>>>> has been loaded.
>>>>>
>>>>> Yes you can, just edit the .dts file for the extension
>>>>> board you have connected. This stuff should be DT
>>>>> only for sure, let's not even start adding platform_data
>>>>> entries for that.
>>>>>
>>>>> The omap_device entries for the omap internal devices
>>>>> will be created automatically during startup based on the
>>>>> .dts. Note that you can set status = "disabled" for the
>>>>> omap internal devices in the .dts file, the devices are
>>>>> there in the hardware.
>>>>>
>>>>> If you are sure the extension boards are safely hot
>>>>> pluggable, then all you need is some interface to enable
>>>>> and disable devices after booting. But that should be
>>>>> done in Linux generic way.
>>>>>
>>>>> So we should not export any omap_hwmod or omap_device
>>>>> things, and want to keep it __init only, and local to
>>>>> arch/arm/mach-omap2.
>>>>>
>>>>
>>>> I disagree. This is not something that is handled by just
>>>> editing the dts. The way it is handled, is in the Linux
>>>> generic way, we have a proper bus, and the drivers as compiled
>>>> as standalone file.
>>>
>>> when you have an actual bus, that'd be correct.
>>
>> What do you think capebus is? It is an actual bus that allows you
>> to do so.
>>
>>>
>>>> We're hitting a use case that wasn't there in omap until now.
>>>>
>>>> There a a whole bunch of conflicting capes. There's no
>>>> way to instantiate them together. They must be instantiated
>>>> only after their EEPROMs are read and they are matched
>>>> to their corresponding cape drivers.
>>>
>>> why this requirement of instantiating them only after reading EEPROMs ?
>>>
>>> It's unnecessary to add that requirement, just do what Tony said
>>> (include my-awesome-cape.dtsi to bone.dts) and all i2c/spi devices
>>> should be created automatically.
>>>
>>> The thing is that there is no such thing as a cape-device. The cape is
>>> just a collection of I2C, 1-wire and SPI devices anyway. What we should
>>> instantiate is bmp085, tls2550, sht21, instead of instantiating
>>> beagle-bone-weather-cape.
>>>
>>> What's the problem in just instantiating all of those from bone.dts ?
>>> Expose the EEPROMs to userland so whatever SW you guys have running on
>>> the bone can figure out what features to expose to the SDK which the
>>> user sees, but the kernel doesn't need to know that there is a
>>> weather-cape attached to the bone.
>>>
>>
>> The I2C/SPI devices are not a problem at all.
>>
>> Let me try to explain what the problem is, and why it all this
>> is needed.
>>
>> First of all, capes may be relatively simple boards, which may function
>> as a generic device - like the generic capes. They might not necessarily
>> be simple. Some capes, for example the geiger cape have a number of
>> components that perform a specific task; in this instance the driving
>> circuit of the geiger tube and the event detector input. Other capes
>> that are being designed now are even more complex, i.e. there's a
>> radar cape, an fpga cape and so on. So for these kind of boards
>> you will need a specific driver. That driver will probably use some
>> generic-cape bits (like gpios, pwms, keys what-ever).
>> But it will put them to use in the custom in-kernel driver in it's own
>> way. You can't put that task to user-space, if it's ever slightly complex.
>>
>> So for really simple capes, after considerable pain you might, just
>> might, dump the problem to user-space and try to make it work.
>> People have tried that and it's a total pain. There is no way that this will
>> work with anything more complex than a generic cape.
>>
>> Then there's the out of the box experience problem.
>>
>> What a customer that buys one of these boards along with a number of
>> capes wants is to plug them, and have them work. You cannot have
>> the DTS file activating all the drivers for each possible cape since
>> they conflict; the pins that one SPI bus that one cape uses might be a
>> PWM output for another, and so on.
>>
>> Asking the customer to edit the distro supplied kernel's dts and recompiling,
>> while figuring out how to solve conflicts is not going to fly.
>
> Well you do not have to rebuild the kernel if you just want to update the DTS.
> The way DT is done, the best you can do is to rely on the bootloader in your case to select the proper DTB. You should try to merge dynamically AMxx + beaglebone + capeXXX based on some EEPROM id.
>

That is what the capebus does. It inserts

> FWIW, we do have a similar, but simpler, problem with the beagle / beagle-xm and panda / panda-es. But for the moment we are just using a different DTS for each board.

A different DTS for each board combination... There alot more capes for the bone that they are for the beagle & the panda.
And more are going to come, but not necessarily from people that have any connection to TI or CCO.

You still haven't described how I could solve the issue of conflicting capes using a single DTS.


>
>> We have the versioning problem. All the standard capes go through
>> a very fast evolution processes. So we now have 3 versions of a DVI cape,
>> 2 of a small LCD cape and so on. We don't want to abandon the capes that
>> are already sold and are out on the field, but we don't want to spend
>> too much time hacking the driver to support all the different version.
>> The version capability of capebus handles that; taking as an example the
>> DVI cape in which the power down GPIO moved around:
>>
>>> version@00A0 {
>>> version = "00A0";
>>> dvi {
>>> compatible = "da8xx-dt";
>>> pinctrl-names = "default";
>>> pinctrl-0 = <&bone_dvi_cape_dvi_00A0_pins>;
>>> ti,hwmods = "lcdc";
>
> That part is still weird to me. Assuming the lcdc is the Display controller, the DVI should be a child of the lcdc not the opposite.
>

At the time of this there are no DT bindings yet for the da8xx driver.

>>> disp-pll = <560000000>;
>>> panel-type = "1024x768@60";
>>> powerdn-gpio = <&gpio2 7 0>;
>>> };
>>> };
>>>
>>> version@00A1 {
>>> version = "00A1", "01";
>>> dvi {
>>> compatible = "da8xx-dt";
>>> pinctrl-names = "default";
>>> pinctrl-0 = <&bone_dvi_cape_dvi_00A1_pins>;
>>> ti,hwmods = "lcdc";
>>>
>>> disp-pll = <560000000>;
>>> panel-type = "1024x768@60";
>>> powerdn-gpio = <&gpio2 31 0>;
>>> };
>>> };
>>>
>>>
>>
>> Finally, we have the target user-base problem. The users are all going to
>> be hobbyists, persons that buy beaglebones as a step up from Arduino. They
>> will want to hack their own kind of hardware; they might not even have
>> an EEPROM in their custom boards. They need some kind of runtime selection
>> of the cape they have defined, these is handled by the case of overrides.
>>
>> For example, the Adafruit 1.8 Display is pretty popular, but it's not a cape.
>> You have to wire it yourself and connect it to the expansion header. Then
>> there's two different kinds of the display. It also has a PWM input for
>> backlight control.
>>
>> Making use of it is simple with capebus:
>>
>> # cd /sys/devices/capebus.10
>> # echo "0:Adafruit 1.8 Cape" >slots
>>
>> And that's it. The disable spi & pwm device the display needs will
>> be turned on, the pinmux it needs will be set, and the spi device
>> that the display uses will be created.
>>
>> I have no clue how this can be simpler using any kind of user-space
>> method. And no, you can't have this active in the DTS of the common
>> kernel for all beaglebones.
>>
>>> &bone_adafruit_cape {
>>> board-name = "Adafruit 1.8 Cape";
>>>
>>> backlight {
>>> compatible = "pwm-backlight";
>>> pinctrl-names = "default";
>>> pinctrl-0 = <&pwm_bl_pins>;
>>>
>>> pwms = <&ehrpwm1 1 500000 0>;
>>> pwm-names = "st7735fb";
>>> brightness-levels = <0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36
>>> default-brightness-level = <50>; /* index to the array above */
>>> };
>>>
>>> spi1-devices {
>>> compatible = "spi-dt";
>>>
>>> #address-cells = <1>;
>>> #size-cells = <0>;
>>>
>>> parent = <&spi1>;
>
> Why do you need that? You seems to completely break the whole DT semantic with tons of customs bindings.
>
> From the driver code, it looks like the cape bus is not a real bus at all. If this is just a connector, then the I2C devices will be children of the AM33xx I2C controller, but there is no intermediate HW in the middle.

No it is not that way. One set of capes can be just simple connector capes. Other capes are full blown devices with their
own drivers. What do you propose as a fix is for the complex kind of capes?

>
>>>
>>> lcd@0 {
>>> compatible = "adafruit,tft-lcd-1.8-red", "sitronix,st7735";
>>> spi-max-frequency = <8000000>;
>>> reg = <0>;
>>> spi-cpol;
>>> spi-cpha;
>>> pinctrl-names = "default";
>>> pinctrl-0 = <&lcd_pins>;
>>> st7735-rst = <&gpio4 19 0>;
>>> st7735-dc = <&gpio4 21 0>;
>>> };
>>>
>>> };
>>> };
>>>
>
> I guess there is no easy solution for that, but it looks to me that what you have to do is to make the DT creation dynamic in your case. Assuming you do not want to do that in the bootloader, you must do that pretty early during the boot process to end up with a full description of your DT tree before creating the devices.
>

Do it pretty early in the boot processes ended up with the am335xevm board file in the PSP tree.

The whole set of possible cape designs cannot be controlled, nor do we want to.
We want to empower users to come up with their own designs without having to do any kernel/boot loader
hacking.

> Each cape will have their own DTS and based on some board id you will fix the DT dynamically.
>
> My point is that the issue you are facing is a real limitation of DT, so you should fix the DT core and not workaround it by creating artificial bindings / drivers.
>

You still haven't described any mechanism to deal with all the use cases I described.

DT can't and will not deal with the complexity that we're facing right now.

This is a relatively clean way to fix it; we can actually ship a mainline kernel that works.


> Regards,
> Benoit
>
>

Regards

-- Pantelis


--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/