Received-SPF: pass (google.com: domain of linux-kernel+bounces-40433-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1;
From: Farouk Bouabid <farouk.bouabid@theobroma-systems.com>
Date: Fri, 26 Jan 2024 18:27:44 +0100
Subject: [PATCH v5 3/6] dt-bindings: serial: add binding for rs485
 rx-enable state when rs485 is disabled
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-Id: <20240126-dev-rx-enable-v5-3-5d934eda05ca@theobroma-systems.com>
References: <20240126-dev-rx-enable-v5-0-5d934eda05ca@theobroma-systems.com>
In-Reply-To: <20240126-dev-rx-enable-v5-0-5d934eda05ca@theobroma-systems.com>
To: Greg Kroah-Hartman <gregkh@linuxfoundation.org>, 
 Jiri Slaby <jirislaby@kernel.org>, Rob Herring <robh+dt@kernel.org>, 
 Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, 
 Conor Dooley <conor+dt@kernel.org>, Heiko Stuebner <heiko@sntech.de>
Cc: Rob Herring <robh@kernel.org>, linux-kernel@vger.kernel.org, 
 linux-serial@vger.kernel.org, devicetree@vger.kernel.org, 
 linux-arm-kernel@lists.infradead.org, linux-rockchip@lists.infradead.org, 
 quentin.schulz@theobroma-systems.com, 
 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?VmxFZnQzM2Nmc0ViL1pXM1c3QjlwTjVZZGZnVFo5U1ZtdURMOHdVT0E2eU9L?=
 =?utf-8?B?TG9CaElIb2MxNDY0YWJjSlpNRDJXSVdJZTc3SXhzM282dWdlQ2RjTVU4N3hI?=
 =?utf-8?B?Qk02bDhpMHQ2c0tIaFBaM1BLYXRrN2l4OWlKUFNzK0Y3THRSMWNidVVDQXJq?=
 =?utf-8?B?cytveis1NFhkZGRZdUd6Y3kvUkdxak96NWUzMlM3QUQvMThhOXhvQlAyWGxk?=
 =?utf-8?B?b01OcWw5ZDg5MGhiMDJoU3p1QkdZY3paZzBpc0psRE9qZ2pzOGhmRlY2dFZK?=
 =?utf-8?B?NVFUZWZJZ2ZYZ0FoOG5SNTltRFl5Uy9yc3ZrdDV3clkzazNXZUFYWkhMb3VT?=
 =?utf-8?B?eEREQ0R4ZDhVWlhSTXhXdlFYWVBmNnhZcExualQwZ1hHMWt6YUQ1cFlqS1pQ?=
 =?utf-8?B?OW02L1BFVURvYTZGSEllODFDVTlFcnYydEN3MG8weDZ3L3NDUkowRHVmR1VF?=
 =?utf-8?B?T3Ayb3c3WWNqNExSTytTVWxKYVlpK2JYcThkc3RvQ1lqS0Z2NmNLMks1bVRI?=
 =?utf-8?B?S1B6Q0FpWVRqZXAwSUFCbFA5TkExVXF1cDF3OGxqRXpVSk1EUXpKL0lBZDRp?=
 =?utf-8?B?MzlwRGdpVm8rOWNpQmxldDQybGtIWjNiLzd0RXdCaTh1czZjYXZYSjIvKzNm?=
 =?utf-8?B?UzRwaVF6UHdoK1dDQi9tVFh6MWYrZW5TdEtPUHVMRExmYTJOVitFd2NhekpP?=
 =?utf-8?B?cE44TkdSQ1U1Q1Q2OXk2SmpsbDJHK2Y0NSt2YlU2NDRFSjVIVWRsMDV6bkdi?=
 =?utf-8?B?RE1RVjBZcjZDVUJNaXVhNlBObTFTOUhSWCtoQitiUmZmNGF0eDhYZmFqNWJi?=
 =?utf-8?B?VWthNWl1eDNGc1JUZTB1UG9LSmRWcHliYkdaNGV5VnY5TnNHeTZpbXFoT3Y5?=
 =?utf-8?B?RzlBamdraS8ySThBd01TMCtMR0lUck1wNklzc3ZoeHo4SHBLWW5oTGtsZDBi?=
 =?utf-8?B?aitCd0c4c3IyZGhMdkU1SVZQVFN4QUZMLzU3RGxCSUVIYjVyWFN1VUZERCsy?=
 =?utf-8?B?YVRtdHFjVisvMVhpb1RWa05EZ2ZPNFd1RDRtajMvY2RGZnc0VEQwS0tWc2Vr?=
 =?utf-8?B?WDczT1pLQTJ5SWtCb1ZucVF1ak12QnNlM0QvbmJPYjR4N3BwVXF5VVl1akRI?=
 =?utf-8?B?WVVFNVFZYS9uNDU1WjNUSlkzaytPT3FTWXpNSUswOVZVRHY3UVFyS3VJci85?=
 =?utf-8?B?NDJGUnNtWVpPTWpJUzFKY0lqbGYxNTlUL0Zqc3hSZ2FaYVpSSWVRS1l3M21m?=
 =?utf-8?B?Y2UwYVd4TlhVcHdiNDVNR0lEeGhXbUxSOEErWUlHMkl1Vkh5VkcvdlNwczI0?=
 =?utf-8?B?bjY4ZlkyRUxqVjVEc2l4TlVkeEwyeGhmTHRtSEtaU3IzMWtBcVRBb3Q0Skk5?=
 =?utf-8?B?Z3QwTmt5MFdBN1V6bE15MTcxeTExaUtSWmFGTzlOV2NUZnc3Z1VmK0VwTW8r?=
 =?utf-8?B?WmJyeUYrVjErTGhrQzNxcndEOUJlMlcrT2VzOHZCdWwyczFoY0IrZjFGV1pH?=
 =?utf-8?B?T2RJUU1lUUZQcHNZUzdoSzdYRWlWNzJhazExQTZZWmpodjZVc1dhT3ZmSGRI?=
 =?utf-8?B?L1UwWWFJMnFBVE12eU9JSzZPN3lCRk5PNm1RUFNhKy8reUlCVzhLcTlIUFE4?=
 =?utf-8?B?Q1ZGNzQ4dGlTcTJOOUI5bGlJeDNvVEk5L3hWMWUveDlFemRvaUhGZFc0Tzcr?=
 =?utf-8?B?bEJONjEvSmFrSENFRGdnVzhpcXUycElGSUlSVG9mb1dnMVNWcmU0K29CcHhz?=
 =?utf-8?B?eGVXZnFXVXZtM0tUcUhPOVJYSFpxWEh0RVlOTEgzL2hxOHp2bHZraUlhNlBr?=
 =?utf-8?B?ZFZ5TVJNaW5JT0tLSzdrUllXNkh5RkV1b1FVdWQxa241enE2d0hZUXJSdHVT?=
 =?utf-8?B?K0NWaHd6TnBEMWQzbUFiM2NOb3hTc2NOcVRZM3dWWDBKR3FFTWtKZUZsaldx?=
 =?utf-8?B?OEFMcm5kTDIzTWF0bUFWazRFWmx0VWVQMkl3OXF3SDJ0cFdQclY1R05HMUZt?=
 =?utf-8?B?VmRjVXRLYUZNdFlxSHBOZ2k5N2Y4NkxLWmNVaUUwS2o0cFFLZ0hzd08xb01o?=
 =?utf-8?B?dFJpdkw2b250Qm5rakwwalpmZUMzWHlFV1hZVVQ0clY5UVl2cWRJMmxZb2Mz?=
 =?utf-8?B?NENRa3VXMWxkbnpZZkVkSlBIVGY0THZac3orVXA2aTdoVHNHeXkxTm8xOXhC?=
 =?utf-8?Q?gWiVhu04/wd0wokRlV2o59w=3D?=
X-OriginatorOrg: theobroma-systems.com
X-MS-Exchange-CrossTenant-Network-Message-Id: b466c037-1544-4b2c-fb7f-08dc1e9439ee
X-MS-Exchange-CrossTenant-AuthSource: VE1PR04MB6382.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Jan 2024 17:28:35.6552
 (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: gbiBoWmkXLfXnlwJODFn/Dnp7Pi9Jh5rGwkEotyIribKFu9Swr0HAjyfmZxUVUCMi7sP747yZAMs9UHT/tkrT8uSCca+S7m15Lvz6ZwyrxRaSU4z41nDXMUJ8TTWjs6n
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB9PR04MB9820

RS485 can have a receiver-enable gpio (rx-enable-gpios). When rs485 is
enabled, this gpio, if provided, must be driven active while receiving.
However when RS485 is disabled this gpio should not have an undefined
state. In that case, as DE and RE pins can be connected both to this gpio,
if its state is not properly defined, can cause unexpected transceiver
behavior.
This binding depend on rx-enable-gpios to be implemented.

Signed-off-by: Farouk Bouabid <farouk.bouabid@theobroma-systems.com>
---
 Documentation/devicetree/bindings/serial/rs485.yaml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Documentation/devicetree/bindings/serial/rs485.yaml b/Documentation/devicetree/bindings/serial/rs485.yaml
index b64577036b5c..4c79dfaaf460 100644
--- a/Documentation/devicetree/bindings/serial/rs485.yaml
+++ b/Documentation/devicetree/bindings/serial/rs485.yaml
@@ -55,6 +55,11 @@ properties:
     description: GPIO to handle a separate RS485 receive enable signal
     maxItems: 1
 
+  rs485-rx-enable-inactive-when-rs485-disabled:
+    description: rx-enable GPIO is not active when RS485 is disabled. If missing, active-state
+      is assumed.
+    $ref: /schemas/types.yaml#/definitions/flag
+
   rs485-term-gpios:
     description: GPIO pin to enable RS485 bus termination.
     maxItems: 1

-- 
2.34.1