* [PATCH 0/2] Add DTS for Smartkiz support @ 2019-10-17 9:48 Kamel Bouhara 2019-10-17 9:48 ` [PATCH 1/2] dt-bindings: arm: at91: Document SmartKiz board binding Kamel Bouhara 2019-10-17 12:26 ` [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file Kamel Bouhara 0 siblings, 2 replies; 7+ messages in thread From: Kamel Bouhara @ 2019-10-17 9:48 UTC (permalink / raw) To: Rob Herring, Nicolas Ferre, Alexandre Belloni, Ludovic Desroches, linux-arm-kernel Cc: Thomas Petazzoni, devicetree, linux-kernel, Kamel Bouhara Yet another Overkiz's SAM9G25 based board and it's documentation. Kamel Bouhara (2): dt-bindings: arm: at91: Document SmartKiz board binding ARM: at91: add support for SmartKiz board .../devicetree/bindings/arm/atmel-at91.yaml | 8 ++ arch/arm/boot/dts/Makefile | 1 + arch/arm/boot/dts/at91-smartkiz.dts | 112 ++++++++++++++++++ 3 files changed, 121 insertions(+) create mode 100644 arch/arm/boot/dts/at91-smartkiz.dts -- 2.23.0 ^ permalink raw reply [flat|nested] 7+ messages in thread
* [PATCH 1/2] dt-bindings: arm: at91: Document SmartKiz board binding 2019-10-17 9:48 [PATCH 0/2] Add DTS for Smartkiz support Kamel Bouhara @ 2019-10-17 9:48 ` Kamel Bouhara 2019-10-17 12:26 ` [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file Kamel Bouhara 1 sibling, 0 replies; 7+ messages in thread From: Kamel Bouhara @ 2019-10-17 9:48 UTC (permalink / raw) To: Rob Herring, Nicolas Ferre, Alexandre Belloni, Ludovic Desroches, linux-arm-kernel Cc: Thomas Petazzoni, devicetree, linux-kernel, Kamel Bouhara Document devicetree's bindings for the SAM9G25 SmartKiz board of Overkiz SAS. Signed-off-by: Kamel Bouhara <kamel.bouhara@bootlin.com> --- Documentation/devicetree/bindings/arm/atmel-at91.yaml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Documentation/devicetree/bindings/arm/atmel-at91.yaml b/Documentation/devicetree/bindings/arm/atmel-at91.yaml index 666462988179..f8053268cfa5 100644 --- a/Documentation/devicetree/bindings/arm/atmel-at91.yaml +++ b/Documentation/devicetree/bindings/arm/atmel-at91.yaml @@ -49,8 +49,16 @@ properties: - const: atmel,at91sam9x5 - const: atmel,at91sam9 + - description: Overkiz SmartKiz Board + items: + - const: overkiz,smartkiz + - const: atmel,at91sam9g25 + - const: atmel,at91sam9x5 + - const: atmel,at91sam9 + - items: - enum: + - atmel,at91sam9g25 - atmel,at91sam9g15 - atmel,at91sam9g25 - atmel,at91sam9g35 -- 2.23.0 ^ permalink raw reply related [flat|nested] 7+ messages in thread
* [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file 2019-10-17 9:48 [PATCH 0/2] Add DTS for Smartkiz support Kamel Bouhara 2019-10-17 9:48 ` [PATCH 1/2] dt-bindings: arm: at91: Document SmartKiz board binding Kamel Bouhara @ 2019-10-17 12:26 ` Kamel Bouhara 1 sibling, 0 replies; 7+ messages in thread From: Kamel Bouhara @ 2019-10-17 12:26 UTC (permalink / raw) To: Rob Herring, Nicolas Ferre, Alexandre Belloni, Ludovic Desroches, linux-arm-kernel Cc: Thomas Petazzoni, devicetree, linux-kernel, Kamel Bouhara, Kévin RAYMOND, Mickael GARDET Split the Kizbox Mini boards into two board configuration, the Kizboxmini Mother board and the Kizboxmini RailDIN board. Signed-off-by: Kamel Bouhara <kamel.bouhara@bootlin.com> Signed-off-by: Kévin RAYMOND <k.raymond@overkiz.com> Signed-off-by: Mickael GARDET <m.gardet@overkiz.com> --- arch/arm/boot/dts/Makefile | 2 + arch/arm/boot/dts/at91-kizboxmini-mb.dts | 38 ++++ arch/arm/boot/dts/at91-kizboxmini-rd.dts | 54 ++++++ arch/arm/boot/dts/at91-kizboxmini_common.dtsi | 166 ++++++++++++++++++ 4 files changed, 260 insertions(+) create mode 100644 arch/arm/boot/dts/at91-kizboxmini-mb.dts create mode 100644 arch/arm/boot/dts/at91-kizboxmini-rd.dts create mode 100644 arch/arm/boot/dts/at91-kizboxmini_common.dtsi diff --git a/arch/arm/boot/dts/Makefile b/arch/arm/boot/dts/Makefile index c976b72a4c94..6b3a65f3f6f8 100644 --- a/arch/arm/boot/dts/Makefile +++ b/arch/arm/boot/dts/Makefile @@ -38,6 +38,8 @@ dtb-$(CONFIG_SOC_AT91SAM9) += \ at91-ariettag25.dtb \ at91-cosino_mega2560.dtb \ at91-kizboxmini.dtb \ + at91-kizboxmini-mb.dtb \ + at91-kizboxmini-rd.dtb \ at91-wb45n.dtb \ at91sam9g15ek.dtb \ at91sam9g25ek.dtb \ diff --git a/arch/arm/boot/dts/at91-kizboxmini-mb.dts b/arch/arm/boot/dts/at91-kizboxmini-mb.dts new file mode 100644 index 000000000000..52921f547dd6 --- /dev/null +++ b/arch/arm/boot/dts/at91-kizboxmini-mb.dts @@ -0,0 +1,38 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * Copyright (C) 2015-2018 Overkiz SAS + * Author: Mickael Gardet <m.gardet@overkiz.com> + * Kévin Raymond <k.raymond@overkiz.com> + */ +/dts-v1/; +#include "at91-kizboxmini_common.dtsi" + +/ { + model = "Overkiz Kizbox Mini Mother Board"; + compatible = "overkiz,kizboxmini-mb", "atmel,at91sam9g25", + "atmel,at91sam9x5", "atmel,at91sam9"; + + clocks { + slow_xtal { + clock-frequency = <32768>; + }; + }; + + pwm_leds { + blue { + label = "pwm:blue:user"; + pwms = <&pwm0 2 10000000 0>; + max-brightness = <255>; + linux,default-trigger = "none"; + }; + }; +}; + +&usb0 { + num-ports = <2>; +}; + +&rtc { + status = "okay"; +}; + diff --git a/arch/arm/boot/dts/at91-kizboxmini-rd.dts b/arch/arm/boot/dts/at91-kizboxmini-rd.dts new file mode 100644 index 000000000000..1d2db8e16271 --- /dev/null +++ b/arch/arm/boot/dts/at91-kizboxmini-rd.dts @@ -0,0 +1,54 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * Copyright (C) 2015-2018 Overkiz SAS + * Author: Mickael Gardet <m.gardet@overkiz.com> + * Kévin Raymond <k.raymond@overkiz.com> + */ +/dts-v1/; +#include "at91-kizboxmini_common.dtsi" + +/ { + model = "Overkiz Kizbox Mini RailDIN"; + compatible = "overkiz,kizboxmini-rd", "atmel,at91sam9g25", + "atmel,at91sam9x5", "atmel,at91sam9"; + + clocks { + slow_xtal { + clock-frequency = <32768>; + }; + adc_op_clk { + status = "okay"; + }; + }; +}; + +&pinctrl { + adc0 { + pinctrl_adc0_ad5: adc0_ad5-0 { + /* pull-up disable */ + atmel,pins = <AT91_PIOB 16 AT91_PERIPH_GPIO AT91_PINCTRL_NONE>; + }; + }; +}; + +&usart0 { + status = "disabled"; +}; + +&rtc { + status = "okay"; +}; + +&leds { + blue { + status = "okay"; + }; +}; + +&adc0 { + atmel,adc-vref = <2500>; + pinctrl-names = "default"; + pinctrl-0 = <&pinctrl_adc0_ad5>; + atmel,adc-channels-used = <0x0020>; + status = "okay"; +}; diff --git a/arch/arm/boot/dts/at91-kizboxmini_common.dtsi b/arch/arm/boot/dts/at91-kizboxmini_common.dtsi new file mode 100644 index 000000000000..2598b776a278 --- /dev/null +++ b/arch/arm/boot/dts/at91-kizboxmini_common.dtsi @@ -0,0 +1,166 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * at91-kizboxmini.dts - Device Tree file for Overkiz Kizbox mini board + * + * Copyright (C) 2014-2018 Overkiz SAS + * Author: Antoine Aubert <a.aubert@overkiz.com> + * Gaël Portay <g.portay@overkiz.com> + * Kévin Raymond <k.raymond@overkiz.com> + * Dorian Rocipon <d.rocipon@overkiz.com> + */ +#include "at91sam9g25.dtsi" + +/ { + chosen { + bootargs = "ubi.mtd=ubi"; + stdout-path = &dbgu; + }; + + memory { + reg = <0x20000000 0x8000000>; + }; + + clocks { + main_xtal { + clock-frequency = <12000000>; + }; + + adc_op_clk { + status = "disabled"; + }; + }; + + gpio_keys { + compatible = "gpio-keys"; + #address-cells = <1>; + #size-cells = <0>; + + prog { + label = "PB_PROG"; + gpios = <&pioC 17 GPIO_ACTIVE_LOW>; + linux,code = <0x102>; + wakeup-source; + }; + + reset { + label = "PB_RST"; + gpios = <&pioC 16 GPIO_ACTIVE_LOW>; + linux,code = <0x100>; + wakeup-source; + }; + }; + + leds: pwm_leds { + compatible = "pwm-leds"; + + blue { + label = "pwm:blue:user"; + pwms = <&pwm0 2 10000000 0>; + max-brightness = <255>; + linux,default-trigger = "none"; + status = "disabled"; + }; + + green { + label = "pwm:green:user"; + pwms = <&pwm0 0 10000000 0>; + max-brightness = <255>; + linux,default-trigger = "default-on"; + }; + + red { + label = "pwm:red:user"; + pwms = <&pwm0 1 10000000 0>; + max-brightness = <255>; + linux,default-trigger = "default-on"; + }; + }; +}; + +&usart0 { + atmel,use-dma-rx; + atmel,use-dma-tx; + status = "okay"; +}; + +&macb0 { + phy-mode = "rmii"; + status = "okay"; +}; + +&pwm0 { + pinctrl-names = "default"; + pinctrl-0 = <&pinctrl_pwm0_pwm0_1 + &pinctrl_pwm0_pwm1_1 + &pinctrl_pwm0_pwm2_1>; + status = "okay"; +}; + +&dbgu { + status = "okay"; +}; + +&watchdog { + status = "okay"; +}; + +&adc0 { + status = "disabled"; +}; + +&rtc { + status = "disabled"; +}; + +&ebi { + pinctrl-0 = <&pinctrl_ebi_addr_nand + &pinctrl_ebi_data_0_7>; + pinctrl-names = "default"; + status = "okay"; +}; + +&nand_controller { + status = "okay"; + pinctrl-0 = <&pinctrl_nand_oe_we + &pinctrl_nand_cs + &pinctrl_nand_rb>; + pinctrl-names = "default"; + + nand@3 { + reg = <0x3 0x0 0x800000>; + rb-gpios = <&pioD 5 GPIO_ACTIVE_HIGH>; + cs-gpios = <&pioD 4 GPIO_ACTIVE_HIGH>; + nand-bus-width = <8>; + nand-ecc-mode = "hw"; + nand-ecc-strength = <4>; + nand-ecc-step-size = <512>; + nand-on-flash-bbt; + label = "atmel_nand"; + + partitions { + compatible = "fixed-partitions"; + #address-cells = <1>; + #size-cells = <1>; + + bootstrap@0 { + label = "bootstrap"; + reg = <0x0 0x20000>; + }; + + ubi@20000 { + label = "ubi"; + reg = <0x20000 0x7fe0000>; + }; + }; + }; +}; + +&usb0 { + num-ports = <1>; + status = "okay"; +}; + +&usb1 { + status = "okay"; +}; + -- 2.23.0 ^ permalink raw reply related [flat|nested] 7+ messages in thread
* [PATCH RESEND 0/2] Add Kizboxmini boards support @ 2019-10-18 14:03 Kamel Bouhara 2019-10-18 14:03 ` [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file Kamel Bouhara 0 siblings, 1 reply; 7+ messages in thread From: Kamel Bouhara @ 2019-10-18 14:03 UTC (permalink / raw) To: Rob Herring, Nicolas Ferre, Alexandre Belloni, Ludovic Desroches, linux-arm-kernel Cc: Thomas Petazzoni, devicetree, linux-kernel, Kamel Bouhara Add support for the Overkiz's SAM9G25 based boards and document them. Kamel Bouhara (2): dt-bindings: arm: at91: Document Kizboxmini boards binding ARM: dts: at91: add a common kizboxmini dtsi file .../devicetree/bindings/arm/atmel-at91.yaml | 14 ++ arch/arm/boot/dts/Makefile | 2 + arch/arm/boot/dts/at91-kizboxmini-mb.dts | 38 ++++ arch/arm/boot/dts/at91-kizboxmini-rd.dts | 54 ++++++ arch/arm/boot/dts/at91-kizboxmini_common.dtsi | 166 ++++++++++++++++++ 5 files changed, 274 insertions(+) create mode 100644 arch/arm/boot/dts/at91-kizboxmini-mb.dts create mode 100644 arch/arm/boot/dts/at91-kizboxmini-rd.dts create mode 100644 arch/arm/boot/dts/at91-kizboxmini_common.dtsi -- 2.23.0 ^ permalink raw reply [flat|nested] 7+ messages in thread
* [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file 2019-10-18 14:03 [PATCH RESEND 0/2] Add Kizboxmini boards support Kamel Bouhara @ 2019-10-18 14:03 ` Kamel Bouhara 2019-10-18 14:23 ` Alexandre Belloni 2019-10-29 12:34 ` Rob Herring 0 siblings, 2 replies; 7+ messages in thread From: Kamel Bouhara @ 2019-10-18 14:03 UTC (permalink / raw) To: Rob Herring, Nicolas Ferre, Alexandre Belloni, Ludovic Desroches, linux-arm-kernel Cc: Thomas Petazzoni, devicetree, linux-kernel, Kamel Bouhara, Kévin RAYMOND, Mickael GARDET Split the Kizbox Mini boards into two board configuration, the Kizboxmini Mother board and the Kizboxmini RailDIN board. Signed-off-by: Kamel Bouhara <kamel.bouhara@bootlin.com> Signed-off-by: Kévin RAYMOND <k.raymond@overkiz.com> Signed-off-by: Mickael GARDET <m.gardet@overkiz.com> --- arch/arm/boot/dts/Makefile | 2 + arch/arm/boot/dts/at91-kizboxmini-mb.dts | 38 ++++ arch/arm/boot/dts/at91-kizboxmini-rd.dts | 54 ++++++ arch/arm/boot/dts/at91-kizboxmini_common.dtsi | 166 ++++++++++++++++++ 4 files changed, 260 insertions(+) create mode 100644 arch/arm/boot/dts/at91-kizboxmini-mb.dts create mode 100644 arch/arm/boot/dts/at91-kizboxmini-rd.dts create mode 100644 arch/arm/boot/dts/at91-kizboxmini_common.dtsi diff --git a/arch/arm/boot/dts/Makefile b/arch/arm/boot/dts/Makefile index c976b72a4c94..6b3a65f3f6f8 100644 --- a/arch/arm/boot/dts/Makefile +++ b/arch/arm/boot/dts/Makefile @@ -38,6 +38,8 @@ dtb-$(CONFIG_SOC_AT91SAM9) += \ at91-ariettag25.dtb \ at91-cosino_mega2560.dtb \ at91-kizboxmini.dtb \ + at91-kizboxmini-mb.dtb \ + at91-kizboxmini-rd.dtb \ at91-wb45n.dtb \ at91sam9g15ek.dtb \ at91sam9g25ek.dtb \ diff --git a/arch/arm/boot/dts/at91-kizboxmini-mb.dts b/arch/arm/boot/dts/at91-kizboxmini-mb.dts new file mode 100644 index 000000000000..52921f547dd6 --- /dev/null +++ b/arch/arm/boot/dts/at91-kizboxmini-mb.dts @@ -0,0 +1,38 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * Copyright (C) 2015-2018 Overkiz SAS + * Author: Mickael Gardet <m.gardet@overkiz.com> + * Kévin Raymond <k.raymond@overkiz.com> + */ +/dts-v1/; +#include "at91-kizboxmini_common.dtsi" + +/ { + model = "Overkiz Kizbox Mini Mother Board"; + compatible = "overkiz,kizboxmini-mb", "atmel,at91sam9g25", + "atmel,at91sam9x5", "atmel,at91sam9"; + + clocks { + slow_xtal { + clock-frequency = <32768>; + }; + }; + + pwm_leds { + blue { + label = "pwm:blue:user"; + pwms = <&pwm0 2 10000000 0>; + max-brightness = <255>; + linux,default-trigger = "none"; + }; + }; +}; + +&usb0 { + num-ports = <2>; +}; + +&rtc { + status = "okay"; +}; + diff --git a/arch/arm/boot/dts/at91-kizboxmini-rd.dts b/arch/arm/boot/dts/at91-kizboxmini-rd.dts new file mode 100644 index 000000000000..1d2db8e16271 --- /dev/null +++ b/arch/arm/boot/dts/at91-kizboxmini-rd.dts @@ -0,0 +1,54 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * Copyright (C) 2015-2018 Overkiz SAS + * Author: Mickael Gardet <m.gardet@overkiz.com> + * Kévin Raymond <k.raymond@overkiz.com> + */ +/dts-v1/; +#include "at91-kizboxmini_common.dtsi" + +/ { + model = "Overkiz Kizbox Mini RailDIN"; + compatible = "overkiz,kizboxmini-rd", "atmel,at91sam9g25", + "atmel,at91sam9x5", "atmel,at91sam9"; + + clocks { + slow_xtal { + clock-frequency = <32768>; + }; + adc_op_clk { + status = "okay"; + }; + }; +}; + +&pinctrl { + adc0 { + pinctrl_adc0_ad5: adc0_ad5-0 { + /* pull-up disable */ + atmel,pins = <AT91_PIOB 16 AT91_PERIPH_GPIO AT91_PINCTRL_NONE>; + }; + }; +}; + +&usart0 { + status = "disabled"; +}; + +&rtc { + status = "okay"; +}; + +&leds { + blue { + status = "okay"; + }; +}; + +&adc0 { + atmel,adc-vref = <2500>; + pinctrl-names = "default"; + pinctrl-0 = <&pinctrl_adc0_ad5>; + atmel,adc-channels-used = <0x0020>; + status = "okay"; +}; diff --git a/arch/arm/boot/dts/at91-kizboxmini_common.dtsi b/arch/arm/boot/dts/at91-kizboxmini_common.dtsi new file mode 100644 index 000000000000..2598b776a278 --- /dev/null +++ b/arch/arm/boot/dts/at91-kizboxmini_common.dtsi @@ -0,0 +1,166 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * at91-kizboxmini.dts - Device Tree file for Overkiz Kizbox mini board + * + * Copyright (C) 2014-2018 Overkiz SAS + * Author: Antoine Aubert <a.aubert@overkiz.com> + * Gaël Portay <g.portay@overkiz.com> + * Kévin Raymond <k.raymond@overkiz.com> + * Dorian Rocipon <d.rocipon@overkiz.com> + */ +#include "at91sam9g25.dtsi" + +/ { + chosen { + bootargs = "ubi.mtd=ubi"; + stdout-path = &dbgu; + }; + + memory { + reg = <0x20000000 0x8000000>; + }; + + clocks { + main_xtal { + clock-frequency = <12000000>; + }; + + adc_op_clk { + status = "disabled"; + }; + }; + + gpio_keys { + compatible = "gpio-keys"; + #address-cells = <1>; + #size-cells = <0>; + + prog { + label = "PB_PROG"; + gpios = <&pioC 17 GPIO_ACTIVE_LOW>; + linux,code = <0x102>; + wakeup-source; + }; + + reset { + label = "PB_RST"; + gpios = <&pioC 16 GPIO_ACTIVE_LOW>; + linux,code = <0x100>; + wakeup-source; + }; + }; + + leds: pwm_leds { + compatible = "pwm-leds"; + + blue { + label = "pwm:blue:user"; + pwms = <&pwm0 2 10000000 0>; + max-brightness = <255>; + linux,default-trigger = "none"; + status = "disabled"; + }; + + green { + label = "pwm:green:user"; + pwms = <&pwm0 0 10000000 0>; + max-brightness = <255>; + linux,default-trigger = "default-on"; + }; + + red { + label = "pwm:red:user"; + pwms = <&pwm0 1 10000000 0>; + max-brightness = <255>; + linux,default-trigger = "default-on"; + }; + }; +}; + +&usart0 { + atmel,use-dma-rx; + atmel,use-dma-tx; + status = "okay"; +}; + +&macb0 { + phy-mode = "rmii"; + status = "okay"; +}; + +&pwm0 { + pinctrl-names = "default"; + pinctrl-0 = <&pinctrl_pwm0_pwm0_1 + &pinctrl_pwm0_pwm1_1 + &pinctrl_pwm0_pwm2_1>; + status = "okay"; +}; + +&dbgu { + status = "okay"; +}; + +&watchdog { + status = "okay"; +}; + +&adc0 { + status = "disabled"; +}; + +&rtc { + status = "disabled"; +}; + +&ebi { + pinctrl-0 = <&pinctrl_ebi_addr_nand + &pinctrl_ebi_data_0_7>; + pinctrl-names = "default"; + status = "okay"; +}; + +&nand_controller { + status = "okay"; + pinctrl-0 = <&pinctrl_nand_oe_we + &pinctrl_nand_cs + &pinctrl_nand_rb>; + pinctrl-names = "default"; + + nand@3 { + reg = <0x3 0x0 0x800000>; + rb-gpios = <&pioD 5 GPIO_ACTIVE_HIGH>; + cs-gpios = <&pioD 4 GPIO_ACTIVE_HIGH>; + nand-bus-width = <8>; + nand-ecc-mode = "hw"; + nand-ecc-strength = <4>; + nand-ecc-step-size = <512>; + nand-on-flash-bbt; + label = "atmel_nand"; + + partitions { + compatible = "fixed-partitions"; + #address-cells = <1>; + #size-cells = <1>; + + bootstrap@0 { + label = "bootstrap"; + reg = <0x0 0x20000>; + }; + + ubi@20000 { + label = "ubi"; + reg = <0x20000 0x7fe0000>; + }; + }; + }; +}; + +&usb0 { + num-ports = <1>; + status = "okay"; +}; + +&usb1 { + status = "okay"; +}; + -- 2.23.0 ^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file 2019-10-18 14:03 ` [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file Kamel Bouhara @ 2019-10-18 14:23 ` Alexandre Belloni 2019-10-29 12:34 ` Rob Herring 1 sibling, 0 replies; 7+ messages in thread From: Alexandre Belloni @ 2019-10-18 14:23 UTC (permalink / raw) To: Kamel Bouhara Cc: Rob Herring, Nicolas Ferre, Ludovic Desroches, linux-arm-kernel, Thomas Petazzoni, devicetree, linux-kernel, Kévin RAYMOND, Mickael GARDET On 18/10/2019 16:03:04+0200, Kamel Bouhara wrote: > Split the Kizbox Mini boards into two board configuration, the > Kizboxmini Mother board and the Kizboxmini RailDIN board. > > Signed-off-by: Kamel Bouhara <kamel.bouhara@bootlin.com> > Signed-off-by: Kévin RAYMOND <k.raymond@overkiz.com> > Signed-off-by: Mickael GARDET <m.gardet@overkiz.com> > --- > arch/arm/boot/dts/Makefile | 2 + > arch/arm/boot/dts/at91-kizboxmini-mb.dts | 38 ++++ > arch/arm/boot/dts/at91-kizboxmini-rd.dts | 54 ++++++ > arch/arm/boot/dts/at91-kizboxmini_common.dtsi | 166 ++++++++++++++++++ This adds more than the subject says. > 4 files changed, 260 insertions(+) > create mode 100644 arch/arm/boot/dts/at91-kizboxmini-mb.dts > create mode 100644 arch/arm/boot/dts/at91-kizboxmini-rd.dts > create mode 100644 arch/arm/boot/dts/at91-kizboxmini_common.dtsi > Is arch/arm/boot/dts/at91-kizboxmini.dts still necessary after that? > diff --git a/arch/arm/boot/dts/Makefile b/arch/arm/boot/dts/Makefile > index c976b72a4c94..6b3a65f3f6f8 100644 > --- a/arch/arm/boot/dts/Makefile > +++ b/arch/arm/boot/dts/Makefile > @@ -38,6 +38,8 @@ dtb-$(CONFIG_SOC_AT91SAM9) += \ > at91-ariettag25.dtb \ > at91-cosino_mega2560.dtb \ > at91-kizboxmini.dtb \ > + at91-kizboxmini-mb.dtb \ > + at91-kizboxmini-rd.dtb \ > at91-wb45n.dtb \ > at91sam9g15ek.dtb \ > at91sam9g25ek.dtb \ > diff --git a/arch/arm/boot/dts/at91-kizboxmini-mb.dts b/arch/arm/boot/dts/at91-kizboxmini-mb.dts > new file mode 100644 > index 000000000000..52921f547dd6 > --- /dev/null > +++ b/arch/arm/boot/dts/at91-kizboxmini-mb.dts > @@ -0,0 +1,38 @@ > +// SPDX-License-Identifier: GPL-2.0 > +/* > + * Copyright (C) 2015-2018 Overkiz SAS > + * Author: Mickael Gardet <m.gardet@overkiz.com> > + * Kévin Raymond <k.raymond@overkiz.com> > + */ > +/dts-v1/; > +#include "at91-kizboxmini_common.dtsi" > + > +/ { > + model = "Overkiz Kizbox Mini Mother Board"; > + compatible = "overkiz,kizboxmini-mb", "atmel,at91sam9g25", > + "atmel,at91sam9x5", "atmel,at91sam9"; > + > + clocks { > + slow_xtal { > + clock-frequency = <32768>; > + }; > + }; > + > + pwm_leds { > + blue { > + label = "pwm:blue:user"; > + pwms = <&pwm0 2 10000000 0>; > + max-brightness = <255>; > + linux,default-trigger = "none"; The pwm is redefined here but is still left disabled from the common dtsi. > + }; > + }; > +}; > + > +&usb0 { > + num-ports = <2>; > +}; > + > +&rtc { > + status = "okay"; > +}; > + > diff --git a/arch/arm/boot/dts/at91-kizboxmini-rd.dts b/arch/arm/boot/dts/at91-kizboxmini-rd.dts > new file mode 100644 > index 000000000000..1d2db8e16271 > --- /dev/null > +++ b/arch/arm/boot/dts/at91-kizboxmini-rd.dts > @@ -0,0 +1,54 @@ > +// SPDX-License-Identifier: GPL-2.0 > +/* > + * Copyright (C) 2015-2018 Overkiz SAS > + * Author: Mickael Gardet <m.gardet@overkiz.com> > + * Kévin Raymond <k.raymond@overkiz.com> > + */ > +/dts-v1/; > +#include "at91-kizboxmini_common.dtsi" > + > +/ { > + model = "Overkiz Kizbox Mini RailDIN"; > + compatible = "overkiz,kizboxmini-rd", "atmel,at91sam9g25", > + "atmel,at91sam9x5", "atmel,at91sam9"; > + > + clocks { > + slow_xtal { > + clock-frequency = <32768>; > + }; > + adc_op_clk { > + status = "okay"; > + }; > + }; > +}; > + > +&pinctrl { > + adc0 { > + pinctrl_adc0_ad5: adc0_ad5-0 { > + /* pull-up disable */ > + atmel,pins = <AT91_PIOB 16 AT91_PERIPH_GPIO AT91_PINCTRL_NONE>; > + }; > + }; > +}; > + > +&usart0 { > + status = "disabled"; > +}; > + > +&rtc { > + status = "okay"; > +}; > + > +&leds { > + blue { > + status = "okay"; > + }; > +}; > + > +&adc0 { > + atmel,adc-vref = <2500>; > + pinctrl-names = "default"; > + pinctrl-0 = <&pinctrl_adc0_ad5>; > + atmel,adc-channels-used = <0x0020>; > + status = "okay"; > +}; > diff --git a/arch/arm/boot/dts/at91-kizboxmini_common.dtsi b/arch/arm/boot/dts/at91-kizboxmini_common.dtsi > new file mode 100644 > index 000000000000..2598b776a278 > --- /dev/null > +++ b/arch/arm/boot/dts/at91-kizboxmini_common.dtsi > @@ -0,0 +1,166 @@ > +// SPDX-License-Identifier: GPL-2.0 > +/* > + * at91-kizboxmini.dts - Device Tree file for Overkiz Kizbox mini board > + * > + * Copyright (C) 2014-2018 Overkiz SAS > + * Author: Antoine Aubert <a.aubert@overkiz.com> > + * Gaël Portay <g.portay@overkiz.com> > + * Kévin Raymond <k.raymond@overkiz.com> > + * Dorian Rocipon <d.rocipon@overkiz.com> > + */ > +#include "at91sam9g25.dtsi" > + > +/ { > + chosen { > + bootargs = "ubi.mtd=ubi"; > + stdout-path = &dbgu; > + }; > + > + memory { > + reg = <0x20000000 0x8000000>; > + }; > + > + clocks { > + main_xtal { > + clock-frequency = <12000000>; > + }; > + > + adc_op_clk { > + status = "disabled"; > + }; > + }; > + > + gpio_keys { > + compatible = "gpio-keys"; > + #address-cells = <1>; > + #size-cells = <0>; > + > + prog { > + label = "PB_PROG"; > + gpios = <&pioC 17 GPIO_ACTIVE_LOW>; > + linux,code = <0x102>; > + wakeup-source; > + }; > + > + reset { > + label = "PB_RST"; > + gpios = <&pioC 16 GPIO_ACTIVE_LOW>; > + linux,code = <0x100>; > + wakeup-source; > + }; > + }; > + > + leds: pwm_leds { > + compatible = "pwm-leds"; > + > + blue { > + label = "pwm:blue:user"; > + pwms = <&pwm0 2 10000000 0>; > + max-brightness = <255>; > + linux,default-trigger = "none"; > + status = "disabled"; > + }; > + > + green { > + label = "pwm:green:user"; > + pwms = <&pwm0 0 10000000 0>; > + max-brightness = <255>; > + linux,default-trigger = "default-on"; > + }; > + > + red { > + label = "pwm:red:user"; > + pwms = <&pwm0 1 10000000 0>; > + max-brightness = <255>; > + linux,default-trigger = "default-on"; > + }; > + }; > +}; > + > +&usart0 { > + atmel,use-dma-rx; > + atmel,use-dma-tx; > + status = "okay"; > +}; > + > +&macb0 { > + phy-mode = "rmii"; > + status = "okay"; > +}; > + > +&pwm0 { > + pinctrl-names = "default"; > + pinctrl-0 = <&pinctrl_pwm0_pwm0_1 > + &pinctrl_pwm0_pwm1_1 > + &pinctrl_pwm0_pwm2_1>; > + status = "okay"; > +}; > + > +&dbgu { > + status = "okay"; > +}; > + > +&watchdog { > + status = "okay"; > +}; > + > +&adc0 { > + status = "disabled"; > +}; > + > +&rtc { > + status = "disabled"; > +}; > + > +&ebi { > + pinctrl-0 = <&pinctrl_ebi_addr_nand > + &pinctrl_ebi_data_0_7>; > + pinctrl-names = "default"; > + status = "okay"; > +}; > + > +&nand_controller { > + status = "okay"; > + pinctrl-0 = <&pinctrl_nand_oe_we > + &pinctrl_nand_cs > + &pinctrl_nand_rb>; > + pinctrl-names = "default"; > + > + nand@3 { > + reg = <0x3 0x0 0x800000>; > + rb-gpios = <&pioD 5 GPIO_ACTIVE_HIGH>; > + cs-gpios = <&pioD 4 GPIO_ACTIVE_HIGH>; > + nand-bus-width = <8>; > + nand-ecc-mode = "hw"; > + nand-ecc-strength = <4>; > + nand-ecc-step-size = <512>; > + nand-on-flash-bbt; > + label = "atmel_nand"; > + > + partitions { > + compatible = "fixed-partitions"; > + #address-cells = <1>; > + #size-cells = <1>; > + > + bootstrap@0 { > + label = "bootstrap"; > + reg = <0x0 0x20000>; > + }; > + > + ubi@20000 { > + label = "ubi"; > + reg = <0x20000 0x7fe0000>; > + }; > + }; > + }; > +}; > + > +&usb0 { > + num-ports = <1>; > + status = "okay"; > +}; > + > +&usb1 { > + status = "okay"; > +}; > + > -- > 2.23.0 > -- Alexandre Belloni, Bootlin Embedded Linux and Kernel engineering https://bootlin.com ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file 2019-10-18 14:03 ` [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file Kamel Bouhara 2019-10-18 14:23 ` Alexandre Belloni @ 2019-10-29 12:34 ` Rob Herring 2019-10-31 11:08 ` Alexandre Belloni 1 sibling, 1 reply; 7+ messages in thread From: Rob Herring @ 2019-10-29 12:34 UTC (permalink / raw) To: Kamel Bouhara Cc: Nicolas Ferre, Alexandre Belloni, Ludovic Desroches, linux-arm-kernel, Thomas Petazzoni, devicetree, linux-kernel, Kévin RAYMOND, Mickael GARDET On Fri, Oct 18, 2019 at 04:03:04PM +0200, Kamel Bouhara wrote: > Split the Kizbox Mini boards into two board configuration, the > Kizboxmini Mother board and the Kizboxmini RailDIN board. > > Signed-off-by: Kamel Bouhara <kamel.bouhara@bootlin.com> > Signed-off-by: Kévin RAYMOND <k.raymond@overkiz.com> > Signed-off-by: Mickael GARDET <m.gardet@overkiz.com> > --- > arch/arm/boot/dts/Makefile | 2 + > arch/arm/boot/dts/at91-kizboxmini-mb.dts | 38 ++++ > arch/arm/boot/dts/at91-kizboxmini-rd.dts | 54 ++++++ > arch/arm/boot/dts/at91-kizboxmini_common.dtsi | 166 ++++++++++++++++++ > 4 files changed, 260 insertions(+) > create mode 100644 arch/arm/boot/dts/at91-kizboxmini-mb.dts > create mode 100644 arch/arm/boot/dts/at91-kizboxmini-rd.dts > create mode 100644 arch/arm/boot/dts/at91-kizboxmini_common.dtsi > > diff --git a/arch/arm/boot/dts/Makefile b/arch/arm/boot/dts/Makefile > index c976b72a4c94..6b3a65f3f6f8 100644 > --- a/arch/arm/boot/dts/Makefile > +++ b/arch/arm/boot/dts/Makefile > @@ -38,6 +38,8 @@ dtb-$(CONFIG_SOC_AT91SAM9) += \ > at91-ariettag25.dtb \ > at91-cosino_mega2560.dtb \ > at91-kizboxmini.dtb \ > + at91-kizboxmini-mb.dtb \ > + at91-kizboxmini-rd.dtb \ > at91-wb45n.dtb \ > at91sam9g15ek.dtb \ > at91sam9g25ek.dtb \ > diff --git a/arch/arm/boot/dts/at91-kizboxmini-mb.dts b/arch/arm/boot/dts/at91-kizboxmini-mb.dts > new file mode 100644 > index 000000000000..52921f547dd6 > --- /dev/null > +++ b/arch/arm/boot/dts/at91-kizboxmini-mb.dts > @@ -0,0 +1,38 @@ > +// SPDX-License-Identifier: GPL-2.0 > +/* > + * Copyright (C) 2015-2018 Overkiz SAS > + * Author: Mickael Gardet <m.gardet@overkiz.com> > + * Kévin Raymond <k.raymond@overkiz.com> > + */ > +/dts-v1/; > +#include "at91-kizboxmini_common.dtsi" > + > +/ { > + model = "Overkiz Kizbox Mini Mother Board"; > + compatible = "overkiz,kizboxmini-mb", "atmel,at91sam9g25", > + "atmel,at91sam9x5", "atmel,at91sam9"; > + > + clocks { > + slow_xtal { Don't use '_' in node names. > + clock-frequency = <32768>; > + }; > + }; > + > + pwm_leds { > + blue { > + label = "pwm:blue:user"; > + pwms = <&pwm0 2 10000000 0>; > + max-brightness = <255>; > + linux,default-trigger = "none"; > + }; > + }; > +}; > + > +&usb0 { > + num-ports = <2>; > +}; > + > +&rtc { > + status = "okay"; > +}; > + > diff --git a/arch/arm/boot/dts/at91-kizboxmini-rd.dts b/arch/arm/boot/dts/at91-kizboxmini-rd.dts > new file mode 100644 > index 000000000000..1d2db8e16271 > --- /dev/null > +++ b/arch/arm/boot/dts/at91-kizboxmini-rd.dts > @@ -0,0 +1,54 @@ > +// SPDX-License-Identifier: GPL-2.0 > +/* > + * Copyright (C) 2015-2018 Overkiz SAS > + * Author: Mickael Gardet <m.gardet@overkiz.com> > + * Kévin Raymond <k.raymond@overkiz.com> > + */ > +/dts-v1/; > +#include "at91-kizboxmini_common.dtsi" > + > +/ { > + model = "Overkiz Kizbox Mini RailDIN"; > + compatible = "overkiz,kizboxmini-rd", "atmel,at91sam9g25", > + "atmel,at91sam9x5", "atmel,at91sam9"; > + > + clocks { > + slow_xtal { > + clock-frequency = <32768>; > + }; > + adc_op_clk { > + status = "okay"; > + }; > + }; > +}; > + > +&pinctrl { > + adc0 { > + pinctrl_adc0_ad5: adc0_ad5-0 { > + /* pull-up disable */ > + atmel,pins = <AT91_PIOB 16 AT91_PERIPH_GPIO AT91_PINCTRL_NONE>; > + }; > + }; > +}; > + > +&usart0 { > + status = "disabled"; > +}; > + > +&rtc { > + status = "okay"; > +}; > + > +&leds { > + blue { > + status = "okay"; > + }; > +}; > + > +&adc0 { > + atmel,adc-vref = <2500>; > + pinctrl-names = "default"; > + pinctrl-0 = <&pinctrl_adc0_ad5>; > + atmel,adc-channels-used = <0x0020>; > + status = "okay"; > +}; > diff --git a/arch/arm/boot/dts/at91-kizboxmini_common.dtsi b/arch/arm/boot/dts/at91-kizboxmini_common.dtsi > new file mode 100644 > index 000000000000..2598b776a278 > --- /dev/null > +++ b/arch/arm/boot/dts/at91-kizboxmini_common.dtsi > @@ -0,0 +1,166 @@ > +// SPDX-License-Identifier: GPL-2.0 > +/* > + * at91-kizboxmini.dts - Device Tree file for Overkiz Kizbox mini board > + * > + * Copyright (C) 2014-2018 Overkiz SAS > + * Author: Antoine Aubert <a.aubert@overkiz.com> > + * Gaël Portay <g.portay@overkiz.com> > + * Kévin Raymond <k.raymond@overkiz.com> > + * Dorian Rocipon <d.rocipon@overkiz.com> > + */ > +#include "at91sam9g25.dtsi" > + > +/ { > + chosen { > + bootargs = "ubi.mtd=ubi"; > + stdout-path = &dbgu; > + }; > + > + memory { memory@20000000 Build your dtb with W=12 and fix any new warnings (feel free to fix existing ones too :) ). > + reg = <0x20000000 0x8000000>; > + }; > + > + clocks { > + main_xtal { > + clock-frequency = <12000000>; > + }; > + > + adc_op_clk { > + status = "disabled"; > + }; > + }; > + > + gpio_keys { > + compatible = "gpio-keys"; > + #address-cells = <1>; > + #size-cells = <0>; > + > + prog { > + label = "PB_PROG"; > + gpios = <&pioC 17 GPIO_ACTIVE_LOW>; > + linux,code = <0x102>; > + wakeup-source; > + }; > + > + reset { > + label = "PB_RST"; > + gpios = <&pioC 16 GPIO_ACTIVE_LOW>; > + linux,code = <0x100>; > + wakeup-source; > + }; > + }; > + > + leds: pwm_leds { > + compatible = "pwm-leds"; > + > + blue { > + label = "pwm:blue:user"; > + pwms = <&pwm0 2 10000000 0>; > + max-brightness = <255>; > + linux,default-trigger = "none"; > + status = "disabled"; > + }; > + > + green { > + label = "pwm:green:user"; > + pwms = <&pwm0 0 10000000 0>; > + max-brightness = <255>; > + linux,default-trigger = "default-on"; > + }; > + > + red { > + label = "pwm:red:user"; > + pwms = <&pwm0 1 10000000 0>; > + max-brightness = <255>; > + linux,default-trigger = "default-on"; > + }; > + }; > +}; > + > +&usart0 { > + atmel,use-dma-rx; > + atmel,use-dma-tx; > + status = "okay"; > +}; > + > +&macb0 { > + phy-mode = "rmii"; > + status = "okay"; > +}; > + > +&pwm0 { > + pinctrl-names = "default"; > + pinctrl-0 = <&pinctrl_pwm0_pwm0_1 > + &pinctrl_pwm0_pwm1_1 > + &pinctrl_pwm0_pwm2_1>; > + status = "okay"; > +}; > + > +&dbgu { > + status = "okay"; > +}; > + > +&watchdog { > + status = "okay"; > +}; > + > +&adc0 { > + status = "disabled"; > +}; > + > +&rtc { > + status = "disabled"; > +}; > + > +&ebi { > + pinctrl-0 = <&pinctrl_ebi_addr_nand > + &pinctrl_ebi_data_0_7>; > + pinctrl-names = "default"; > + status = "okay"; > +}; > + > +&nand_controller { > + status = "okay"; > + pinctrl-0 = <&pinctrl_nand_oe_we > + &pinctrl_nand_cs > + &pinctrl_nand_rb>; > + pinctrl-names = "default"; > + > + nand@3 { > + reg = <0x3 0x0 0x800000>; > + rb-gpios = <&pioD 5 GPIO_ACTIVE_HIGH>; > + cs-gpios = <&pioD 4 GPIO_ACTIVE_HIGH>; > + nand-bus-width = <8>; > + nand-ecc-mode = "hw"; > + nand-ecc-strength = <4>; > + nand-ecc-step-size = <512>; > + nand-on-flash-bbt; > + label = "atmel_nand"; > + > + partitions { > + compatible = "fixed-partitions"; > + #address-cells = <1>; > + #size-cells = <1>; > + > + bootstrap@0 { > + label = "bootstrap"; > + reg = <0x0 0x20000>; > + }; > + > + ubi@20000 { > + label = "ubi"; > + reg = <0x20000 0x7fe0000>; > + }; > + }; > + }; > +}; > + > +&usb0 { > + num-ports = <1>; > + status = "okay"; > +}; > + > +&usb1 { > + status = "okay"; > +}; > + > -- > 2.23.0 > ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file 2019-10-29 12:34 ` Rob Herring @ 2019-10-31 11:08 ` Alexandre Belloni 0 siblings, 0 replies; 7+ messages in thread From: Alexandre Belloni @ 2019-10-31 11:08 UTC (permalink / raw) To: Rob Herring Cc: Kamel Bouhara, Nicolas Ferre, Ludovic Desroches, linux-arm-kernel, Thomas Petazzoni, devicetree, linux-kernel, Kévin RAYMOND, Mickael GARDET On 29/10/2019 07:34:26-0500, Rob Herring wrote: > On Fri, Oct 18, 2019 at 04:03:04PM +0200, Kamel Bouhara wrote: > > Split the Kizbox Mini boards into two board configuration, the > > Kizboxmini Mother board and the Kizboxmini RailDIN board. > > > > Signed-off-by: Kamel Bouhara <kamel.bouhara@bootlin.com> > > Signed-off-by: Kévin RAYMOND <k.raymond@overkiz.com> > > Signed-off-by: Mickael GARDET <m.gardet@overkiz.com> > > --- > > arch/arm/boot/dts/Makefile | 2 + > > arch/arm/boot/dts/at91-kizboxmini-mb.dts | 38 ++++ > > arch/arm/boot/dts/at91-kizboxmini-rd.dts | 54 ++++++ > > arch/arm/boot/dts/at91-kizboxmini_common.dtsi | 166 ++++++++++++++++++ > > 4 files changed, 260 insertions(+) > > create mode 100644 arch/arm/boot/dts/at91-kizboxmini-mb.dts > > create mode 100644 arch/arm/boot/dts/at91-kizboxmini-rd.dts > > create mode 100644 arch/arm/boot/dts/at91-kizboxmini_common.dtsi > > > > diff --git a/arch/arm/boot/dts/Makefile b/arch/arm/boot/dts/Makefile > > index c976b72a4c94..6b3a65f3f6f8 100644 > > --- a/arch/arm/boot/dts/Makefile > > +++ b/arch/arm/boot/dts/Makefile > > @@ -38,6 +38,8 @@ dtb-$(CONFIG_SOC_AT91SAM9) += \ > > at91-ariettag25.dtb \ > > at91-cosino_mega2560.dtb \ > > at91-kizboxmini.dtb \ > > + at91-kizboxmini-mb.dtb \ > > + at91-kizboxmini-rd.dtb \ > > at91-wb45n.dtb \ > > at91sam9g15ek.dtb \ > > at91sam9g25ek.dtb \ > > diff --git a/arch/arm/boot/dts/at91-kizboxmini-mb.dts b/arch/arm/boot/dts/at91-kizboxmini-mb.dts > > new file mode 100644 > > index 000000000000..52921f547dd6 > > --- /dev/null > > +++ b/arch/arm/boot/dts/at91-kizboxmini-mb.dts > > @@ -0,0 +1,38 @@ > > +// SPDX-License-Identifier: GPL-2.0 > > +/* > > + * Copyright (C) 2015-2018 Overkiz SAS > > + * Author: Mickael Gardet <m.gardet@overkiz.com> > > + * Kévin Raymond <k.raymond@overkiz.com> > > + */ > > +/dts-v1/; > > +#include "at91-kizboxmini_common.dtsi" > > + > > +/ { > > + model = "Overkiz Kizbox Mini Mother Board"; > > + compatible = "overkiz,kizboxmini-mb", "atmel,at91sam9g25", > > + "atmel,at91sam9x5", "atmel,at91sam9"; > > + > > + clocks { > > + slow_xtal { > > Don't use '_' in node names. > We are stuck with that one until we change the dtsi. -- Alexandre Belloni, Bootlin Embedded Linux and Kernel engineering https://bootlin.com ^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2019-10-31 11:08 UTC | newest] Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2019-10-17 9:48 [PATCH 0/2] Add DTS for Smartkiz support Kamel Bouhara 2019-10-17 9:48 ` [PATCH 1/2] dt-bindings: arm: at91: Document SmartKiz board binding Kamel Bouhara 2019-10-17 12:26 ` [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file Kamel Bouhara 2019-10-18 14:03 [PATCH RESEND 0/2] Add Kizboxmini boards support Kamel Bouhara 2019-10-18 14:03 ` [PATCH 2/2] ARM: dts: at91: add a common kizboxmini dtsi file Kamel Bouhara 2019-10-18 14:23 ` Alexandre Belloni 2019-10-29 12:34 ` Rob Herring 2019-10-31 11:08 ` Alexandre Belloni
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).