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

From Variscite Wiki
 
(15 intermediate revisions by 3 users not shown)
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.
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 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: ftp://customerv:Variscite1@ftp.variscite.com/DART-6UL/Software/debian/<br>
See the detailed [ftp://customerv:Variscite1@ftp.variscite.com/DART-6UL/Software/debian/var-mx6ul-debian-recovery-sd.changelog changelog]


== Write the image to an SD card ==
== Write the image to an SD card ==
=== Using a Linux based host ===
=== 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)
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)
(Replace /dev/sdX with your actual device)
</pre>


=== Using a Windows based host ===
=== Using a Windows based host ===
Line 25: Line 29:
* Power-off the board.
* Power-off the board.
* Insert the SD card into the SD card slot of the carrier board (DVK)
* 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
* Power up the board - it will boot into Linux from the SD card


=== Flash from command line ===
=== Flash from command line ===
* Login as root (no password)
* Login as root (password root)
* From Linux command line, type the following
* From Linux command line, type the following
{{#ifeq: {{#var:DEBIAN_INSTALL_SCRIPT}} | unified |
<pre>
<pre>
$ debian-emmc.sh - Flash Debian into eMMC (for SOMs with eMMC)
# install_debian.sh -r nand (Follow instructions)
 
</pre>
$ 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)
</pre>
}}
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>
</pre>
}}


=== SD card image file tree ===
=== SD card image file tree ===
<pre>
{{#lst:Debian_Platform_Customization|{{#var:SD_TREE_SECTION}}}}
/opt/images/
└── Debian
    ├── imx6ull-var-dart-5g-emmc_wifi.dtb
    ├── imx6ull-var-dart-5g-nand_wifi.dtb
    ├── imx6ull-var-dart-emmc_wifi.dtb
    ├── imx6ull-var-dart-nand_wifi.dtb
    ├── imx6ull-var-dart-sd_emmc.dtb
    ├── imx6ull-var-dart-sd_nand.dtb
    ├── imx6ul-var-dart-5g-emmc_wifi.dtb
    ├── imx6ul-var-dart-5g-nand_wifi.dtb
    ├── 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>
<pre>
The debian-emmc.sh and debian-nand.sh script files are located at /usr/sbin/
The debian-emmc.sh and debian-nand.sh script files are located at /usr/sbin/
</pre>
</pre>

Latest revision as of 21:08, 14 October 2021

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: ftp://customerv:Variscite1@ftp.variscite.com/DART-6UL/Software/debian/
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/