From patchwork Mon May 10 18:25:05 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Corentin LABBE X-Patchwork-Id: 1476673 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org (client-ip=23.128.96.18; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=baylibre-com.20150623.gappssmtp.com header.i=@baylibre-com.20150623.gappssmtp.com header.a=rsa-sha256 header.s=20150623 header.b=WdHVdgAr; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by ozlabs.org (Postfix) with ESMTP id 4Ff8cK4yJ8z9sWp for ; Tue, 11 May 2021 04:25:21 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231586AbhEJS0X (ORCPT ); Mon, 10 May 2021 14:26:23 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:60836 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231668AbhEJS0V (ORCPT ); Mon, 10 May 2021 14:26:21 -0400 Received: from mail-wr1-x433.google.com (mail-wr1-x433.google.com [IPv6:2a00:1450:4864:20::433]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C66F2C061760 for ; Mon, 10 May 2021 11:25:13 -0700 (PDT) Received: by mail-wr1-x433.google.com with SMTP id t18so17626458wry.1 for ; Mon, 10 May 2021 11:25:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=IA+mE070EGJp8sOVYovOMc17oE3lYWvffqteaPcfIVY=; b=WdHVdgArrAfk+1tBnhrIbojqIPJpqqXY0eDpblWF7One+upDGTaN8pQjgpuBhyV11x aK/b2fwIVWbYeEnehU2M5vbRY+J2fKKEOAg6Hnzr5J7D4u8Yjy5b/L2dELB2oLFyF4nP KFZ91Y7++DP1IqXswAIqNIA5iLLZ6a+B//i4dLOYOS/pu7GpDocA+ltp8W8PQN6hCSU+ dY04KX5BuxCqbyiNT1DUAokstUEbeJq58ZVo6B4DePmNEhn2X2s2m/RjXLIv30S1HNS7 p0V/GYzYBZvpu8UTW6I9q0XOVALokp/XSxPh8IGJ+BP6Thfr9EoPLiOZHeoT9sRKmcdT d2yg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=IA+mE070EGJp8sOVYovOMc17oE3lYWvffqteaPcfIVY=; b=ASpCfOMI5PF8CZrIfL2OSVCmfiID5VF8Ftz9GnUMpU9wWF1uky9mX6k1rxED6AVBh0 za9hvOKvFBT4XeywRM324khhYrSCirlp0NoZ9LCLoCve+ZQGRmvi64zL1wwo6SpCzWed 5vmBAYOj1z2GHvWBavU9fgtmXOaFiylmkdo3qjMTxDVWoOksatcXf3q/zPlVOI0BLjmE Ul2yhRlR2eblJ+DdNcBPGe0wVqqIOHr8tFvVsHWMO2wwHamqZekVA2oPp5fI5h7RCOb7 V5krKj6yo4PnDHCIdhrBWWTQz7XZ2uh2xQqU53FKkUcoozFZjPI0m6WBY+TxcgHsGois /AkQ== X-Gm-Message-State: AOAM533BLpR+P9sPdceqXWe8ESplFrXpl0DvMFp+bIxWfF3VYnY9xTke xIpsm9HWEQJm65c7Q2UtOqKQViZJxO/k7YM5 X-Google-Smtp-Source: ABdhPJz5aohqhzhsbUNr7TYZz5k2LY2t4k+wvZN9P+UJoTrr78Ibsovp7Jy0r0wJ3jm8XIbdAgaQsg== X-Received: by 2002:a5d:64e6:: with SMTP id g6mr31910513wri.216.1620671112430; Mon, 10 May 2021 11:25:12 -0700 (PDT) Received: from localhost.localdomain (laubervilliers-658-1-213-31.w90-63.abo.wanadoo.fr. [90.63.244.31]) by smtp.googlemail.com with ESMTPSA id k10sm1109598wmf.0.2021.05.10.11.25.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 10 May 2021 11:25:11 -0700 (PDT) From: Corentin Labbe To: alexandre.belloni@bootlin.com, a.zummo@towertech.it, linus.walleij@linaro.org, robh+dt@kernel.org, ulli.kroll@googlemail.com Cc: devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, linux-rtc@vger.kernel.org, Corentin Labbe Subject: [PATCH v2] dt-bindings: convert rtc/faraday,ftrtc01 to yaml Date: Mon, 10 May 2021 18:25:05 +0000 Message-Id: <20210510182505.3968936-1-clabbe@baylibre.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Converts rtc/faraday,ftrtc01.txt to yaml. This permits to detect some missing properties: reg, resets, interrupts Reviewed-by: Linus Walleij Signed-off-by: Corentin Labbe Reviewed-by: Rob Herring --- Changes since v1: - fixed issues reported by Rob Herring https://lore.kernel.org/linux-rtc/20210506174539.GA536770@robh.at.kernel.org/T/#t .../bindings/rtc/faraday,ftrtc010.txt | 28 --------- .../bindings/rtc/faraday,ftrtc010.yaml | 59 +++++++++++++++++++ 2 files changed, 59 insertions(+), 28 deletions(-) delete mode 100644 Documentation/devicetree/bindings/rtc/faraday,ftrtc010.txt create mode 100644 Documentation/devicetree/bindings/rtc/faraday,ftrtc010.yaml diff --git a/Documentation/devicetree/bindings/rtc/faraday,ftrtc010.txt b/Documentation/devicetree/bindings/rtc/faraday,ftrtc010.txt deleted file mode 100644 index e3938f5e0b6c..000000000000 --- a/Documentation/devicetree/bindings/rtc/faraday,ftrtc010.txt +++ /dev/null @@ -1,28 +0,0 @@ -* Faraday Technology FTRTC010 Real Time Clock - -This RTC appears in for example the Storlink Gemini family of -SoCs. - -Required properties: -- compatible : Should be one of: - "faraday,ftrtc010" - "cortina,gemini-rtc", "faraday,ftrtc010" - -Optional properties: -- clocks: when present should contain clock references to the - PCLK and EXTCLK clocks. Faraday calls the later CLK1HZ and - says the clock should be 1 Hz, but implementers actually seem - to choose different clocks here, like Cortina who chose - 32768 Hz (a typical low-power clock). -- clock-names: should name the clocks "PCLK" and "EXTCLK" - respectively. - -Examples: - -rtc@45000000 { - compatible = "cortina,gemini-rtc"; - reg = <0x45000000 0x100>; - interrupts = <17 IRQ_TYPE_LEVEL_HIGH>; - clocks = <&foo 0>, <&foo 1>; - clock-names = "PCLK", "EXTCLK"; -}; diff --git a/Documentation/devicetree/bindings/rtc/faraday,ftrtc010.yaml b/Documentation/devicetree/bindings/rtc/faraday,ftrtc010.yaml new file mode 100644 index 000000000000..657c13b62b67 --- /dev/null +++ b/Documentation/devicetree/bindings/rtc/faraday,ftrtc010.yaml @@ -0,0 +1,59 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/rtc/faraday,ftrtc010.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Faraday Technology FTRTC010 Real Time Clock + +maintainers: + - Linus Walleij + +description: | + This RTC appears in for example the Storlink Gemini family of SoCs. + +properties: + compatible: + oneOf: + - const: faraday,ftrtc010 + - items: + - const: cortina,gemini-rtc + - const: faraday,ftrtc010 + + resets: + maxItems: 1 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + clocks: + minItems: 2 + items: + - description: PCLK clocks + - description: EXTCLK clocks. Faraday calls it CLK1HZ and says the clock + should be 1 Hz, but implementers actually seem to choose different + clocks here, like Cortina who chose 32768 Hz (a typical low-power clock). + + clock-names: + items: + - const: "PCLK" + - const: "EXTCLK" + +required: + - compatible + +additionalProperties: false + +examples: + - | + #include + rtc@45000000 { + compatible = "cortina,gemini-rtc", "faraday,ftrtc010"; + reg = <0x45000000 0x100>; + interrupts = <17 IRQ_TYPE_LEVEL_HIGH>; + clocks = <&foo 0>, <&foo 1>; + clock-names = "PCLK", "EXTCLK"; + };