Ctrl+K
Welcome to new site for BeagleBoard.org docs!
Why are we doing this?

We believe in making computers open again to democratize technology and empower individuals and organizations to explore, experiment, and create without the constraints of proprietary systems.

What are we doing?

We design versatile and affordable single-board computers to provide developers, hobbyists, and educators with a platform for prototyping, experimentation, and production of embedded systems. Our comprehensive documentation, tutorials, and vibrant online community support users in their projects and foster knowledge sharing.

How are we doing it?

Through open-source hardware designs, diverse software support, and active community engagement, we enable users to customize, innovate, and collaborate effortlessly in embedded computing.

Support us

The BeagleBoard.org Foundation is a Michigan, USA-based 501(c)(3) non-profit corporation existing to provide education in and collaboration around the design and use of open-source software and hardware in embedded computing.

Become a Patreon Sponsor on GitHub

BeagleY-AI Quick Start#

What’s included in the box?#

When you purchase a BeagleY-AI, you’ll get the following in the box:

  1. BeagleY-AI

  2. 2.4GHz antenna

  3. Quick-start card

Todo

Attaching antennas instructions for BeagleY-AI

Todo

BeagleY-AI unboxing video

Getting started#

To get started your BeagleY-AI you need the following:

  1. 5V @ 3A power supply

  2. MicromicroSD card (32GB)

  3. Boot Media (Software image)

You may need additional accessories based on the mode of operation, you can use your BeagleY-AI in different ways.

  1. USB Tethering by directly connecting via USB type-c port

  2. Headless connection via UART debug port

  3. Standalone connection with Monitor and other peripherals attached

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)#

Todo

Update this section to use latest boot media (software image) for BeagleY-AI.

Download the boot media from https://www.beagleboard.org/distros/beagley-ai-xfce-12-5-2024-06-10 and flash it on a micro microSD card using using Balena Etcher following these steps:

  1. Select downloaded boot media

  2. Select microSD card

  3. 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

Fig. 13 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

Fig. 14 Flashed microSD card mounted partitions#

Under BOOT partition open sysconf.txt to edit login username and password.

sysconf file under BOOT partition

Fig. 15 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

Note

Make sure to remove # from in front of these lines else the lines will still be interpreted like a comment and your username & password will not be updated.

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

Fig. 16 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

Fig. 17 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

Tip

If you are not able to find your beagle at 192.168.7.2 make sure to 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

Fig. 18 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 operatig systems. To find serial port for your system you can checkout this guide.

Putty serial connection

Fig. 19 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 adapter.

Todo

Add images and description for this section.

Standalone connection#

To setup your BeagleY-AI for standalone usage, you need the following additional accessories,

  1. HDMI monitor

  2. micro HDMI to full-size HDMI cable

  3. Wireless keyboard & mice combo

  4. Ethernet cable (Optional)

Make sure you have the microSD card with boot media (software image) inserted in to the BeagleY-AI. Now connect,

  1. microHDMI to BeagleY-AI and full size HDMI to monitor

  2. keyboard and mice combo to one of the four USB port of BeagleY-AI

  3. 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

Fig. 20 BeagleY-AI standalone connection#

If everything is connected properly you should see four penguins on your monitor.

BeagleY-AI boot penguins

Fig. 21 BeagleY-AI boot penguins#

When prompted, log in using the updated login credentials you updated during the USB tethering 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

Fig. 22 BeagleY-AI XFCE desktop login#

Once logged in you should see the splash screen shown in the image below:

BeagleY-AI XFCE home screen

Fig. 23 BeagleY-AI XFCE home screen#

Test network connection by running ping 8.8.8.8

BeagleY-AI network ping test

Fig. 24 BeagleY-AI network ping test#

Explore and build with your new BeagleY-AI board!

BeagleY-AI running htop

Fig. 25 BeagleY-AI running htop#

Connecting to WiFi#

We have two options to connect to WiFi,

  1. nmtui

  2. iwctl

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 press Tab to step forwards and press Shift+Tab to step back through the options. Press Enter to select an option. The Space bar toggles the status of a check box.

  • You should see a screen as shown below, here you have to press Enter on Acticate a connection option to activate wired and wireless connection options.

NetworkManager TUI

Fig. 26 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 fan#

Todo

add instructions to attach raspberrypi official fan.

Demos and Tutorials#

On this page
Edit on OpenBeagle
Show Source
Download PDF
Provide Feedback
Discuss on Forum
License Terms

BeagleBoard.org is all about being open, please discuss in public on our forum!

BeagleY-AI

BeagleY-AI OSHW mark