From patchwork Fri Mar 11 23:51:16 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Linus Walleij X-Patchwork-Id: 550575 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id C90C4C433F5 for ; Fri, 11 Mar 2022 23:53:30 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229461AbiCKXyd (ORCPT ); Fri, 11 Mar 2022 18:54:33 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43362 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229447AbiCKXyb (ORCPT ); Fri, 11 Mar 2022 18:54:31 -0500 Received: from mail-lf1-x131.google.com (mail-lf1-x131.google.com [IPv6:2a00:1450:4864:20::131]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9B8DE21652A for ; Fri, 11 Mar 2022 15:53:26 -0800 (PST) Received: by mail-lf1-x131.google.com with SMTP id b28so6034160lfc.4 for ; Fri, 11 Mar 2022 15:53:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=KBNusC+uzmE0NrjzdEt+MgpvOycN0Iv0sdzR/jIW3O4=; b=BrfZpw80bcUCAJ5ook8HcxZEJWCjo6aPyYHhqWwrcM44fXo5pV9/zdwN95JErycKdm YDdaejMurLJPrt6zHvZjsHRVeuyRyELshiFLI3ZwonMcKOUNy8Fsl2bxZjxO7dLjXD1B idkf5Bf8tOnMN/co5ONgYf0Equ52FR8PDDV0ydxbK2Qt2tvVfySh8lXb/PXMZPx2CY0z ioGBrk6RTOSVsTm6GYi4pwUPP/bB0YJK5jyMFshkvkEyRUQl0TlH2XQzWojDK+3kKfKR NKuqynUfHM+c+H1iKIhRjKE/LYF2D7um0oKm82+4iCA8rgQ6OjJ7y04grwkfxUJGqwxW KULg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=KBNusC+uzmE0NrjzdEt+MgpvOycN0Iv0sdzR/jIW3O4=; b=1ewE5GJx5J2gL9h5rhXCvma59wAHmRG5bQVzUCrrruTSAJ5MpmXVSdQ4Xz/uErVEaD 9lo1KeWDQ29ETmvPWJ4G/9N7Q9sQSyiC+Y+foODAQGRsTsaKv7rr7Grm350WNe2DZVN7 ghgL68eVZoD725iwN9L7oFkbP7CkV2/5dee3AqW6RbJLILWrDwxUtnm2l+eE3DX05fy3 sfquTjLwS+k9aojE3POiS+ojcKnK1JoVWfUxwDWaN+JztiprPVhudmkfTaDnd3T38nCT DtzN3WBCgsyY2yEwHqd0IF/yAoe+ztF05xb5Q9gV46bTHl/e+hNLxqHdWAwUJ81qV5wG unGw== X-Gm-Message-State: AOAM532mpzjDQDGhEn017nXPF56XxpPWpXz6SUa6LayZg3Q0aNuDO90s QAN9eL2wKqub/uc2/9DCThYPBE5kkFscxQ== X-Google-Smtp-Source: ABdhPJyHLFY2Ff1XzOmbH3oaRd1mU0jpYboeQk159tp3ZmzfUn0rb4lidtgNvzDq+TyX+ABJEvS2KQ== X-Received: by 2002:a19:7612:0:b0:448:307a:4bca with SMTP id c18-20020a197612000000b00448307a4bcamr7559415lff.361.1647042804911; Fri, 11 Mar 2022 15:53:24 -0800 (PST) Received: from localhost.localdomain (c-fdcc225c.014-348-6c756e10.bbcust.telenor.se. [92.34.204.253]) by smtp.gmail.com with ESMTPSA id 8-20020a2e1548000000b002463639d0f2sm1967691ljv.68.2022.03.11.15.53.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 11 Mar 2022 15:53:24 -0800 (PST) From: Linus Walleij To: Johan Hovold Cc: linux-kernel@vger.kernel.org, Linus Walleij , devicetree@vger.kernel.org Subject: [PATCH 1/4] dt-bindings: gnss: Rewrite common bindings in YAML Date: Sat, 12 Mar 2022 00:51:16 +0100 Message-Id: <20220311235119.523374-1-linus.walleij@linaro.org> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This rewrites the text-based GNSS common bindings to use a YAML schema. Cc: devicetree@vger.kernel.org Signed-off-by: Linus Walleij --- .../devicetree/bindings/gnss/gnss-common.yaml | 55 +++++++++++++++++++ .../devicetree/bindings/gnss/gnss.txt | 37 ------------- 2 files changed, 55 insertions(+), 37 deletions(-) create mode 100644 Documentation/devicetree/bindings/gnss/gnss-common.yaml delete mode 100644 Documentation/devicetree/bindings/gnss/gnss.txt diff --git a/Documentation/devicetree/bindings/gnss/gnss-common.yaml b/Documentation/devicetree/bindings/gnss/gnss-common.yaml new file mode 100644 index 000000000000..963b926e30a7 --- /dev/null +++ b/Documentation/devicetree/bindings/gnss/gnss-common.yaml @@ -0,0 +1,55 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/gnss/gnss-common.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Common Properties for Global Navigation Satellite Systems (GNSS) + receiver devices + +maintainers: + - Johan Hovold + +description: | + This document defines device tree properties common to Global Navigation + Satellite System receivers. + +properties: + $nodename: + pattern: "^gnss(@.*)?$" + + lna-supply: + description: A separate regulator supplying power for the Low Noise + Amplifier (LNA). This is an amplifier connected between the GNSS + device and the receiver antenna. + + enable-gpios: + description: A GPIO line that will enable the GNSS receiver when + asserted. If this line is active low, the GPIO phandle should + consequently be tagged with the GPIO_ACTIVE_LOW flag so the operating + system can rely on asserting the line to enable the GNSS device. + maxItems: 1 + + timepulse-gpios: + description: When a timepulse is provided to the GNSS device using a + GPIO line, this is used. + maxItems: 1 + + current-speed: + description: The baudrate in bits per second of the device as it comes + online, current active speed. + $ref: /schemas/types.yaml#/definitions/uint32 + +additionalProperties: true + +examples: + - | + #include + serial { + gnss { + compatible = "u-blox,neo-8"; + vcc-supply = <&gnss_reg>; + timepulse-gpios = <&gpio0 16 GPIO_ACTIVE_HIGH>; + current-speed = <4800>; + }; + }; diff --git a/Documentation/devicetree/bindings/gnss/gnss.txt b/Documentation/devicetree/bindings/gnss/gnss.txt deleted file mode 100644 index d6dc9c0d8249..000000000000 --- a/Documentation/devicetree/bindings/gnss/gnss.txt +++ /dev/null @@ -1,37 +0,0 @@ -GNSS Receiver DT binding - -This documents the binding structure and common properties for GNSS receiver -devices. - -A GNSS receiver node is a node named "gnss" and typically resides on a serial -bus (e.g. UART, I2C or SPI). - -Please refer to the following documents for generic properties: - - Documentation/devicetree/bindings/serial/serial.yaml - Documentation/devicetree/bindings/spi/spi-bus.txt - -Required properties: - -- compatible : A string reflecting the vendor and specific device the node - represents - -Optional properties: -- lna-supply : Separate supply for an LNA -- enable-gpios : GPIO used to enable the device -- timepulse-gpios : Time pulse GPIO - -Example: - -serial@1234 { - compatible = "ns16550a"; - - gnss { - compatible = "u-blox,neo-8"; - - vcc-supply = <&gnss_reg>; - timepulse-gpios = <&gpio0 16 GPIO_ACTIVE_HIGH>; - - current-speed = <4800>; - }; -}; From patchwork Fri Mar 11 23:51:18 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Linus Walleij X-Patchwork-Id: 550574 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2500DC433FE for ; Fri, 11 Mar 2022 23:53:45 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229636AbiCKXyr (ORCPT ); Fri, 11 Mar 2022 18:54:47 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:44246 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229567AbiCKXyq (ORCPT ); Fri, 11 Mar 2022 18:54:46 -0500 Received: from mail-lf1-x12a.google.com (mail-lf1-x12a.google.com [IPv6:2a00:1450:4864:20::12a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E1A40218CD1 for ; Fri, 11 Mar 2022 15:53:40 -0800 (PST) Received: by mail-lf1-x12a.google.com with SMTP id s25so17692131lfs.10 for ; Fri, 11 Mar 2022 15:53:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=NDgjT8Gm2p6BPTGasZC7u/yG4vPfMFDnsjFz5IVd4Uw=; b=CTpMqBG1uv/qYPHfdMPvRhpFs+ZKyifzaptHgK1kKsYSJpx6RfFpXNQ0Y8TGBreD2i IqkcTPzdPjrIsApiQBlRA2QPI2DPkU2uwhG5Ks6XRlQUr+aEH3n1VV6AqEDfuXxmmPLH I5yNXPQXc2JjTgImkI7FtXEocq/u4CFVoT0oXgW5rOdC5/HqOXk3MVY5QG1xMoaU0Dbu VF7NwurFKTDxxlUdHIeoQhe5CfPQfL38r+/1nXjuqXZBwg3HUE1/3Ut3/cJLC8y3p1RH ERsrLwOoL5PgDflFfH7g3Yfu5z9G9mDz3USlAaiVo1eu5eUgIN/LrrHkRgAkz8QrnBF0 +szQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=NDgjT8Gm2p6BPTGasZC7u/yG4vPfMFDnsjFz5IVd4Uw=; b=WJHxpkgO0QVtRNcKZ8DdrKKqt3RuFJnC0k1kaJKqI2ysUIA8byxGo4q6VvYwcoeibH o+KYQqbBtMg+Vgfqu9SYunwesttHEU4TCwqtu2wBxNTJwexsoUS3X3g4ESfVAWmr3af5 GpPYdMZLGfWhWA8cbhemrDbJjb+rlw3pYMeOJRCrHmKR/Ogovp2RTPBYVVm6ys6zoOmr qlomQ0DJu3fii6wKEiooLiKXfXESt8cR4RjQEc+L8Qyn2zZb5povwBXTg7+NSYCsEYov RneYQqn/fU63jwXbqmz6o3SBeZ6T1rJIrt0AKxzvytgHr801Rim5VJeCZuat5c2TqSm+ Xscg== X-Gm-Message-State: AOAM5338R7B4pUfrR0gpE7FmGEEPdN92Ru5uYvgEzv9AAzs01YQkda4R rixRy8zz/oBYXv3CpUnWOJMaxQ== X-Google-Smtp-Source: ABdhPJxGhburhEuMkwUDjD59rBNrEz/JqfvzAAc16+Urfva38ZcqZOSzagPQLAfw2WnET/3w8tyI/g== X-Received: by 2002:a05:6512:23a1:b0:448:6d3c:57aa with SMTP id c33-20020a05651223a100b004486d3c57aamr3762986lfv.2.1647042819250; Fri, 11 Mar 2022 15:53:39 -0800 (PST) Received: from localhost.localdomain (c-fdcc225c.014-348-6c756e10.bbcust.telenor.se. [92.34.204.253]) by smtp.gmail.com with ESMTPSA id 8-20020a2e1548000000b002463639d0f2sm1967691ljv.68.2022.03.11.15.53.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 11 Mar 2022 15:53:38 -0800 (PST) From: Linus Walleij To: Johan Hovold Cc: linux-kernel@vger.kernel.org, Linus Walleij , devicetree@vger.kernel.org Subject: [PATCH 3/4] dt-bindings: gnss: Rewrite sirfstar binding in YAML Date: Sat, 12 Mar 2022 00:51:18 +0100 Message-Id: <20220311235119.523374-3-linus.walleij@linaro.org> X-Mailer: git-send-email 2.35.1 In-Reply-To: <20220311235119.523374-1-linus.walleij@linaro.org> References: <20220311235119.523374-1-linus.walleij@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This rewrites the SiRFstar DT bindings in YAML. Cc: devicetree@vger.kernel.org Signed-off-by: Linus Walleij --- .../devicetree/bindings/gnss/sirfstar.txt | 46 ------------ .../devicetree/bindings/gnss/sirfstar.yaml | 73 +++++++++++++++++++ 2 files changed, 73 insertions(+), 46 deletions(-) delete mode 100644 Documentation/devicetree/bindings/gnss/sirfstar.txt create mode 100644 Documentation/devicetree/bindings/gnss/sirfstar.yaml diff --git a/Documentation/devicetree/bindings/gnss/sirfstar.txt b/Documentation/devicetree/bindings/gnss/sirfstar.txt deleted file mode 100644 index f4252b6b660b..000000000000 --- a/Documentation/devicetree/bindings/gnss/sirfstar.txt +++ /dev/null @@ -1,46 +0,0 @@ -SiRFstar-based GNSS Receiver DT binding - -SiRFstar chipsets are used in GNSS-receiver modules produced by several -vendors and can use UART, SPI or I2C interfaces. - -Please see Documentation/devicetree/bindings/gnss/gnss.txt for generic -properties. - -Required properties: - -- compatible : Must be one of - - "fastrax,uc430" - "linx,r4" - "wi2wi,w2sg0004" - "wi2wi,w2sg0008i" - "wi2wi,w2sg0084i" - -- vcc-supply : Main voltage regulator (pin name: 3V3_IN, VCC, VDD) - -Required properties (I2C): -- reg : I2C slave address - -Required properties (SPI): -- reg : SPI chip select address - -Optional properties: - -- sirf,onoff-gpios : GPIO used to power on and off device (pin name: ON_OFF) -- sirf,wakeup-gpios : GPIO used to determine device power state - (pin name: RFPWRUP, WAKEUP) -- timepulse-gpios : Time pulse GPIO (pin name: 1PPS, TM) - -Example: - -serial@1234 { - compatible = "ns16550a"; - - gnss { - compatible = "wi2wi,w2sg0084i"; - - vcc-supply = <&gnss_reg>; - sirf,onoff-gpios = <&gpio0 16 GPIO_ACTIVE_HIGH>; - sirf,wakeup-gpios = <&gpio0 17 GPIO_ACTIVE_HIGH>; - }; -}; diff --git a/Documentation/devicetree/bindings/gnss/sirfstar.yaml b/Documentation/devicetree/bindings/gnss/sirfstar.yaml new file mode 100644 index 000000000000..91874241d0f3 --- /dev/null +++ b/Documentation/devicetree/bindings/gnss/sirfstar.yaml @@ -0,0 +1,73 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/gnss/sirfstar.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: SiRFstar GNSS Receiver Device Tree Bindings + +allOf: + - $ref: gnss-common.yaml# + +maintainers: + - Johan Hovold + +description: + The SiRFstar GNSS receivers have incarnated over the years in different + chips, starting from the SiRFstarIII which was a chip that was introduced in + 2004 and used in a lot of dedicated GPS devices. In 2009 SiRF was acquired + by CSR (Cambridge Silicon Radio) and in 2012 the CSR GPS business was + acquired by Samsung, while some products remained with CSR. In 2014 CSR + was acquired by Qualcomm who still sell some of the SiRF products. + + SiRF chips can be used over UART, I2C or SPI buses. + +properties: + compatible: + enum: + - fastrax,uc430 + - linx,r4 + - wi2wi,w2sg0004 + - wi2wi,w2sg0008i + - wi2wi,w2sg0084i + + reg: + description: + The I2C Address, SPI chip select address. Not required on UART buses. + + vcc-supply: + description: + Main voltage regulator, pin names such as 3V3_IN, VCC, VDD. + + timepulse-gpios: + description: Comes with pin names such as 1PPS or TM + + sirf,onoff-gpios: + maxItems: 1 + description: GPIO used to power on and off device, pin name ON_OFF. + + sirf,wakeup-gpios: + maxItems: 1 + description: GPIO used to determine device power state, pin names such + as RFPWRUP, WAKEUP. + + current-speed: true + +required: + - compatible + - vcc-supply + +additionalProperties: false + +examples: + - | + #include + serial { + gnss { + compatible = "wi2wi,w2sg0084i"; + vcc-supply = <&gnss_vcc_reg>; + sirf,onoff-gpios = <&gpio0 16 GPIO_ACTIVE_HIGH>; + sirf,wakeup-gpios = <&gpio0 17 GPIO_ACTIVE_HIGH>; + current-speed = <38400>; + }; + };