From mboxrd@z Thu Jan 1 00:00:00 1970 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 9F58AC433FE for ; Tue, 1 Nov 2022 22:27:22 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229516AbiKAW1V (ORCPT ); Tue, 1 Nov 2022 18:27:21 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33488 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229457AbiKAW1V (ORCPT ); Tue, 1 Nov 2022 18:27:21 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0CA461038 for ; Tue, 1 Nov 2022 15:27:20 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id B3A03B81F90 for ; Tue, 1 Nov 2022 22:27:18 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 1CD1EC433C1; Tue, 1 Nov 2022 22:27:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1667341637; bh=0u4H5qEji6npzhKQDJsf/GJL+msrjaYOWYJBjWFyeVU=; h=Date:From:To:Subject:References:In-Reply-To:From; b=C4e11Z1WotYPzmo2DOBg5MzEBLpSdGinOPlGot/gb+eMr5hVccjCcZ4BZQfsrYHu+ /GtmglA+dQDbYmKJ9eJfcEW8PXSWbWvayUMvRW7NrKbFPPAJJX+sXzWsGcby/P5wIk bDS0rdG07Ng8akLZvp8G1pzqdWEG4GJWLFzQOIqq1fNPFNMpkWQaCFdhMM4JywBaxO lCO52b9nU5yxuloK7PkUfvMsvVl3497R5G0QfPgGEzWLzdzpnMmu52/Mxt/wDmUdzc TKlZMrwPIZtj3QG6BEwnNGNdzEJCS/6oebeDM99w3iHZInx3Jya3P3mGFXFPwjnhW3 Ay7gcJa/L1F+Q== Received: by pali.im (Postfix) id A02FA7F8; Tue, 1 Nov 2022 23:27:14 +0100 (CET) Date: Tue, 1 Nov 2022 23:27:14 +0100 From: Pali =?utf-8?B?Um9ow6Fy?= To: devicetree@vger.kernel.org, Rob Herring , Marek =?utf-8?B?QmVow7pu?= Subject: Re: [PATCH] dt-bindings: bus: add device tree bindings for fsl,p1021rdb-pc-cpld Message-ID: <20221101222714.7jh5xoahjscuhfcd@pali> References: <20220705175450.11886-1-kabel@kernel.org> <20220831114640.qwfr7lea3lvcfl2v@pali> <20221009113825.l67w4qvv6v5kmst4@pali> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20221009113825.l67w4qvv6v5kmst4@pali> User-Agent: NeoMutt/20180716 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org PING? On Sunday 09 October 2022 13:38:25 Pali Rohár wrote: > PING? > > If you really do not care about documentation then just tell people to > not waste time on doing it. Because dts files can be compiled and used > on the real hardware without those superfluous YAML files. > > On Wednesday 31 August 2022 13:46:40 Pali Rohár wrote: > > PING? Documentation binding patch is waiting there fore two months. > > Could we move forward? > > > > Note that meanwhile turris1x.dts which uses this was merged. > > > > On Tuesday 05 July 2022 19:54:50 Marek Behún wrote: > > > Add binding for CPLD bus interface of Freescale P1021RDB Combo Board > > > CPLD Design. > > > > > > Signed-off-by: Marek Behún > > > --- > > > .../bindings/bus/fsl,p1021rdb-pc-cpld.yaml | 73 +++++++++++++++++++ > > > 1 file changed, 73 insertions(+) > > > create mode 100644 Documentation/devicetree/bindings/bus/fsl,p1021rdb-pc-cpld.yaml > > > > > > diff --git a/Documentation/devicetree/bindings/bus/fsl,p1021rdb-pc-cpld.yaml b/Documentation/devicetree/bindings/bus/fsl,p1021rdb-pc-cpld.yaml > > > new file mode 100644 > > > index 000000000000..822dfb93dcd8 > > > --- /dev/null > > > +++ b/Documentation/devicetree/bindings/bus/fsl,p1021rdb-pc-cpld.yaml > > > @@ -0,0 +1,73 @@ > > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > > > +%YAML 1.2 > > > +--- > > > +$id: http://devicetree.org/schemas/bus/fsl,p1021rdb-pc-cpld.yaml# > > > +$schema: http://devicetree.org/meta-schemas/core.yaml# > > > + > > > +title: CPLD Bus Inteface for Freescale P1021RDB Combo Board CPLD Design > > > + > > > +maintainers: > > > + - Pali Rohár > > > + > > > +description: | > > > + A simple bus enabling access to peripherals on boards with use Freescale > > > + P1021RDB Combo Board CPLD Design. > > > + > > > + The "fsl,p1021rdb-pc-cpld" follows the "simple-bus" set of properties, as > > > + specified in the Devicetree Specification. It is an extension of "simple-bus" > > > + because some registers are CPLD specific and allows to identify if board has > > > + wired CPLD according to Freescale P1021RDB Combo Board CPLD Design. > > > + > > > +select: > > > + properties: > > > + compatible: > > > + contains: > > > + const: fsl,p1021rdb-pc-cpld > > > + required: > > > + - compatible > > > + > > > +properties: > > > + $nodename: > > > + pattern: "^cpld(@[0-9a-f]+(,[0-9a-f]+)?)?$" > > > + > > > + compatible: > > > + items: > > > + - const: fsl,p1021rdb-pc-cpld > > > + - const: simple-bus > > > + > > > + '#address-cells': > > > + enum: [ 1, 2 ] > > > + > > > + '#size-cells': > > > + enum: [ 1, 2 ] > > > + > > > + reg: > > > + maxItems: 1 > > > + > > > + ranges: true > > > + > > > +required: > > > + - compatible > > > + - '#address-cells' > > > + - '#size-cells' > > > + - reg > > > + - ranges > > > + > > > +additionalProperties: > > > + type: object > > > + > > > +examples: > > > + - | > > > + > > > + localbus { > > > + #address-cells = <2>; > > > + #size-cells = <1>; > > > + > > > + cpld@3,0 { > > > + #address-cells = <1>; > > > + #size-cells = <1>; > > > + compatible = "fsl,p1021rdb-pc-cpld", "simple-bus"; > > > + reg = <0x3 0x0 0x20000>; > > > + ranges = <0x0 0x3 0x0 0x20000>; > > > + }; > > > + }; > > > -- > > > 2.35.1 > > >