From patchwork Thu Mar 17 22:58:42 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Linus Walleij X-Patchwork-Id: 552731 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 C1F86C433FE for ; Thu, 17 Mar 2022 23:00:59 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230077AbiCQXCO (ORCPT ); Thu, 17 Mar 2022 19:02:14 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54880 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230062AbiCQXCN (ORCPT ); Thu, 17 Mar 2022 19:02:13 -0400 Received: from mail-lj1-x22e.google.com (mail-lj1-x22e.google.com [IPv6:2a00:1450:4864:20::22e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5B280147AFD for ; Thu, 17 Mar 2022 16:00:55 -0700 (PDT) Received: by mail-lj1-x22e.google.com with SMTP id s25so9212321lji.5 for ; Thu, 17 Mar 2022 16:00:55 -0700 (PDT) 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=45WiQuXkjTLwjH5KekJze4iDLtUQ2UlWaqKlaD1vlfU=; b=O1uLVIDYM5fl7sZQRbcj9rjoWtAVK446LBhQZ+vm2XLwi/hJGbQLrpKZCSfjgZV9xC f1v4X9+/CJoIASqRasudGMitV3p+vb3zOiD0kkW8W0cnfXIUcCwC6gtKJT7vue6y/KZu L+8PDBjEaIFO+x7JzYRpVPJ1CquGg4BbIxkzHcuhT10PpOwYyrDpNZyiw6cnlwwqOsDL ADdeUbp4cX24Io+vocI8kkwk/czBm8ORISg5LYRqNd32i6LZHEmkkTS1NeapFpjn7zLE y/6WTcBtSGWwfiauf9fCvAWF/tY+M2JMQE2EfOa9YDlcUmHQw8/4ow9xmYiUo7Muv27o QMxA== 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=45WiQuXkjTLwjH5KekJze4iDLtUQ2UlWaqKlaD1vlfU=; b=TCqCYpmsX+YbeaJMLMmWTd++svkMOBtctI0bzwluafPR8rP71XoNjoQgWEen8BXTI0 GhJo5k4MJFyXVeZLQXXU+kOzKchxN9KD96LYmYKFWk5PDHMHj/uMAzxy9n5YWwZPxSzu hMfv/hcct0alrUdsiz5V6hdEchuaeIxxzGaNh3otBYd7yO/YxonjkJ/neWf0FUPjBT+F eJaC+oWbjBKYkPvtjPwPXmQYgHZbfo4wXrst80AK14IzI2113S09Fv5SUe2fXHgiYNKp MxBIdQRskzRPyy/B2BDstiOdLQm8Fch+Ydz+PKGHRLOJU7mzyKq22S/wG9mvG6N+R11o rxTQ== X-Gm-Message-State: AOAM530zJBaN+A+7h+AlwjjyVBtNZYPCrxeN6eRN+xcRqjafFMRmYlwn rnCC3UzCya8Y2RNJNNKFrvJCGw== X-Google-Smtp-Source: ABdhPJwuwYyEOdjueIIJ8/a9Si9EB0k5nSdlhsDtQPYoGlIqZnU0oT4grkWutD4aG3ykIfk5ZVJ4og== X-Received: by 2002:a05:651c:2dc:b0:247:e451:48ae with SMTP id f28-20020a05651c02dc00b00247e45148aemr4478851ljo.248.1647558053641; Thu, 17 Mar 2022 16:00:53 -0700 (PDT) Received: from localhost.localdomain (c-fdcc225c.014-348-6c756e10.bbcust.telenor.se. [92.34.204.253]) by smtp.gmail.com with ESMTPSA id 11-20020a2e154b000000b0024967cd674esm191876ljv.35.2022.03.17.16.00.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 17 Mar 2022 16:00:53 -0700 (PDT) From: Linus Walleij To: Johan Hovold Cc: linux-kernel@vger.kernel.org, Linus Walleij , devicetree@vger.kernel.org, Krzysztof Kozlowski Subject: [PATCH 3/5 v2] dt-bindings: gnss: Rewrite sirfstar binding in YAML Date: Thu, 17 Mar 2022 23:58:42 +0100 Message-Id: <20220317225844.1262643-3-linus.walleij@linaro.org> X-Mailer: git-send-email 2.35.1 In-Reply-To: <20220317225844.1262643-1-linus.walleij@linaro.org> References: <20220317225844.1262643-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 Cc: Krzysztof Kozlowski Signed-off-by: Linus Walleij --- ChangeLog v1->v2: - Change additionalProperties: false to uneavaluatedProperties: false so new common properties get available immediately - This should also make the checker robot happy about lna-supply --- .../devicetree/bindings/gnss/sirfstar.txt | 46 ------------ .../devicetree/bindings/gnss/sirfstar.yaml | 71 +++++++++++++++++++ 2 files changed, 71 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..9f80add3e61b --- /dev/null +++ b/Documentation/devicetree/bindings/gnss/sirfstar.yaml @@ -0,0 +1,71 @@ +# 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. + +required: + - compatible + - vcc-supply + +unevaluatedProperties: 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>; + }; + };