Debian Recovery SD card: Difference between revisions

Revision as of 14:23, 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's FTP server: https://variscite-public.nyc3.cdn.digitaloceanspaces.com/DART-MX8M/Software/debian

Note: Some web browsers have removed FTP support. Please see our FTP wiki page.

The easiest way to download files from an FTP 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
---> {{INIT_RELEASE_PARAM|RELEASE_STRETCH_V1.0_DART-MX8M}} <!--
+--> {{INIT_RELEASE_PARAM|RELEASE_BUSTER_V3.1_DART-MX8M}} <!--
 --> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
 --> {{COMMON_DEBIAN_VARS}} <!--