Ubuntu-jammy-23.0

Kernel release: 5.15.0-1029-mtk

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. https://ubuntu.com/download/mediatek-genio

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:

   ethaddr=00:55:7b:b5:7d:f7

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:

   cd {UBUNTU_IMAGE}
   genio-flash

   The tool should have the following output:

   genio-flash
   AIoT Tools: v1.3.4
   Ubuntu Image:
   ...
   Looking for MediaTek SoC matching USB device 0e8d:0003
   ...

   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:

    Erasing 'mmc0'                                     (bootloader) request sz: 0xece000000, real erase len: 0x0
    OKAY [  1.432s]
    Finished. Total time: 7.869s
    erasing mmc0boot0
    Erasing 'mmc0boot0'                                (bootloader) request sz: 0x400000, real erase len: 0x400000
    OKAY [  0.010s]
    Finished. Total time: 0.015s
    erasing mmc0boot1
    Erasing 'mmc0boot1'                                (bootloader) request sz: 0x400000, real erase len: 0x400000
    OKAY [  0.007s]
    Finished. Total time: 0.013s
    flashing mmc0=ubuntu.img
    Sending sparse 'mmc0' 1/17 (261522 KB)             OKAY [  7.267s]
    Writing 'mmc0'                                     OKAY [ 17.980s]
    Sending sparse 'mmc0' 2/17 (261674 KB)             OKAY [  7.123s]
    ...

Eventually, the flash tool would report the following logs once it finishes writing the onboard storage and reboot the board:

Finished. Total time: 0.028s
Rebooting                                          OKAY [  0.002s]
Finished. Total time: 0.002s

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:

    cd {kernel-packages}
    scp *.deb ubuntu@{IP}:/home/ubuntu

    Check that all 5 packages were transferred successfully:

    $ ls -1 *.deb
    linux-buildinfo-5.15.0-1003-mtk_5.15.0-1003.4_arm64.deb
    linux-headers-5.15.0-1003-mtk_5.15.0-1003.4_arm64.deb
    linux-image-5.15.0-1003-mtk_5.15.0-1003.4_arm64.deb
    linux-modules-5.15.0-1003-mtk_5.15.0-1003.4_arm64.deb
    linux-mtk-headers-5.15.0-1003_5.15.0-1003.4_all.deb

    You can Install them and reboot the system with:

    $ sudo dpkg -i *.deb
    $ sudo reboot

    Now the setup is done.

List of available device tree overlays

Downloads