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
Major changes against the previous release:
- upgraded kernel to 6.6.36
- upgraded U-Boot to v2024.07