DART-6UL Debian Recovery SD card: Difference between revisions

Latest revision as of 21:11, 22 August 2024

DART-6UL Debian Recovery SD card

Variscite provides a recovery SD card image that can be used to install the pre-built Debian images into the internal storage device of the SOM.

Download the recovery SD card image

Download var-mx6ul-debian-recovery-sd.vXX.img.gz (latest) from Variscite's FTP server: sftp://customerv@ftp.variscite.com/Public/DART-6UL/Software/debian/

For more information about Variscite's FTP server, see: https://variwiki.com/index.php?title=FTP

See the detailed changelog

Write the image to an SD card

Using a Linux based host

Plug-in the SD card to your Linux HOST PC, run dmesg and see which device is added (i.e. /dev/sdX or /dev/mmcblkX)

$ gunzip var-mx6ul-debian-recovery-sd.vXX.img.gz
$ sudo umount /dev/sdX*
$ sudo dd if=var-mx6ul-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M; sync

(Replace /dev/sdX with your actual device)

Using a Windows based host

Download Win32 Disk Imager from: https://sourceforge.net/projects/win32diskimager/, install and run it.
Select the image file, and the SD card device - double check that the device is correct to avoid accidentally overwriting a different device.
Click on "Write".
No need to format the SD card before writing the image to it.

Recover NAND flash/eMMC

Power-off the board.
Insert the SD card into the SD card slot of the carrier board (DVK)
Make sure the Boot DIP switches are set to SD card: Setting the Boot Mode
Power up the board - it will boot into Linux from the SD card

Flash from command line

Login as root (password root)
From Linux command line, type the following

# debian-nand.sh - Flash Debian into NAND flash (for SOMs with NAND flash)

In case you are using a SOM with eMMC, run the following command as root to install Debian on it:

# debian-emmc.sh - Flash Debian into eMMC (for SOMs with eMMC)

SD card image file tree

/opt/images/
└── Yocto
    ├── imx6ull-var-dart-6ulcustomboard-emmc-sd-card.dtb
    ├── imx6ull-var-dart-6ulcustomboard-emmc-wifi.dtb
    ├── imx6ull-var-dart-6ulcustomboard-nand-sd-card.dtb
    ├── imx6ull-var-dart-6ulcustomboard-nand-wifi.dtb
    ├── imx6ull-var-som-concerto-board-emmc-sd-card.dtb
    ├── imx6ull-var-som-concerto-board-emmc-wifi.dtb
    ├── imx6ull-var-som-concerto-board-nand-sd-card.dtb
    ├── imx6ull-var-som-concerto-board-nand-wifi.dtb
    ├── imx6ul-var-dart-6ulcustomboard-emmc-sd-card.dtb
    ├── imx6ul-var-dart-6ulcustomboard-emmc-wifi.dtb
    ├── imx6ul-var-dart-6ulcustomboard-nand-sd-card.dtb
    ├── imx6ul-var-dart-6ulcustomboard-nand-wifi.dtb
    ├── imx6ul-var-som-concerto-board-emmc-sd-card.dtb
    ├── imx6ul-var-som-concerto-board-emmc-wifi.dtb
    ├── imx6ul-var-som-concerto-board-nand-sd-card.dtb
    ├── imx6ul-var-som-concerto-board-nand-wifi.dtb
    ├── imx6ulz-var-dart-6ulcustomboard-emmc-sd-card.dtb
    ├── imx6ulz-var-dart-6ulcustomboard-emmc-wifi.dtb
    ├── imx6ulz-var-dart-6ulcustomboard-nand-sd-card.dtb
    ├── imx6ulz-var-dart-6ulcustomboard-nand-wifi.dtb
    ├── imx6ulz-var-som-concerto-board-emmc-sd-card.dtb
    ├── imx6ulz-var-som-concerto-board-emmc-wifi.dtb
    ├── imx6ulz-var-som-concerto-board-nand-sd-card.dtb
    ├── imx6ulz-var-som-concerto-board-nand-wifi.dtb
    ├── rootfs.tar.gz
    ├── rootfs.ubi.img
    ├── SPL.mmc
    ├── SPL.nand
    ├── u-boot.img.mmc
    ├── u-boot.img.nand
    └── zImage

The debian-emmc.sh and debian-nand.sh script files are located at /usr/sbin/

@@ Line 1: / Line 1: @@
-{{PageHeader|DART-6UL - Debian recovery SD card}} {{DocImage|category1=DART-6UL|category2=Debian}}
+<!-- Set release according to "release" parameter in URL and use RELEASE_STRETCH_V3.0_DART-6UL as default
+--> {{#vardefine:RELEASE_PARAM|{{#urlget:release}}}} <!--
+--> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM|RELEASE_STRETCH_V3.0_DART-6UL}}}} <!--
+--> {{PageHeader|{{#var:HARDWARE_NAME}} Debian Recovery SD card}} {{DocImage|category1={{#var:HARDWARE_NAME}}|category2=Debian|}} __toc__
 Variscite provides a recovery SD card image that can be used to install the pre-built Debian images into the internal storage device of the SOM.
 == Download the recovery SD card image ==
-Download mx6ul-dart-debian-recovery-sd.vXX.img.gz (latest) from Variscite's FTP server: ftp://customerv:Variscite1@ftp.variscite.com/DART-6UL/Software/debian/
+Download {{#ifexpr: {{#var:DEBIAN_VERSION}} >= 10 | {{#var:RECOVERY_SD_NAME}} | var-mx6ul-debian-recovery-sd.vXX.img.gz (latest) }} from Variscite's FTP server: sftp://customerv@ftp.variscite.com/Public/DART-6UL/Software/debian/<br>
+For more information about Variscite's FTP server, see: https://variwiki.com/index.php?title=FTP
+See the detailed [https://variscite-public.nyc3.cdn.digitaloceanspaces.com/DART-6UL/Software/debian/var-mx6ul-debian-recovery-sd.changelog changelog]
 == Write the image to an SD card ==
 === Using a Linux based host ===
 Plug-in the SD card to your Linux HOST PC, run dmesg and see which device is added (i.e. /dev/sdX or /dev/mmcblkX)
-<pre>
-$ gunzip mx6ul-dart-debian-recovery-sd.vXX.img.gz
+ $ gunzip {{#ifexpr: {{#var:DEBIAN_VERSION}} >= 10 | {{#var:RECOVERY_SD_NAME}} | var-mx6ul-debian-recovery-sd.vXX.img.gz }}
-$ sudo umount /dev/sdX*
+ $ sudo umount /dev/sdX*
-$ sudo dd if=mx6ul-dart-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M; sync
+ $ sudo dd if={{#ifexpr: {{#var:DEBIAN_VERSION}} >= 10 | {{#var:DEBIAN_TAG}}.img | var-mx6ul-debian-recovery-sd.vXX.img }} of=/dev/sdX bs=1M; sync
 (Replace /dev/sdX with your actual device)
-</pre>
 === Using a Windows based host ===
@@ Line 25: / Line 32: @@
 * Power-off the board.
 * Insert the SD card into the SD card slot of the carrier board (DVK)
-* Make sure the Boot DIP switches are set to SD card: [[DART-6UL_Debian_Jessie_MX6UL_R3#Setting_board_dip-switches|Setting the Boot DIP switches]]
+* Make sure the Boot DIP switches are set to SD card: {{Varlink|Debian_Build_Release#Setting the Boot Mode|{{#var:RELEASE_LINK}}|Setting the Boot Mode}}
 * Power up the board - it will boot into Linux from the SD card
 === Flash from command line ===
-* Login as root (no password)
+* Login as root (password root)
 * From Linux command line, type the following
+{{#ifeq: {{#var:DEBIAN_INSTALL_SCRIPT}} | unified |
+<pre>
+# install_debian.sh -r nand (Follow instructions)
+</pre>
+|
 <pre>
-$ debian-emmc.sh	- Flash Debian into eMMC (for SOMs with eMMC)
+# debian-nand.sh - Flash Debian into NAND flash (for SOMs with NAND flash)
+</pre>
-$ debian-nand.sh	- Flash Debian into NAND flash (for SOMs with NAND flash)
+}}
+In case you are using a SOM with eMMC, run the following command '''as root''' to install Debian on it:
+{{#ifeq: {{#var:DEBIAN_INSTALL_SCRIPT}} | unified |
+<pre>
+# install_debian.sh -r emmc (Follow instructions)
+</pre>
+|
+<pre>
+# debian-emmc.sh - Flash Debian into eMMC (for SOMs with eMMC)
 </pre>
+}}
 === SD card image file tree ===
-<pre>
+{{#lst:Debian_Platform_Customization|{{#var:SD_TREE_SECTION}}}}
-/opt/images/
-└── Debian
-    ├── imx6ul-var-dart-emmc_wifi.dtb
-    ├── imx6ul-var-dart-nand_wifi.dtb
-    ├── imx6ul-var-dart-sd_emmc.dtb
-    ├── imx6ul-var-dart-sd_nand.dtb
-    ├── rootfs.tar.bz2
-    ├── rootfs.ubi.img
-    ├── SPL.mmc
-    ├── SPL.nand
-    ├── u-boot.img.mmc
-    ├── u-boot.img.nand
-    └── zImage
-</pre>
 <pre>
 The debian-emmc.sh and debian-nand.sh script files are located at /usr/sbin/
 </pre>