From patchwork Mon Feb 19 14:29:45 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Josua Mayer X-Patchwork-Id: 1901005 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=solidrn.onmicrosoft.com header.i=@solidrn.onmicrosoft.com header.a=rsa-sha256 header.s=selector1-solidrn-onmicrosoft-com header.b=RIs/FzL2; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org (client-ip=2604:1380:45e3:2400::1; helo=sv.mirrors.kernel.org; envelope-from=linux-rtc+bounces-667-incoming=patchwork.ozlabs.org@vger.kernel.org; receiver=patchwork.ozlabs.org) Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org [IPv6:2604:1380:45e3:2400::1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1)) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4TdlLs613gz1yP6 for ; Tue, 20 Feb 2024 01:30:29 +1100 (AEDT) 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 437A1282865 for ; Mon, 19 Feb 2024 14:30:28 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id A27271DDEC; Mon, 19 Feb 2024 14:30:25 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=solidrn.onmicrosoft.com header.i=@solidrn.onmicrosoft.com header.b="RIs/FzL2" X-Original-To: linux-rtc@vger.kernel.org Received: from EUR04-DB3-obe.outbound.protection.outlook.com (mail-db3eur04on2102.outbound.protection.outlook.com [40.107.6.102]) (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 7B671149DFE; Mon, 19 Feb 2024 14:30:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.6.102 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708353025; cv=fail; b=ji0nsCOv37sbUaCwKf8ZNxRtc5pyIlsCrS+UFSt9SUJo81zRzCXM7J/BhZ76Fu57Z2xp9MKj/kpoVh8J4KrU6RLIjW84ulm7x9syd2nPHWWV9uM48/KMWuC/ecWrkk4jT+6r0Jt9juTZzAdwdFmKwoqGqwlQ9fGjzGLdgd+l5kA= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708353025; c=relaxed/simple; bh=p6bAOIc/y3zSfNk9WumFmoexjhd4IIp6lJHcWWbMGOo=; h=From:Date:Subject:Content-Type:Message-Id:To:Cc:MIME-Version; b=YDJuGTu3nkiTc4xDP0pXfqSUpmZdyWDensS+ZyPeUdk7Pn8E+wjAbZugLwz62ZaNmWtkm06AwJsXVbeYPQJ1lUWvHHvvawPZSUrMsMo/zp08l5t17NlG+vLeeLDYcyoAr2khpnOdatgIsnvYY0zZO/74yglFsS6/9tO9Hk0xVQI= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=solid-run.com; spf=pass smtp.mailfrom=solid-run.com; dkim=pass (1024-bit key) header.d=solidrn.onmicrosoft.com header.i=@solidrn.onmicrosoft.com header.b=RIs/FzL2; arc=fail smtp.client-ip=40.107.6.102 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=solid-run.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=solid-run.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ivFO7F3jABlzUHea7KJRz1U4mzbJtkq4ZPRRjBhb1oluxFHN/jnSMBG28CJ7adBpsLUQ0arc9Wzbq8Habmj8Rxv13OnOrwtO1mYqtPtbEqkyQf+FOapX8vyyK7/HUethz1gKvwZS2+mIKDBEoVRuQzWQJV9XG8b5pw8T+Xi1anmhex8IupE3aJETqH13m9x8Iyfw4KYbfipt0C0JeDpdXUIuF30ddqxEAc5IefDySYCV10GOAUZvXliuEFqKs5VT8T1lePIYgvCfE1Sh8RTCKbuT2voPJdutLgoYySrHCakPRM5Yiz+C8IWLxija8v86BIbg3SRpChw/XNBWisRw/g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=oqX+2IjaEkj5tXWnkYh4XHYiCHnMGoBROf5VN4IEyc8=; b=dfghau0IWIiRqjjGgSC79az1dGHqE8h86qhEQRUzhodYVwO1hSuaZDpZY0jLvTGV3+6Wu1w6mi7ncx4miiD7+POxqC7taLwe/8YRBErky8I9+8RFVeIIRP+hVOSAfkDK2t4z1FpI4MlM3zSEfTpK65dtVbqbxGYuiJ5Vzpj3hKtOu4PECPMpB0npav4f+90nuPiHSIbq0CHJ8ofpZGlxapFINXPmBhmQrHhN5hh8dmwQGcLJG6JVr1JKjnmJf+7scK4/1EQWhEGBfP9q3TurpQaILLz16hxlUmO+EbF7wRhGx3kM1L+55uMIJ8l++HElTDYEchoMiPvDV8cXgjTsfw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=solid-run.com; dmarc=pass action=none header.from=solid-run.com; dkim=pass header.d=solid-run.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=solidrn.onmicrosoft.com; s=selector1-solidrn-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=oqX+2IjaEkj5tXWnkYh4XHYiCHnMGoBROf5VN4IEyc8=; b=RIs/FzL28f4I8/sZ6sy4dsN0M9TWsndvNRg46+4066ttLwHmlI0B+VRvNkc9GBF9nCMVwb3OtRcU8S+nyLZm+QoKEf1w5XB40j4+CrcBbVHkGM7S7dIU28Ptx6v/dHcIsQQMJzWm6o+eTbvIDjlo4twe40Pi1uUPgramUrdPOlk= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=solid-run.com; Received: from AM9PR04MB7586.eurprd04.prod.outlook.com (2603:10a6:20b:2d5::17) by AM0PR04MB7106.eurprd04.prod.outlook.com (2603:10a6:208:191::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7292.38; Mon, 19 Feb 2024 14:30:20 +0000 Received: from AM9PR04MB7586.eurprd04.prod.outlook.com ([fe80::3b94:f607:ebe1:7d6c]) by AM9PR04MB7586.eurprd04.prod.outlook.com ([fe80::3b94:f607:ebe1:7d6c%7]) with mapi id 15.20.7292.036; Mon, 19 Feb 2024 14:30:20 +0000 From: Josua Mayer Date: Mon, 19 Feb 2024 15:29:45 +0100 Subject: [PATCH v7] dt-bindings: rtc: abx80x: convert to yaml Message-Id: <20240219-rtc-abracon-convert-bindings-v7-1-aca4fc3b8cec@solid-run.com> X-B4-Tracking: v=1; b=H4sIANhl02UC/6XNTQ6CMBCG4auQrh1TSgviynsYF/0DJpHWtNhoC He3kHiCLmbxzuL5VhJtQBvJtVpJsAkjepejO1VET9KNFtDkJowyTlndQ1g0SBWk9g7yJRsWUOg MujGCoB1vhl5oyxTJxCvYAT8Hf3/knjAuPnyPtVTv3z/MQBoDcm45RD9DaoGCEr01iil90c0t+ icaCG931n4mO5ZYKdCUArwUEKVAWwJs2/YDoghkBQECAAA= To: Alexandre Belloni , Rob Herring , Krzysztof Kozlowski , Conor Dooley , linux-rtc@vger.kernel.org Cc: Yazan Shhady , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Josua Mayer , Krzysztof Kozlowski X-Mailer: b4 0.13.0 X-ClientProxiedBy: TL2P290CA0021.ISRP290.PROD.OUTLOOK.COM (2603:1096:950:3::15) To AM9PR04MB7586.eurprd04.prod.outlook.com (2603:10a6:20b:2d5::17) Precedence: bulk X-Mailing-List: linux-rtc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM9PR04MB7586:EE_|AM0PR04MB7106:EE_ X-MS-Office365-Filtering-Correlation-Id: 064727cc-b3f9-4c22-428f-08dc31574d07 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: WK5kV21djBn7xt/8Eo1n9rVVTP1n8ju62n+dS/sUizxZzduSZ1e/ZvIFqkVP0AYS4HyPtxRDMD/xroWaIg+E5ntmzurrBbvPb12ibXnySDP1J8WoimptgGJ+DOBklFTfWi9rVio6CYTatqnXudaBN1lV2/I6/BxfCOvHVLDQiKukKxQOfgki0HN9WRwrIwPlki6ATHOX8AqzbqNAtajaD68zEvSS0iHZwNo26euJ6m4n72qqrg36W0wVW7Xlpy6b2eaFYtiwpf2suY3GuqdGQC/XKlLoN3kAjq5Ia4b4zQyR528h0aj+ItuenNufJBqEICtSqY3ai62HZZ5EkBZs+XvycHA0XGxEuzKM+0q4LTftIGugWHBne3GzyjMLEfMZspqK/qeqfs3HTDo/CkvmEJApHIoB3x97B1H82ZU71ZIsMzfnxymOaAOE2lFLABuNGNM/PUCTkULJnw0V5creOuS0ofP2zaJDU+EMeuTzmbjaseHZ1HXaqo6Bi9Cqp9Rr0dTjz4OLJYQ0h6Hk5JRDUgxWdHBADfPmSWubH76b49r/ViXzAW36LSEIEJdIqEk8aJQkbo6lKOiDzcT5L7UYgb8iGUOlnNSOARwVDIuK/xU= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM9PR04MB7586.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(38350700005);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?dtNlq5i9mWylvNH2WFNfAZonDP5n?= =?utf-8?q?x5BUGKTLwFPoHtaFXVAm0kZYpbLvXag5pwexiXtyuJLiv8WW/1QMFWOJxnA/rnKSn?= =?utf-8?q?CVC9WmJHGHRvzRd+fh1PWsrfC6Ke/jY/E73awF/scN85mdafFCu6fVeLD6NpLkV0U?= =?utf-8?q?4ncvAxqy/ukFzhnPPVFGcmoCWHhIuRDX2KOkhT3KEmjYNq3hwiigyC1IYrAs3AWU0?= =?utf-8?q?3rR85Wkx+wPMd6WEZetLa+rVrHrIL+U6npQ0fcw5XEoptTnmc5/2BOPIluT64mjh8?= =?utf-8?q?UIghQLdGQ+IEEArMxMuFraBYAyzJ4kKoytmbi9gdnDKk5aUnwLXBF6KD7rvWZR9iY?= =?utf-8?q?hfJ7bGNpLhcu/tcWFx6g/gf1mAESRp7CtYuRQBmBtR6zb1XqI9bY3zLyP5QwrjUHe?= =?utf-8?q?FnxeVoz+vCu8ySCQxtA1Bmmg3MyN6kemsyeKdRWTaXdFj4LcUF6BSafbg9kpIMs7U?= =?utf-8?q?WDdwFNCpfCuiMz8ZtUoyWdz5OP6gCfn/Xhjc0aPR5wE6yMF7qxYS8i+dzVXwngpgx?= =?utf-8?q?3wUkaONVURQac0jsusDOMdtBxpwXwWcNmapdXqK1i7FAlwUuFvMmaAW8NTBh/HNxp?= =?utf-8?q?xuQtvEaR6PFShbJ00xzWuHkIkW8ZKFbJ2sQCj0rTAk0ZdgApx6h6/4atVWEn4ZHn0?= =?utf-8?q?0oTTsZnNFMXgsxE1X2ZJorl41kBOycdGDlp6czVmLBAmh09B/jfO7JTkuYsKvAnyq?= =?utf-8?q?trsiAHlT6PGepLQhaa6be3StxVzrQbMioFdYmyPC1nLTRuXZHI7dkv3dQjduv0fTv?= =?utf-8?q?LXm4gIOtfB2w91WDH0ITjFyxEb1wlpLnSaKpnAHIymhATI5OaF0ebHjNAaQaQ4CiZ?= =?utf-8?q?uF5RwtcQWn6prMzb3CXmkiNyELjm4ElHZHwtFuvKG4gAAapFpqrTTS+MdtEdtbkYo?= =?utf-8?q?PWyHIIdqD7OkSUwTeLZVaPpjtqJdju2O8xVw6kq75ljKmqmXpKUKtTRZyZmcCvHzD?= =?utf-8?q?I0Pu5suQAb5XLRIFp0eW3XZ6p2HwtoKuL4urq0EDlFsShCvZRPfyidxiUfTJklrB2?= =?utf-8?q?l7OIOt7Rou6+IQddU17qxhQJjGWXLTtIP1UZIn0Uu/iXJOiqNd8lpnaypA5H5iVd0?= =?utf-8?q?N0w43FIbVA89UP1FBrcp5unfCcuVq7OAvmIq1Cy1K0o1+zjpIIT2aUma+T1gqTcT6?= =?utf-8?q?0Zai6q4vpKN0VDMXq06REk6wjZgYhxbu6iAteec6CVTImsy8H4xuFjGxhVtqUSC16?= =?utf-8?q?QQs2hs4p5h94Wo0P6mRlVpqpjM8ysuOyVTzaXZEQYDA6cU7FK9j5G/Tc8EMcNTE5g?= =?utf-8?q?ud4r4rqmj5oq/dQWTwsRGfR5DSP+s0nEkdiczyQAqE3+ENchlCCKJyY1uh0BpbMQ3?= =?utf-8?q?My7kqlJGdNU8HgjcvLkwYQfDwwCFN2Iwy0RJFwu7Pmiobtjn7qpqFA3F8yrEQSPVg?= =?utf-8?q?40yXT8ySr2BUsvEv0zayU6Cyv9zVR4HR2sQmm8xnrGwr2psfUxFFbWNYdUHEdqjJp?= =?utf-8?q?F5cjiCcBUAJDNmexKegdsgMk//dzc6NH9XcX78UPRJK/bWdFvhLF24uCRaW6QTxiF?= =?utf-8?q?pqweYmOS6/TQ?= X-OriginatorOrg: solid-run.com X-MS-Exchange-CrossTenant-Network-Message-Id: 064727cc-b3f9-4c22-428f-08dc31574d07 X-MS-Exchange-CrossTenant-AuthSource: AM9PR04MB7586.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Feb 2024 14:30:20.4848 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: a4a8aaf3-fd27-4e27-add2-604707ce5b82 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: Sh4pHs9wJSfD0uy96Y2Q3I9y3G+DG9j0lJ5hCUWr/Il4fIDAMQBHCHB5WZOqQaYne/+rL2Hb7MRqi/yTjfIufg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR04MB7106 Convert the abracon abx80x rtc text bindings to dt-schema format. In addition to the text description reference generic interrupts properties and add an example. Signed-off-by: Josua Mayer Reviewed-by: Krzysztof Kozlowski --- Changes in v7: - split out of original patchset because it should go by rtc tree - collected reviewed-by from v5 (Krzysztof Kozlowski ) - Link to v6: https://lore.kernel.org/r/20240212-add-am64-som-v6-0-b59edb2bc8c3@solid-run.com --- .../devicetree/bindings/rtc/abracon,abx80x.txt | 31 --------- .../devicetree/bindings/rtc/abracon,abx80x.yaml | 79 ++++++++++++++++++++++ 2 files changed, 79 insertions(+), 31 deletions(-) --- base-commit: 6613476e225e090cc9aad49be7fa504e290dd33d change-id: 20240219-rtc-abracon-convert-bindings-50743f95ce2b Best regards, diff --git a/Documentation/devicetree/bindings/rtc/abracon,abx80x.txt b/Documentation/devicetree/bindings/rtc/abracon,abx80x.txt deleted file mode 100644 index 2405e35a1bc0..000000000000 --- a/Documentation/devicetree/bindings/rtc/abracon,abx80x.txt +++ /dev/null @@ -1,31 +0,0 @@ -Abracon ABX80X I2C ultra low power RTC/Alarm chip - -The Abracon ABX80X family consist of the ab0801, ab0803, ab0804, ab0805, ab1801, -ab1803, ab1804 and ab1805. The ab0805 is the superset of ab080x and the ab1805 -is the superset of ab180x. - -Required properties: - - - "compatible": should one of: - "abracon,abx80x" - "abracon,ab0801" - "abracon,ab0803" - "abracon,ab0804" - "abracon,ab0805" - "abracon,ab1801" - "abracon,ab1803" - "abracon,ab1804" - "abracon,ab1805" - "microcrystal,rv1805" - Using "abracon,abx80x" will enable chip autodetection. - - "reg": I2C bus address of the device - -Optional properties: - -The abx804 and abx805 have a trickle charger that is able to charge the -connected battery or supercap. Both the following properties have to be defined -and valid to enable charging: - - - "abracon,tc-diode": should be "standard" (0.6V) or "schottky" (0.3V) - - "abracon,tc-resistor": should be <0>, <3>, <6> or <11>. 0 disables the output - resistor, the other values are in kOhm. diff --git a/Documentation/devicetree/bindings/rtc/abracon,abx80x.yaml b/Documentation/devicetree/bindings/rtc/abracon,abx80x.yaml new file mode 100644 index 000000000000..58dbbca27deb --- /dev/null +++ b/Documentation/devicetree/bindings/rtc/abracon,abx80x.yaml @@ -0,0 +1,79 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/rtc/abracon,abx80x.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Abracon ABX80X I2C ultra low power RTC/Alarm chip + +maintainers: + - linux-rtc@vger.kernel.org + +allOf: + - $ref: rtc.yaml# + +properties: + compatible: + description: + The wildcard 'abracon,abx80x' may be used to support a mix + of different abracon rtc`s. In this case the driver + must perform auto-detection from ID register. + enum: + - abracon,abx80x + - abracon,ab0801 + - abracon,ab0803 + - abracon,ab0804 + - abracon,ab0805 + - abracon,ab1801 + - abracon,ab1803 + - abracon,ab1804 + - abracon,ab1805 + - microcrystal,rv1805 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + abracon,tc-diode: + description: + Trickle-charge diode type. + Required to enable charging backup battery. + + Supported are 'standard' diodes with a 0.6V drop + and 'schottky' diodes with a 0.3V drop. + $ref: /schemas/types.yaml#/definitions/string + enum: + - standard + - schottky + + abracon,tc-resistor: + description: + Trickle-charge resistor value in kOhm. + Required to enable charging backup battery. + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 3, 6, 11] + +required: + - compatible + - reg + +unevaluatedProperties: false + +examples: + - | + #include + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + rtc@69 { + compatible = "abracon,abx80x"; + reg = <0x69>; + abracon,tc-diode = "schottky"; + abracon,tc-resistor = <3>; + interrupts = <44 IRQ_TYPE_EDGE_FALLING>; + }; + };