Debian Recovery SD card: Difference between revisions

From Variscite Wiki
No edit summary
No edit summary
 
(17 intermediate revisions by 4 users not shown)
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_STRETCH_V1.0_DART-MX8M as default
--> {{#vardefine:RELEASE_PARAM|{{#urlget:release}}}} <!--
--> {{INIT_RELEASE_PARAM|RELEASE_STRETCH_V1.0_DART-MX8M}} <!--
--> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM|RELEASE_STRETCH_V1.0_DART-MX8M}}}} <!--
--> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
-->{{PageHeader|{{#var:HARDWARE_NAME}} - Debian recovery SD card}} {{DocImage|category1={{#var:HARDWARE_NAME}}|category2=Debian}}
-->{{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.
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 {{#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's FTP server: {{#var:RECOVERY_SD_URL}}<br>
{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX8X |{{#ifeq: {{#var:MACHINE_NAME_B0}} | imx8qxpb0-var-som |
{{Note|'''Note:''' Some web browsers have removed FTP support. Please see our [[FTP|FTP wiki page]].|info}}
<br>
<br>{{#ifeq: {{#var:HARDWARE_NAME}} | VAR-SOM-MX8X | {{#ifeq: {{#var:MACHINE_NAME_B0}} | imx8qxpb0-var-som |
'''Or, for i.MXQXP SOC revision B0:''' <br>
Note that i.MXQXP SOC revisions B0 and C0 each require a slightly different recovery SD card image (with their appropriate bootloader):<br>
Download {{#var:RECOVERY_SD_NAME_B0}} from Variscite's FTP server: ftp://customerv:Variscite1@ftp.variscite.com/{{#var:HARDWARE_NAME}}/Software/debian/
For i.MXQXP SOC revisions B0 download '''{{#var:RECOVERY_SD_NAME}}'''<br>
|}}|}}
For i.MXQXP SOC revisions C0 download '''{{#var:RECOVERY_SD_NAME_B0}}'''|}}|}}
 
The easiest way to download files from an FTP server using the Linux command line is to use wget:<br>
 
$ 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}}}}


== Write the image to an SD card ==
== Write the image to an SD card ==
{{note|'''Note:''' During the SD card image writing all files and partitions are erased from target device.<br> Double check that the device is correct to avoid accidentally overwriting a different device and potentially damaging your existing operating system.|info}}
=== 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)
Line 20: Line 26:
$ gunzip mx8mm-dart-debian-recovery-sd.vXX.img.gz
$ gunzip mx8mm-dart-debian-recovery-sd.vXX.img.gz
$ sudo umount /dev/sdX*
$ sudo umount /dev/sdX*
$ sudo dd if=mx8mm-dart-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M; sync
$ sudo dd if=mx8mm-dart-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M conv=fsync status=progress; sync
 
(Replace /dev/sdX with your actual device)
</pre>
|
{{#ifeq: {{#var:HARDWARE_NAME}} | DART-MX8M-PLUS |
<pre>
$ gunzip dart-mx8mp-debian-recovery-sd.vXX.img.gz
$ sudo umount /dev/sdX*
$ sudo dd if=dart-mx8mp-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M conv=fsync status=progress; sync


(Replace /dev/sdX with your actual device)
(Replace /dev/sdX with your actual device)
Line 29: Line 44:
$ gunzip mx8qxp-var-som-debian-recovery-sd.vXX.img.gz
$ gunzip mx8qxp-var-som-debian-recovery-sd.vXX.img.gz
$ sudo umount /dev/sdX*
$ sudo umount /dev/sdX*
$ sudo dd if=mx8qxp-var-som-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M; sync
$ sudo dd if=mx8qxp-var-som-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M conv=fsync status=progress; sync


(Replace /dev/sdX with your actual device)
(Replace /dev/sdX with your actual device)
Line 37: Line 52:
$ gunzip mx8m-dart-debian-recovery-sd.vXX.img.gz
$ gunzip mx8m-dart-debian-recovery-sd.vXX.img.gz
$ sudo umount /dev/sdX*
$ sudo umount /dev/sdX*
$ sudo dd if=mx8m-dart-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M; sync
$ sudo dd if=mx8m-dart-debian-recovery-sd.vXX.img of=/dev/sdX bs=1M conv=fsync status=progress; sync


(Replace /dev/sdX with your actual device)
(Replace /dev/sdX with your actual device)
</pre>
</pre>
}}
}}
}}
}}
}}


=== Using a Windows based host ===
=== Using a Windows based host ===
Download Win32 Disk Imager from: https://sourceforge.net/projects/win32diskimager/, install and run it.<br>
* Download Win32 Disk Imager from: https://sourceforge.net/projects/win32diskimager/ and install it.
Select the image file, and the SD card device - double check that the device is correct to avoid accidentally overwriting a different device.<br>
* Extract downloaded <image name>.img.gz file to get <image name>.img (using [http://www.7-zip.org/ 7-Zip] for example)
Click on "Write".<br>
* Insert your SD card into your PC. <br>No need to format the SD card before writing the image to it, as the card will be formatted once it will be flashed.
No need to format the SD card before writing the image to it.<br>
* 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 <image name>.img 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 [https://www.thefanclub.co.za/how-to/dd-utility-write-and-backup-operating-system-img-files-memory-card-mac-os-x dd Utility for MAC OS X] to flash .img files to your SD card.


== Recover NAND flash/eMMC ==
== Recover NAND flash/eMMC ==
Line 57: Line 80:


=== Flash from command line ===
=== Flash from command line ===
* Login as root (password root)
* Login as root (password 'root')
* From Linux command line, type the following
* From Linux command line, type the following
<pre>
<pre>

Latest revision as of 22:09, 6 April 2023

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

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

  1. Visit variwiki.com
  2. Select your SoM
  3. 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/stretch-4.14.78-mx8m-v1.0.img.gz 

Write the image to an SD card

Note: 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)

$ 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 conv=fsync status=progress; 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 downloaded <image name>.img.gz file to get <image name>.img (using 7-Zip 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 <image name>.img 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 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/