Skip to content

AMMDK OS Installation

Benjamin Riggs edited this page Dec 2, 2019 · 5 revisions

Warning

This will overwrite any data stored on the AMMDK. Be sure data is saved elsewhere before proceeding.

OS Images

Fastboot

The AMMDK uses the Android utility fastboot to flash OS images onto the SoM. General installation instructions for fastboot are available here. For Linux & macOS, an easy installation tool is available here.

Fastboot Mode

Once fastboot is installed on a host computer, the AMMDK-CCB needs to be put into Fastboot Mode before connecting to the host via USB. This procedure is outlined and illustrated below:

  1. Disconnect power from AMMDK-CCB.
  2. Press & hold the Volume- button and Power button, as illustrated below. AMMDK Buttons
  3. While simultaneously holding both buttons, connect power to the DC power jack. (Power via PoE may not work.)
  4. Continue holding buttons for a few seconds.

Alternatively, Fastboot mode can be triggered from the AMMDK Linux command line via reboot bootloader.

Connect

Connect the AMMDK-CCB to host computer via the indicated Fastboot micro USB port, illustrated below. AMMDK MicroUSB ports

Optionally, you can connect to the serial debug UART port with your computer. The serial UART settings are 115200 8N1.

Finally, confirm the AMMDK-CCB is connected in Fastboot Mode using the fastboot utility.

  • On *nix-like machine, the command is fastboot devices.
  • Alternatively, the lsusb utility can be used and should show a device with a ‘vid:pid - name’ entry that matches “18d1:d00d – Unnamed device”.

Flashing

Once the AMMDK-CCB is booted into Fastboot Mode and connected to the host computer, it is ready to have its OS flashed. The binary OS images are available here and should contain the following files (where XXX is a version number):

  • emmc_appsboot.mbn
  • boot-linaro-XXX.img
  • rootfs-buster-linaro-XXX.img
  • flashall.sh

From a *nix-like host computer, the images can be flashed by executing the flashall.sh script. (A script for Windows may be added in the future.)

After the OS images are successfully flashed onto the AMMDK-CCB, the board should automatically reboot. If it doesn’t, power cycle it manually.

If the host computer is also connected via serial debug UART, the boot process can be monitored without attaching a monitor directly.

Installing AMM Libraries

After flashing the new OS, the AMM libraries, and their prerequisites, will need to be installed. This repository contains a convenience script, board_init.sh for this purpose. It can be easily run from the command line:

bash <(curl -s https://raw.githubusercontent.com/AdvancedModularManikin/development-kit/master/board_init.sh)

Clone this wiki locally