Start your Beagle
Beagles are tiny computers with the capability of modern systems, without the bulk, expense, or noise. Read the step-by-step getting started tutorial below to begin developing with your Beagle in minutes.
For user supplied tips on getting started, visit the eLinux (or other) community wiki pages:
- BeagleBone Black
- BeagleBone Black Wireless
- BeagleBone Blue
- SeeedStudio BeagleBone Green
- SeeedStudio BeagleBone Green Wireless
- SanCloud BeagleBone Enhanced
- Neuromeka BeagleBone Air
If any step fails, it is recommended to update to the latest software image to use the instructions below.
Power and boot
Most Beagles include a USB cable, providing a convenient way to provide both power to your Beagle and connectivity to your computer. If you provide your own, ensure it is of good quality. You'll connect the "type-B" plug of the USB cable to your Beagle and the "type-A" plug to your computer. Note that BeagleBoard-X15 must always be powered instead by a 12V adapter with a barrel jack.
Alternatively, for Beagles other than BeagleBoard-X15 and BeagleBone Blue that require 12V, you can utilize a 5V adapter connected to the barrel jack.
If your Beagle was provided with an SD (microSD) card, make sure it is inserted ahead of providing power. Most Beagles include programmed on-board flash and therefore do not require an SD card to be inserted.
You'll see the power (PWR or ON) LED lit steadily. Within a minute or so, you should see the other LEDs blinking in their default configurations.
- USR0 is typically configured at boot to blink in a heartbeat pattern
- USR1 is typically configured at boot to light during SD (microSD) card accesses
- USR2 is typically configured at boot to light during CPU activity
- USR3 is typically configured at boot to light during eMMC accesses
- WIFI is typically configured at boot to light with WiFi network association (BeagleBone Blue only)
Enable a network connection
If connected via USB, a network adapter should show up on your computer. Your Beagle should be running a DHCP server that will provide your computer with an IP address of either 192.168.7.1 or 192.168.6.1, depending on the type of USB network adapter supported by your computer's operating system. Your Beagle will reserve 192.168.7.2 or 192.168.6.2 for itself.
If your Beagle includes WiFi, an access point called "BeagleBone-XXXX" where "XXXX" varies between boards. The access point password defaults to "BeagleBone". Your Beagle should be running a DHCP server that will provide your computer with an IP address in the 192.168.8.x range and reserve 192.168.8.1 for itself.
If your Beagle is connected to your local area network (LAN) via either Ethernet or WiFi, it will utilize mDNS to broadcast itself to your computer. If your computer supports mDNS, you should see your Beagle as beaglebone.local. Non-BeagleBone boards will utilize alternate names. Multiple BeagleBone boards on the same network will add a suffix such as beaglebone-2.local.
The below table summarizes the typical addresses and should dynamically update to indicate an active connection. Note that you must load this page without HTTPS security for the automatic detection to work.
|IP Address||Connection Type||Operating System(s)||Status|
|192.168.6.2||USB||Mac OS X, Linux|
With the latest images, it should no longer be necessary to install drivers for your operating system to give you network-over-USB access to your Beagle. In case you are running an older image, an older operating system or need additional drivers for serial access to older boards, links to the old drivers are below.
|Operating System||USB Drivers||Comments|
|Windows (64-bit)||64-bit installer||
If in doubt, try the 64-bit installer first.
|Windows (32-bit)||32-bit installer|
|Mac OS X||
|Install both sets of drivers.|
|Linux||mkudevrule.sh||Driver installation isn't required, but you might find a few udev rules helpful.|
Note: Additional FTDI USB to serial/JTAG information and drivers are available from www.ftdichip.com/Drivers/VCP.htm.
Browse to your Beagle
Using either Chrome or Firefox (Internet Explorer will NOT work), browse to the web server running on your board. It will load a presentation showing you the capabilities of the board. Use the arrow keys on your keyboard to navigate the presentation.
- Click here to launch: http://192.168.7.2
Older software images require you to EJECT the BEAGLE_BONE drive to start the network. With the latest software image, that step is no longer required.
Do not use Internet Explorer.
Virtual machines are not recommended when using the direct USB connection. It is recommended you use only network connections to your board if you are using a virtual machine.
When using 'ssh' with the provided image, the username is 'debian' and the password is 'temppwd'.
Visit beagleboard.org/support for additional debugging tips.
Update board with latest software
Step #1: Download the latest software image
Download the lastest Debian image from beagleboard.org/latest-images. The "IoT" images provide more free disk space if you don't need to use a graphical user interface (GUI).
Note: Due to sizing necessities, this download may take 30 minutes or more.
The Debian distribution ships with the boards. The file you download will have an .img.xz extension. This is a compressed sector-by-sector image of the SD card.
Step #2: Install SD card programming utility
Download and install Etcher.
Some general help on programming SD cards can be found on the Ubuntu Image Writer page.
Step #3: Connect SD card to your computer
Use your computer's SD slot or a USB adapter to connect the SD card to your computer.
Step #4: Write the image to your SD card
Use Etcher to write the image to your SD card. Etcher will transparently decompress the image on-the-fly before writing it to the SD card.
Step #5: Eject the SD card
Eject the newly programmed SD card.
Step #6: Boot your board off of the SD card
Insert SD card into your (powered-down) board, hold down the USER/BOOT button (if using Black) and apply power, either by the USB cable or 5V adapter.
If using an original BeagleBone, you are done.
If using BeagleBone Black and desire to write the image to your on-board eMMC, you'll need to follow the instructions at http://elinux.org/Beagleboard:BeagleBoneBlack_Debian#Flashing_eMMC. When the flashing is complete, all 4 USRx LEDs will be steady on or off. The latest Debian flasher images automatically power down the board upon completion. This can take up to 45 minutes. Power-down your board, remove the SD card and apply power again to finish.
Other currently available software images
Some of the starting images below involve multiple steps to produce an SD card image or otherwise change some of the steps above, so be sure to read all the instructions on their pages. Choose the starting point you want, download or produce the SD card image and follow the steps above.
At the time of release, not all of these distributions support BeagleBone Black, but should soon.
- Texas Instruments releases: Android, Linux, StarterWare (no OS)
- Linux: Debian, Angstrom Distribution, Ubuntu, ArchLinux, Gentoo, Sabayon, Buildroot, Erlang, Fedora
- Other: QNX, FreeBSD
- Projects page
The BeagleBoneBlack wiki page documents all of the known hardware issues, as well as the latest available software, hardware hardware documentation and design materials.
Other links to design materials for various releases can be found at beagleboard.org/hardware/design.
For a complete list of books on BeagleBone, see beagleboard.org/books.
Bad to the Bone
Perfect for high-school seniors or freshman univerisity level text, consider using "Bad to the Bone"
A lighter treatment suitable for a bit broader audience without the backgrounders on programming and electronics, consider "BeagleBone Cookbook"
Exploring BeagleBone and Embedded Linux Primer
To take things to the next level of detail, consider "Exploring BeagleBone" which can be considered the missing software manual and utilize "Embedded Linux Primer" as a companion textbook to provide a strong base on embedded Linux suitable for working with any hardware that will run Linux.