Message ID | 20240618-dev-mule-i2c-mux-v4-0-5462d28354c8@cherry.de (mailing list archive) |
---|---|
Headers | show |
Series | Add Mule MFD support | expand |
On 6/18/24 09:06, Farouk Bouabid wrote: > Mule is an MCU that emulates a set of I2C devices which are reachable > through an I2C-mux. > > The mux and amc6821 combined make the Mule multi-function device (@0x18) > I don't think that is appropriate. Those devices should all have separate devicetree entries and be modeled as individual i2c devices. Guenter
Hi Guenter, On 6/18/24 6:29 PM, Guenter Roeck wrote: > On 6/18/24 09:06, Farouk Bouabid wrote: >> Mule is an MCU that emulates a set of I2C devices which are reachable >> through an I2C-mux. >> >> The mux and amc6821 combined make the Mule multi-function device (@0x18) >> > > I don't think that is appropriate. Those devices should all have separate > devicetree entries and be modeled as individual i2c devices. > I think there is a misunderstanding around the wording. They all have separate devicetree entries and they all are individual i2c devices (from the PoV of the kernel, they all are emulated within the same MCU). - AMC6821 on address 0x18 for registers from 0x00 to 0xfe. - Mux (paging, however you want to call it) on address 0x18 for register 0xff. Note that AMC6821 is **emulated** in the MCU so this is not some HW trickery here. This MCU also emulates ISL1208 on 0x6f, as well as a PWM controller (merge request pending) and two small AT24 "protocol" EEPROMs, on that same address. Those are behind a paging/muxing mechanism. You access ISL1208 through page 0, PWM controller through page 1, etc... So basically, the point is: - 0x18 on i2c is now MFD Mule - two platform devices behind MFD = AMC6821 (reg 0x00 to 0xfe) + Mux (reg 0xff) - 0x6f for devices "behind" the Mux - page 0 for device behind adapter 0 - page 1 for device behind adapter 1 - ... All of the above are part of the same MCU. Mule MFD is a simple-mfd-i2c device with its own devicetree entry. Child nodes of the Mule MFD are AMC6821 as a platform device (but operates over i2c) and Mule Mux. That's what was meant as "The mux and amc6821 combined make the Mule multi-function device (@0x18)". The Mule Mux then creates N i2c adapters representing the mux/pages, all of those being represented in DT. Each of those have one device on address 0x6f, all represented in DT as well. Nothing hidden or hardcoded, everything in DT. Did I miss something here? Cheers, Quentin
On 6/18/24 09:51, Quentin Schulz wrote: > Hi Guenter, > > On 6/18/24 6:29 PM, Guenter Roeck wrote: >> On 6/18/24 09:06, Farouk Bouabid wrote: >>> Mule is an MCU that emulates a set of I2C devices which are reachable >>> through an I2C-mux. >>> >>> The mux and amc6821 combined make the Mule multi-function device (@0x18) >>> >> >> I don't think that is appropriate. Those devices should all have separate >> devicetree entries and be modeled as individual i2c devices. >> > > I think there is a misunderstanding around the wording. They all have separate devicetree entries and they all are individual i2c devices (from the PoV of the kernel, they all are emulated within the same MCU). > > - AMC6821 on address 0x18 for registers from 0x00 to 0xfe. > - Mux (paging, however you want to call it) on address 0x18 for register 0xff. > > Note that AMC6821 is **emulated** in the MCU so this is not some HW trickery here. > > This MCU also emulates ISL1208 on 0x6f, as well as a PWM controller (merge request pending) and two small AT24 "protocol" EEPROMs, on that same address. Those are behind a paging/muxing mechanism. You access ISL1208 through page 0, PWM controller through page 1, etc... > > So basically, the point is: > - 0x18 on i2c is now MFD Mule > - two platform devices behind MFD = AMC6821 (reg 0x00 to 0xfe) + Mux (reg 0xff) > - 0x6f for devices "behind" the Mux > - page 0 for device behind adapter 0 > - page 1 for device behind adapter 1 > - ... > > All of the above are part of the same MCU. > > Mule MFD is a simple-mfd-i2c device with its own devicetree entry. > Child nodes of the Mule MFD are AMC6821 as a platform device (but operates over i2c) and Mule Mux. That's what was meant as "The mux and amc6821 combined make the Mule multi-function device (@0x18)". > > The Mule Mux then creates N i2c adapters representing the mux/pages, all of those being represented in DT. Each of those have one device on address 0x6f, all represented in DT as well. > > Nothing hidden or hardcoded, everything in DT. > > Did I miss something here? > If it is properly defined in devicetree, the emulated AMC6821 should be an i2c device, possibly sitting behind an i2c multiplexer, not a platform device. Guenter
Hi Guenter, On 18.06.24 19:30, Guenter Roeck wrote: > On 6/18/24 09:51, Quentin Schulz wrote: >> Hi Guenter, >> >> On 6/18/24 6:29 PM, Guenter Roeck wrote: >>> On 6/18/24 09:06, Farouk Bouabid wrote: >>>> Mule is an MCU that emulates a set of I2C devices which are reachable >>>> through an I2C-mux. >>>> >>>> The mux and amc6821 combined make the Mule multi-function device >>>> (@0x18) >>>> >>> >>> I don't think that is appropriate. Those devices should all have >>> separate >>> devicetree entries and be modeled as individual i2c devices. >>> >> >> I think there is a misunderstanding around the wording. They all have >> separate devicetree entries and they all are individual i2c devices >> (from the PoV of the kernel, they all are emulated within the same MCU). >> >> - AMC6821 on address 0x18 for registers from 0x00 to 0xfe. >> - Mux (paging, however you want to call it) on address 0x18 for >> register 0xff. >> >> Note that AMC6821 is **emulated** in the MCU so this is not some HW >> trickery here. >> >> This MCU also emulates ISL1208 on 0x6f, as well as a PWM controller >> (merge request pending) and two small AT24 "protocol" EEPROMs, on >> that same address. Those are behind a paging/muxing mechanism. You >> access ISL1208 through page 0, PWM controller through page 1, etc... >> >> So basically, the point is: >> - 0x18 on i2c is now MFD Mule >> - two platform devices behind MFD = AMC6821 (reg 0x00 to 0xfe) + >> Mux (reg 0xff) >> - 0x6f for devices "behind" the Mux >> - page 0 for device behind adapter 0 >> - page 1 for device behind adapter 1 >> - ... >> >> All of the above are part of the same MCU. >> >> Mule MFD is a simple-mfd-i2c device with its own devicetree entry. >> Child nodes of the Mule MFD are AMC6821 as a platform device (but >> operates over i2c) and Mule Mux. That's what was meant as "The mux >> and amc6821 combined make the Mule multi-function device (@0x18)". >> >> The Mule Mux then creates N i2c adapters representing the mux/pages, >> all of those being represented in DT. Each of those have one device >> on address 0x6f, all represented in DT as well. >> >> Nothing hidden or hardcoded, everything in DT. >> >> Did I miss something here? >> > > If it is properly defined in devicetree, the emulated AMC6821 should be > an i2c device, possibly sitting behind an i2c multiplexer, not a > platform device. The emulated AMC6821 and the Mule I2C mux are both reachable using I2C address (0x18), and hence the use of MFD as the mux only uses one I2C register that is not used by AMC6821. Cheers, Farouk
On 6/19/24 00:45, Farouk Bouabid wrote: >> >> If it is properly defined in devicetree, the emulated AMC6821 should be >> an i2c device, possibly sitting behind an i2c multiplexer, not a >> platform device. > > > The emulated AMC6821 and the Mule I2C mux are both reachable using I2C address (0x18), and hence the use of MFD as the mux only uses one I2C register that is not used by AMC6821. > Whatever you do, the amc chip is still an i2c driver and needs to remain one. Modeling it as platform driver is simply wrong, and I won't accept those patches. Guenter
Hi Guenter, On 19.06.24 15:31, Guenter Roeck wrote: > On 6/19/24 00:45, Farouk Bouabid wrote: > >>> >>> If it is properly defined in devicetree, the emulated AMC6821 should be >>> an i2c device, possibly sitting behind an i2c multiplexer, not a >>> platform device. >> >> >> The emulated AMC6821 and the Mule I2C mux are both reachable using >> I2C address (0x18), and hence the use of MFD as the mux only uses one >> I2C register that is not used by AMC6821. >> > > Whatever you do, the amc chip is still an i2c driver and needs to > remain one. > Modeling it as platform driver is simply wrong, and I won't accept > those patches. > The issue that we have cannot be handled by an I2C mux because in that case both the mux and its child would have the same address which is not supported in the I2C subsystem: i2c-mux@18 { compatible = "tsd,mule-i2c-mux"; reg = <0x18>; #address-cells = <1>; #size-cells = <0>; i2c10: i2c@0 { reg = <0x0>; #address-cells = <1>; #size-cells = <0>; fan: fan@18 { compatible = "ti, amc6821"; reg = <0x18>; }; }; }; The I2C maintainer rejected supporting this use case and suggested that an MFD could probably be more suitable. On one hand, the MFD looks indeed more appropriate and a lot of I2C devices are modeled through platform sub devices. On the other hand we are emulating the amc6821 in our device which requires us to have it modeled as platform: +--------+----------------+------------------------------+ | Mule (MFD) | 0x18 | +----------------+ | --------+----->| amc6821 | | | | +----------------+ | | +----->| Mux |-----+ | | +----------------+ | | | V__ +---------+ | | | \-------->| isl1208 | | | | | +---------+ | 0x6f | | M |-------->| dev #1 | | ------------------------------------>| U | +---------+ | | | X |-------->| dev #2 | | | | | +---------+ | | | /-------->| dev #3 | | | |__/ +---------+ | +--------------------------------------------------------+ If we cannot proceed with that then we could add a compatible to the amc6821 driver to add the mux device (Basically the "tsd,mule" compatible in amc6821 compatible list would be a combo driver with mux logic + amc6821). Do you think that is more appropriate ? Cheers, Farouk
On 6/24/24 09:13, Farouk Bouabid wrote: > Hi Guenter, > > On 19.06.24 15:31, Guenter Roeck wrote: >> On 6/19/24 00:45, Farouk Bouabid wrote: >> >>>> >>>> If it is properly defined in devicetree, the emulated AMC6821 should be >>>> an i2c device, possibly sitting behind an i2c multiplexer, not a >>>> platform device. >>> >>> >>> The emulated AMC6821 and the Mule I2C mux are both reachable using I2C address (0x18), and hence the use of MFD as the mux only uses one I2C register that is not used by AMC6821. >>> >> >> Whatever you do, the amc chip is still an i2c driver and needs to remain one. >> Modeling it as platform driver is simply wrong, and I won't accept those patches. >> > > The issue that we have cannot be handled by an I2C mux because in that case both the mux and its child would have the same address which is not supported in the I2C subsystem: > > > i2c-mux@18 { > > compatible = "tsd,mule-i2c-mux"; > > reg = <0x18>; > > #address-cells = <1>; > > #size-cells = <0>; > > > i2c10: i2c@0 { > > reg = <0x0>; > > #address-cells = <1>; > > #size-cells = <0>; > > > fan: fan@18 { > > compatible = "ti, amc6821"; > > reg = <0x18>; > > }; > > }; > > }; > > > The I2C maintainer rejected supporting this use case and suggested that an MFD could probably be more suitable. > > > On one hand, the MFD looks indeed more appropriate and a lot of I2C devices are modeled through platform sub devices. On the other hand we are emulating the amc6821 in our device which requires us to have it modeled as platform: > The difference is that those other i2c devices are real multi-function devices. > > +--------+----------------+------------------------------+ > | Mule (MFD) | > 0x18 | +----------------+ | > --------+----->| amc6821 | | > | | +----------------+ | > | +----->| Mux |-----+ | > | +----------------+ | | > | V__ +---------+ | > | | \-------->| isl1208 | | > | | | +---------+ | > 0x6f | | M |-------->| dev #1 | | > ------------------------------------>| U | +---------+ | > | | X |-------->| dev #2 | | > | | | +---------+ | > | | /-------->| dev #3 | | > | |__/ +---------+ | > +--------------------------------------------------------+ > > It would have been much more appropriate to use a different I2C address for the mux. > If we cannot proceed with that then we could add a compatible to the amc6821 driver to add the mux device (Basically the "tsd,mule" compatible in amc6821 compatible list would be a combo driver with mux logic + amc6821). Do you think that is more appropriate ? > Implement the mux as part of the amc6821 driver ? No. We could discuss instantiating the i2c mux driver from the amc6821 driver. Guenter
Hi Guenter, On 28.06.24 02:05, Guenter Roeck wrote: > On 6/24/24 09:13, Farouk Bouabid wrote: >> Hi Guenter, >> >> On 19.06.24 15:31, Guenter Roeck wrote: >>> On 6/19/24 00:45, Farouk Bouabid wrote: [...] > >> If we cannot proceed with that then we could add a compatible to the >> amc6821 driver to add the mux device (Basically the "tsd,mule" >> compatible in amc6821 compatible list would be a combo driver with >> mux logic + amc6821). Do you think that is more appropriate ? >> > > Implement the mux as part of the amc6821 driver ? No. We could discuss > instantiating the i2c mux driver from the amc6821 driver. If I understand correctly we would have the amc6821 for "tsd,mule" compatible probe the mule-i2c-mux as platform_device. Possible DT representation would be something like: i2c { #address-cells = <1>; #size-cells = <0>; fan@18 { compatible = "tsd,mule", "ti,amc6821"; reg = <0x18>; i2c-mux { compatible = "tsd,mule-i2c-mux"; #address-cells = <1>; #size-cells = <0>; i2c@0 { reg = <0x0>; #address-cells = <1>; #size-cells = <0>; rtc@6f { compatible = "isil,isl1208"; reg = <0x6f>; }; }; }; }; }; Cheers, Farouk
On 6/28/24 02:03, Farouk Bouabid wrote: > Hi Guenter, > > On 28.06.24 02:05, Guenter Roeck wrote: >> On 6/24/24 09:13, Farouk Bouabid wrote: >>> Hi Guenter, >>> >>> On 19.06.24 15:31, Guenter Roeck wrote: >>>> On 6/19/24 00:45, Farouk Bouabid wrote: > > > [...] > > >> >>> If we cannot proceed with that then we could add a compatible to the amc6821 driver to add the mux device (Basically the "tsd,mule" compatible in amc6821 compatible list would be a combo driver with mux logic + amc6821). Do you think that is more appropriate ? >>> >> >> Implement the mux as part of the amc6821 driver ? No. We could discuss >> instantiating the i2c mux driver from the amc6821 driver. > > > If I understand correctly we would have the amc6821 for "tsd,mule" compatible probe the mule-i2c-mux as platform_device. Possible DT representation would be something like: > Yes, something like that. I have a patch series ready which converts the amc6821 to use regmap, so the i2c-mux driver might work as-is with that patch series in place. Thanks, Guenter
Mule is an MCU that emulates a set of I2C devices which are reachable through an I2C-mux. The mux and amc6821 combined make the Mule multi-function device (@0x18) The devices on the mux can be selected by writing the appropriate device number to an I2C config register (0xff) that is not used by amc6821 logic. The selected device on the mux can be accessed for reading and writing at I2C address 0x6f. +--------+----------------+------------------------------+ | Mule (MFD) | 0x18 | +----------------+ | --------+----->| amc6821 | | | | +----------------+ | | +----->| Mux config reg |-----+ | | +----------------+ | | | V__ +---------+ | | | \-------->| isl1208 | | | | | +---------+ | 0x6f | | M |-------->| dev #1 | | ------------------------------------>| U | +---------+ | | | X |-------->| dev #2 | | | | | +---------+ | | | /-------->| dev #3 | | | |__/ +---------+ | +--------------------------------------------------------+ This patch-series adds support for the Mule MFD and I2C multiplexer as part of rk3399-puma, px30-ringneck, rk3588-tiger and rk3588-jaguar boards. Signed-off-by: Farouk Bouabid <farouk.bouabid@cherry.de> Changes in v4: - Drop the previously added i2c adapter quirks - Add platform driver probe to amc6821. - Change mule-i2c-mux driver to a platform driver - Add dev_probe_err in mule-i2c-mux driver - Add support for tsd,mule in simple-mfd-i2c - Add tsd,mule mfd to supported dts - Link to v3: https://lore.kernel.org/r/20240611-dev-mule-i2c-mux-v3-0-08d26a28e001@cherry.de Changes in v3: - Change "i2c" in comments/commit-logs to "I2C" - Fix long line-length - Warn when "share_addr_with_children" is set and the Mux is not an I2C device - Fix/stop propagating "I2C_AQ_SKIP_ADDR_CHECK" flag if "share_addr_with_children" is not set. - Fix "old_fw" variable is used to indicate the reversed meaning. - Link to v2: https://lore.kernel.org/r/20240506-dev-mule-i2c-mux-v2-0-a91c954f65d7@cherry.de Changes in v2: - Add i2c-adapter quirks to skip checking for conflict between the mux core and a child device address. - Rename dt-binding to "tsd,mule-i2c-mux.yaml" - Add Mule description to kconfig - Fix indentation - Move device table after probe - Link to v1: https://lore.kernel.org/r/20240426-dev-mule-i2c-mux-v1-0-045a482f6ffb@theobroma-systems.com --- Farouk Bouabid (9): hwmon: (amc6821) add platform driver probe hwmon: (amc6821) dev_err using amc6821 device struct dt-bindings: mfd: add support for mule i2c: muxes: add support for mule i2c multiplexer mfd: simple-mfd-i2c: Add support for tsd,mule arm64: dts: rockchip: add mule mfd (0x18) on rk3588-jaguar arm64: dts: rockchip: add mule mfd (0x18) on rk3399-puma arm64: dts: rockchip: add mule mfd (0x18) on rk3588-tiger arm64: dts: rockchip: add mule mfd (0x18) on px30-ringneck .../devicetree/bindings/i2c/tsd,mule-i2c-mux.yaml | 48 +++++++ .../devicetree/bindings/mfd/tsd,mule.yaml | 82 +++++++++++ arch/arm64/boot/dts/rockchip/px30-ringneck.dtsi | 33 ++++- arch/arm64/boot/dts/rockchip/rk3399-puma.dtsi | 33 ++++- arch/arm64/boot/dts/rockchip/rk3588-jaguar.dts | 34 ++++- arch/arm64/boot/dts/rockchip/rk3588-tiger.dtsi | 32 ++++- drivers/hwmon/amc6821.c | 88 +++++++----- drivers/i2c/muxes/Kconfig | 17 +++ drivers/i2c/muxes/Makefile | 1 + drivers/i2c/muxes/i2c-mux-mule.c | 151 +++++++++++++++++++++ drivers/mfd/simple-mfd-i2c.c | 1 + 11 files changed, 461 insertions(+), 59 deletions(-) --- base-commit: 915c5c8d4bc3c72020b9526cb3cbbd8e14318fc4 change-id: 20240404-dev-mule-i2c-mux-9103cde07021 Best regards,