From patchwork Sat Jan 6 16:02:24 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Christoph Winklhofer via B4 Relay X-Patchwork-Id: 185644 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:37c1:b0:101:2151:f287 with SMTP id y1csp174138dyq; Sat, 6 Jan 2024 08:03:38 -0800 (PST) X-Google-Smtp-Source: AGHT+IGqzXXNYFVwTtRiFE275MjgwT2uecVEWUb4TdNNH7SfJDebB0GztIFEvVq8XM+CLzaLIKVz X-Received: by 2002:a05:6870:2f05:b0:204:a79:143c with SMTP id qj5-20020a0568702f0500b002040a79143cmr893297oab.61.1704557018313; Sat, 06 Jan 2024 08:03:38 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1704557018; cv=none; d=google.com; s=arc-20160816; b=CJQQPLoSF59mLVK9I5yNU9xd7N4m97WkwHx8AZoKoS4E+h5mQnF/NgLm17WimbXd32 ZsP4Dj7qdZ6sXa49rBTLBjbSmjIv/qp+7gOpU/ephlXsK59+K8xOwkztni46lZj3shs+ Ql5RQGUDbPtXX3q0gKL6WjiZvP14MvO50xV0Ty3MYuOdB9ZSeHm7B2bEb3Qx23TeB4Vs aaNNGdItrwmJUysXqVnGaTsVbH8011TYpBH5Gczgfgxxc+VCdGSN0kNhlmc3tOD05Bn8 lNZIyFxqDQiom76ucxvKDFFy/QfebXwnoAqB4BOoiXxXEarXhQzWJcwlPgEFVZDYZyPN eatA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=reply-to:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:subject:date:from:dkim-signature; bh=tTVpoQBm5by/gySWsgc6YKHNE3z51EYLg/nImWTCs74=; fh=r7BajV2D2Jg57gZaa17CglIUBPH7SMJfiunV2wQAzJw=; b=BHnJHfRa30qJEMO+dytKYXj/cXnpgx0zcfj1sZgaFtwBZyQ+5LU9f4JYBhcaqhDEc/ wFwY/dpTQBFTWhGvFsjlvIbFevQKnBSEQ1/j/A8Am2CEPCkC9rS4lzUmjD7JDmMMrSLO Q/eETcCMt78+MIgmVUIvbM8e9/Na3TlsIjKh1hxpDV37qIcDxPb31M4qUBeSlFvB/zsR EkUdQqdrJ2vK0hTpNBTQeM5pJdTWhqVF4scBpIrfRRvwKT6/KiBpwZWa6iKVEejK8GJb 9jFGqlKVtB/ZX5r3fFAZHAcXqrANM46hvyiddaahfTcq80uQUJNkXGJv0BiXFj6fnlii EUog== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b="HZ/9496T"; spf=pass (google.com: domain of linux-kernel+bounces-18635-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-18635-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id l7-20020a05620a28c700b007831155b31csi1421054qkp.644.2024.01.06.08.03.38 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Jan 2024 08:03:38 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-18635-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b="HZ/9496T"; spf=pass (google.com: domain of linux-kernel+bounces-18635-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-18635-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id 1427C1C212F7 for ; Sat, 6 Jan 2024 16:03:38 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 6F91FE563; Sat, 6 Jan 2024 16:02:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="HZ/9496T" X-Original-To: linux-kernel@vger.kernel.org Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C17DC846F; Sat, 6 Jan 2024 16:02:27 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPS id 3CC08C433C9; Sat, 6 Jan 2024 16:02:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1704556947; bh=CyM+dK81AY1GNze7Q8lQ3o9F39LiJRzCOqn3mymlsFA=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=HZ/9496TlKf4v2wV7fF+9NcTM9dHMCQXAcuuMIVE4Hf2npLU+aBIP13h7taxNKweL CdBEFlAlaZessnSINFRDXLEXwctVsGzcWGMAculhsm6vtjTiTHDUipkb6xgi63pg2z pNRoe7lzUz9ymDNXH9gpEKGTqgplPrQUKUl4l1kIQ0jbqhk0JSJZrd0G/BRoke5+NU MLN1GZmBLM6PDKBqTV4l0ZhSUFIiOBeDR94sZqC8oEySftYvX+Pi+jeTObESrVheVm fNMa3xdj5rbU8lLOKm/hmRpjdAyD6wlKo1RJfDYaUo1g81NydRk0ocL0sIjzSZg0af ZpNv5IRQIpJDA== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 221D4C47079; Sat, 6 Jan 2024 16:02:27 +0000 (UTC) From: Christoph Winklhofer via B4 Relay Date: Sat, 06 Jan 2024 17:02:24 +0100 Subject: [PATCH v4 1/3] dt-bindings: w1: UART 1-Wire bus Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240106-w1-uart-v4-1-7fe1378a8b3e@gmail.com> References: <20240106-w1-uart-v4-0-7fe1378a8b3e@gmail.com> In-Reply-To: <20240106-w1-uart-v4-0-7fe1378a8b3e@gmail.com> To: Krzysztof Kozlowski , Rob Herring , Conor Dooley , Christoph Winklhofer , Rob Herring , Greg Kroah-Hartman , Jiri Slaby , Krzysztof Kozlowski , Jonathan Corbet Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-serial@vger.kernel.org, linux-doc@vger.kernel.org X-Mailer: b4 0.12.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1704556945; l=2346; i=cj.winklhofer@gmail.com; s=20240104; h=from:subject:message-id; bh=GIA/37nqwlMBtA6FnEHKs8XRjdXS3bL5cBDD0chGbYE=; b=M9HnA7l2nrFyCHwVTBHbWDWAg2k8moEEOvGkn+dsZ/9+/tDbjI2gkLt8m2R2tMuZtV1oBBsEM fwu0Ljq8EFNCw9b3ffM+i852WMaMePLLihudoO6BHBUfjhd9wuHthLd X-Developer-Key: i=cj.winklhofer@gmail.com; a=ed25519; pk=lgjGjOt7hFKJT9UXhgUyrdthxvZ7DJ5F1U/7d9qdAsk= X-Endpoint-Received: by B4 Relay for cj.winklhofer@gmail.com/20240104 with auth_id=111 X-Original-From: Christoph Winklhofer Reply-To: X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1787357579834276377 X-GMAIL-MSGID: 1787357579834276377 From: Christoph Winklhofer Add device tree binding for UART 1-Wire bus. Signed-off-by: Christoph Winklhofer --- Documentation/devicetree/bindings/w1/w1-uart.yaml | 62 +++++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/Documentation/devicetree/bindings/w1/w1-uart.yaml b/Documentation/devicetree/bindings/w1/w1-uart.yaml new file mode 100644 index 000000000000..6b90693b2ca0 --- /dev/null +++ b/Documentation/devicetree/bindings/w1/w1-uart.yaml @@ -0,0 +1,62 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/w1/w1-uart.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: UART 1-Wire Bus + +maintainers: + - Christoph Winklhofer + +description: | + UART 1-wire bus. Utilizes the UART interface via the Serial Device Bus + to create the 1-Wire timing patterns. + + The UART peripheral must support full-duplex and operate in open-drain + mode. The timing patterns are generated by a specific combination of + baud-rate and transmitted byte, which corresponds to a 1-Wire read bit, + write bit or reset pulse. + + The default baud-rate for reset and presence detection is 9600 and for + a 1-Wire read or write operation 115200. In case the actual baud-rate + is different from the requested one, the transmitted byte is adapted + to generate the 1-Wire timing patterns. + + https://www.analog.com/en/technical-articles/using-a-uart-to-implement-a-1wire-bus-master.html + + +properties: + compatible: + const: w1-uart + + reset-speed: + $ref: /schemas/types.yaml#/definitions/uint32 + default: 9600 + description: | + The baud rate for the 1-Wire reset and presence detect. + + touch_0-speed: + $ref: /schemas/types.yaml#/definitions/uint32 + default: 115200 + description: | + The baud rate for the 1-Wire write-0 cycle (touch bit 0). + + touch_1-speed: + $ref: /schemas/types.yaml#/definitions/uint32 + default: 115200 + description: | + The baud rate for the 1-Wire write-1 and read cycle (touch bit 1). + +required: + - compatible + +additionalProperties: false + +examples: + - | + serial { + onewire { + compatible = "w1-uart"; + }; + }; From patchwork Sat Jan 6 16:02:25 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Christoph Winklhofer via B4 Relay X-Patchwork-Id: 185645 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:37c1:b0:101:2151:f287 with SMTP id y1csp174150dyq; Sat, 6 Jan 2024 08:03:39 -0800 (PST) X-Google-Smtp-Source: AGHT+IEiFk/fpjmaxQvgsFz+NIpnMQbzBrJwsMde6XetulRA9ekzpkpqJkwT+qGRLRqRaKJqXB2o X-Received: by 2002:a05:6a20:3d1d:b0:199:8bab:ed3 with SMTP id y29-20020a056a203d1d00b001998bab0ed3mr220266pzi.18.1704557019144; Sat, 06 Jan 2024 08:03:39 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1704557019; cv=none; d=google.com; s=arc-20160816; b=rdnJNPLkjyBrY0PjjtFH0zBUIbuQEYri/qW2YjXREPpfM+i9qBa8W5GZV6qJNSC2gU OvlCa1z7RfJzXdpKc1v1RsMtvJsxuyJeEngaErVr9Qn8IeMsJD2kxf610DpFznOD5yMC XnaYA82TmONE1mstl0v+YaZRRdM5g9j5pSToFixI4ZVLnr/HZlBm8vVOkQPajcZ3nqef AyOtM95htFir4TaSnXaZ2bE9AQZKWNivlbFiE3lKCsrx/pFZjZgyf2f2398i/z0QiSzv gDvWUuCtxopatLa9Twfq9clArf1qyh6j+4MIWxA8uNFc4J55EnNOif2KPFzVVUhwZH/X BNUg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=reply-to:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:subject:date:from:dkim-signature; bh=ohWS4x3jrQ5qql8uK4hEuFMXbXt8YajP59FvuiE2vAE=; fh=r7BajV2D2Jg57gZaa17CglIUBPH7SMJfiunV2wQAzJw=; b=yx1uLNqlR0lj4uZ6QKJloqC49/PYQu48oTl03BUwGX2kEGlHSdtfrNcJubQldIdzjR /P7Ho1eksR2/kHvPZjSpbSnGSOGRlrLYudpiKHpZ7LRQvH4BRq2lkzWMqMckCAhdGIUh 3mx8XMNU5puCkrZbvg3Co2+yzWmepCZRVvjp8FOfYuT5EkdKAibO44CwjPbYjlGkX+rK mLnIrpOS9pikVW7cLQybwt8ur8k1tOEJsFDYnpg3isQuVRKfcofAI8TYjBe2UOVlRRYR 10/uf7b3nuvS8TerxWAcQg64D7DRXB6RqoZvca4QmKx6NaVpyD1VF5Nd+65ewApeKk2C lpEg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=dsKfRhR3; spf=pass (google.com: domain of linux-kernel+bounces-18638-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-18638-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id w68-20020a636247000000b005ceef90f840si1095741pgb.883.2024.01.06.08.03.39 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Jan 2024 08:03:39 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-18638-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=dsKfRhR3; spf=pass (google.com: domain of linux-kernel+bounces-18638-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-18638-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id E802028393F for ; Sat, 6 Jan 2024 16:03:38 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 873E6E56D; Sat, 6 Jan 2024 16:02:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="dsKfRhR3" X-Original-To: linux-kernel@vger.kernel.org Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D38CD847B; Sat, 6 Jan 2024 16:02:27 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPS id 4F075C433CA; Sat, 6 Jan 2024 16:02:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1704556947; bh=71uc0hK9NDOdEhHgFTZarT58L7adnWBofG0Y0tpQY4Q=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=dsKfRhR30bbGHBWMuzQEW2U4QLMWM7p885k0pgQV0RreZB1CnwvM44XfujnexGxjT MLQUIvu3XkBWAtNnWZtlctWwoKvhIbY8DTz9uUqvepp/c9vKq6ov78WyAwgLPACC+X SjGQ3KyPyrlKKxJA6wKHe2dyQRlXoP9px/8CM+Qyz3IpXd7yXCAHqCHkWOLgljcmnU 7Ik/Liu9GKOleP7jHGCMd8f8UQSXo53mc+DK/ExtgT/Smlr/G8oqncadEO7jMxhPrk NM6YNMWyf9dVMv2y9UHt+d4KL70Od+QptUEmnBoN7ninIZU18z3b1DTCLuuQszKoOf 3Wnta0/IYa71w== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2E58DC4707C; Sat, 6 Jan 2024 16:02:27 +0000 (UTC) From: Christoph Winklhofer via B4 Relay Date: Sat, 06 Jan 2024 17:02:25 +0100 Subject: [PATCH v4 2/3] dt-bindings: serial: allow onewire as child node Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240106-w1-uart-v4-2-7fe1378a8b3e@gmail.com> References: <20240106-w1-uart-v4-0-7fe1378a8b3e@gmail.com> In-Reply-To: <20240106-w1-uart-v4-0-7fe1378a8b3e@gmail.com> To: Krzysztof Kozlowski , Rob Herring , Conor Dooley , Christoph Winklhofer , Rob Herring , Greg Kroah-Hartman , Jiri Slaby , Krzysztof Kozlowski , Jonathan Corbet Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-serial@vger.kernel.org, linux-doc@vger.kernel.org X-Mailer: b4 0.12.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1704556945; l=827; i=cj.winklhofer@gmail.com; s=20240104; h=from:subject:message-id; bh=BPcWb7esDB40/mUZFKo7VPDltCBO7/vmdkKQuHI4X3c=; b=+DOlTbh6Pw9avHCALYuaoty0WhiZY/A49sTN5hWHau/0sX1XxYyWXOtpj4rcgqsg59qSs8W+t 2xfHNgN2lvYDML0E9yXwq9fDvrjZYP2ofeM2PEXZRhFYTf1IA7qNazs X-Developer-Key: i=cj.winklhofer@gmail.com; a=ed25519; pk=lgjGjOt7hFKJT9UXhgUyrdthxvZ7DJ5F1U/7d9qdAsk= X-Endpoint-Received: by B4 Relay for cj.winklhofer@gmail.com/20240104 with auth_id=111 X-Original-From: Christoph Winklhofer Reply-To: X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1787357580482690118 X-GMAIL-MSGID: 1787357580482690118 From: Christoph Winklhofer The UART 1-Wire bus utilizes the Serial Device Bus to create the 1-wire timing patterns. Signed-off-by: Christoph Winklhofer Acked-by: Rob Herring --- Documentation/devicetree/bindings/serial/serial.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/devicetree/bindings/serial/serial.yaml b/Documentation/devicetree/bindings/serial/serial.yaml index 65804ca274ae..ffc9198ae214 100644 --- a/Documentation/devicetree/bindings/serial/serial.yaml +++ b/Documentation/devicetree/bindings/serial/serial.yaml @@ -88,7 +88,7 @@ properties: TX FIFO threshold configuration (in bytes). patternProperties: - "^(bluetooth|bluetooth-gnss|gnss|gps|mcu)$": + "^(bluetooth|bluetooth-gnss|gnss|gps|mcu|onewire)$": if: type: object then: From patchwork Sat Jan 6 16:02:26 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Christoph Winklhofer via B4 Relay X-Patchwork-Id: 185646 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:37c1:b0:101:2151:f287 with SMTP id y1csp174179dyq; Sat, 6 Jan 2024 08:03:41 -0800 (PST) X-Google-Smtp-Source: AGHT+IEaVo4CsnxIUAhh7L3KzbWyNiqGgmpH+03uUXT+bww15X/mqH8koAjv9J3+z1qFMErApPSm X-Received: by 2002:a50:9b4e:0:b0:554:4d7f:a054 with SMTP id a14-20020a509b4e000000b005544d7fa054mr690803edj.1.1704557021270; Sat, 06 Jan 2024 08:03:41 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1704557021; cv=none; d=google.com; s=arc-20160816; b=h/wJ2dbhaRru7lwnE/a1cIui7+sSfRgO77Z2zRhLgS/mgqRxJ3WAqWxTVUdiG1P6bA ZZNXAHPYp+C4Zn2qN4ZhAwu8B9g2l3FewoBmNtNBFZA4HCmErT2Os318gKpkXEVRAJBH BZA7hqQWtyuI9hBnkdGC53111MvtfGv9GS2KloqhdqWOXmScKrMIy3Vw8dfNuhwlhdL5 WFk/0dw+6JBXXyeArpQwyGb5M40QAo0nnMFnsFWnkfMjEtv+yvmccSDr3oPBTmoGH7Om JFsGD/J29437Tp2Ihxpe8ngfGWkhmt01oeiJifvT6xqQUTZ4xagHCBQCxmN9KBnANQfO 8OLg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=reply-to:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:subject:date:from:dkim-signature; bh=7c74RlRVncXoQ3arnHK3u1LWq9wVmjNgLt5KlGVRjiE=; fh=r7BajV2D2Jg57gZaa17CglIUBPH7SMJfiunV2wQAzJw=; b=ehuTztGfGg9vxb0YNFNY/YCeFuKrIKs/74Wink8CAzV13b7r2vg+IvNVtH4aeAb85y Bw7krsgcnXQf999QUECH0paPxK8LT1S20KfwM4DwTTYSnoV8hLms9rdrrwquq1uIrL8S KNdX93gQn0xS3onGCnpbTQ/Cty4fC2MaxdhVAm7luwesDDaJzJhWy4+8o4HekEHLvT1R k0lOUUcX2ryzBeDFzdDG/Niglp83yAQx/pah0/98mBgySec7OUZn71QzM8fNvrDeDlX6 p440FLGkrPpUlT2hYMYbudkX0EFhFshR8Nda+uVaUbxGQrtwwheXzZ6CNtVPs8q8chOn 53Fw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=NJbd8PgT; spf=pass (google.com: domain of linux-kernel+bounces-18637-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-18637-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id s6-20020a05640217c600b00557447b4af4si1042923edy.390.2024.01.06.08.03.41 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Jan 2024 08:03:41 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-18637-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=NJbd8PgT; spf=pass (google.com: domain of linux-kernel+bounces-18637-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-18637-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id B60901F226B7 for ; Sat, 6 Jan 2024 16:03:40 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 874CFE570; Sat, 6 Jan 2024 16:02:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="NJbd8PgT" X-Original-To: linux-kernel@vger.kernel.org Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D38A3847A; Sat, 6 Jan 2024 16:02:27 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPS id 5BFFBC433C8; Sat, 6 Jan 2024 16:02:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1704556947; bh=wLC2ox3dYqkH3wQaGG3RdVVosDp4HEObsxCLhjJqsgQ=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=NJbd8PgTCahdnPucAOcMnqHIXZMeF/HzQaWlec3kduukGtDBeNXcK4eXLPohpzaog /24+uDmljKB+S4gwk2Hn1Ugm5YZcX6pVjXc2Hm9oFr8LuC4yJCcZxKvWAQOd7Ps/o2 H54ke8XOXDhWLg2qASiFaw9B0IBW1cLSqqyTvrXqKofEu2eZZHlEjhZBw7akC8CHYK FytLJ07yzrvYI0Sgz9oLLEIgVvxhIoRDs34fj1OdmtIn4zXv56xOpfU0uNJQChRNC6 OLWQ6E3kUruofRFJgGgLM8efjdVHrCQie4+VoAYn9WgPWePmgBGfH5UOHKuMDYIeou AxSzYbUpzETUA== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3E559C47077; Sat, 6 Jan 2024 16:02:27 +0000 (UTC) From: Christoph Winklhofer via B4 Relay Date: Sat, 06 Jan 2024 17:02:26 +0100 Subject: [PATCH v4 3/3] w1: add UART w1 bus driver Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240106-w1-uart-v4-3-7fe1378a8b3e@gmail.com> References: <20240106-w1-uart-v4-0-7fe1378a8b3e@gmail.com> In-Reply-To: <20240106-w1-uart-v4-0-7fe1378a8b3e@gmail.com> To: Krzysztof Kozlowski , Rob Herring , Conor Dooley , Christoph Winklhofer , Rob Herring , Greg Kroah-Hartman , Jiri Slaby , Krzysztof Kozlowski , Jonathan Corbet Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-serial@vger.kernel.org, linux-doc@vger.kernel.org X-Mailer: b4 0.12.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1704556945; l=15524; i=cj.winklhofer@gmail.com; s=20240104; h=from:subject:message-id; bh=UOoGkHAnezlxB6RgYDDo3ul/kN6oDAhar95IjRXXtQ0=; b=jN2YfBB0BMEMgEapPX+zV4C71KjYyfBqsThQv6iAIb0N/nCvXjH/I2GaIPWSUhQTAIuphlaH8 ujuhUhPqKURCRHdsASA+pJvgTTvOkI+/98Avd1qra81vS1tKrzPQIsG X-Developer-Key: i=cj.winklhofer@gmail.com; a=ed25519; pk=lgjGjOt7hFKJT9UXhgUyrdthxvZ7DJ5F1U/7d9qdAsk= X-Endpoint-Received: by B4 Relay for cj.winklhofer@gmail.com/20240104 with auth_id=111 X-Original-From: Christoph Winklhofer Reply-To: X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1787357580145499762 X-GMAIL-MSGID: 1787357583194934875 From: Christoph Winklhofer Add a UART 1-Wire bus driver. The driver utilizes the UART interface via the Serial Device Bus to create the 1-Wire timing patterns. The driver was tested on a "Raspberry Pi 3B" with a DS18B20 and on a "Variscite DART-6UL" with a DS18S20 temperature sensor. The 1-Wire timing pattern and the corresponding UART baud-rate with the interpretation of the transferred bytes are described in the document: Link: https://www.analog.com/en/technical-articles/using-a-uart-to-implement-a-1wire-bus-master.html In short, the UART peripheral must support full-duplex and operate in open-drain mode. The timing patterns are generated by a specific combination of baud-rate and transmitted byte, which corresponds to a 1-Wire read bit, write bit or reset. Signed-off-by: Christoph Winklhofer --- Documentation/w1/masters/index.rst | 1 + Documentation/w1/masters/w1-uart.rst | 54 +++++ drivers/w1/masters/Kconfig | 10 + drivers/w1/masters/Makefile | 1 + drivers/w1/masters/w1-uart.c | 398 +++++++++++++++++++++++++++++++++++ 5 files changed, 464 insertions(+) diff --git a/Documentation/w1/masters/index.rst b/Documentation/w1/masters/index.rst index 4442a98850ad..cc40189909fd 100644 --- a/Documentation/w1/masters/index.rst +++ b/Documentation/w1/masters/index.rst @@ -12,3 +12,4 @@ mxc-w1 omap-hdq w1-gpio + w1-uart diff --git a/Documentation/w1/masters/w1-uart.rst b/Documentation/w1/masters/w1-uart.rst new file mode 100644 index 000000000000..8d0f122178d4 --- /dev/null +++ b/Documentation/w1/masters/w1-uart.rst @@ -0,0 +1,54 @@ +.. SPDX-License-Identifier: GPL-2.0-or-later + +===================== +Kernel driver w1-uart +===================== + +Author: Christoph Winklhofer + + +Description +----------- + +UART 1-Wire bus driver. The driver utilizes the UART interface via the +Serial Device Bus to create the 1-Wire timing patterns as described in +the document `"Using a UART to Implement a 1-Wire Bus Master"`_. + +.. _"Using a UART to Implement a 1-Wire Bus Master": https://www.analog.com/en/technical-articles/using-a-uart-to-implement-a-1wire-bus-master.html + +In short, the UART peripheral must support full-duplex and operate in +open-drain mode. The timing patterns are generated by a specific +combination of baud-rate and transmitted byte, which corresponds to a +1-Wire read bit, write bit or reset pulse. + +For instance the timing pattern for a 1-Wire reset and presence detect uses +the baud-rate 9600, i.e. 104.2 us per bit. The transmitted byte 0xf0 over +UART (least significant bit first, start-bit low) sets the reset low time +for 1-Wire to 521 us. A present 1-Wire device changes the received byte by +pulling the line low, which is used by the driver to evaluate the result of +the 1-Wire operation. + +Similar for a 1-Wire read bit or write bit, which uses the baud-rate +115200, i.e. 8.7 us per bit. The transmitted byte 0x80 is used for a +Write-0 operation (low time 69.6us) and the byte 0xff for Read-0, Read-1 +and Write-1 (low time 8.7us). + +The default baud-rate for reset and presence detection is 9600 and for +a 1-Wire read or write operation 115200. In case the actual baud-rate +is different from the requested one, the transmitted byte is adapted +to generate the 1-Wire timing patterns. + + +Usage +----- + +Specify the UART 1-wire bus in the device tree by adding the single child +onewire to the serial node (e.g. uart0). For example: +:: + + @uart0 { + ... + onewire { + compatible = "w1-uart"; + }; + }; diff --git a/drivers/w1/masters/Kconfig b/drivers/w1/masters/Kconfig index 513c0b114337..e6049a75b35b 100644 --- a/drivers/w1/masters/Kconfig +++ b/drivers/w1/masters/Kconfig @@ -78,5 +78,15 @@ config W1_MASTER_SGI This support is also available as a module. If so, the module will be called sgi_w1. +config W1_MASTER_UART + tristate "UART 1-wire driver" + depends on SERIAL_DEV_BUS + help + Say Y here if you want to communicate with your 1-wire devices using + UART interface. + + This support is also available as a module. If so, the module + will be called w1-uart. + endmenu diff --git a/drivers/w1/masters/Makefile b/drivers/w1/masters/Makefile index 6c5a21f9b88c..227f80987e69 100644 --- a/drivers/w1/masters/Makefile +++ b/drivers/w1/masters/Makefile @@ -12,3 +12,4 @@ obj-$(CONFIG_W1_MASTER_MXC) += mxc_w1.o obj-$(CONFIG_W1_MASTER_GPIO) += w1-gpio.o obj-$(CONFIG_HDQ_MASTER_OMAP) += omap_hdq.o obj-$(CONFIG_W1_MASTER_SGI) += sgi_w1.o +obj-$(CONFIG_W1_MASTER_UART) += w1-uart.o diff --git a/drivers/w1/masters/w1-uart.c b/drivers/w1/masters/w1-uart.c new file mode 100644 index 000000000000..e3a1f97e2a4c --- /dev/null +++ b/drivers/w1/masters/w1-uart.c @@ -0,0 +1,398 @@ +// SPDX-License-Identifier: GPL-2.0-or-later +/* + * w1-uart - UART 1-Wire bus driver + * + * Uses the UART interface (via Serial Device Bus) to create the 1-Wire + * timing patterns. Implements the following 1-Wire master interface: + * + * - reset_bus: requests baud-rate 9600 + * + * - touch_bit: requests baud-rate 115200 + * + * Author: Christoph Winklhofer + */ + +#include +#include +#include +#include +#include +#include +#include +#include + +#define W1_UART_TIMEOUT msecs_to_jiffies(500) + +/* + * struct w1_uart_config - configuration for 1-Wire operation + * + * @baudrate: baud-rate returned from serdev + * @delay_us: delay to complete a 1-Wire cycle (in us) + * @tx_byte: byte to generate 1-Wire timing pattern + */ +struct w1_uart_config { + unsigned int baudrate; + unsigned int delay_us; + unsigned char tx_byte; +}; + +struct w1_uart_device { + struct serdev_device *serdev; + struct w1_bus_master bus; + + struct w1_uart_config cfg_reset; + struct w1_uart_config cfg_touch_0; + struct w1_uart_config cfg_touch_1; + + struct completion rx_byte_received; + unsigned char rx_byte; + int rx_err; + + struct mutex mutex; +}; + +/* + * struct w1_uart_limits - limits for 1-Wire operations + * + * @baudrate: Requested baud-rate to create 1-Wire timing pattern + * @bit_min_us: minimum time for a bit (in us) + * @bit_max_us: maximum time for a bit (in us) + * @sample_us: timespan to sample 1-Wire response + * @cycle_us: duration of the 1-Wire cycle + */ +struct w1_uart_limits { + unsigned int baudrate; + unsigned int bit_min_us; + unsigned int bit_max_us; + unsigned int sample_us; + unsigned int cycle_us; +}; + +static inline unsigned int baud_to_bit_ns(unsigned int baud) +{ + return 1000000000 / baud; +} + +static inline unsigned int to_ns(unsigned int us) +{ + return us * 1000; +} + +/* + * Set baud-rate, delay and tx-byte to create a 1-Wire pulse and adapt + * the tx-byte according to the actual baud-rate. + * + * Reject when: + * - time for a bit outside min/max range + * - a 1-Wire response is not detectable for sent byte + */ +static int w1_uart_set_config(struct serdev_device *serdev, + const struct w1_uart_limits *limits, + struct w1_uart_config *w1cfg) +{ + unsigned int bits_low; + unsigned int bit_ns; + unsigned int low_ns; + + w1cfg->baudrate = serdev_device_set_baudrate(serdev, limits->baudrate); + if (w1cfg->baudrate == 0) + return -EINVAL; + + /* Compute in nanoseconds for accuracy */ + bit_ns = baud_to_bit_ns(w1cfg->baudrate); + bits_low = to_ns(limits->bit_min_us) / bit_ns; + /* start bit is always low */ + low_ns = bit_ns * (bits_low + 1); + + if (low_ns < to_ns(limits->bit_min_us)) + return -EINVAL; + + if (low_ns > to_ns(limits->bit_max_us)) + return -EINVAL; + + /* 1-Wire response detectable for sent byte */ + if (limits->sample_us > 0 && + bit_ns * 8 < low_ns + to_ns(limits->sample_us)) + return -EINVAL; + + /* delay to complete 1-Wire cycle, include start and stop-bit */ + w1cfg->delay_us = 0; + if (bit_ns * 10 < to_ns(limits->cycle_us)) + w1cfg->delay_us = + (to_ns(limits->cycle_us) - bit_ns * 10) / 1000; + + /* byte to create 1-Wire pulse */ + w1cfg->tx_byte = 0xff << bits_low; + + return 0; +} + +/* + * Configuration for reset and presence detect + * - bit_min_us is 480us, add margin and use 485us + * - limits for sample time 60us-75us, use 65us + */ +static int w1_uart_set_config_reset(struct w1_uart_device *w1dev) +{ + struct serdev_device *serdev = w1dev->serdev; + struct device_node *np = serdev->dev.of_node; + + struct w1_uart_limits limits = { .baudrate = 9600, + .bit_min_us = 485, + .bit_max_us = 640, + .sample_us = 65, + .cycle_us = 960 }; + + of_property_read_u32(np, "reset-speed", &limits.baudrate); + + return w1_uart_set_config(serdev, &limits, &w1dev->cfg_reset); +} + +/* + * Configuration for write-0 cycle (touch bit 0) + * - bit_min_us is 60us, add margin and use 65us + * - no sampling required, sample_us = 0 + */ +static int w1_uart_set_config_touch_0(struct w1_uart_device *w1dev) +{ + struct serdev_device *serdev = w1dev->serdev; + struct device_node *np = serdev->dev.of_node; + + struct w1_uart_limits limits = { .baudrate = 115200, + .bit_min_us = 65, + .bit_max_us = 120, + .sample_us = 0, + .cycle_us = 70 }; + + of_property_read_u32(np, "touch_0-speed", &limits.baudrate); + + return w1_uart_set_config(serdev, &limits, &w1dev->cfg_touch_0); +} + +/* + * Configuration for write-1 and read cycle (touch bit 1) + * - bit_min_us is 5us, add margin and use 6us + * - limits for sample time 5us-15us, use 15us + */ +static int w1_uart_set_config_touch_1(struct w1_uart_device *w1dev) +{ + struct serdev_device *serdev = w1dev->serdev; + struct device_node *np = serdev->dev.of_node; + + struct w1_uart_limits limits = { .baudrate = 115200, + .bit_min_us = 6, + .bit_max_us = 15, + .sample_us = 15, + .cycle_us = 70 }; + + of_property_read_u32(np, "touch_1-speed", &limits.baudrate); + + return w1_uart_set_config(serdev, &limits, &w1dev->cfg_touch_1); +} + +/* + * Configure and open the serial device + */ +static int w1_uart_serdev_open(struct w1_uart_device *w1dev) +{ + struct serdev_device *serdev = w1dev->serdev; + struct device *dev = &serdev->dev; + int ret; + + ret = devm_serdev_device_open(dev, serdev); + if (ret < 0) + return ret; + + ret = serdev_device_set_parity(serdev, SERDEV_PARITY_NONE); + if (ret < 0) { + dev_err(dev, "set parity failed\n"); + return ret; + } + + ret = w1_uart_set_config_reset(w1dev); + if (ret < 0) { + dev_err(dev, "config for reset failed\n"); + return ret; + } + + ret = w1_uart_set_config_touch_0(w1dev); + if (ret < 0) { + dev_err(dev, "config for touch-0 failed\n"); + return ret; + } + + ret = w1_uart_set_config_touch_1(w1dev); + if (ret < 0) { + dev_err(dev, "config for touch-1 failed\n"); + return ret; + } + + serdev_device_set_flow_control(serdev, false); + + return 0; +} + +/* + * Send one byte (tx_byte) and read one byte (rx_byte) via serdev. + */ +static int w1_uart_serdev_tx_rx(struct w1_uart_device *w1dev, + const struct w1_uart_config *w1cfg, + unsigned char *rx_byte) +{ + struct serdev_device *serdev = w1dev->serdev; + int ret; + + serdev_device_write_flush(serdev); + serdev_device_set_baudrate(serdev, w1cfg->baudrate); + + /* write and immediately read one byte */ + reinit_completion(&w1dev->rx_byte_received); + ret = serdev_device_write_buf(serdev, &w1cfg->tx_byte, 1); + if (ret != 1) + return -EIO; + ret = wait_for_completion_interruptible_timeout( + &w1dev->rx_byte_received, W1_UART_TIMEOUT); + if (ret <= 0) + return -EIO; + + /* locking could fail during driver remove or when serdev is + * unexpectedly in the receive callback. + */ + if (!mutex_trylock(&w1dev->mutex)) + return -EIO; + + ret = w1dev->rx_err; + if (ret == 0) + *rx_byte = w1dev->rx_byte; + + if (w1cfg->delay_us > 0) + fsleep(w1cfg->delay_us); + + mutex_unlock(&w1dev->mutex); + + return ret; +} + +static int w1_uart_serdev_receive_buf(struct serdev_device *serdev, + const unsigned char *buf, size_t count) +{ + struct w1_uart_device *w1dev = serdev_device_get_drvdata(serdev); + + mutex_lock(&w1dev->mutex); + + /* sent a single byte and receive one single byte */ + if (count == 1) { + w1dev->rx_byte = buf[0]; + w1dev->rx_err = 0; + } else { + w1dev->rx_err = -EIO; + } + + mutex_unlock(&w1dev->mutex); + complete(&w1dev->rx_byte_received); + + return count; +} + +static const struct serdev_device_ops w1_uart_serdev_ops = { + .receive_buf = w1_uart_serdev_receive_buf, + .write_wakeup = serdev_device_write_wakeup, +}; + +/* + * 1-wire reset and presence detect: A present slave will manipulate + * the received byte by pulling the 1-Wire low. + */ +static u8 w1_uart_reset_bus(void *data) +{ + struct w1_uart_device *w1dev = data; + const struct w1_uart_config *w1cfg = &w1dev->cfg_reset; + unsigned char val; + int ret; + + ret = w1_uart_serdev_tx_rx(w1dev, w1cfg, &val); + if (ret < 0) + return -1; + + /* Device present (0) or no device (1) */ + return val != w1cfg->tx_byte ? 0 : 1; +} + +/* + * 1-Wire read and write cycle: Only the read-0 manipulates the + * received byte, all others left the line untouched. + */ +static u8 w1_uart_touch_bit(void *data, u8 bit) +{ + struct w1_uart_device *w1dev = data; + const struct w1_uart_config *w1cfg = bit ? &w1dev->cfg_touch_1 : + &w1dev->cfg_touch_0; + unsigned char val; + int ret; + + ret = w1_uart_serdev_tx_rx(w1dev, w1cfg, &val); + + /* return inactive bus state on error */ + if (ret < 0) + return 1; + + return val == w1cfg->tx_byte ? 1 : 0; +} + +static int w1_uart_probe(struct serdev_device *serdev) +{ + struct device *dev = &serdev->dev; + struct w1_uart_device *w1dev; + int ret; + + w1dev = devm_kzalloc(dev, sizeof(*w1dev), GFP_KERNEL); + if (!w1dev) + return -ENOMEM; + w1dev->bus.data = w1dev; + w1dev->bus.reset_bus = w1_uart_reset_bus; + w1dev->bus.touch_bit = w1_uart_touch_bit; + w1dev->serdev = serdev; + + init_completion(&w1dev->rx_byte_received); + mutex_init(&w1dev->mutex); + + ret = w1_uart_serdev_open(w1dev); + if (ret < 0) + return ret; + serdev_device_set_drvdata(serdev, w1dev); + serdev_device_set_client_ops(serdev, &w1_uart_serdev_ops); + + return w1_add_master_device(&w1dev->bus); +} + +static void w1_uart_remove(struct serdev_device *serdev) +{ + struct w1_uart_device *w1dev = serdev_device_get_drvdata(serdev); + + mutex_lock(&w1dev->mutex); + + w1_remove_master_device(&w1dev->bus); + + mutex_unlock(&w1dev->mutex); +} + +static const struct of_device_id w1_uart_of_match[] = { + { .compatible = "w1-uart" }, + {}, +}; +MODULE_DEVICE_TABLE(of, w1_uart_of_match); + +static struct serdev_device_driver w1_uart_driver = { + .driver = { + .name = "w1-uart", + .of_match_table = w1_uart_of_match, + }, + .probe = w1_uart_probe, + .remove = w1_uart_remove, +}; + +module_serdev_device_driver(w1_uart_driver); + +MODULE_DESCRIPTION("UART w1 bus driver"); +MODULE_AUTHOR("Christoph Winklhofer "); +MODULE_LICENSE("GPL");