Skip to content

Yocto Recovery SD Card

Variscite provides a recovery SD card image that can be used to install the pre-built U-Boot, Linux kernel, and filesystem into the internal storage of the SOM.

Download the recovery SD card image

Download the latest recovery SD card from Variscite:

wget https://variscite-public.nyc3.cdn.digitaloceanspaces.com/VAR-SOM-MX6/Software/mx6__yocto-scarthgap-6.6.23_2.0.0-v1.0__android-8.0.0_1.0.0-v1.0.wic.zst

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?*

zstdcat mx6__yocto-scarthgap-6.6.23_2.0.0-v1.0__android-8.0.0_1.0.0-v1.0.wic.zst | \
  sudo dd of=/dev/sdX bs=1M && sync

Replace /dev/sdX with your actual device.

Using a Windows-based host

  • Download Rufus from https://rufus.ie/ and install it.
  • Extract the downloaded image using the latest 7-Zip.
  • 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 Rufus.
  • If the SD card (Device) you are using isn’t found automatically, click on the drop-down box and select it.
  • In the Boot selection field, choose the .img/.wic file you extracted previously.
  • Click Start.
  • After a few minutes, you receive a notification that your SD has been created successfully.

Using a Mac OS X host

Use the latest 7-Zip to extract the image, then use bmaptool when a .bmap file is available, or dd, 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 Mode is set to SD card
  • Power up the board - it will boot into Linux from the SD card

Flash from command line

  • Log in as root (no password)
  • From Linux command line, run the following script:
install_yocto.sh

Install Yocto to the SOM's internal storage and follow the printed instructions.

SD card image file tree

The install_yocto.sh script file is located at /usr/bin/