USB armory

Install to a micro SD card

Replace sdX in the following instructions with the device name for the SD card as it appears on your computer.

1. Zero the beginning of the SD card:

   dd if=/dev/zero of=/dev/sdX bs=1M count=8

2. Start fdisk to partition the SD card:

   fdisk /dev/sdX

3. At the fdisk prompt, delete old partitions and create a new one:
   1. Type o. This will clear out any partitions on the drive.
   2. Type p to list partitions. There should be no partitions left.
   3. Now type n, then p for primary, 1 for the first partition on the drive, 2048 for the first sector, and then press ENTER to accept the default last sector.
   4. Write the partition table and exit by typing w.
4. Create the ext4 filesystem:

   mkfs.ext4 /dev/sdX1

5. Mount the filesystem:

   mkdir mnt
   mount /dev/sdX1 mnt

6. Download and extract the root filesystem:

   wget http://os.archlinuxarm.org/os/ArchLinuxARM-usbarmory-latest.tar.gz
   bsdtar -xpf ArchLinuxARM-usbarmory-latest.tar.gz -C mnt
   sync

7. Install the U-Boot bootloader and unmount the micro SD card:

   sudo dd if=mnt/boot/u-boot.imx of=/dev/sdX bs=512 seek=2 conv=fsync
   sync
   umount mnt

8. Insert the micro SD card into the USB Armory, connect computers USB port.
9. Use the serial console (/dev/ttyACM0) or SSH as below.
   • Login as the default user alarm with the password alarm.
   • The default root password is root.
10. Initialize the pacman keyring and populate the Arch Linux ARM package signing keys:

    pacman-key --init
    pacman-key --populate archlinuxarm

Host Communication

The root filesystem is configured to load the g_cdc module which provides USB ethernet and ACM serial devices on the host. To connect via SSH, you will need to configure the host networking:

1. Bring the interface up (usb0 is used here, yours may be different)

   ip link set usb0 up

2. Set the IP address

   ip addr add 10.0.0.2/24 dev usb0

3. Enable masquerading out your primary interface (eth0 is used here, yours may be different)

   iptables -t nat -A POSTROUTING -s 10.0.0.1/32 -o eth0 -j MASQUERADE

4. Enable IP forwarding

   echo 1 > /proc/sys/net/ipv4/ip_forward

Set the USB OTG to host mode

The USB Armory will boot by default in peripheral mode, allowing the board to be plugged into a computer. To use the host adapter board to attach USB devices to the USB Armory, the USB OTG port must be put in host mode.

1. Open /boot/boot.txt in an editor
2. Uncomment the following line near the top:

   #setenv otg_host yes

3. Install uboot-tools if not already installed:

   pacman -S uboot-tools

4. From inside the /boot directory, run the mkscr script to create the boot.scr file:

   ./mkscr

5. Disable g_cdc serial port's getty service to prevent boot delays:

   systemctl disable getty@ttyGS0