USB armory Mk II

The USB armory Mk II from Inverse Path is an open source hardware design, implementing a flash drive sized computer.

The compact USB powered device provides a platform for developing and running a variety of applications.

The security features of the USB armory System on a Chip (SoC), combined with the openness of the board design, empower developers and users with a fully customizable USB trusted device for open and innovative personal security applications.

The hardware design features the NXP i.MX6ULZ processor, supporting advanced security features such as secure boot and ARM® TrustZone®.

  • NXP i.MX6ULZ ARM® Cortex™-A7 900Mhz, 512MB DDR3 RAM
  • USB host powered (<500 mA) device with compact form factor (65 x 19 x 6 mm)
  • ARM® TrustZone®, secure boot + storage + RAM
  • 16GB eMMC
  • MicroSD card slot
  • u-blox ANNA-B112 Bluetooth module
  • Debug accessory support for UART, GPIO, SPI, I2C, CAN breakout
  • Customizable LED, including secure mode detection
  • USB device emulation (CDC Ethernet, mass storage, HID, etc.)
  • Open Hardware & Software
ARMv7 Cortex-A7
Micro SD

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 device:
    dd if=/dev/zero of=/dev/sdX bs=1M count=8
  2. Start fdisk to partition the device:
    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 (as root, not via sudo):
    bsdtar -xpf ArchLinuxARM-usbarmory-mkii-latest.tar.gz -C mnt
  7. Install the U-Boot bootloader and unmount the device:
    dd if=mnt/boot/u-boot-dtb.imx of=/dev/sdX bs=512 seek=2 conv=fsync
    umount mnt
  8. Insert the micro SD card into the USB armory, set the boot switch to uSD, and connect to your computer's USB-C 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 dev usb0
  3. Enable masquerading out your primary interface (eth0 is used here, yours may be different)
    iptables -t nat -A POSTROUTING -s -o eth0 -j MASQUERADE
  4. Enable IP forwarding
    echo 1 > /proc/sys/net/ipv4/ip_forward

Gadget configuration:

  • Device and host ethernet MAC addresses: /etc/modprobe.d/g_cdc.conf
  • Gadget ethernet network settings: /etc/systemd/network/

Installing to eMMC

Click here to magically adjust the instructions above for the mmcblk1 eMMC device.

  1. After booting into Arch Linux ARM, follow the above steps 1 through 7 using the device /dev/mmcblk1.
  2. Power down the system, waiting until all the LEDs go out:
  3. Remove power, set the boot switch to eMMC, then reapply power. The system will boot into eMMC.
  4. To use the micro SD slot for general storage, simply partition and format the device as a normal drive.

Copyright ©2009-2022 Arch Linux ARM
The registered trademark Linux® is used pursuant to a sublicense from LMI, the exclusive licensee of Linus Torvalds, owner of the mark on a world-wide basis.
The Arch Linux™ name and logo are used under permission of the Arch Linux Project Lead.