Installation - T3 Foundation Gemstone Project

1

Update the Package Repository

sudo apt update

Keeping the system package list up to date prevents dependency errors that may occur during installation.

2

Install T3 Edge AI Packages

sudo apt install t3-gem-o1-edgeai

This command installs the Edge AI development tools and libraries in a single step.

3

Activate Edge AI Overlay

Open the uEnv.txt file located in the boot directory using the nano text editor from the terminal interface.

sudo nano /boot/uEnv.txt

Since we are using the command with sudo, it will prompt for a password. If you have not changed it, you must use the password you set while writing the image with Gem-Imager.

The uEnv.txt file will contain definitions such as the following:

firstboot=0
overlays=k3-am67a-t3-gem-o1-spidev0-2cs.dtbo k3-am67a-t3-gem-o1-i2c1-400000.dtbo

bootpart=1:1
initrdaddr=0x90000000
fdtoverlayaddr=0x89000000
get_kern_mmc=load mmc ${bootpart} ${loadaddr} Image
get_fdt_mmc=load mmc ${bootpart} ${fdtaddr} k3-am67a-t3-gem-o1.dtb;fdt addr ${fdtaddr};fdt resize 8192
get_initrd_mmc=load mmc ${bootpart} ${initrdaddr} gemstone-image-rd-t3-gem-o1.cpio.gz
get_overlays=for o in ${overlays}; do load mmc ${bootpart} ${fdtoverlayaddr} overlays/${o};fdt apply ${fdtoverlayaddr}; done
args_mmc=setenv bootargs console=${console} ${optargs} root=/dev/mmcblk1p2 rw rootfstype=btrfs bootpart=/dev/mmcblk1p1 firstboot=${firstboot} init_fatal_sh=1
boot_mmc=run get_kern_mmc;run get_fdt_mmc;run get_overlays;run get_initrd_mmc;booti ${loadaddr} ${initrdaddr}:${filesize} ${fdtaddr}
distro_bootcmd=run args_mmc;run boot_mmc

Add the k3-am67a-t3-gem-o1-edgeai-apps.dtbo filename to the end of the overlays= line, leaving a space.The final state of the uEnv.txt file will look like this. You must place the appropriate filename in the <file-name> section.

firstboot=0
overlays=k3-am67a-t3-gem-o1-spidev0-2cs.dtbo k3-am67a-t3-gem-o1-i2c1-400000.dtbo <file-name>

bootpart=1:1
initrdaddr=0x90000000
fdtoverlayaddr=0x89000000
get_kern_mmc=load mmc ${bootpart} ${loadaddr} Image
get_fdt_mmc=load mmc ${bootpart} ${fdtaddr} k3-am67a-t3-gem-o1.dtb;fdt addr ${fdtaddr};fdt resize 8192
get_initrd_mmc=load mmc ${bootpart} ${initrdaddr} gemstone-image-rd-t3-gem-o1.cpio.gz
get_overlays=for o in ${overlays}; do load mmc ${bootpart} ${fdtoverlayaddr} overlays/${o};fdt apply ${fdtoverlayaddr}; done
args_mmc=setenv bootargs console=${console} ${optargs} root=/dev/mmcblk1p2 rw rootfstype=btrfs bootpart=/dev/mmcblk1p1 firstboot=${firstboot} init_fatal_sh=1
boot_mmc=run get_kern_mmc;run get_fdt_mmc;run get_overlays;run get_initrd_mmc;booti ${loadaddr} ${initrdaddr}:${filesize} ${fdtaddr}
distro_bootcmd=run args_mmc;run boot_mmc

After defining the overlay file, the board must be rebooted for the changes to be applied by the system.

  sudo reboot

4

Load Environment Variables

sudo su
source /opt/t3-edgeai-env

These commands allow you to switch to the root user and load the environment variables required for Edge AI.

Note: Due to the use of AI accelerators, operations are performed at the hardware level. Therefore, the relevant steps must be executed under the root user.