Getting Started with the BeagleY-AI


Latest documentation : BeagleY-AI — BeagleBoard Documentation
To fork and add fixes : Documentation / · GitLab


Forum: (here)

bb-imager (forked from rpi-imager)

Project Repo: BeagleY-AI / BB Imager · GitLab
Linux and mac installer: Index of /public

Remember to Set Your Username and Password

Official Images Official Image: Latest Software Images - BeagleBoard

Latest release: BeagleY-AI Debian 12.5 2024-06-19 XFCE - BeagleBoard

Development Snapshots (daily/weekly)

Writing Image to microSD:


Configure First User

Mount Boot Partition:

Open sysconf.txt:

root user (optional)

By default root user is disabled, but if you want to enable it, set a password and/or your ssh key

# root_password - Set a password for the root user (not used in ubuntu)

root user ssh key (optional)

# root_authorized_key - Set an authorized key for a root ssh login (not used in ubuntu)

first user (optional)

Set your username, will still end up as user (1000)

# user_name - Set a user name for the user (1000)

first password (REQUIRED)

user_password this must be set, otherwise x11/wayland will not start

# user_password - Set a password for user (1000)

first user ssh key (optional)

# user_authorized_key - Set an authorized key for a user (1000) ssh login

hostname (optional)

# hostname - Set the system hostname.

keymap (optional)

# keymap - Set the system keymap.

timezone (optional)

# timezone - Set the system timezone.

Firewall (ufw) (optional)

# enable_ufw - enable ufw firewall (

# ufw_allow_ssh - allow ssh access over port 22

# ufw_allow_http - allow http access over port 80

# ufw_allow_https - allow https access over port 443

# ufw_allow_nodered - allow nodered access over port 1880 (

# ufw_allow_vscode - allow vscode access over port 3000 (

# ufw_allow_vnc - allow vnc access over port 5901

# ufw_allow_cockpit - allow cockpit access over port 9090 (

Head: src/sysconf.txt · main · / bbbio-set-sysconf · GitLab

Boot Menu (over RPI debug connector)

BeagleY-AI microSD (extlinux.conf) (swap enabled)
1:	microSD (production test)
2:	transfer microSD rootfs to NVMe (advanced)
3:	microSD (debug)
4:	microSD (default)

WiFi - iwd

Helpful Docs: iwd - ArchWiki

WiFI - What commands do i run?

iwctl device list
iwctl station wlan0 scan
iwctl station wlan0 get-networks
iwctl --passphrase "PassWord" station wlan0 connect "MY_SSID"
iwctl station wlan0 show
iwctl station wlan0 get-networks

WiFI - Connection example:

What wireless devices do i have?

debian@BeagleBone:~$ iwctl device list
  Name                  Address               Powered     Adapter     Mode      
  wlan0                 80:30:dc:f8:30:22     on          phy0        station     

Initiate network scan:

debian@BeagleBone:~$ iwctl station wlan0 scan

List of all available networks:

debian@BeagleBone:~$ iwctl station wlan0 get-networks
                               Available networks                              
      Network name                      Security            Signal
      Avenger                           psk                 ****    
      BeagleBone                        psk                 ****    

Connect to a network:

debian@BeagleBone:~$ iwctl --passphrase "BeagleBone" station wlan0 connect "BeagleBone"

Show Connection:

debian@BeagleBone:~$ iwctl station wlan0 show
                                 Station: wlan0                                
  Settable  Property              Value                                          
            Scanning              no                                               
            State                 connected                                        
            Connected network     BeagleBone                                     
            IPv4 address                                     
            ConnectedBss          ba:fb:e4:f4:7a:ad                                
            Frequency             2412                                             
            Security              WPA2-Personal                                    
            RSSI                  -78 dBm                                          
            AverageRSSI           -79 dBm                                          
            TxBitrate             1000 Kbit/s                                      
            RxBitrate             1000 Kbit/s 

List of all available networks (now with connection hint)

debian@BeagleBone:~$ iwctl station wlan0 get-networks
                               Available networks                              
      Network name                      Security            Signal
  >   BeagleBone                      psk                 ****    
      Avenger                           psk                 ****    

Network out of box



Help sudo beagle-version:

voodoo@BeagleY-AI:~$ sudo beagle-version
dogtag:[ Debian Bookworm Xfce Image 2024-06-15]
bootloader:[/dev/mmcblk1]:[/boot/firmware/tiboot3.bin]:[U-Boot SPL 2023.04-g93735daa (Jun 14 2024 - 23:22:59 +0000)]
bootloader:[/dev/mmcblk1]:[/boot/firmware/tispl.bin]:[U-Boot SPL 2023.04-g93735daa (Jun 14 2024 - 23:22:59 +0000)]
bootloader:[/dev/mmcblk1]:[/boot/firmware/u-boot.img]:[U-Boot 2023.04-g93735daa (Jun 14 2024 - 23:22:59 +0000)]
UBOOT: Booted Device-Tree:[k3-am67a-beagley-ai.dts]

Kernel (developers)

Device Tree: (v6.1.x-ti): src/arm64/ti/k3-am67a-beagley-ai.dts · v6.1.x-Beagle · / BeagleBoard-DeviceTrees · GitLab

u-boot (developers)

U-Boot: Files · v2023.04-ti- · / u-boot · GitLab

Build order along with other git projects: bb-u-boot-beagley-ai/suite/bookworm/debian/rules · main · / repos-arm64 · GitLab


Official Pi PCIe to M.2 HAT for Raspberry Pi 5
Geekworm X1001 PCIe to M.2 HAT


MPS2280-POE for RPi PI 5 PoE-Powered Adapter NVME SSD HAT

Zephyr on R5

CI build project: / zephyr-beagley-ai · GitLab

mcu-r5f0_0 micropython /dev/ttyRPMSG0

cd /opt/ti-zephyr-firmware/j722s/mcu-r5f0_0/
sudo ./

main-r5f0_0 micropython /dev/ttyRPMSG0

cd /opt/ti-zephyr-firmware/j722s/main-r5f0_0
sudo ./