[[PageOutline]]

= Ubuntu on Newport =
This page provides details on running Ubuntu on a Gateworks Newport Board.

Other references:
 * The Gateworks [wiki:newport#BoardSupportPackagesBSPSoftware Newport] software page for other Linux options on Newport products.
 * [wiki:/ubuntu Gateworks Ubuntu Page for generic notes]  


[=#prebuilt]
== Gateworks pre-built Ubuntu Disk Image ==
Gateworks provides a pre-built Ubuntu firmware images for the Newport Family:
 * [http://dev.gateworks.com/newport/images/jammy-newport.img.gz jammy-newport.img.gz] - '''(Recommended)''' Compressed Disk Image containing Firmware, Linux kernel, and Ubuntu 22.04 Focal root filesystem. 
  * To update the firmware on the eMMC see [wiki:newport/firmware#UpdateFirmwareviaSerialConsoleandEthernet]
  * To update the firmware on a microSD card see [wiki:linux/blockdev#UsingaDiskImage]
 * [http://dev.gateworks.com/newport/kernel/linux-newport.tar.xz linux-newport.tar.xz] - Compressed TAR archive of pre-built Linux kernel
 * [http://dev.gateworks.com/ubuntu/focal/focal-newport.tar.xz focal-arm64.tar.xz] - Compressed TAR archive of Ubuntu 20.04 Focal arm64 root filesystem (does not include kernel)([http://dev.gateworks.com/ubuntu/focal/focal-newport.manifest package manifest])

'''Login Information (default)'''
 * Username: root
 * Password: root

Features:
- Ubuntu aarch64 core (created via debootstrap)
- Gateworks Newport Linux kernel
- eth0 dhcp with a 10 second timeout
- User: root password: root
- Packages installed on top of core including:
 * Updated modemmanager/libqmi-utils/libmbim-utils (see [wiki:ubuntu#modem ubuntu/modem])
 * Misc wireless: wpasupplicant iw 
 * Misc utils: vim can-utils i2c-tools usbutils pciutils screen watchdog binutils
 * Misc network: wget ethtool iperf iperf3 openssh-server iptables
 * Linux firmware
 * mmc-utils from https://packages.debian.org/sid/utils/mmc-utils
 * Gateworks [https://raw.githubusercontent.com/Gateworks/meta-gateworks/master/recipes-support/hostapd-conf/hostapd-conf/hostapd-conf hostapd-conf script]
 * Filesystem tools: e2fstools parted
- first-boot script to grow root filesystem partition and filesystem (useful when putting disk images on removable storage devices)
- use ifupdown tools instead of netplan (we find them easier to understand and configure)


To install the kernel and root filesystem on a removable block storage device see [#disk-images below].

== BSP ==

To build a complete Ubuntu image, including all the boot firmware, start with the [wiki:newport/bsp Newport BSP] page as the easiest option.

== Root Filesystem
see [wiki:ubuntu]

[=#disk-images]
== Building a Bootable Disk Image ==
You will want to build your own Ubuntu disk image if you want control over any of the following:
 * Contents of root filesystem (packages and configuration) (see [#debootstrap debootsrap below)
 * Configuration of the Linux kernel (see [wiki:newport/bsp#kernel newport/bsp/kernel])

See [wiki:newport/boot#disk-images newpowrt/boot/disk-images] for detailed instructions.