Received-SPF: pass (google.com: domain of linux-kernel+bounces-209794-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99;
From: Farouk Bouabid <farouk.bouabid@cherry.de>
Date: Tue, 11 Jun 2024 13:43:53 +0200
Subject: [PATCH v3 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: <20240611-dev-mule-i2c-mux-v3-2-08d26a28e001@cherry.de>
References: <20240611-dev-mule-i2c-mux-v3-0-08d26a28e001@cherry.de>
In-Reply-To: <20240611-dev-mule-i2c-mux-v3-0-08d26a28e001@cherry.de>
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>, 
 Farouk Bouabid <farouk.bouabid@cherry.de>, 
 Quentin Schulz <quentin.schulz@cherry.de>, 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
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?utf-8?B?TU9IdVEycHpjYmxRTDNZQy9FNStIcHlzeVp6bDVwdTlxNVVvSUNGNUp3QlB2?=
 =?utf-8?B?a0tvUXRVM2RqOTZ5WDNhenpYUGloYXl2UlJhTUttaXUycENwV01NOEs3bGhB?=
 =?utf-8?B?L1lCSUVSZ05TT3MzK1F1aDNhaFQ5ZGxJSWkyZnlMVTFNOTFveVhDM1hGaGlQ?=
 =?utf-8?B?SWlEZERGMmlESEwyRVBTbVR6N3VJdWlMQ0JXK3pOQzFtK3JIOC9OTmVnZDRx?=
 =?utf-8?B?eGFSeWlZd0t6Zi9mcW5DMUxQZHRNdENGQkZiVWQ0a0R6MklUVmdxaXNOZFQy?=
 =?utf-8?B?a0llWG1CTGs0V0MzSk1wblp3WnpYNmNqcnNSanRWd0xIS24xUWVqakVHak81?=
 =?utf-8?B?RmVtT1M1ck9sY25MS1V2ZTZnNVV2MlJuaFpuR3BleUUxdmdHRGhDbVJSQ3Jq?=
 =?utf-8?B?dm1HTFlEaWg5RXFWN2J1dlJCVVFKZ1dNei9UQkZ3dmVhNkhlQk5LYXdZdTRr?=
 =?utf-8?B?bjlNRFdDSnFmeUZibUdaeTIyUnZnekhrTS9MVndzQ0hCNWVheXZEQWJSRDIw?=
 =?utf-8?B?Z290RmZoNmdVbW5zYzdDc0IwdHh3L09CcnUwSFhvZ3d1MW1Hbk1aR2UzY2Z4?=
 =?utf-8?B?M2NPS0tZckVRTjZCdXBHTXJvcExuS2t4dU9CVUFNS00zR1dCVHdiTFFYT3o2?=
 =?utf-8?B?cDF3ZW1nZ0ZSNHdIeXRvVFVTK2I1YUVsUnlMRkRJV1hkL0JWQ016NVNBYitP?=
 =?utf-8?B?SytZcHREbEdjK3UrcWRpNUQvbUd0eS8vbW5UQ2lURGpSNkdNRjg0NWhhZkRu?=
 =?utf-8?B?RHhvRUp5dU1BNmNqWG42TkhUbU94RkVtc0Q4OWltUG4wdUk3Z2dUOTN5MjJD?=
 =?utf-8?B?MjZuWmZpY2VpK1hqSFlMQmJlU2sxcnB4Z0RzejVHWEk5Vkd5OHljdkNZUXZ4?=
 =?utf-8?B?TjFSQndnTGQ0NnpYTis0K0ZxakJ6aEpVUThZcDY0NlJsdmJMMFJmOVpOWTVy?=
 =?utf-8?B?cjRRVk5tUitqbGd4aklpUFQyczkvVFdFVGxPU3Z2ekxvOGlBbHBwN1pYYVdZ?=
 =?utf-8?B?RHRsdkdPZEhQbENOanpZUVdxdGo2eVlwVVRBSUV4OGhVZTVTa2FaSmMrRjA2?=
 =?utf-8?B?RXhsR0c3RzQ3SjVzaUQzeHBhYXd3ZmVMUHRzdWZ3ZG1abnFFYzk0cDYzaTRi?=
 =?utf-8?B?dFdvUjlpQlYycnd6RHRnYlk3M1pzOTZyT1BBUDN0MllRTHpGL0w2YkljOExq?=
 =?utf-8?B?TXFEUnp3emNWSmRrY04yWnVBSTlwNXpaUkxvS2lmb21qbTNSNCt3QVZ0cHFB?=
 =?utf-8?B?TldMOEVQUWlCQUlUbHdPcDFJMWxQZmdIM3Bpd0pzVHhrT1NxNW5KL0xDOSsr?=
 =?utf-8?B?cndCWmJUSW9lcUFKNm9xVVpHdDJGcG5MdUp4THB2K001dnZkc1AwcUdGeVE3?=
 =?utf-8?B?Y2YzNUlwbnF4V1N1djF0ZEhJQjJTa09TQ3VRZDd3Q3hiOXpCOVpNcFJSWTdD?=
 =?utf-8?B?QjBtTEtHQ2p1dVczOFd1SDNBRTVqUTZzRk5DQTlReWZvOGUzTytRc3JzM2Ri?=
 =?utf-8?B?OUJHd1ZIb3l1UVp2L0UvNFBPOGdLY3dPU2s2dlg2MGVTTU1EcVR1S2FpRFhY?=
 =?utf-8?B?cS9KbFNyL2N5d3BDb0NyQ0RvaUlIeFp6Znd5ak91Ui9CVHFpWGZ1ZVpxd2Rt?=
 =?utf-8?B?TE1DeWpWNGtwbW0zVUdyZjZmUkZTNU93WVBYNmd4RUJiSVlicGVORGdhK2to?=
 =?utf-8?B?blNtaDBrTmJ6ZHJIVmw2V1NpcWVCakwveUpEMHlkM1B4ckhpeGNRbmtjanZL?=
 =?utf-8?B?b0FTazhPUHVCN0x4UVlFSDA0d0JrNHJpQnBwOXVRR05Qd3BaYU8yZ2J4UTBM?=
 =?utf-8?B?RkMwajFYR3M0bEQxb1NFZkVSNFp5RTl4Vm9Fd3RSa0tGVDF3Z2pDZ1ZRNVVN?=
 =?utf-8?B?YzFiWWJkMU9Fb29CdVF5VVhrMStCN3AxWkx6UkhHSjBLZzVOc3FJMVQ1N20y?=
 =?utf-8?B?ZnBFLzdyeHZ1WTgwR3d3V1hzNFNIN0Ntd1dCVSs5V0lCT2Q0RTFyd254WVZ6?=
 =?utf-8?B?U2w5UU1SU3YyVFpEMitwaXoybDJXcS9jcVhzc1lib3JwWnA3b3RYd2hKYUxs?=
 =?utf-8?B?Sk9hUGtSUHBISUE4enR2eUtPT0RJdU9ISlk5ZUR3TFZtcnJObTFyT0NueFB1?=
 =?utf-8?B?TFpTRFpDM0tyTllxMUttYXpQZHJiV0FPOFJmUWVENUpWRjdobUtSdCtsT1Ew?=
 =?utf-8?B?Q0E9PQ==?=
X-OriginatorOrg: cherry.de
X-MS-Exchange-CrossTenant-Network-Message-Id: 491f2924-d347-4fd8-bbc4-08dc8a0bd9e3
X-MS-Exchange-CrossTenant-AuthSource: VE1PR04MB6382.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Jun 2024 11:44:28.7439
 (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: G672EwOK+6X6Eay1FaIUQs/1GAqewLpU6bNo90eK+G99ker+ZUdWPlwMQhAFigMHj+KTse+qkNlEtph4FxeYh59On9XY3dI2qBWSs32R9H8=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: GVXPR04MB10301

Mule is an MCU that emulates a set of I2C devices which are reachable
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 logic or device logic).

Add support for the Mule I2C multiplexer bindings.

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

diff --git a/Documentation/devicetree/bindings/i2c/tsd,mule-i2c-mux.yaml b/Documentation/devicetree/bindings/i2c/tsd,mule-i2c-mux.yaml
new file mode 100644
index 000000000000..b7bb13549027
--- /dev/null
+++ b/Documentation/devicetree/bindings/i2c/tsd,mule-i2c-mux.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/tsd,mule-i2c-mux.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Mule I2C multiplexer
+
+maintainers:
+  - Farouk Bouabid <farouk.bouabid@cherry.de>
+  - Quentin Schulz <quentin.schulz@cherry.de>
+
+description: |
+  Mule is an MCU that emulates a set of I2C devices which are reachable
+  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 logic or device logic)
+
+      +--------------------------------------------------+
+      | 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