BeagleBone: Setup and First Task

The BeagleBone Black is a small Linux computer aimed at hardware projects - it boots from on-board storage, has a huge number of GPIO pins, and reaches the internet the moment you plug it into your laptop over USB. This tutorial gets it running: the OS image, flashing, connecting over USB, and a first task blinking both an on-board and an external LED.

What You Will Need

A BeagleBone - Black or Green
A micro-USB cable that carries data
A microSD card, 8 GB or larger, for flashing the image
A host computer (Windows, macOS, or Linux)
Optional: a 5V/2A barrel-jack supply for heavier use

On storage: unlike a Raspberry Pi, the BeagleBone has built-in eMMC flash and can run without an SD card at all. The card is used to carry the new image, which is then written to that on-board storage.

Step 1: Download the Image

Go to beagleboard.org/distros.
Download the latest Debian IoT image for your board - a .img.xz file.
Pick a flasher image if offered: it writes itself to the on-board eMMC automatically on first boot.

Step 2: Flash the Image to the SD Card

Use balenaEtcher (balena.io/etcher) - it reads the .img.xz directly, no unzipping.

Insert the microSD card.
Etcher → Flash from file → the downloaded image.
Select the SD card as the target - confirm the size, it erases it.
Flash, then eject.

Step 3: Boot (and Flash the eMMC)

Two cases, depending on the image you downloaded:

Flasher image: insert the card, power the board. The four USER LEDs sweep back and forth while it writes to eMMC, then all turn off. Remove the card - it now boots from on-board storage.
Plain image: the board simply boots from the SD card each time. Hold the S2 / BOOT button while powering on if it will not pick the card.

Step 4: Connect Over USB

Plug the board into your computer with the micro-USB cable. It powers up and appears as three things at once: a USB drive (with drivers), a serial port, and - the useful one - a small network device. The board is reachable at a fixed address:

Windows: 192.168.7.2
macOS / Linux: 192.168.6.2

If it does not appear, install the drivers from the BEAGLEBONE USB drive that mounts, then re-plug.

Step 5: Access the Board

Connect over SSH from a terminal:

You can also open the board’s built-in web tools in a browser at http://192.168.7.2, which links to the on-board coding environment and documentation.

Step 6: First Task - Blink an On-board LED

No wiring needed. The four green USER LEDs are controlled through the Linux /sys filesystem - just write to files:

Wrap that in a loop to blink it. Save as blink.sh, then bash blink.sh:

Why write to files: Linux exposes hardware as files under /sys. Setting the trigger to none releases the LED from its default heartbeat so your writes to brightness take effect. This is the same model for GPIO, PWM, and more.

Step 7: Blink an External LED

To drive your own LED, use a header pin. Set it to GPIO mode with config-pin, then toggle it from Python:

P9_14 → 330Ω resistor → LED long leg (anode)
LED short leg (cathode) → P9_1 (GND)

Troubleshooting

No 192.168.7.2: the USB network drivers are not installed. Open the BEAGLEBONE drive that mounts and run the installer, then re-plug.
eMMC flash never finishes: a weak USB port cannot power the write. Use a 5V barrel supply, or a powered USB hub.
config-pin: not found: an older image. Update with sudo apt update && sudo apt upgrade, or address the GPIO by its /sys/class/gpio number instead.
Permission denied writing to /sys: those files need root - keep the sudo tee pattern shown above.

Where to Go Next

Read analogue sensors on the AIN pins - the BeagleBone has a built-in ADC the Pi lacks.
Use the PRU real-time cores for precise timing a normal Linux process cannot hit.
Drive motors and relays from the many GPIO pins for a robotics build.
Compare with the Raspberry Pi and Jetson Nano tutorials to pick the right board per project.