02-quick-start.rst

BeagleY-AI Quick Start

What's included in the box?

When you purchase a brand new BeagleY-AI, In the box you'll get:

1. BeagleY-AI
2. JST-SH cables
3. 2.4GHz antennas
4. Quick-start card

Tip

For board files, 3D model, and more, you can checkout BeagleY-AI repository on OpenBeagle.

Getting started

To get started you need the following:

1. :ref:`USB Type-A to Type-C cable or Type-C to Type-C cable <accessories-cables-usb>`
2. :ref:`5V > 3A power supply <accessories-power-supplies>`
3. Micro SD Card
4. Boot media

Boot Media

Download the boot media from https://www.beagleboard.org/distros/beagley-ai-debian-xfce-12-5-2024-03-25 and flash it on a micro SD Card using using Balena Etcher following these steps:

1. Select downloaded boot media
2. Select SD Card
3. Flash!

Once flashed, you can insert the SD card into your BeagleY-AI as shown in the image below:

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 docs power supply page for recommended power supply.

Board connection

There is only one USB type-c port on board, if you choose to use a dedicated power supply you have to access to board via any of the following methods:

1. Connection to HDMI display, Keyboard and Mouse
2. UART using rpi pico debug probe or similar
3. Ethernet network connection

Another direct and easy option is to connect the board directly to your PC or Laptop using a USB type-a to type-c cable. This is not recommended if you are doing any heavy task on your BeagleY-AI but, for testing this should be fine.

Note

If you are using the board with a fan or running a heavy task you should always power the board with a dedicated power supply that can supply 5V ≥ 3A.

USB Tethering

To initially test your board, you can connect the board directly to your computer using a type-a to type-c cable shown in the image below.

After connecting, you should see Power LED glow, and soon just like with other Beagles, you’ll see a virtual wired connection on your computer. To access the board you can use ssh as shown below.

Note

Here you must update the default password to something safer.

Using BeagleY-AI

To setup your BeagleY-AI for normal usage, connect the following:

1. 5V ≥ 3A power supply
2. HDMI monitor using micro HDMI to full-size HDMI cable
3. Ethernet cable from the board to your router
4. Wireless or wired keyboard & mice

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

When prompted, log in using the updated login credentials you updated during the USB tethering step.

Note

You can not update login credentials at this step, you must update them during USB tethering step!

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

Test network connection by running ping 8.8.8.8

Explore and build with your new BeagleY-AI board!

Connecting to WiFi

Connect 2x antennas to your BeagleY-AI board if not pre-attached.

After successfully attaching the antenna, power up the board. Once booted you can 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