This is the latest (main) BeagleBoard documentation. If you are looking for stable releases, use the drop-down menu on the bottom-left and select the desired version.

Quick Start

What’s included in the box?

When you purchase a brand new BeagleV Ahead, In the box you’ll get:

  1. BeagleV Ahead board

  2. One (1) 2.4GHz/5GHz antenna

  3. super-speed micro-B OTG cable

  4. Quick-start card

BeagleV Ahead box contents

Unboxing

Antenna guide

Warning

uFL antenna connectors are very delicate and should be handled with care.

To use WiFi you are required to connect the 2.4GHz/5GHz antenna provided in BeagleV Ahead box. Below is a guide to connect the antenna to your BeagleV Ahead board.

Connecting 2.4GHz/5GHz antenna to BeagleV Ahead.

Fig. 182 Connecting 2.4GHz/5GHz antenna to BeagleV Ahead.

Tethering to PC

To connect the board to PC via USB 3.0 port you can use either a standard high-speed micro-B cable or a USB 3.0 super-speed micro-B cable. Connection guide for both are shown below:

Important

high-speed micro-B will support only USB 2.0 speed but super-speed micro-B cable will support USB 3.0 speed.

For super speed USB 3.0 connection it’s recommended to use super-speed micro-B USB cable. To get a super-speed micro-B cable you can checkout links below:

  1. USB 3.0 Micro-B Cable - 1m (sparkfun)

  2. Stewart Connector super-speed micro-B (DigiKey)

  3. CNC Tech super-speed micro-B (DigiKey)

  4. Assmann WSW Components super-speed micro-B (DigiKey)

Note

If you only have a high-speed micro-B cable you can checkout high-speed micro-B connection guide.

super-speed micro-B (USB 3.0) connection guide for BeagleV Ahead.

Fig. 184 super-speed micro-B (USB 3.0) connection guide for BeagleV Ahead.

Flashing eMMC

Note

To flash your BeagleV Ahead you need either a super-speed micro-B or high-speed micro-B cable as shown in section above.

Download latest software image

To download the latest software image visit https://www.beagleboard.org/distros and search for BeagleV Ahead as shown below.

Download latest software image for BeagleV Ahead board

Fig. 186 Download latest software image for BeagleV Ahead board

Put BeagleV Ahead in USB flash mode

Note

Only super-speed micro-B is shown in graphic below but you can use a high-speed micro-B cable. Only difference will be lower flash speeds.

To put your BeagleV Ahead board into eMMC flash mode you can follow the steps below:

  1. Press and hold USB button.

  2. Connect to PC with super-speed micro-B or high-speed micro-B cable.

  3. Release USB button.

Connecting BeagleV Ahead to flash eMMC

Fig. 187 Connecting BeagleV Ahead to flash eMMC

Important

If you want to put the board into eMMC flashing while it is already connected to a PC you can follow these steps:

  1. Press and hold USB button.

  2. Press reset button once.

  3. Release USB button.

Flash the latest image on eMMC

First you need to install android platform tools which includes adb and fastboot.

  • Debian/Ubuntu-based Linux users can type the following command:

sudo apt-get install android-sdk-platform-tools
  • Fedora/SUSE-based Linux users can type the following command:

sudo dnf install android-tools

Now unzip the latest software image zip file you have downloaded from https://www.beagleboard.org/distros which contains four files shown below:

[lorforlinux@fedora deploy] $ ls
boot.ext4  fastboot_emmc.sh  root.ext4  u-boot-with-spl.bin

Important

Make sure your board is in flash mode, you can follow the guide above to do that.

To flash the board you just have to exexute the script fastboot_emmc.sh as root and provide your passoword:

[lorforlinux@fedora deploy] $ sudo ./fastboot_emmc.sh
[sudo] password for lorforlinux:

Access UART debug console

Note

It has been noticed that 6pin FTDI cables like this doesn’t seem work with BeagleV Ahead debug port and there might be other cables/modules that will show garbage when connected to the board.

Some tested devices that are working good includes:

  1. Adafruit CP2102N Friend - USB to Serial Converter

  2. Raspberry Pi Debug Probe Kit for Pico and RP2040

To access a BeagleV Ahead serial debug console you can connected a USB to UART to your board as shown below:

BeagleV Ahead UART debug port connection

Fig. 188 BeagleV Ahead UART debug port connection

To see the board boot log and access your BeagleV Ahead’s console you can use application like tio to access the conole. If you are using Linux your USB to UART converter may appear as /dev/ttyUSB. It will be different for Mac and Windows operatig systems. To find serial port for your system you can checkout this guide.

[lorforlinux@fedora ~] $ tio /dev/ttyUSB0
tio v2.5
Press ctrl-t q to quit
Connected

Connect USB gadgets

A super-speed micro-B (male) to USB A (female) OTG cable included in the box can be used to connect USB gadgets to your BeagleV Ahead board. When you do this, you’ll be required to power the board via Barrel jack.

Important

To properly power the board and USB gadgets you must power the board with 5V @ 2A power supply.

USB OTG to connect USB gadgets to BeagleV Ahead board

Fig. 189 USB OTG to connect USB gadgets to BeagleV Ahead board

Connect to WiFi

After getting access to the UART debug console you will be prompted with,

THEAD C910 Release Distro 1.1.2 BeagleV ttyS0

BeagleV login:

Here you have to simply type root and press enter to start uisng your BeagleV Head board. Once you are in, to connect to any WiFi access point you have to edit the /etc/wpa_supplicant.conf

root@BeagleV:~# nano /etc/wpa_supplicant.conf

In the wpa_supplicant.conf file you have to provide ssid and psk. Here ssid is your WiFi access point name and psk is the passoword. It should look as shown below:

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
ap_scan=1
update_config=1

network={
        ssid="My WiFi"         psk="passoword"         key_mgmt=WPA-PSK
}

① WiFi access point name

② WiFi passoword

Once you are done with editing the file you can save the file with CTRL+O and exit the nano editor with CTRL+X. Once you are back to terminal reconfigure the wlan0 wireless interface which will trigger it to connect to the access point with the credentials you have added to wpa_supplicant.conf. Execute the command below to reconfigure wlan0 wireless interface.

root@BeagleV:~# wpa_cli -i wlan0 reconfigure
OK

After executing this you can check if internet is working by executing ping 8.8.8.8 as shown below:

root@BeagleV:~# ping 8.8.8.8
PING 8.8.8.8 (8.8.8.8): 56 data bytes
64 bytes from 8.8.8.8: seq=0 ttl=118 time=13.676 ms
64 bytes from 8.8.8.8: seq=1 ttl=118 time=17.050 ms
64 bytes from 8.8.8.8: seq=2 ttl=118 time=14.367 ms
64 bytes from 8.8.8.8: seq=3 ttl=118 time=19.320 ms
64 bytes from 8.8.8.8: seq=4 ttl=118 time=14.796 ms
^C
--- 8.8.8.8 ping statistics ---
5 packets transmitted, 5 packets received, 0% packet loss
round-trip min/avg/max = 13.676/15.841/19.320 ms

Important

Due to a software issue Yocto might now assign any ip address to wlan0 wireless interface thus even if you are connected successfully to the access point of your choice you will still not be able to connect to the internet. Particularly If you are not getting any pings back when you execute ping 8.8.8.8 you must execute the commands below:

  1. root@BeagleV:~# cp /lib/systemd/network/80-wifi-station.network.example /lib/systemd/network/80-wifi-station.network

  2. root@BeagleV:~# networkctl reload

this should fix the no internet issue on your BeagleV Ahead board!

Demos and Tutorials