Debian Recovery SD card: Difference between revisions

Latest revision as of 14:31, 14 April 2024

Warning: This page is designed to be used with a 'release' URL parameter.

This page is using the default release RELEASE_BUSTER_V3.1_DART-MX8M.
To view this page for a specific Variscite SoM and software release, please follow these steps:

Visit variwiki.com
Select your SoM
Select the software release

DART-MX8M - 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 the latest recovery SD card from Variscite: mx8mq-dart-debian-recovery-sd.v31.img.gz

The easiest way to download files from the file server using the Linux command line is to use wget:

$ wget https://variscite-public.nyc3.cdn.digitaloceanspaces.com/DART-MX8M/Software/debian/mx8mq-dart-debian-recovery-sd.v31.img.gz

Write the image to an SD card

During the SD card image writing all files and partitions are erased from target device.
Double check that the device is correct to avoid accidentally overwriting a different device and potentially damaging your existing operating system.

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)

$ sudo umount /dev/sdX?*

# For img.gz files:
$ zcat <image name>.img.gz | sudo dd 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/ and install it.
Extract the downloaded image:
- For extracting a .gz file the latest 7-Zip can be used, for example.
- For extracting a .zst file the latest WinRAR can be used, for example.
Insert your SD card into your PC.
No need to format the SD card before writing the image to it, as the card will be formatted once it will be flashed.
Run the file named Win32DiskImager.exe (in Windows 7, 8 and 10 we recommend that you right-click this file and choose “Run as administrator”).
If the SD card (Device) you are using isn’t found automatically. Click on the drop down box and select it.
In the Image File box, choose the .img/.wic file you have extracted previously.
Click Write.
After a few minutes, you receive a notification that your SD has been created successfully.

Using a Mac OS X host

Use the dd Utility for MAC OS X to flash .img/.wic files to your SD card

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

$ install_debian.sh	- Flash Debian into eMMC

SD card image file tree

/opt/images/
└── Debian
    ├── rootfs.tar.gz
    └── imx-boot-sd.bin

The install_debian.sh script file is located at /usr/sbin/

@@ Line 1: / Line 1: @@
-<!-- Set release according to "release" parameter in URL and use RELEASE_STRETCH_V1.0_DART-MX8M as default
+<!-- Set release according to "release" parameter in URL and use RELEASE_BUSTER_V3.1_DART-MX8M as default
---> {{#vardefine:RELEASE_PARAM|{{#urlget:release}}}} <!--
+--> {{INIT_RELEASE_PARAM|RELEASE_BUSTER_V3.1_DART-MX8M}} <!--
---> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM|RELEASE_STRETCH_V1.0_DART-MX8M}}}} <!--
+--> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
+--> {{COMMON_DEBIAN_VARS}} <!--
 -->{{PageHeader|{{#var:HARDWARE_NAME}} - Debian recovery SD card}} {{DocImage|category1={{#var:HARDWARE_NAME}}|category2=Debian}}
 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:RECOVERY_SD_NAME}} from Variscite's FTP server: ftp://customerv:Variscite1@ftp.variscite.com/{{#var:HARDWARE_NAME}}/Software/debian/
+Download the latest recovery SD card from Variscite: [{{#var:RECOVERY_SD_URL}}/{{#var:RECOVERY_SD_NAME}} {{#var:RECOVERY_SD_NAME}}]
-== Write the image to an SD card ==
+{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX8X | {{#ifeq: {{#var:MACHINE_NAME_B0}} | imx8qxpb0-var-som |
-=== Using a Linux based host ===
+Note that i.MXQXP SOC revisions B0 and C0 each require a slightly different recovery SD card image (with their appropriate bootloader):<br>
-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)
+For i.MXQXP SOC revisions B0 download '''{{#var:RECOVERY_SD_NAME}}'''<br>
-{{#ifeq: {{#var:HARDWARE_NAME}} | DART-MX8M-MINI |
+For i.MXQXP SOC revisions C0 download '''{{#var:RECOVERY_SD_NAME_B0}}'''|}}|}}
-<pre>
-$ gunzip mx8mm-dart-debian-recovery-sd.vXX.img.gz
-$ sudo umount /dev/sdX*
-$ sudo dd if=mx8mm-dart-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M; sync
-(Replace /dev/sdX with your actual device)
+The easiest way to download files from the file server using the Linux command line is to use wget:<br>
-</pre>
-|
-{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX8X |
-<pre>
-$ gunzip mx8qxp-var-som-debian-recovery-sd.vXX.img.gz
-$ sudo umount /dev/sdX*
-$ sudo dd if=mx8qxp-var-som-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M; sync
-(Replace /dev/sdX with your actual device)
+ $ wget {{#var:RECOVERY_SD_URL}}/{{#var:RECOVERY_SD_NAME}} {{#if: {{#var: RECOVERY_SD_NAME_B0 }} | <br>or, for the i.MX8X rev. B0 image:<br>$ wget {{#var:RECOVERY_SD_URL}}/{{#var:RECOVERY_SD_NAME_B0}}}}
-</pre>
-|
-<pre>
-$ gunzip mx8m-dart-debian-recovery-sd.vXX.img.gz
-$ sudo umount /dev/sdX*
-$ sudo dd if=mx8m-dart-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M; sync
-(Replace /dev/sdX with your actual device)
-</pre>
-}}
-}}
-=== Using a Windows based host ===
+<!-- Section: Write the image to an SD card -->
-Download Win32 Disk Imager from: https://sourceforge.net/projects/win32diskimager/, install and run it.<br>
+{{:Recovery_SD_card_general}}
-Select the image file, and the SD card device - double check that the device is correct to avoid accidentally overwriting a different device.<br>
-Click on "Write".<br>
-No need to format the SD card before writing the image to it.<br>
 == Recover NAND flash/eMMC ==
@@ Line 52: / Line 28: @@
 === Flash from command line ===
-* Login as root (password root)
+* Login as root (password 'root')
 * From Linux command line, type the following
 <pre>
-$ debian-emmc.sh	- Flash Debian into eMMC
+$ install_debian.sh	- Flash Debian into eMMC
 </pre>
@@ Line 67: / Line 43: @@
 <pre>
-The debian-emmc.sh script file is located at /usr/sbin/
+The install_debian.sh script file is located at /usr/sbin/
 </pre>