Received-SPF: pass (google.com: domain of linux-kernel+bounces-160403-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1;
From: Farouk Bouabid <farouk.bouabid@theobroma-systems.com>
Date: Fri, 26 Apr 2024 18:49:33 +0200
Subject: [PATCH 2/7] dt-bindings: i2c: mux: mule: add dt-bindings for mule
 i2c multiplexer
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-Id: <20240426-dev-mule-i2c-mux-v1-2-045a482f6ffb@theobroma-systems.com>
References: <20240426-dev-mule-i2c-mux-v1-0-045a482f6ffb@theobroma-systems.com>
In-Reply-To: <20240426-dev-mule-i2c-mux-v1-0-045a482f6ffb@theobroma-systems.com>
To: Wolfram Sang <wsa+renesas@sang-engineering.com>, 
 Peter Rosin <peda@axentia.se>, Andi Shyti <andi.shyti@kernel.org>, 
 Rob Herring <robh@kernel.org>, 
 Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, 
 Conor Dooley <conor+dt@kernel.org>, 
 Quentin Schulz <quentin.schulz@theobroma-systems.com>, 
 Heiko Stuebner <heiko@sntech.de>
Cc: linux-i2c@vger.kernel.org, linux-kernel@vger.kernel.org, 
 devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, 
 linux-rockchip@lists.infradead.org, 
 Farouk Bouabid <farouk.bouabid@theobroma-systems.com>
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?utf-8?B?YlYyay91c2RaZ29TTUgrd21SVUpBQ0lhSFZzM0xlMVdwa1F4ZEFNU25CV1Rz?=
 =?utf-8?B?cG05ZFptRDJSQXBISGl2dHU3QndTSkRFZk9seGhUNWVNbEdXN3dWMXQ1UG5k?=
 =?utf-8?B?Uzhna3l1Q29PenJEWFJIOU5VUkc0YWJlZGo2QUhNOWc2dUV3NTJPaHlRdTNs?=
 =?utf-8?B?cnl2RHU1a2RuK253NnBVd0NISE1NSzlIZE1OQnN0d3lYbmtWZXB6d3Zyc0Qr?=
 =?utf-8?B?TnFRYlhuaUZvbTRtelYxRGo4ZTRhdElWSk11NlZjblpxeVEwMFVpcHh6TEFU?=
 =?utf-8?B?dEU4YmJGUzkxN2dKaWhMZHAveFlHRkVLQ0NUS0hQTzdENmkrWUc0R3dLbkRl?=
 =?utf-8?B?R2JrQ3pWT3FhdWxjekdiTjF6NldPdksvYWlTSGl3L3ZGcUlOZFVxWlRYOTlJ?=
 =?utf-8?B?d1UvZ1J4QW8yMmNCQi9Eb0RUaU5EME5CMHcrZHd1OWsyWHFFZHRjdERqMm5v?=
 =?utf-8?B?N2wvM3h4bEZoTXQrVWNZQnVydnZvWjZGRERyNDVzMHNZQ09YUGU4WHdvVnpq?=
 =?utf-8?B?RVBsc0s2cStDZ2w4bzJ5ekxWK0xraU8zaTNhNnFxVWdCRi82WFpmcjBsWFdh?=
 =?utf-8?B?eFM5NzYrTHBLdWFLQk1ZQSs0SW04cXJHYmhmRFZkU0phTytOYm5xdHBqb3Q3?=
 =?utf-8?B?dldseGpNcys4QzVIMExRaTBzdEloZFRMWENVdU1FeXBzQnRKMGVnSWJha0cy?=
 =?utf-8?B?azVGbTZrbGpOd0I2WmNjRU1HY1NNdWVLbFpJcGN1QzA0R09ndkptdnErOEFC?=
 =?utf-8?B?V0tZMjk2WEhheVhLdjhXNVdRNGdvQlk0cU4xUkdleFFGSGZWb1pwMVdiT01r?=
 =?utf-8?B?VEpzTU1ZSGZaMkNXcndnUFFhc256bzJtcEZuREVBajVDZS9DOERKdkVKRUg2?=
 =?utf-8?B?QklVN3V3UHhJRzNXcnMyeWpES2p0dWlMei9ZeDZONGpVVlgzTWM4UlhMS0tO?=
 =?utf-8?B?cGMyZ3VvTXVETy9aZEttNWF0Mit2VGdLeWs2OE4vSFpXL21wdVdwVjhONXpx?=
 =?utf-8?B?NGc5WUlVZ0xMYTRKM2w3QWVjODVhdElub2RLY1NqdnB2S24zdkV5akFoeDUx?=
 =?utf-8?B?c01xZy96NEhFLzVZcGhpUzBNUDBnNWVRSHJrb2c5NlMvYU1xREI5b1IydmlE?=
 =?utf-8?B?WWZ5dVpITTRFWk1EYW56L1RXaWxHai84LzhwMU5XS29WZnZUZlo3SVhJL21L?=
 =?utf-8?B?R2FUZVU1Lyt1c2ZBY0hHeW1uWlZDWHpRZHhkS0dhZTBib3l3NzZNTG1yZHdi?=
 =?utf-8?B?N2xMQ0FJd1B3ZWhTc2ZqenBpWlVLMkllNHV4b2lBRHNWVFExSk9yaUMwQm9n?=
 =?utf-8?B?NTN5VzMrYXQ1UERqMFBNMjVQcDJQQ0RuN2FHM2ZHUEEwVE90cFArcEtzVmVv?=
 =?utf-8?B?TG1tM1VJYXhRS1VHSUZxWTJ4eWhQRm44bVI5eW5jVGdTSnFESkl1d1RWeDRs?=
 =?utf-8?B?T01XZ2FNcDNqcjYzVDlQSjVZbDVaOC9oZEZacHh4c2VmbFA3SHVsS2ppdmhq?=
 =?utf-8?B?QXk3ZHhPK0xha1RWanhyQTdFVVVWVWw0SU1aenR0SmdSRXpUWmEzanlUV1Rs?=
 =?utf-8?B?RW0wR1NvOXFVRWJjRytmcFVLb1BaRHFDZnBxSThNc29hcDRUUCtvNHV2YWFJ?=
 =?utf-8?B?clZpV0hreGVXYlFqeU1jZnN6RzlmYTBYQnZ1eUh3NUtESUtUZENTekF2YkJa?=
 =?utf-8?B?b3JIeHk2UHpJYUJIdHlqNi9uRGc0Q2VsN1V6UVVyaCtkREcxQ2dnRGIzelNQ?=
 =?utf-8?B?SmRlU0QvRDZ3RGR3U0xLTlovM05uMmcwd20weTBvQTNndjlMS2NQMFN1WUJq?=
 =?utf-8?B?UTdOSUZ0MFV1TVJUTWNVNkhVaFNlb3ZMSW1lVitNNVUyUHR5MnRlTnBqSDFn?=
 =?utf-8?B?c3oydEpxV0QrOFNMR3ZMcElldjlCbHByb1BxeGRGc0pHbytRdW1zZkplZkFr?=
 =?utf-8?B?MXYweUIxU1l4akpJSlBKdW5PNU9wNFlMbGwyWklsbHFFc0dyNTduL3VTanpn?=
 =?utf-8?B?RzBhcWF1RXI1NXBhaXJCc1lOcTVkODJTQ3RvcmZWZ0JZSlhrNVJqWHNZMXJK?=
 =?utf-8?B?elNCT2Y4a3NROWovQ05XN2dUaUdwL1EvUnBmTjdZUmlwZ1NoM3ByTm0xemV1?=
 =?utf-8?B?dXIvdVNJb0JDVVVHRExyMEN0RCtmZ1h5am9NQStPSmhTZG8xd25QLzJCOWIw?=
 =?utf-8?Q?Ok/XhQeydK8ygQRZEB2oth4=3D?=
X-OriginatorOrg: theobroma-systems.com
X-MS-Exchange-CrossTenant-Network-Message-Id: af46b4df-ff1a-4c96-0ccf-08dc6610f956
X-MS-Exchange-CrossTenant-AuthSource: VE1PR04MB6382.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Apr 2024 16:50:27.0357
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 5e0e1b52-21b5-4e7b-83bb-514ec460677e
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: UEfeJGkXKgeKFCwo4RCRiluJhh1vlMIspGuJWNh/vlBw/OdXtDvBr4DWadWoSi2fIcu0AATlzPet0th2WfgRSdzJqz3zYmcmJ0uUzzxgDnZJgZAzxYH2EwJHoFVQVlFD
X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI0PR04MB10230

This patch adds support for the Mule I2C multiplexer.

Mule is an mcu that emulates a set of i2c devices which are reacheable
through an i2c-mux.

The emulated devices share a single i2c address with the mux itself where
the requested register is what determines which logic is executed (mux or
device).

Signed-off-by: Farouk Bouabid <farouk.bouabid@theobroma-systems.com>
---
 .../devicetree/bindings/i2c/i2c-mux-mule.yaml      | 80 ++++++++++++++++++++++
 1 file changed, 80 insertions(+)

diff --git a/Documentation/devicetree/bindings/i2c/i2c-mux-mule.yaml b/Documentation/devicetree/bindings/i2c/i2c-mux-mule.yaml
new file mode 100644
index 000000000000..458e4661cbc8
--- /dev/null
+++ b/Documentation/devicetree/bindings/i2c/i2c-mux-mule.yaml
@@ -0,0 +1,80 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/i2c/i2c-mux-mule.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Mule I2C multiplexer
+
+maintainers:
+  - Farouk Bouabid <farouk.bouabid@theobroma-systems.com>
+  - Quentin Schulz <quentin.schulz@theobroma-systems.com>
+
+description: |
+  Mule is an mcu that emulates a set of i2c devices which are reacheable
+  through an i2c-mux.
+
+  The emulated devices share a single i2c address with the mux itself where
+  the requested register is what determines which logic is executed (mux or
+  device)
+
+      +--------------------------------------------------+
+      | Mule                                             |
+      |    +---------------+                             |
+  ------+->|Config register|----+                        |
+      | |  +---------------+    |                        |
+      | |                       V_                       |
+      | |                      |  \          +--------+  |
+      | |                      |   \-------->| dev #0 |  |
+      | |                      |   |         +--------+  |
+      | |                      | M |-------->| dev #1 |  |
+      | +--------------------->| U |         +--------+  |
+      |                        | X |-------->| dev #2 |  |
+      |                        |   |         +--------+  |
+      |                        |   /-------->| dev #3 |  |
+      |                        |__/          +--------+  |
+      +--------------------------------------------------+
+
+
+allOf:
+  - $ref: /schemas/i2c/i2c-mux.yaml#
+
+properties:
+  compatible:
+    const: tsd,mule-i2c-mux
+
+  reg:
+    maxItems: 1
+
+required:
+  - compatible
+  - reg
+
+unevaluatedProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        i2c-mux@18 {
+            compatible = "tsd,mule-i2c-mux";
+            reg = <0x18>;
+            #address-cells = <1>;
+            #size-cells = <0>;
+
+            i2c@0 {
+                reg = <0x0>;
+                #address-cells = <1>;
+                #size-cells = <0>;
+
+                fan: fan@18 {
+                  compatible = "ti,amc6821";
+                  reg = <0x18>;
+                  #cooling-cells = <2>;
+                };
+            };
+        };
+    };
+...

-- 
2.34.1