Getting started with your BeagleBone

What is BeagleBone?

BeagleBone is a family of open-source single-board computers similar to Raspberry Pi but with unique strengths:

• Real-time processing: Built-in PRU (Programmable Real-time Units) for time-critical tasks.
• More GPIO: 65 digital I/O pins vs. Raspberry Pi's 26.
• Industrial focus: Designed for robotics, CNC machines, and embedded systems.
• Analog inputs: 7 analog input pins (Raspberry Pi requires external ADC).

Popular models:

• BeagleBone Black: The standard model, 512MB RAM, 1GHz processor.
• BeagleBone AI: Machine learning-focused with dual-core Cortex-A15 and PowerVR GPU.
• BeagleBone Green: Similar to Black but with Grove connectors for easy sensor connections.

Unboxing and first boot

What's in the box

• BeagleBone board
• USB cable (mini-USB or USB-C depending on model)
• Quick start card

What you'll also need

• Computer (Windows, Mac, or Linux)
• 5V power supply (optional but recommended for peripherals)
• MicroSD card (optional, for installing different operating systems)

First boot

1. Connect the USB cable from your BeagleBone to your computer.
2. The board will power on automatically. You'll see 4 LEDs blink in sequence (known as the "Cylon" pattern).
3. Wait 30–60 seconds for the board to boot fully.

BeagleBone comes with Debian Linux pre-installed on internal eMMC storage. No SD card required for your first boot!

Connect to your BeagleBone

Method 1: Web browser (easiest)

1. Once your BeagleBone boots, open a web browser.
2. Navigate to http://192.168.7.2 (or http://beaglebone.local on macOS/Linux).
3. You'll see the BeagleBone Getting Started page with tutorials and documentation.

Method 2: SSH

For command-line access:

ssh debian@192.168.7.2

Default password: temppwd (you should change this immediately with passwd).

Method 3: Serial console (advanced)

Connect via the serial header (requires a USB-to-serial adapter). Useful for debugging boot issues.

Cloud9 IDE

BeagleBone includes Cloud9, a web-based IDE for writing and running code.

Access Cloud9

1. Open your browser and go to http://192.168.7.2:3000.
2. You'll see the Cloud9 interface with a file browser, code editor, and terminal.

Write your first program

1. In Cloud9, create a new file: blink.py.
2. Add this Python code to blink the onboard USER LEDs:

   import Adafruit_BBIO.GPIO as GPIO
   import time
   
   LED = "USR3"
   GPIO.setup(LED, GPIO.OUT)
   
   while True:
       GPIO.output(LED, GPIO.HIGH)
       time.sleep(1)
       GPIO.output(LED, GPIO.LOW)
       time.sleep(1)

3. Run the script from the Cloud9 terminal: sudo python3 blink.py.
4. Watch USR3 LED blink on your board!

GPIO basics

BeagleBone has 65 GPIO pins accessible via two expansion headers (P8 and P9).

Pin numbering

Pins are labeled as P8_XX or P9_XX where XX is the pin number. For example:

• P9_1 and P9_2: Ground
• P9_3 and P9_4: 3.3V
• P9_11: GPIO pin

Libraries for GPIO

• Python: Adafruit_BBIO library (pre-installed)
• C/C++: libpruio or sysfs
• JavaScript: bonescript (Node.js)

Safety tips

• BeagleBone GPIO pins are 3.3V only. Applying 5V will damage the board.
• Maximum current per pin: 6mA. Use transistors or MOSFETs for high-power devices.
• Some pins have special functions (analog in, PWM, I2C). Check the pinout diagram before wiring.

Next steps

Install a different OS

BeagleBone supports multiple operating systems:

• Debian (default): General-purpose Linux
• Ubuntu: For users familiar with Ubuntu
• TI SDK: For industrial and real-time applications

Download OS images from beagleboard.org and flash to microSD card.

Explore PRU (real-time units)

The PRU co-processors run independently of the main CPU, perfect for:

• Bit-banging protocols (WS2812 LEDs, custom serial)
• High-speed data acquisition
• Motor control with microsecond precision

Project ideas

• Home automation controller
• CNC machine controller
• Robotics brain
• Data logger with analog sensors
• Real-time audio/video processing