BeagleY-AI Quick Start#
What’s included in the box?#
When you purchase a BeagleY-AI, you’ll get the following in the box:
BeagleY-AI with attached antenna.
Quick-start card
Todo
BeagleY-AI unboxing video
Getting started#
To get started your BeagleY-AI you need the following:
MicroSD card (32GB)
You may need additional accessories based on the mode of operation, you can use your BeagleY-AI in different ways.
Easiest option is to connect the board directly to your PC or Laptop using a USB type-C to type-c cable. There is only one USB type-C port on board, if you choose to use a dedicated power supply for first time setup, you may choose to access the board via any other methods listed above.
Power Supply#
To power the board you can either connect it to a dedicated power supply like a mobile charger or a wall adapter that can provide 5V ≥ 3A. Checkout the docs power supply page for power supply recommendations.
Note
Instead of using a power supply or power adapter if you are using a Type-C to Type-C cable to connect the board to your laptop/PC then make sure it can supply at least 1000mA.
Boot Media (Software image)#
We have two methods to prepare bootable microSD card, It is recommended to use bb-imager.
bb-imager#
Download and install bb-imager for your operating system. Below are all the steps required to create a bootable microSD card with latest/recommended OS image for BeagleY-AI.
![Click on ``CHOOSE DEVICE`` button](../../../_images/step1-choose-device.png)
Fig. 4 Click on CHOOSE DEVICE
button#
![Choose ``BeagleY-AI`` board](../../../_images/step2-choose-beagley-ai.png)
Fig. 5 Choose BeagleY-AI
board#
![Click on ``CHOOSE OS`` button](../../../_images/step3-choose-os.png)
Fig. 6 Click on CHOOSE OS
button#
![Select ``Recommended OS``](../../../_images/step4-select-recommended-os.png)
Fig. 7 Select Recommended OS
#
![Click on ``CHOOSE STORAGE`` button](../../../_images/step5-select-storage.png)
Fig. 8 Click on CHOOSE STORAGE
button#
![Choose your microSD card](../../../_images/step6-choose-microsd-card.png)
Fig. 9 Choose your microSD card#
![Click on ``Next`` button](../../../_images/step7-hit-next.png)
Fig. 10 Click on Next
button#
![Click on ``EDIT SETTINGS`` button](../../../_images/step8-edit-settings.png)
Fig. 11 Click on EDIT SETTINGS
button#
![Edit settings](../../../_images/step9-settings-save.png)
Fig. 12 Edit settings#
![Under ``SERVICES`` you can enable SSH](../../../_images/step9a-enable-ssh.png)
Fig. 13 Under SERVICES
you can enable SSH#
![Under ``OPTIONS`` you can enable to play sound when flashing is finished](../../../_images/step9b-play-sound.png)
Fig. 14 Under OPTIONS
you can enable to play sound when flashing is finished#
![Select ``YES`` to apply settings](../../../_images/step10-select-yes.png)
Fig. 15 Select YES
to apply settings#
![Select ``YES`` again to confirm sdCard formatting](../../../_images/step11-erase-data.png)
Fig. 16 Select YES
again to confirm sdCard formatting#
![Provide password to Authenticate the flashing process](../../../_images/step12-authenticate.png)
Fig. 17 Provide password to Authenticate the flashing process#
![Download image else automatically open cached image](../../../_images/step13-download-started.png)
Fig. 18 Download image else automatically open cached image#
![Writing data to microSD card](../../../_images/step14-writing.png)
Fig. 19 Writing data to microSD card#
![Verifying flashed microSD card](../../../_images/step15-verifying.png)
Fig. 20 Verifying flashed microSD card#
![microSD card is ready](../../../_images/step16-sdcard-ready.png)
Fig. 21 microSD card is ready#
Balena Etcher#
Download and install Balena Etcher and then download the boot media from https://www.beagleboard.org/distros/beagley-ai-debian-12-5-2024-06-19-xfce. Flash it on a microSD card using Balena Etcher following the steps below:
Select downloaded boot media
Select microSD card
Flash!
Tip
For more detailed steps checkout the Getting Started Guide under support section of the documentation.
![Flashing BeagleY-AI boot image (software image) to microSD card](../../../_images/balena-etcher.png)
Fig. 22 Flashing BeagleY-AI boot image (software image) to microSD card#
Once the microSD card is flashed you should see BOOT
and rootfs
mounted on your system as shown in image below,
![Flashed microSD card mounted partitions](../../../_images/disk.png)
Fig. 23 Flashed microSD card mounted partitions#
Under BOOT
partition open sysconf.txt
to edit login username
and password
.
![sysconf file under BOOT partition](../../../_images/sysconf.png)
Fig. 24 sysconf file under BOOT partition#
In sysconf.txt
file you have to edit the two lines highlighted below.
29# user_name - Set a user name for the user (1000)
30#user_name=beagle ①
31
32# user_password - Set a password for user (1000)
33#user_password=FooBar ②
① If boris
is your username, update #user_name=beagle
to user_name=boris
② If bash
is your password, update #user_password=FooBar
to user_password=bash
Important
Make sure to remove
#
from#user_name=
and#user_password=
else the lines will be interpreted as a comment and your username & password will not be updated.If you do not change your username and passord here then you will not see any output on your HDMI monitor when you do a Standalone connection setup.
Once username and password are updated, you can insert the microSD card into your BeagleY-AI as shown in the image below:
![Insert microSD card in BeagleY-AI](../../../_images/beagley-ai-micro-sd-card.jpg)
Fig. 25 Insert microSD card in BeagleY-AI#
USB Tethering#
Note
If you are using the board with a fan or running a computationally intensive task you should always power the board with a dedicated power supply that can supply 5V ≥ 3A (15W+).
As per USB standards these are the current at 5V that each downstream USB port type can (max) supply:
USB Type-A 3.x port - 900mA (4.5W)
USB Type-C 1.2 port - 1500mA (7.5W) to 3000mA (15W)
Thus it’s recommended to use type-C to type-C cable.
To initially test your board, you can connect the board directly to your computer using a type-C to type-C
cable shown in the image below.
![BeagleY-AI tethered connection](../../../_images/beagley-ai-tethered-connection.jpg)
Fig. 26 BeagleY-AI tethered connection#
SSH connection#
After connecting, you should see the power LED glow, and soon just like with other Beagles, BeagleY-AI will create a virtual wired connection on your computer. To access the board, open up a terminal (Linux/Mac) or command prompt (Windows) and use the SSH command as shown below.
ssh debian@192.168.7.2
Important
Here debian
is the default username, make sure to replace debian
with the username
you selected during Boot Media (Software image) preparation step.
Tip
If you are not able to find your beagle at 192.168.7.2
, checkout Browse to your Beagle to resolve your connection issue.
Important
If you have not updated your default username and password during Boot Media (Software image), you must update the default password at this step to something safer.
![BeagleY-AI SSH connection](../../../_images/ssh-connection.png)
Fig. 27 BeagleY-AI SSH connection#
UART connection#
Your BeagleY-AI board creates a UART connection (No additional hardware required) when tethered to a Laptop/PC which you can access using Putty
of tio
.
On a linux machine it may come up as dev/ttyACM*
, it will be different for Mac and Windows operating systems. To find serial port for your system you can checkout
this guide.
![Putty serial connection](../../../_images/putty.png)
Fig. 28 Putty serial connection#
If you are on linux, try
tio
with default setting using command below,
tio /dev/ttyACM0
With this you have the access to BeagleY-AI terminal. Now, you can connect your board to WiFi, try out all the cool demos and explore all the other ways to access your BeagleY-AI listed below.
Headless connection#
If you want to run your BeagleY-AI in headless mode, you need Raspberry Pi Debug Probe
or similar serial (USB to UART) adapter. Connect your UART debug probe to BeagleY-AI as shown in the image below. After making the connection you can use command
line utility like tio
on Linux of Putty on any operating system. Check UART connection for more information.
![Connecting Raspberry Pi debug probe to BeagleY-AI](../../../_images/rpi-debug-probe-connection.jpg)
Fig. 29 Connecting Raspberry Pi debug probe to BeagleY-AI#
Standalone connection#
Important
Make sure to update your username
and password
during
Boot Media (Software image) preparation step else you’ll not see any output on you HDMI monitor.
To setup your BeagleY-AI for standalone usage, you need the following additional accessories,
HDMI monitor
micro HDMI to full-size HDMI cable
Wireless keyboard & mice combo
Ethernet cable (Optional)
Make sure you have the microSD card with boot media (software image) inserted in to the BeagleY-AI. Now connect,
microHDMI to BeagleY-AI and full size HDMI to monitor
keyboard and mice combo to one of the four USB port of BeagleY-AI
Power supply to USB type-c connector of BeagleY-AI
The connection diagram below provides a clear representation of all the connections,
![BeagleY-AI standalone connection](../../../_images/standalone.jpg)
Fig. 30 BeagleY-AI standalone connection#
If everything is connected properly you should see four penguins on your monitor.
![BeagleY-AI boot penguins](../../../_images/boot-penguins.jpg)
Fig. 31 BeagleY-AI boot penguins#
When prompted, login using the credentials you updated during Boot Media (Software image) preparation step.
Important
You can not update login credentials at this step, you must update them during boot media (software image) micrSD card flashing or USB tethering step!
![BeagleY-AI XFCE desktop login](../../../_images/login.jpg)
Fig. 32 BeagleY-AI XFCE desktop login#
Once logged in you should see the splash screen shown in the image below:
![BeagleY-AI XFCE home screen](../../../_images/screen-saver.jpg)
Fig. 33 BeagleY-AI XFCE home screen#
Test network connection by running ping 8.8.8.8
![BeagleY-AI network ping test](../../../_images/ping-test.jpg)
Fig. 34 BeagleY-AI network ping test#
Explore and build with your new BeagleY-AI board!
![BeagleY-AI running htop](../../../_images/htop.jpg)
Fig. 35 BeagleY-AI running htop#
Connecting to WiFi#
The onboard BM3301
can connect to any 2.5GHz wifi access point.
We have two options to connect to WiFi,
nmtui#
Enable
NetworkManager
sudo systemctl enable NetworkManager
Start
NetworkManager
sudo systemctl start NetworkManager
Start
nmtui
application
sudo nmtui
To navigate, use the
arrow keys
or pressTab
to step forwards and pressShift+Tab
to step back through the options. PressEnter
to select an option. TheSpace bar
toggles the status of a check box.You should see a screen as shown below, here you have to press
Enter
onActicate a connection
option to activate wired and wireless connection options.
![NetworkManager TUI](../../../_images/nmtui.png)
Fig. 36 NetworkManager TUI#
There under WiFi
section press Enter
on desired access point and provide password to connect. When successfully connected press Esc
to get out of the nmtui
application window.
iwctl#
Once board is fully booted and you have access to the shell, follow the commands below to connect to any WiFi access point,
To list the wireless devices attached, (you should see wlan0 listed)
iwctl device list
Scan WiFi using,
iwctl station wlan0 scan
Get networks using,
iwctl station wlan0 get-networks
Connect to your wifi network using,
iwctl --passphrase "<wifi-pass>" station wlan0 connect "<wifi-name>"
Check wlan0 status with,
iwctl station wlan0 show
To list the networks with connected WiFi marked you can again use,
iwctl station wlan0 get-networks
Test connection with ping command,
ping 8.8.8.8
Attach cooling fan#
To attached the Raspberry Pi cooling fan to BeagleY-AI you have to follow these steps,
Clean the surface of BeagleY-AI with a microfiber cloth or electronics safe cleaning brush.
Gently pull the pre-cut (blue) thermal pads from cooling fan surface and transfer them to the most heating parts of BegleY-AI like CPU and RAM.
Connect the fan cable, then carefully place the flat part of cooling fan on BeagleY-AI. Now, gently apply force on spring loaded push pins to securely attach the cooling fan.
![Attaching cooling fan to BeagleY-AI](../../../_images/fan-connection.jpg)
Fig. 37 Attaching cooling fan to BeagleY-AI#