Ubuntu-jammy-23.0

Kernel release: 5.15.0-1029-mtk
HW Compatibility: RevA0

Installation and Post-Installation

1. Download the Ubuntu OS image (Desktop or Server) of your choice. The following steps apply to both Ubuntu Desktop and Ubuntu Server. Install Ubuntu on MediaTek Genio | Ubuntu

2. Download the boot firmware for your SOM-SMARC-Genio700 from our latest release.

3. Extract the Ubuntu image first, and then extract the boot firmware into the same directory. On Ubuntu host PC this can be done with the following commands:

   tar -xvf {UBUNTU_IMAGE}.tar.xz tar --strip-components=1 -xvf {BOOT_FIRMWARE}.tar.gz -C {UBUNTU_IMAGE}/ cd baoshan-{UBUNTU_IMAGE}

4. The resulting image directory should contain at least these files:

   $ ls bl2.img bootassets.vfat fip.bin firmware.vfat lk.bin u-boot-initial-env ubuntu.img ubuntu.json

5. Check the following lines in the u-boot-initial-env file. They are responsible device tree overlays which will be applied. You can remove or add overlays from the list.

   conf ... list_dtbo= gpu-mali.dtbo video.dtbo apusys.dtbo

6. You can also set the MAC address at the boot time, which will be saved in the bootloader config. You can do so by adding a new line to u-boot-initial-env file:

7. Connect the Baseboard with SOM-SMARC-Genio700 module to PC. Open a terminal application on your host PC and connect to the serial device (converter name). Make sure you set the following parameters on your terminal application:

   • baud rate: 921600

   • 8-bit

   • Party bit: 1

   • No flow control

8. Launch a command line prompt on your host PC.
   First change directory(cd) to the image directory, and run genio-flash:

   The tool should have the following output:

   The line Looking for MediaTek SoC matching USB device 0e8d:0003 shows that genio-flash tool is waiting for the board to be reset into download mode to start the flash programming procedure.

9. Set the board into download mode
   Describe the procedure here

10. The flash tool should continue with the following log output, which shows the progress of erasing the onboard storage and writing image content to the storage:

11. Now the module will boot into the Ubuntu OS.
    Default user: ubuntu
    Default password: ubuntu
    You will be asked to change the password during the first login.

12. We still need to update the linux kernel which includes the custom drivers for the Embedded Controller and enables some features of the SOM-SMARC-Genio700 module e.g. the USB hub. The ethernet phy should work with default device tree and you should be able to connect to the internet.
    At this step you will need the *.deb packages, those are available along with the boot assets in our releases. Now you can copy those packages to the module with scp:

    Check that all 5 packages were transferred successfully:

    You can Install them and reboot the system with:

    Now the setup is done.

List of available device tree overlays

Downloads