Newer
Older
BeagleY-AI Quick Start
######################
What's included in the box?
****************************
.. todo:: Update BeagleY-AI what's included in the box section as per production release.
When you purchase a BeagleY-AI, you'll get the following in the box:
1. `BeagleY-AI <https://www.beagleboard.org/boards/beagley-ai>`_
2. 2.4GHz antennas
3. Quick-start card
.. tip:: For board files, 3D model, and more, you can checkout the `BeagleY-AI repository on OpenBeagle <https://openbeagle.org/beagley-ai/beagley-ai>`_.
.. todo:: Attaching antennas instructions for BeagleY-AI
.. todo:: BeagleY-AI unboxing video
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. MicroSD 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 <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 <https://etcher.balena.io/>`_ following these steps:
1. Select downloaded boot media
2. Select SD Card
3. Flash!
.. image:: images/balena-etcher.*
Once flashed, you can insert the SD card into your BeagleY-AI as shown in the image below:
.. image:: images/beagley-ai-micro-sd-card.*
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 <https://docs.beagleboard.org/latest/accessories/power-supplies.html#accessories-power-supplies>`_
for power supply recommendations.
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 access the board via one of the following methods:
1. Connection to HDMI display, Keyboard and Mouse
Another direct and easy option is to connect the board directly to your PC or Laptop using a USB type-C cable.
.. 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.
.. image:: images/beagley-ai-tethered-connection.*
After connecting, you should see the 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.
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
.. note::
Here you must update the default password to something safer.
.. image:: images/ssh-connection.*
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
.. image:: images/beagley-ai-tethered-connection.*
If everything is connected properly you should see four penguins on your monitor.
.. image:: images/boot-penguins.*
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!
.. image:: images/login.*
Once logged in you should see the splash screen shown in the image below:
.. image:: images/screen-saver.*
Test network connection by running ping 8.8.8.8
.. image:: images/ping-test.*
Explore and build with your new BeagleY-AI board!
.. image:: images/htop.*
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)
.. code:: shell
iwctl device list
- Scan WiFi using,
.. code:: shell
iwctl station wlan0 scan
- Get networks using,
.. code:: shell
iwctl station wlan0 get-networks
- Connect to your wifi network using,
.. code::
iwctl --passphrase "<wifi-pass>" station wlan0 connect "<wifi-name>"
- Check wlan0 status with,
.. code::
iwctl station wlan0 show
- To list the networks with connected WiFi marked you can again use,
.. code::
iwctl station wlan0 get-networks
- Test connection with ping command,
.. code::
ping 8.8.8.8