Skip to content

USB armory - Debian base image release 20200714

Compare
Choose a tag to compare
@andrejro andrejro released this 14 Jul 14:25
· 156 commits to master since this release

This release contains the Debian base operating system image provided as reference for booting, and start developing on, the USB armory board.

The base image consists of a standard Linux distribution (Debian) prepared with the process outlined in the usbarmory-debian-base_image repository.

Installation

IMPORTANT: <path to raw file> must be replaced with the uncompressed raw file (e.g. not the .xz file) matching your USB armory model and boot media.

IMPORTANT: /dev/sdX, /dev/diskN must be replaced with your microSD device (not eventual microSD partitions), ensure that you are specifying the correct one. Errors in target specification will result in disk corruption.

NOTE: Remember to uncompress the downloaded image file before imaging.

Linux (verify target from terminal using dmesg):

sudo dd if=<path to raw file> of=/dev/sdX bs=1M conv=fsync

Mac OS X (verify target from terminal with diskutil list):

sudo dd if=<path to raw file> of=/dev/rdiskN bs=1m

On Windows, and other OSes, alternatively the Etcher utility can be used.

Connecting

After being booted, the image uses Ethernet over USB emulation (CDC Ethernet) to communicate with the host, with assigned IP address 10.0.0.1 (using 10.0.0.2 as gateway). Connection can be accomplished via SSH to 10.0.0.1, with default user usbarmory and password usbarmory. NOTE: There is a DHCP server running by default. Alternatively the host interface IP address can be statically set to 10.0.0.2/24.

LED feedback

To aid initial testing the base image configures the board LED to reflect CPU load average, via the Linux Heartbeat Trigger driver. In case this is undesired, the heartbeat can be disabled by removing the ledtrig_heartbeat module in /etc/modules. More information about LED control here.

Resizing

The default image is 4GB of size, to use the full microSD space a new partition can be added or the existing one can be resized as described here.

Additional resources

Project page
Documentation

Major changes against the previous release:

  • upgraded kernel to 5.4.51
  • add binary releases for Mk II eMMC and Mk I uSD