Ubuntu on Newport

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

Other references:

• The Gateworks Newport software page for other Linux options on Newport products.
• Gateworks Ubuntu Page for generic notes

Gateworks pre-built Ubuntu Disk Image

Gateworks provides a pre-built Ubuntu firmware images for the Newport Family:

• ​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 newport/firmware
  • To update the firmware on a microSD card see linux/blockdev
• ​linux-newport.tar.xz - Compressed TAR archive of pre-built Linux kernel
• ​focal-arm64.tar.xz - Compressed TAR archive of Ubuntu 20.04 Focal arm64 root filesystem (does not include kernel)(​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 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 ​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 below.

BSP

To build a complete Ubuntu image, including all the boot firmware, start with the Newport BSP page as the easiest option.

Root Filesystem

see ubuntu

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 newport/bsp/kernel)

See newpowrt/boot/disk-images for detailed instructions.