|
| 1 | +--- |
| 2 | +title: "ARM: TQMa8MPxL" |
| 3 | +category: Deploy |
| 4 | +order: 4 |
| 5 | +--- |
| 6 | + |
| 7 | +# Deploy GyroidOS on TQ-Systems TQMa8MPxL-MBa8MPxL |
| 8 | +- TOC |
| 9 | +{:toc} |
| 10 | + |
| 11 | +This section describes how to deploy GyroidOS on the TQ-Systems TQMa8MPxL module |
| 12 | +when mounted on the MBa8MPxL board. |
| 13 | + |
| 14 | +## GyroidOS image |
| 15 | +Build the GyroidOS image according to the instructions [here]({{ "/" | abolute_url }}build/build#build-gyroidos-image). |
| 16 | +> **Note**: In order to build the image, you need to accept the Freescale EULA by placing the line `ACCEPT_FSL_EULA = "1"` in `out-yocto/conf/local.conf`. |
| 17 | +
|
| 18 | +## Create bootable medium |
| 19 | +### Requirements |
| 20 | +* A successfully built GyroidOS image file `trustmeimage.img`. |
| 21 | +* The script **copy_image_to_disk_mbr.sh** which can be found [on GitHub](https://github.com/gyroidos/gyroidos/raw/master/yocto/copy_image_to_disk_mbr.sh) or in your build folder at `trustme/build/yocto/copy_image_to_disk.sh` |
| 22 | +* A MicroSD card compatible with your board |
| 23 | +* Optional: Bmap file `trustmeimage.img.bmap` which is automatically created by the build system and deployed next to `trustmeimage.img`. This enables flashing using [bmaptool](https://manpages.debian.org/testing/bmap-tools/bmaptool.1.en.html). |
| 24 | + |
| 25 | +First, ensure the needed packages are installed on your system. |
| 26 | +``` |
| 27 | +apt-get install util-linux btrfs-progs sgdisk parted bmap-tools |
| 28 | +``` |
| 29 | + |
| 30 | +### Copy GyroidOS image to disk |
| 31 | +Now the GyroidOS image can be copied to the MicroSD card. |
| 32 | +The provided script takes care of expanding the partitions to use all of the available disk space. |
| 33 | + |
| 34 | +**WARNING: This operation will wipe all data on the target device** |
| 35 | +``` |
| 36 | +sudo copy_image_to_disk_mbr.sh <gyroidos-image> </path/to/target/device> |
| 37 | +``` |
| 38 | + |
| 39 | +If you have built from source in `ws-yocto` and your target device is `/dev/mmcblk0` the command would be: |
| 40 | +``` |
| 41 | +cd ws-yocto # your yocto workspace directory |
| 42 | +sudo copy_image_to_disk_mbr.sh \ |
| 43 | + out-yocto/tmp/deploy/images/tqma8mpxl-mba8mpxl/trustme_image/trustmeimage.img \ |
| 44 | + /dev/mmcblk0 |
| 45 | +``` |
| 46 | + |
| 47 | +In this example, if the bmap file `out-yocto/tmp/deploy/images/tqma8mpxl-mba8mpxl/trustme_image/trustmeimage.img.bmap` |
| 48 | +exists and bmaptool is installed, the script will automatically flash to the MicroSD card using the quick bmaptool. |
| 49 | +If one of these requirements is not fulfilled `copy_image_to_disk_mbr.sh` will fall back to slower copy using dd. |
| 50 | + |
| 51 | +## Boot GyroidOS |
| 52 | +Connect your PC via a Micro-USB cable to connector X28 on the board. |
| 53 | +This will create four serial interfaces, e.g.: |
| 54 | +``` |
| 55 | +crw-rw---- 1 0 986 188, 0 19. Feb 11:32 /dev/ttyUSB0 |
| 56 | +crw-rw---- 1 0 986 188, 1 19. Feb 11:32 /dev/ttyUSB1 |
| 57 | +crw-rw---- 1 0 986 188, 2 19. Feb 11:32 /dev/ttyUSB2 |
| 58 | +crw-rw---- 1 0 986 188, 3 19. Feb 11:32 /dev/ttyUSB3 |
| 59 | +``` |
| 60 | + |
| 61 | +Connect to the CML debug shell via the highest interface, e.g. `ttyUSB3`. |
| 62 | + |
| 63 | +For instructions on how to operate GyroidOS please refer to section [Operate](/operate/control). |
0 commit comments