| | 1 | [[PageOutline]] |
| | 2 | |
| | 3 | = Ubuntu on Catalina |
| | 4 | This page provides details on running Ubuntu on a Gateworks Catalina Board. |
| | 5 | |
| | 6 | Other references: |
| | 7 | * The Gateworks [wiki:catalina Catalina] software page |
| | 8 | * [wiki:/ubuntu Gateworks Ubuntu Page for generic Ubuntu notes not specific to Catalina] |
| | 9 | |
| | 10 | |
| | 11 | [=#prebuilt] |
| | 12 | == Gateworks pre-built Ubuntu based Disk Images for Catalina |
| | 13 | Gateworks provides a pre-built Ubuntu based firmware images for the Catalina Family: |
| | 14 | * [https://dev.gateworks.com/catalina/images/noble-catalina.img.gz noble-catalina.img.gz] Ubuntu 24.04 (Noble) based root filesystem image with the default [https://github.com/Gateworks/linux-catalina Gateworks kernel] |
| | 15 | * To update the firmware on the eMMC see [wiki:catalina/firmware#serial-ethernet] |
| | 16 | * To update the firmware on a microSD card see [wiki:linux/blockdev#UsingaDiskImage] |
| | 17 | * [http://dev.gateworks.com/catalina/kernel/linux-catalina.tar.xz linux-catalina.tar.xz] - Compressed TAR archive of pre-built Linux kernel |
| | 18 | |
| | 19 | '''Login Information (default)''' |
| | 20 | * Username: root |
| | 21 | * Password: root |
| | 22 | |
| | 23 | Features: |
| | 24 | - Ubuntu aarch64 core (created via BSP) |
| | 25 | - Gateworks Catalina Linux kernel (typically latest LTS) |
| | 26 | - eth0 dhcp with a 10 second timeout |
| | 27 | - User: root password: root |
| | 28 | - Packages installed on top of core including: |
| | 29 | * Updated modemmanager/libqmi-utils/libmbim-utils (see [wiki:ubuntu#modem ubuntu/modem]) |
| | 30 | * Misc wireless: wpasupplicant iw |
| | 31 | * Misc utils: vim can-utils i2c-tools usbutils pciutils screen watchdog binutils |
| | 32 | * Misc network: wget ethtool iperf iperf3 openssh-server iptables |
| | 33 | * Linux firmware |
| | 34 | * Gateworks [https://raw.githubusercontent.com/Gateworks/meta-gateworks/master/recipes-support/hostapd-conf/hostapd-conf/hostapd-conf hostapd-conf script] |
| | 35 | * Filesystem tools: e2fstools parted |
| | 36 | - first-boot script to grow root filesystem partition and filesystem (useful when putting disk images on removable storage devices) |
| | 37 | - use ifupdown tools instead of netplan (we find them easier to understand and configure) |
| | 38 | |
| | 39 | |
| | 40 | To install the kernel and root filesystem on a removable block storage device see [#disk-images below]. |
| | 41 | |
| | 42 | Notes: |
| | 43 | * '''By default root ssh access is disabled for security'''. See [wiki:/ubuntu#SSHServer This link] for info on enabling it |
| | 44 | |
| | 45 | == BSP |
| | 46 | To build a complete Ubuntu image, including all the boot firmware, start with the [wiki:catalina/bsp Catalina BSP] page as the easiest option. |
| | 47 | |
| | 48 | == Root Filesystem |
| | 49 | see [wiki:ubuntu] |
| | 50 | |
| | 51 | [=#disk-images] |
| | 52 | == Building a Bootable Disk Image == |
| | 53 | You will want to build your own Ubuntu disk image if you want control over any of the following: |
| | 54 | * Contents of root filesystem (packages and configuration) (see [#debootstrap debootsrap below) |
| | 55 | * Configuration of the Linux kernel (see [wiki:catalina/bsp#kernel catalina/bsp/kernel]) |
| | 56 | |
| | 57 | See [wiki:catalina/firmware#disk-images catalina/firmware/disk-images] for detailed instructions. |
