| 12 | |
| 13 | |
| 14 | [=#prebuilt] |
| 15 | == Gateworks pre-built Ubuntu Disk Image == |
| 16 | Gateworks provides a pre-built Ubuntu firmware images for the Newport Family: |
| 17 | * [https://github.com/Gateworks/images-newport/raw/master/linux-newport.tar.bz2 linux-newport.tar.bz2] - Compressed TAR archive of pre-built Linux kernel |
| 18 | * [https://github.com/Gateworks/images-newport/blob/master/xenial-newport.tar.bz2 xenial-newport.tar.bz2] - Compressed TAR archive of Ubuntu 16.04 Xenial arm64 root filesystem (does not include kernel) |
| 19 | * [https://github.com/Gateworks/images-newport/raw/master/xenial-newport.img.gz xenial-newport.img.gz] - Compressed Disk Image containing Firmware, Linux kernel, and Ubuntu 16.04 Xenial root filesystem. To update the firmware using this see [wiki:newport#serial-ethernet here] |
| 20 | |
| 21 | Features: |
| 22 | - Ubuntu 16.04 aarch64 core (from debootstrap instructions) |
| 23 | - Gateworks Newport Linux kernel (Linux 4.14 based) |
| 24 | - several pre-installed packages |
| 25 | - eth0 dhcp |
| 26 | - user root passwd root |
| 27 | |
| 28 | To install the kernel and root filesystem on a removable block storage device see [#disk-images below]. |
| 29 | |
| 30 | |
| 31 | [=#disk-images] |
| 32 | == Disk Images == |
| 33 | Gateworks releases disk images that can be easily flashed using the U-Boot Bootloader (see [wiki:newport#serial-ethernet here]). These disk images contain a partition table so they are tailored to the specific eMMC device on the boards they are intended for. Additionally they are configured for a small partition size to keep flash programming time at a minimum. This requires resizing the rootfs partition be resized in order to take advantage of the remaining flash space. |
| 34 | |
| 35 | The script used to create these images can be found on !GitHub [https://github.com/Gateworks/images-newport/raw/master/mkimage here] and an example usage is: |
| 36 | {{{#!bash |
| 37 | sudo ./mkimage /tmp/xenial-newport 7264 1536 firmware-newport.img xenial-newport.tar.bz2 linux-newport.tar.bz2 |
| 38 | }}} |
| 39 | * The user partition of the 8GiB eMMC used on Newport is 7264MB |
| 40 | * We need around 1536MB of partition space for the extracted kernel and root filesystem |
| 41 | |
| 42 | To flash this compressed disk image to a board see [wiki:newport#serial-ethernet here] |
| 43 | |
| 44 | To install the kernel and root filesystem on a removable block storage device see [wiki:linux/blockdev]. |