lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID:
 <PUZPR06MB5887AA9C68D11448A3125E58EF66A@PUZPR06MB5887.apcprd06.prod.outlook.com>
Date: Fri, 6 Feb 2026 05:42:02 +0000
From: Gary Yang <gary.yang@...tech.com>
To: Krzysztof Kozlowski <krzk@...nel.org>
CC: "robh@...nel.org" <robh@...nel.org>, "krzk+dt@...nel.org"
	<krzk+dt@...nel.org>, "conor+dt@...nel.org" <conor+dt@...nel.org>,
	"p.zabel@...gutronix.de" <p.zabel@...gutronix.de>, Peter Chen
	<peter.chen@...tech.com>, "unicorn_wang@...look.com"
	<unicorn_wang@...look.com>, "inochiama@...il.com" <inochiama@...il.com>,
	"alchark@...il.com" <alchark@...il.com>, "devicetree@...r.kernel.org"
	<devicetree@...r.kernel.org>, "linux-kernel@...r.kernel.org"
	<linux-kernel@...r.kernel.org>, "linux-arm-kernel@...ts.infradead.org"
	<linux-arm-kernel@...ts.infradead.org>, cix-kernel-upstream
	<cix-kernel-upstream@...tech.com>
Subject:
 回复: 回复: [PATCH v7 1/3] dt-bindings: soc: cix: document the simple-mfd syscon on Sky1 SoC

Hi Krzysztof:

> EXTERNAL EMAIL
> 
> On 05/02/2026 11:39, Gary Yang wrote:
> > Hi Krzysztof:
> >
> > I'm glad to see your comments
> >
> >> EXTERNAL EMAIL
> >>
> >> On Wed, Feb 04, 2026 at 10:06:42AM +0800, Gary Yang wrote:
> >>> There are two system control on Cix sky1 Soc. One is located in S0
> >>> domain, and the other is located in S0 and S5 domain. The system
> >>> control contains resets, usb typeC and more. At this point, only the
> >>> reset controller child is described as usb typeC uses it by phandle.
> >>>
> >>> Signed-off-by: Gary Yang <gary.yang@...tech.com>
> >>> ---
> >>>  .../soc/cix/cix,sky1-system-control.yaml      |  49 ++++++
> >>>  include/dt-bindings/reset/cix,sky1-rst-fch.h  |  42 +++++
> >>>  include/dt-bindings/reset/cix,sky1-rst.h      | 164
> >> ++++++++++++++++++
> >>>  3 files changed, 255 insertions(+)
> >>>  create mode 100644
> >>> Documentation/devicetree/bindings/soc/cix/cix,sky1-system-control.ya
> >>> ml  create mode 100644 include/dt-bindings/reset/cix,sky1-rst-fch.h
> >>>  create mode 100644 include/dt-bindings/reset/cix,sky1-rst.h
> >>>
> >>> diff --git
> >>> a/Documentation/devicetree/bindings/soc/cix/cix,sky1-system-control.
> >>> ya
> >>> ml
> >>> b/Documentation/devicetree/bindings/soc/cix/cix,sky1-system-control.
> >>> ya
> >>> ml
> >>> new file mode 100644
> >>> index 000000000000..5fb6b97c3c00
> >>> --- /dev/null
> >>> +++ b/Documentation/devicetree/bindings/soc/cix/cix,sky1-system-cont
> >>> +++ ro
> >>> +++ l.yaml
> >>> @@ -0,0 +1,49 @@
> >>> +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause %YAML 1.2
> >>> +---
> >>> +$id:
> >>> +http://devicetree.org/schemas/soc/cix/cix,sky1-system-control.yaml#
> >>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> >>> +
> >>> +title: Cix Sky1 SoC system control register region
> >>> +
> >>> +maintainers:
> >>> +  - Gary Yang <gary.yang@...tech.com>
> >>> +
> >>> +description:
> >>> +  An wide assortment of registers of the system controller on Sky1
> >>> +SoC,
> >>> +  including resets, usb, wakeup sources and so on.
> >>> +
> >>> +properties:
> >>> +  compatible:
> >>> +    items:
> >>> +      - enum:
> >>> +          - cix,sky1-system-control
> >>> +          - cix,sky1-s5-system-control
> >>> +      - const: syscon
> >>> +      - const: simple-mfd
> >>
> >> Drop simple-mfd, no children
> >>
> >
> > Yes, just now there is no child nodes. We want to reserve it for further.
> > If you feel confuse, we can also delete this strings.
> 
> Sorry, you cannot reserve it. Bindings should be complete (see writing
> bindings), so you should post a COMPLETE binding for this device now.
> 
> Adding ABI for "reserved case" is poor idea, because you will have to support it
> forever.
> 
> 
> >
> >>> +
> >>> +  reg:
> >>> +    maxItems: 1
> >>> +
> >>> +  '#address-cells':
> >>
> >> Drop, no children
> >
> > The same as above
> >
> >>
> >>> +    const: 1
> >>> +
> >>> +  '#size-cells':
> >>
> >> Drop
> >>
> >
> > same
> >
> >> Do you see any recent simple-mfd binding written like this? There are
> >> no. Did you read any of other bindings before sending this? Or at
> >> least my slides or amny other resources from vast documentation from
> elinux.org?
> >>
> >
> > This yaml comes from microchip,mpfs-mss-top-sysreg.yaml as conor's
> suggestions on V3.
> > More info:
> > https://patchwork.kernel.org/project/linux-arm-kernel/patch/2025112406
> > 3235.952136-2-gary.yang@...tech.com/
> 
> Please point to a specific message, not entire thread of 8 untrimmed replies.
> 

Please pay attention to these below:

> Three, In corresponding driver files, we can get the regmap pointers via syscon API.
> All right? By the way, How should we describe syscon in yaml file? Are there some files used to refer?

microchip,mpfs-mss-top-sysreg.yaml is one I wrote recently. Going to the
corresponding driver you will be able to see how the reset controller
driver is probed. You should be able to find it in linux-next.
sophgo,sg2044-top-syscon.yaml is another that works in the same way


> > If you have the different views, please give more information. Thanks
> 
> These are simply wrong in this context.
> 
> If you claim you might need it, it means you actually need to finish the binding
> with missing pieces. Look, do you write such Cc code:
> 
> int some_probe() {
>         ...
> 
>         if (0) {
>                 /* Code reserved for future */
>         }
> 
>         return 0;
> }
> 
> No. Creating unused code means more maintenance, wasted review, wasted
> cycles of preprocessor or compiler. We NEVER write such code.
> 
> 
> >
> > If miss any information, please remind me.
> 
> Yeah, please post COMPLETE bindings for this device.
> 
> 

Yes, I agree your views. we will delete "simple-mfd" strings next version.
Thanks for your advices.

Best Regards
Gary

> Best regards,
> Krzysztof

Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ