P3H2x4x (P3H2440/P3H2441/P3H2840/P3H2841) is multiport I3C hub device which connects to a host CPU via I3C/I2C/SMBus bus on one side and to multiple peripheral devices on the other side. Signed-off-by: Aman Kumar Pandey <aman.kumarpandey@xxxxxxx> Signed-off-by: Vikash Bansal <vikash.bansal@xxxxxxx> --- .../bindings/i3c/p3h2x4x_i3c_hub.yaml | 404 ++++++++++++++++++ MAINTAINERS | 7 + 2 files changed, 411 insertions(+) create mode 100644 Documentation/devicetree/bindings/i3c/p3h2x4x_i3c_hub.yaml diff --git a/Documentation/devicetree/bindings/i3c/p3h2x4x_i3c_hub.yaml b/Documentation/devicetree/bindings/i3c/p3h2x4x_i3c_hub.yaml new file mode 100644 index 000000000000..33ea524e5432 --- /dev/null +++ b/Documentation/devicetree/bindings/i3c/p3h2x4x_i3c_hub.yaml @@ -0,0 +1,404 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +# Copyright 2024-2025 NXP + +%YAML 1.2 + +$id: http://devicetree.org/schemas/i3c/p3h2x4x_i3c_hub.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: P3H2X4X I3C HUB + +maintainers: + - Vikash Bansal <vikash.bansal@xxxxxxx> + - Aman Kumar Pandey <aman.kumarpandey@xxxxxxx> + +description: | + P3H2x4x (P3H2440/P3H2441/P3H2840/P3H2841) are multiport I3C hub devices + that connect to:- + 1. A host CPU via I3C/I2C/SMBus bus on one side and connect to multiple + peripheral devices on the other side. + 2. Have two Controller Ports which can support either + I2C/SMBus or I3C buses and connect to a CPU, BMC or SOC. + 3. P3H2840/ P3H2841 are 8 port I3C hub devices with eight I3C/I2C Target Port. + 4. P3H2440/ P3H2441 are 4 port I3C hub devices with four I3C/I2C Target Port. + Target ports can be configured as I2C/SMBus, I3C or GPIO and connect to + peripherals. + + Device tree node can be used for following configurations:- + 1. Controller Port can be configured via dt entry to support + 2. I2C/SMBus mode or I3C buses. + 3. Enabling voltage compatibility across I3C Controller and + Target devices. + 4. Up to eight target devices and their modes(I3C/I2C/SMbus modes). + 5. To support MCTP device + 6. To support In-band interrupts + + Controller Port can be configured via dt entry to support I2C/SMBus mode or + I3C buses. + + For I2C devices, use below format: + DT node: hub@static_address + reg: encodes the static I2C address. + + For I3C devices, use below format: + DT node: hub@static_address,PID + reg: encodes the static I2C address (0 if the device does not have one), and the + Provisioned ID (PID) used to uniquely identify a device on a bus. + This PID contains information about the vendor, the part, and an instance ID so + that several devices of the same type can be connected on the same bus. + assigned-address: represents the dynamic address to be assigned to this device. + +allOf: + - $ref: i3c.yaml# + +properties: + + cp0-ldo-en: + enum: + - disabled + - enabled + description: | + I3C HUB Controller Port 0 LDO setting for turning on and off. If enabled, the dedicated + pin will provide the voltage generated by the on-die LDO. It is an optional property, + the configuration remains default if it is not supplied. + + cp1-ldo-en: + enum: + - disabled + - enabled + + description: | + I3C HUB Controller Port 0 LDO setting for turning on and off. If enabled, the dedicated + pin will provide the voltage generated by the on-die LDO. It is an optional property, + the configuration remains default if it is not supplied. + + tp0145-ldo-en: + enum: + - disabled + - enabled + + description: | + I3C HUB Target Ports 0/1/4/5 LDO setting for turning on and off. If enabled, the dedicated + pin will provide the voltage generated by the on-die LDO. It is an optional property, + the configuration remains default if it is not supplied. + + tp2367-ldo-en: + enum: + - disabled + - enabled + + description: | + I3C HUB Target Ports 2/3/6/7 LDO setting for turning on and off. If enabled, the dedicated + pin will provide the voltage generated by the on-die LDO. It is an optional property, + the configuration remains default if it is not supplied. + + cp0-ldo-volt: + enum: + - 1.0V + - 1.1V + - 1.2V + - 1.8V + + description: | + Controller Port 0 voltage level is controlled by the I3C HUB Controller Port 0 + LDO setting. + Since this parameter is optional, the configuration remains default if it is not supplied. + + cp1-ldo-volt: + enum: + - 1.0V + - 1.1V + - 1.2V + - 1.8V + + description: | + Controller Port 1 voltage level is controlled by the I3C HUB Controller Port 1 + LDO setting. + Since this parameter is optional, the configuration remains default if it is not supplied. + + tp0145-ldo-volt: + enum: + - 1.0V + - 1.1V + - 1.2V + - 1.8V + + description: | + Target Port 0/1/4/5 voltage level is controlled by the I3C HUB Target Port 0/1/4/5 + LDO setting. + Since this parameter is optional, the configuration remains default if it is not supplied. + + tp2367-ldo-volt: + enum: + - 1.0V + - 1.1V + - 1.2V + - 1.8V + + description: | + Target Port 2/3/6/7 voltage level is controlled by the I3C HUB Target Port 2/3/6/7 + LDO setting. + Since this parameter is optional, the configuration remains default if it is not supplied. + + tp0145-pullup: + enum: + - 250R + - 500R + - 1000R + - 2000R + + description: | + Target Port 0/1/4/5 pull up setting is controlled by the I3C HUB Target Port 0/1/4/5 + pull up resistance level. + Since this parameter is optional, the configuration remains default if it is not supplied. + + tp2367-pullup: + enum: + - 250R + - 500R + - 1000R + - 2000R + + description: | + Target Port 2/3/6/7 pull up setting is controlled by the I3C HUB Target Port 2/3/6/7 + pull up resistance level. + Since this parameter is optional, the configuration remains default if it is not supplied. + + cp0-io-strength: + enum: + - 20Ohms + - 30Ohms + - 40Ohms + - 50Ohms + + description: | + To regulate the output driver strength at Controller Port 0, use the I3C HUB Controller + Port 0 IO strength setting. + It is an optional property, the configuration remains default if it is not supplied. + + cp1-io-strength: + enum: + - 20Ohms + - 30Ohms + - 40Ohms + - 50Ohms + description: | + To regulate the output driver strength at Controller Port 1, use the I3C HUB Controller + Port 1 IO strength setting. + It is an optional property, the configuration remains default if it is not supplied. + + tp0145-io-strength: + enum: + - 20Ohms + - 30Ohms + - 40Ohms + - 50Ohms + + description: | + To regulate the output driver strength at Target port 0/1/4/5, use the I3C HUB Target + port 0/1/4/5 IO strength setting. + It is an optional property, the configuration remains default if it is not supplied. + + tp2367-io-strength: + enum: + - 20Ohms + - 30Ohms + - 40Ohms + - 50Ohms + + description: | + To regulate the output driver strength at Target port 2/3/6/7, use the I3C HUB Target + port 2/3/6/7 IO strength setting. + It is an optional property, the configuration remains default if it is not supplied. + +patternProperties: + "@[0-7]$": + type: object + description: | + I3C HUB Target Port child, should be named: target-port@<target-port-id> + + properties: + mode: + enum: + - i3c + - smbus + - i2c + - gpio + + description: | + I3C HUB Target Port mode setting to control Target Port functionality. + As per now it is oly supporting SMBus, i2c and i3c( i2c mode will work + with hub network). + + pullup: + enum: + - disabled + - enabled + description: | + I3C HUB Target Port pull-up setting to disable/enable Target Port pull-up. + It is an optional property, the configuration remains default if it is not supplied. + + ibi_en: + enum: + - disabled + - enabled + description: | + I3C HUB Target Port IBI setting to disable/enable IBI for Target Port. + This property is optional. If not provided, Target Port IBI will disabled. + + local_dev: + description: | + SMBus Target Agent can discard transactions of downstream device and not generate an IBI to upstream I3C Hub + Controller Port. Up to 8 device (addresses) can be configured as local Devices. + + This property is optional. If not provided, local device list will empty. + + always-enable: + description: | + Add this field to enable hub network(Controller port -> target port). + + This property is optional. If not provided, by default hub network will disabled for respective port. + + patternProperties: + "@slave-address,pid$": + type: object + description: | + Adding this node to install the downstream devices. + + properties: + compatible: + description: + Compatible of the I2C/SMBus downstream device. + + reg: + description: + Downstream device addresses which are connected to target port. + + I3c HUB driver supports standerd i2c/i3c DT entry as it passes DT node to respective driver for + downstream device. + +additionalProperties: true + +examples: + - | + i3c_hub: hub@70,236153000c2{ + reg = <0x70 0x236 0x3000c2>; + assigned-address = <0x50>; + dcr = <0xC2>; + + cp0-ldo-en = "disabled"; + cp1-ldo-en = "disabled"; + cp0-ldo-volt = "1.8V"; + cp1-ldo-volt = "1.8V"; + tp0145-ldo-en = "disabled"; + tp2367-ldo-en = "disabled"; + tp0145-ldo-volt = "1.8V"; + tp2367-ldo-volt = "1.8V"; + tp0145-pullup= "1000R"; + tp2367-pullup = "1000R"; + tp0145-io-strength = "20Ohms"; + tp2367-io-strength = "20Ohms"; + cp0-io-strength = "20Ohms"; + cp1-io-strength = "20Ohms"; + target-port@0 { + #address-cells = <1>; + #size-cells = <0>; + mode = "smbus"; + pullup_en = "enabled"; + ibi_en = "enabled"; + local_dev = <0x30>, <0x40>, <0x50>; + backend@4c{ + compatible = "i3c-hub"; + reg = <0x4c>; + }; + rtc@68 { + compatible = "dallas,ds3232"; + reg = <0x68>; + interrupt-parent = <&gpio2>; + interrupts = <20 0>; + trickle-resistor-ohms = <250>; + }; + + eeprom@57 { + compatible = "atmel,24c32"; + reg = <0x57>; + pagesize = <32>; + wp-gpios = <&gpio2 2 0>; + num-addresses = <8>; + }; + }; + target-port@1 { + #address-cells = <1>; + #size-cells = <0>; + mode = "smbus"; + pullup_en = "enabled"; + ibi_en = "enabled"; + local_dev = <0x35>, <0x45>, <0x55>; + }; + target-port@2 { + #address-cells = <1>; + #size-cells = <0>; + mode = "i3c"; + pullup_en = "enabled"; + hub-test@4c,25400000000{ + reg = <0x4c 0x254 0x0000>; + assigned-address = <0x50>; + }; + }; + target-port@3 { + #address-cells = <1>; + #size-cells = <0>; + mode = "i3c"; + pullup_en = "enabled"; + always-enable; + }; + }; + + i3c_hub: hub@70 { + compatible = "nxp,p3h2x4x"; + reg = <0x70>; + + cp0-ldo-en = "disabled"; + cp1-ldo-en = "disabled"; + cp0-ldo-volt = "1.8V"; + cp1-ldo-volt = "1.8V"; + tp0145-ldo-en = "disabled"; + tp2367-ldo-en = "disabled"; + tp0145-ldo-volt = "1.8V"; + tp2367-ldo-volt = "1.8V"; + tp0145-pullup= "1000R"; + tp2367-pullup = "1000R"; + tp0145-io-strength = "20Ohms"; + tp2367-io-strength = "20Ohms"; + cp0-io-strength = "20Ohms"; + cp1-io-strength = "20Ohms"; + target-port@0 { + #address-cells = <1>; + #size-cells = <0>; + mode = "smbus"; + pullup_en = "enabled"; + ibi_en = "enabled"; + local_dev = <0x30>, <0x40>, <0x50>; + + backend@4c{ + compatible = "test-dvr"; + reg = <0x4c>; + }; + rtc@68 { + compatible = "dallas,ds3232"; + reg = <0x68>; + interrupt-parent = <&gpio2>; + interrupts = <20 0>; + trickle-resistor-ohms = <250>; + }; + + eeprom@57 { + compatible = "atmel,24c32"; + reg = <0x57>; + pagesize = <32>; + wp-gpios = <&gpio2 2 0>; + num-addresses = <8>; + }; + }; + }; +- | diff --git a/MAINTAINERS b/MAINTAINERS index af686e0bb6d7..20aa3e987ac5 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -17167,6 +17167,13 @@ S: Maintained F: Documentation/devicetree/bindings/sound/nxp,tfa989x.yaml F: sound/soc/codecs/tfa989x.c +NXP P3H2X4X I3C-HUB DRIVER +M: Vikash Bansal <vikash.bansal@xxxxxxx> +M: Aman Kumar Pandey <aman.kumarpandey@xxxxxxx> +L: linux-kernel@xxxxxxxxxxxxxxx +S: Maintained +F: Documentation/devicetree/bindings/i3c/p3h2x4x_i3c_hub.yaml + NZXT-KRAKEN2 HARDWARE MONITORING DRIVER M: Jonas Malaco <jonas@xxxxxxxxxxxx> L: linux-hwmon@xxxxxxxxxxxxxxx -- 2.25.1
