-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
0844235
commit 12e33c4
Showing
1 changed file
with
2 additions
and
63 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -4,74 +4,13 @@ This [beagleboard module](https://app.viam.com/module/viam/beagleboard) implemen | |
|
|
||
| ## Setup | ||
|
|
||
| The [BeagleBone AI-64](https://docs.beagleboard.org/latest/boards/beaglebone/ai-64/) from [BeagleBoard.org](https://beagleboard.org/) is an open-source single-board computer with a Debian GNU/Linux operating system based on the Texas Instruments TDA4VM processor. | ||
| Follow this guide to set up your BeagleBone AI-64 and prepare it for `viam-server` installation. | ||
| Follow the [setup guide](https://docs.viam.com/installation/prepare/beaglebone-setup/) to prepare your BeagleBone for running `viam-server` before configuring a `beaglebone` board. | ||
|
|
||
| ### Hardware requirements | ||
|
|
||
| You need the following hardware, tools, and software to install `viam-server` on a BeagleBone AI-64: | ||
|
|
||
| 1. A [BeagleBone AI-64](https://www.beagleboard.org/boards/beaglebone-ai-64) | ||
| 2. A 5V barrel jack (recommended) and/or USB-C power supply, to power the BeagleBone | ||
| 3. Ethernet cable and/or WiFi dongle, to establish network connection on the BeagleBone | ||
| 4. (Optional) A microSD card and a way to connect the microSD card to the computer (like a microSD slot or microSD reader) | ||
| - This is required if you need to set up your BeagleBone for the first time or update your BeagleBone to the latest software image. | ||
|
|
||
| The following instructions mirror the instructions given in the [BeagleBoard Quick Start Guide](https://docs.beagleboard.org/latest/boards/beaglebone/ai-64/02-quick-start.html). | ||
|
|
||
| If you want additional help setting up your BeagleBone, you can follow the guides there and return to the Viam docs after SSH'ing into your BeagleBone. | ||
|
|
||
| ### Power your BeagleBone | ||
|
|
||
| Power your board by plugging a 5VDC power source into the BeagleBone's barrel jack. | ||
| You can also power the BeagleBone with a USB-C cable, but a 5VDC power source is recommended for more reliable performance. | ||
|
|
||
| If the board has power, the LED on the board labeled _PWR_ or _ON_ is lit steadily. | ||
|
|
||
| ### Enable a network connection | ||
|
|
||
| You need to enable a network connection on your BeagleBone to install `viam-server` on it. | ||
| You can do this in multiple ways: | ||
|
|
||
| - Connect an ethernet cable to your BeagleBone's ethernet port. | ||
| - If you are working on a macOS machine, use [internet sharing over USB](https://support.apple.com/guide/mac-help/share-internet-connection-mac-network-users-mchlp1540/mac) to share your connection. | ||
| After enabling the option on your machine, SSH into your BeagleBone and run `sudo dhclient usb1`. | ||
| - If you are working on a Linux machine, read [these tips on enabling a network connection](https://elinux.org/Beagleboard:Terminal_Shells). | ||
| - If your personal computer supports mDNS (Multicast DNS), you can check to see if your BeagleBone board has established a network connection by visiting [beaglebone.local](https://beaglebone.local). | ||
|
|
||
| ### SSH into your BeagleBone from your PC | ||
|
|
||
| You can SSH into your BeagleBone by running the following command in your terminal: | ||
|
|
||
| `ssh <your-username>@<your-hostname>.local` | ||
|
|
||
| By default, the hostname, username and password on a BeagleBone are: | ||
|
|
||
| - Hostname: `beaglebone` | ||
| - Username: `debian` | ||
| - Password: `temppwd` | ||
|
|
||
| Therefore, if you are using the default settings on your BeagleBone, the command is: | ||
|
|
||
| `ssh [email protected]` | ||
|
|
||
| ### Update your BeagleBone | ||
|
|
||
| After SSH'ing into your BeagleBone, verify all packages are up to date: | ||
|
|
||
| `sudo apt update && sudo apt dist-upgrade && sudo reboot` | ||
|
|
||
| ### Troubleshooting | ||
|
|
||
| If you experience any issues getting Viam working on your BeagleBone, consult the [BeagleBone documentation](https://docs.beagleboard.org/latest/boards/beaglebone/ai-64/02-quick-start.html) for help updating your BeagleBone. | ||
|
|
||
| You can find additional assistance in the [Troubleshooting section](https://docs.viam.com/appendix/troubleshooting/). | ||
| ## Configure your beaglebone board | ||
|
|
||
| > [!NOTE] | ||
| > Before configuring your board, you must [create a machine](https://docs.viam.com/cloud/machines/#add-a-new-machine). | ||
| ## Configure your beaglebone board | ||
|
|
||
| Navigate to the [**CONFIGURE** tab](https://docs.viam.com/configure/) of your [machine](https://docs.viam.com/fleet/machines/) in the [Viam app](https://app.viam.com/). | ||
| [Add board / beagleboard:beaglebone to your machine](https://docs.viam.com/configure/#components). | ||
|
|
||
|
|
||