From: Marcel Ziswiler <marcel@ziswiler.com> To: linux-arm-kernel@lists.infradead.org Cc: Marcel Ziswiler <marcel.ziswiler@toradex.com>, Alexander Stein <alexander.stein@ew.tq-group.com>, Ariel D'Alessandro <ariel.dalessandro@collabora.com>, Arnd Bergmann <arnd@arndb.de>, Christoph Niedermaier <cniedermaier@dh-electronics.com>, Fabio Estevam <festevam@gmail.com>, Frank Rowand <frowand.list@gmail.com>, Krzysztof Kozlowski <krzk+dt@kernel.org>, Li Yang <leoyang.li@nxp.com>, Lucas Stach <l.stach@pengutronix.de>, Matthias Schiffer <matthias.schiffer@ew.tq-group.com>, NXP Linux Team <linux-imx@nxp.com>, Olof Johansson <olof@lixom.net>, Pengutronix Kernel Team <kernel@pengutronix.de>, Rob Herring <robh+dt@kernel.org>, Russell King <linux@armlinux.org.uk>, Sascha Hauer <s.hauer@pengutronix.de>, Sebastian Reichel <sebastian.reichel@collabora.com>, Shawn Guo <shawnguo@kernel.org>, Stefan Agner <stefan@agner.ch>, Tim Harvey <tharvey@gateworks.com>, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, soc@kernel.org Subject: [PATCH v1 00/24] ARM: dts: imx7-colibri: device tree improvements Date: Fri, 6 May 2022 17:27:45 +0200 [thread overview] Message-ID: <20220506152809.295409-1-marcel@ziswiler.com> (raw) From: Marcel Ziswiler <marcel.ziswiler@toradex.com> This is a general update of the Colibri iMX7 device tree files. The Toradex Colibri family is composed of a SoM that can be plugged on various carrier boards, with carrier boards allowing multiple optional accessories (e.g. display, camera, ...). The device tree sources are structured into a SoM dtsi and a carrier dts which then includes the SoM dtsi. The SoM dtsi defines and enables the functionality self-contained on the SoM and prepares for the functionality provided by the carrier HW or accessories so that the carrier dts then can enable or amend nodes provided. Accessories are enabled in overlays depending on HW configuration. Please find the following colibri-imx7 device trees improvements: - Display/Touch Functionality Overhaul Rename display interface to match other modules to make it easier to use device tree overlays. The parallel RGB interface (lcdif) and all related stuff turn on in a device tree overlay. Keep them disabled in the main devicetree. As these subsystems are provided by module and not a part of boards, move their definitions into the module-level devicetree. Disable ad7879 touchscreen which turns on in a devic tree overlay. Remains it disabled in the main devicetree. The Toradex 7" Capacitive and 10" LVDS touch screens are Atmel MXT peripherals available on the I2C bus for touchscreen events. Add atmel_mxt_ts node to the module-level device tree. Also, provide pinmux configuration for the INT/RST inputs from SODIMM pins 106/107 for most carrier boards or an external touchscreen adapter inputs configured to SODIMM pins 28/30. - Ethernet Improvements Add the MDIO bus with the respective PHY. Add Ethernet aliases which is required to properly pass MAC address from bootloader. Add delay for on-module phy supply. - USB Device/Host Switching Add usb dual-role switching using extcon. - MMC/SD The original Colibri specification only defined 3.3 volt TTL signaling and relied on external on-carrier pull-ups for the SD_DATA[0..3] lines. The latest carrier boards like Iris V2 on the other hand are now UHS-I compliant by leaving such external on-carrier pull-ups away relying on module- or even SoC-level ones which pull up to resp. signaling voltage. In such cases, the carrier board-level device tree may explicitly delete the no-1-8-v property to enable full UHS-I support. Also, fix SD/MMC regulator for the carrier boards using UHS-I modes. - Add Iris and Iris V2 Carrier Board Device Trees Add support for Toradex Iris carrier boards. Marcel Ziswiler (18): ARM: dts: imx7-colibri: overhaul display/touch functionality ARM: dts: imx7-colibri: add mdio phy node ARM: dts: imx7-colibri: move aliases, chosen, extcon and gpio-keys ARM: dts: imx7-colibri: move regulators ARM: dts: imx7-colibri: clean-up usdhc1 and add sleep config ARM: dts: imx7-colibri: move rtc node ARM: dts: imx7d-colibri-emmc: add cpu1 supply ARM: dts: imx7-colibri-eval-v3: correct can controller comment ARM: dts: imx7-colibri: disable adc2 ARM: dts: imx7-colibri-aster: add ssp aka spi cs aka ss pins ARM: dts: imx7-colibri: add clarifying comments ARM: dts: imx7-colibri: alphabetical re-order ARM: dts: imx7-colibri: clean-up device enabling/disabling ARM: dts: imx7-colibri: remove leading zero from reg address ARM: dts: imx7-colibri: set regulator-name properties ARM: dts: imx7-colibri: clean-up iomuxc pinctrl group naming dt-bindings: arm: fsl: add toradex,colibri-imx7s/d/d-emmc-iris/-v2 ARM: dts: imx7-colibri: add support for Toradex Iris carrier boards Max Krummenacher (1): ARM: dts: imx7-colibri: add ethernet aliases Oleksandr Suvorov (3): ARM: dts: imx7-colibri: improve licensing and compatible strings ARM: dts: imx7-colibri: improve wake-up with gpio key ARM: dts: imx7-colibri: add delay for on-module phy supply Philippe Schenker (1): ARM: dts: imx7-colibri: add usb dual-role switching using extcon Stefan Agner (1): ARM: dts: imx7-colibri: set lcdif clock source to video pll .../devicetree/bindings/arm/fsl.yaml | 6 + arch/arm/boot/dts/Makefile | 6 + arch/arm/boot/dts/imx6dl-colibri-iris.dts | 9 +- arch/arm/boot/dts/imx7-colibri-aster.dtsi | 142 +-- arch/arm/boot/dts/imx7-colibri-eval-v3.dtsi | 156 +--- arch/arm/boot/dts/imx7-colibri-iris-v2.dtsi | 112 +++ arch/arm/boot/dts/imx7-colibri-iris.dtsi | 108 +++ arch/arm/boot/dts/imx7-colibri.dtsi | 830 +++++++++++------- arch/arm/boot/dts/imx7d-colibri-aster.dts | 30 +- .../arm/boot/dts/imx7d-colibri-emmc-aster.dts | 10 +- .../boot/dts/imx7d-colibri-emmc-eval-v3.dts | 10 +- .../boot/dts/imx7d-colibri-emmc-iris-v2.dts | 21 + arch/arm/boot/dts/imx7d-colibri-emmc-iris.dts | 21 + arch/arm/boot/dts/imx7d-colibri-emmc.dtsi | 17 +- arch/arm/boot/dts/imx7d-colibri-eval-v3.dts | 45 +- arch/arm/boot/dts/imx7d-colibri-iris-v2.dts | 83 ++ arch/arm/boot/dts/imx7d-colibri-iris.dts | 56 ++ arch/arm/boot/dts/imx7d-colibri.dtsi | 13 +- arch/arm/boot/dts/imx7s-colibri-aster.dts | 27 +- arch/arm/boot/dts/imx7s-colibri-eval-v3.dts | 43 +- arch/arm/boot/dts/imx7s-colibri-iris-v2.dts | 78 ++ arch/arm/boot/dts/imx7s-colibri-iris.dts | 51 ++ arch/arm/boot/dts/imx7s-colibri.dtsi | 5 +- 23 files changed, 1295 insertions(+), 584 deletions(-) create mode 100644 arch/arm/boot/dts/imx7-colibri-iris-v2.dtsi create mode 100644 arch/arm/boot/dts/imx7-colibri-iris.dtsi create mode 100644 arch/arm/boot/dts/imx7d-colibri-emmc-iris-v2.dts create mode 100644 arch/arm/boot/dts/imx7d-colibri-emmc-iris.dts create mode 100644 arch/arm/boot/dts/imx7d-colibri-iris-v2.dts create mode 100644 arch/arm/boot/dts/imx7d-colibri-iris.dts create mode 100644 arch/arm/boot/dts/imx7s-colibri-iris-v2.dts create mode 100644 arch/arm/boot/dts/imx7s-colibri-iris.dts -- 2.35.1
WARNING: multiple messages have this Message-ID (diff)
From: Marcel Ziswiler <marcel@ziswiler.com> To: linux-arm-kernel@lists.infradead.org Cc: Marcel Ziswiler <marcel.ziswiler@toradex.com>, Alexander Stein <alexander.stein@ew.tq-group.com>, Ariel D'Alessandro <ariel.dalessandro@collabora.com>, Arnd Bergmann <arnd@arndb.de>, Christoph Niedermaier <cniedermaier@dh-electronics.com>, Fabio Estevam <festevam@gmail.com>, Frank Rowand <frowand.list@gmail.com>, Krzysztof Kozlowski <krzk+dt@kernel.org>, Li Yang <leoyang.li@nxp.com>, Lucas Stach <l.stach@pengutronix.de>, Matthias Schiffer <matthias.schiffer@ew.tq-group.com>, NXP Linux Team <linux-imx@nxp.com>, Olof Johansson <olof@lixom.net>, Pengutronix Kernel Team <kernel@pengutronix.de>, Rob Herring <robh+dt@kernel.org>, Russell King <linux@armlinux.org.uk>, Sascha Hauer <s.hauer@pengutronix.de>, Sebastian Reichel <sebastian.reichel@collabora.com>, Shawn Guo <shawnguo@kernel.org>, Stefan Agner <stefan@agner.ch>, Tim Harvey <tharvey@gateworks.com>, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, soc@kernel.org Subject: [PATCH v1 00/24] ARM: dts: imx7-colibri: device tree improvements Date: Fri, 6 May 2022 17:27:45 +0200 [thread overview] Message-ID: <20220506152809.295409-1-marcel@ziswiler.com> (raw) From: Marcel Ziswiler <marcel.ziswiler@toradex.com> This is a general update of the Colibri iMX7 device tree files. The Toradex Colibri family is composed of a SoM that can be plugged on various carrier boards, with carrier boards allowing multiple optional accessories (e.g. display, camera, ...). The device tree sources are structured into a SoM dtsi and a carrier dts which then includes the SoM dtsi. The SoM dtsi defines and enables the functionality self-contained on the SoM and prepares for the functionality provided by the carrier HW or accessories so that the carrier dts then can enable or amend nodes provided. Accessories are enabled in overlays depending on HW configuration. Please find the following colibri-imx7 device trees improvements: - Display/Touch Functionality Overhaul Rename display interface to match other modules to make it easier to use device tree overlays. The parallel RGB interface (lcdif) and all related stuff turn on in a device tree overlay. Keep them disabled in the main devicetree. As these subsystems are provided by module and not a part of boards, move their definitions into the module-level devicetree. Disable ad7879 touchscreen which turns on in a devic tree overlay. Remains it disabled in the main devicetree. The Toradex 7" Capacitive and 10" LVDS touch screens are Atmel MXT peripherals available on the I2C bus for touchscreen events. Add atmel_mxt_ts node to the module-level device tree. Also, provide pinmux configuration for the INT/RST inputs from SODIMM pins 106/107 for most carrier boards or an external touchscreen adapter inputs configured to SODIMM pins 28/30. - Ethernet Improvements Add the MDIO bus with the respective PHY. Add Ethernet aliases which is required to properly pass MAC address from bootloader. Add delay for on-module phy supply. - USB Device/Host Switching Add usb dual-role switching using extcon. - MMC/SD The original Colibri specification only defined 3.3 volt TTL signaling and relied on external on-carrier pull-ups for the SD_DATA[0..3] lines. The latest carrier boards like Iris V2 on the other hand are now UHS-I compliant by leaving such external on-carrier pull-ups away relying on module- or even SoC-level ones which pull up to resp. signaling voltage. In such cases, the carrier board-level device tree may explicitly delete the no-1-8-v property to enable full UHS-I support. Also, fix SD/MMC regulator for the carrier boards using UHS-I modes. - Add Iris and Iris V2 Carrier Board Device Trees Add support for Toradex Iris carrier boards. Marcel Ziswiler (18): ARM: dts: imx7-colibri: overhaul display/touch functionality ARM: dts: imx7-colibri: add mdio phy node ARM: dts: imx7-colibri: move aliases, chosen, extcon and gpio-keys ARM: dts: imx7-colibri: move regulators ARM: dts: imx7-colibri: clean-up usdhc1 and add sleep config ARM: dts: imx7-colibri: move rtc node ARM: dts: imx7d-colibri-emmc: add cpu1 supply ARM: dts: imx7-colibri-eval-v3: correct can controller comment ARM: dts: imx7-colibri: disable adc2 ARM: dts: imx7-colibri-aster: add ssp aka spi cs aka ss pins ARM: dts: imx7-colibri: add clarifying comments ARM: dts: imx7-colibri: alphabetical re-order ARM: dts: imx7-colibri: clean-up device enabling/disabling ARM: dts: imx7-colibri: remove leading zero from reg address ARM: dts: imx7-colibri: set regulator-name properties ARM: dts: imx7-colibri: clean-up iomuxc pinctrl group naming dt-bindings: arm: fsl: add toradex,colibri-imx7s/d/d-emmc-iris/-v2 ARM: dts: imx7-colibri: add support for Toradex Iris carrier boards Max Krummenacher (1): ARM: dts: imx7-colibri: add ethernet aliases Oleksandr Suvorov (3): ARM: dts: imx7-colibri: improve licensing and compatible strings ARM: dts: imx7-colibri: improve wake-up with gpio key ARM: dts: imx7-colibri: add delay for on-module phy supply Philippe Schenker (1): ARM: dts: imx7-colibri: add usb dual-role switching using extcon Stefan Agner (1): ARM: dts: imx7-colibri: set lcdif clock source to video pll .../devicetree/bindings/arm/fsl.yaml | 6 + arch/arm/boot/dts/Makefile | 6 + arch/arm/boot/dts/imx6dl-colibri-iris.dts | 9 +- arch/arm/boot/dts/imx7-colibri-aster.dtsi | 142 +-- arch/arm/boot/dts/imx7-colibri-eval-v3.dtsi | 156 +--- arch/arm/boot/dts/imx7-colibri-iris-v2.dtsi | 112 +++ arch/arm/boot/dts/imx7-colibri-iris.dtsi | 108 +++ arch/arm/boot/dts/imx7-colibri.dtsi | 830 +++++++++++------- arch/arm/boot/dts/imx7d-colibri-aster.dts | 30 +- .../arm/boot/dts/imx7d-colibri-emmc-aster.dts | 10 +- .../boot/dts/imx7d-colibri-emmc-eval-v3.dts | 10 +- .../boot/dts/imx7d-colibri-emmc-iris-v2.dts | 21 + arch/arm/boot/dts/imx7d-colibri-emmc-iris.dts | 21 + arch/arm/boot/dts/imx7d-colibri-emmc.dtsi | 17 +- arch/arm/boot/dts/imx7d-colibri-eval-v3.dts | 45 +- arch/arm/boot/dts/imx7d-colibri-iris-v2.dts | 83 ++ arch/arm/boot/dts/imx7d-colibri-iris.dts | 56 ++ arch/arm/boot/dts/imx7d-colibri.dtsi | 13 +- arch/arm/boot/dts/imx7s-colibri-aster.dts | 27 +- arch/arm/boot/dts/imx7s-colibri-eval-v3.dts | 43 +- arch/arm/boot/dts/imx7s-colibri-iris-v2.dts | 78 ++ arch/arm/boot/dts/imx7s-colibri-iris.dts | 51 ++ arch/arm/boot/dts/imx7s-colibri.dtsi | 5 +- 23 files changed, 1295 insertions(+), 584 deletions(-) create mode 100644 arch/arm/boot/dts/imx7-colibri-iris-v2.dtsi create mode 100644 arch/arm/boot/dts/imx7-colibri-iris.dtsi create mode 100644 arch/arm/boot/dts/imx7d-colibri-emmc-iris-v2.dts create mode 100644 arch/arm/boot/dts/imx7d-colibri-emmc-iris.dts create mode 100644 arch/arm/boot/dts/imx7d-colibri-iris-v2.dts create mode 100644 arch/arm/boot/dts/imx7d-colibri-iris.dts create mode 100644 arch/arm/boot/dts/imx7s-colibri-iris-v2.dts create mode 100644 arch/arm/boot/dts/imx7s-colibri-iris.dts -- 2.35.1 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
next reply other threads:[~2022-05-06 15:29 UTC|newest] Thread overview: 58+ messages / expand[flat|nested] mbox.gz Atom feed top 2022-05-06 15:27 Marcel Ziswiler [this message] 2022-05-06 15:27 ` [PATCH v1 00/24] ARM: dts: imx7-colibri: device tree improvements Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 01/24] ARM: dts: imx7-colibri: overhaul display/touch functionality Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 02/24] ARM: dts: imx7-colibri: add mdio phy node Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 03/24] ARM: dts: imx7-colibri: set lcdif clock source to video pll Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 04/24] ARM: dts: imx7-colibri: add usb dual-role switching using extcon Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 05/24] ARM: dts: imx7-colibri: improve licensing and compatible strings Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 06/24] ARM: dts: imx7-colibri: improve wake-up with gpio key Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 07/24] ARM: dts: imx7-colibri: move aliases, chosen, extcon and gpio-keys Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 08/24] ARM: dts: imx7-colibri: add ethernet aliases Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 09/24] ARM: dts: imx7-colibri: move regulators Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 10/24] ARM: dts: imx7-colibri: add delay for on-module phy supply Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 11/24] ARM: dts: imx7-colibri: clean-up usdhc1 and add sleep config Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 12/24] ARM: dts: imx7-colibri: move rtc node Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 13/24] ARM: dts: imx7d-colibri-emmc: add cpu1 supply Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:27 ` [PATCH v1 14/24] ARM: dts: imx7-colibri-eval-v3: correct can controller comment Marcel Ziswiler 2022-05-06 15:27 ` Marcel Ziswiler 2022-05-06 15:28 ` [PATCH v1 15/24] ARM: dts: imx7-colibri: disable adc2 Marcel Ziswiler 2022-05-06 15:28 ` Marcel Ziswiler 2022-05-06 15:28 ` [PATCH v1 16/24] ARM: dts: imx7-colibri-aster: add ssp aka spi cs aka ss pins Marcel Ziswiler 2022-05-06 15:28 ` Marcel Ziswiler 2022-05-06 15:28 ` [PATCH v1 17/24] ARM: dts: imx7-colibri: add clarifying comments Marcel Ziswiler 2022-05-06 15:28 ` Marcel Ziswiler 2022-05-06 15:28 ` [PATCH v1 18/24] ARM: dts: imx7-colibri: alphabetical re-order Marcel Ziswiler 2022-05-06 15:28 ` Marcel Ziswiler 2022-05-06 15:28 ` [PATCH v1 19/24] ARM: dts: imx7-colibri: clean-up device enabling/disabling Marcel Ziswiler 2022-05-06 15:28 ` Marcel Ziswiler 2022-05-06 15:46 ` [PATCH v1 00/24] ARM: dts: imx7-colibri: device tree improvements Marcel Ziswiler 2022-05-06 15:46 ` Marcel Ziswiler 2022-05-06 15:46 ` [PATCH v1 19/24] ARM: dts: imx7-colibri: clean-up device enabling/disabling Marcel Ziswiler 2022-05-06 15:46 ` Marcel Ziswiler 2022-05-06 15:47 ` [PATCH v1 20/24] ARM: dts: imx7-colibri: remove leading zero from reg address Marcel Ziswiler 2022-05-06 15:47 ` Marcel Ziswiler 2022-05-06 15:48 ` [PATCH v1 21/24] ARM: dts: imx7-colibri: set regulator-name properties Marcel Ziswiler 2022-05-06 15:48 ` Marcel Ziswiler 2022-05-06 15:48 ` [PATCH v1 22/24] ARM: dts: imx7-colibri: clean-up iomuxc pinctrl group naming Marcel Ziswiler 2022-05-06 15:48 ` Marcel Ziswiler 2022-05-06 15:56 ` [PATCH v1 23/24] dt-bindings: arm: fsl: add toradex,colibri-imx7s/d/d-emmc-iris/-v2 Marcel Ziswiler 2022-05-06 15:56 ` [PATCH v1 23/24] dt-bindings: arm: fsl: add toradex, colibri-imx7s/d/d-emmc-iris/-v2 Marcel Ziswiler 2022-05-09 11:03 ` [PATCH v1 23/24] dt-bindings: arm: fsl: add toradex,colibri-imx7s/d/d-emmc-iris/-v2 Krzysztof Kozlowski 2022-05-09 11:03 ` Krzysztof Kozlowski 2022-05-06 15:58 ` [PATCH v1 24/24] ARM: dts: imx7-colibri: add support for Toradex Iris carrier boards Marcel Ziswiler 2022-05-06 15:58 ` Marcel Ziswiler 2022-05-06 21:32 ` Marcel Ziswiler 2022-05-06 21:32 ` Marcel Ziswiler
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20220506152809.295409-1-marcel@ziswiler.com \ --to=marcel@ziswiler.com \ --cc=alexander.stein@ew.tq-group.com \ --cc=ariel.dalessandro@collabora.com \ --cc=arnd@arndb.de \ --cc=cniedermaier@dh-electronics.com \ --cc=devicetree@vger.kernel.org \ --cc=festevam@gmail.com \ --cc=frowand.list@gmail.com \ --cc=kernel@pengutronix.de \ --cc=krzk+dt@kernel.org \ --cc=l.stach@pengutronix.de \ --cc=leoyang.li@nxp.com \ --cc=linux-arm-kernel@lists.infradead.org \ --cc=linux-imx@nxp.com \ --cc=linux-kernel@vger.kernel.org \ --cc=linux@armlinux.org.uk \ --cc=marcel.ziswiler@toradex.com \ --cc=matthias.schiffer@ew.tq-group.com \ --cc=olof@lixom.net \ --cc=robh+dt@kernel.org \ --cc=s.hauer@pengutronix.de \ --cc=sebastian.reichel@collabora.com \ --cc=shawnguo@kernel.org \ --cc=soc@kernel.org \ --cc=stefan@agner.ch \ --cc=tharvey@gateworks.com \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.