Add YAML DT schema for the AMD AXI w1 host IP.
This hardware guarantees protocol timing for driving off-board devices such
as thermal sensors, proms, etc using the 1wire protocol.
Add MAINTAINERS entry for DT schema.
Co-developed-by: Thomas Delev <thomas.delev@amd.com>
Signed-off-by: Thomas Delev <thomas.delev@amd.com>
Signed-off-by: Kris Chaplin <kris.chaplin@amd.com>
---
.../bindings/w1/amd,axi-1wire-host.yaml | 44 +++++++++++++++++++
MAINTAINERS | 7 +++
2 files changed, 51 insertions(+)
create mode 100644 Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml
diff --git a/Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml b/Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml
new file mode 100644
index 000000000000..ef70fa2c0c5d
--- /dev/null
+++ b/Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml
@@ -0,0 +1,44 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/w1/amd,axi-1wire-host.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: AMD AXI 1-wire bus host for programmable logic
+
+maintainers:
+ - Kris Chaplin <kris.chaplin@amd.com>
+
+properties:
+ compatible:
+ const: amd,axi-1wire-host
+
+ reg:
+ maxItems: 1
+
+ clocks:
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+required:
+ - compatible
+ - reg
+ - clocks
+ - interrupts
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/arm-gic.h>
+
+ onewire@a0000000 {
+ compatible = "amd,axi-1wire-host";
+ reg = <0xa0000000 0x10000>;
+ clocks = <&zynqmp_clk 0x47>;
+ interrupts = <GIC_SPI 0x59 IRQ_TYPE_LEVEL_HIGH>;
+ };
+
+...
diff --git a/MAINTAINERS b/MAINTAINERS
index 7a7bd8bd80e9..3dacb7ed6e3b 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -890,6 +890,13 @@ Q: https://patchwork.kernel.org/project/linux-rdma/list/
F: drivers/infiniband/hw/efa/
F: include/uapi/rdma/efa-abi.h
+AMD AXI W1 DRIVER
+M: Kris Chaplin <kris.chaplin@amd.com>
+R: Thomas Delev <thomas.delev@amd.com>
+R: Michal Simek <michal.simek@amd.com>
+S: Maintained
+F: Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml
+
AMD CDX BUS DRIVER
M: Nipun Gupta <nipun.gupta@amd.com>
M: Nikhil Agarwal <nikhil.agarwal@amd.com>
--
2.42.GITOn Thu, Oct 26, 2023 at 02:28:41AM -0700, Kris Chaplin wrote: > Add YAML DT schema for the AMD AXI w1 host IP. > > This hardware guarantees protocol timing for driving off-board devices such > as thermal sensors, proms, etc using the 1wire protocol. > > Add MAINTAINERS entry for DT schema. > > Co-developed-by: Thomas Delev <thomas.delev@amd.com> > Signed-off-by: Thomas Delev <thomas.delev@amd.com> > Signed-off-by: Kris Chaplin <kris.chaplin@amd.com> > --- > .../bindings/w1/amd,axi-1wire-host.yaml | 44 +++++++++++++++++++ > MAINTAINERS | 7 +++ > 2 files changed, 51 insertions(+) > create mode 100644 Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml > > diff --git a/Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml b/Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml > new file mode 100644 > index 000000000000..ef70fa2c0c5d > --- /dev/null > +++ b/Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml > @@ -0,0 +1,44 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/w1/amd,axi-1wire-host.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: AMD AXI 1-wire bus host for programmable logic > + > +maintainers: > + - Kris Chaplin <kris.chaplin@amd.com> > + > +properties: > + compatible: > + const: amd,axi-1wire-host Is there a device side implementation? I can't really imagine that 1-wire would ever be implemented as firmware on the device side given its limited nature. So adding 'host' doesn't make this any more specific. Rob
On 30/10/2023 16:40, Rob Herring wrote: > On Thu, Oct 26, 2023 at 02:28:41AM -0700, Kris Chaplin wrote: >> Add YAML DT schema for the AMD AXI w1 host IP. >> >> This hardware guarantees protocol timing for driving off-board devices such >> as thermal sensors, proms, etc using the 1wire protocol. >> >> Add MAINTAINERS entry for DT schema. >> >> Co-developed-by: Thomas Delev <thomas.delev@amd.com> >> Signed-off-by: Thomas Delev <thomas.delev@amd.com> >> Signed-off-by: Kris Chaplin <kris.chaplin@amd.com> >> --- >> .../bindings/w1/amd,axi-1wire-host.yaml | 44 +++++++++++++++++++ >> MAINTAINERS | 7 +++ >> 2 files changed, 51 insertions(+) >> create mode 100644 Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml >> >> diff --git a/Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml b/Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml >> new file mode 100644 >> index 000000000000..ef70fa2c0c5d >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/w1/amd,axi-1wire-host.yaml >> @@ -0,0 +1,44 @@ >> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) >> +%YAML 1.2 >> +--- >> +$id: http://devicetree.org/schemas/w1/amd,axi-1wire-host.yaml# >> +$schema: http://devicetree.org/meta-schemas/core.yaml# >> + >> +title: AMD AXI 1-wire bus host for programmable logic >> + >> +maintainers: >> + - Kris Chaplin <kris.chaplin@amd.com> >> + >> +properties: >> + compatible: >> + const: amd,axi-1wire-host > > Is there a device side implementation? I can't really imagine that > 1-wire would ever be implemented as firmware on the device side given > its limited nature. So adding 'host' doesn't make this any more > specific. "host" here means "controller", to avoid the other naming "master/slave". Best regards, Krzysztof
Hi Rob, On 30/10/2023 15:40, Rob Herring wrote: > Is there a device side implementation? I can't really imagine that > 1-wire would ever be implemented as firmware on the device side given > its limited nature. So adding 'host' doesn't make this any more > specific. > There are slave drivers as well as master, although these do not have a device tree binding. The IP device from AMD is called "axi_1wire_host", and so we are hoping to stick with this binding if appropriate as it relates to the IP name. Regards, Kris
© 2016 - 2025 Red Hat, Inc.