Skip to main content
Version: 0.2.x

Software Installation

BeagleBone shortcut is BBB.

  1. Connect BeagleBone to boneIO and plug-in network cable.
  2. Find BBB in your network.
  3. Connect via ssh with username debian. Default password is temppwd.
  4. Change default password by running
passwd

Update your BBB​

(click Yes if needed to perform upgrade). First upgrade can take ~30mins.

sudo apt-get update && sudo apt-get dist-upgrade
reboot

Add uEnv to enable all possible PINS​

Edit /boot/uEnv.txt and uncomment following lines

disable_uboot_overlay_video=1
disable_uboot_overlay_audio=1
disable_uboot_overlay_wireless=1

Disable unnecessary services​

(if you need some you can just avoid disabling it).

sudo systemctl disable bonescript-autorun nginx wpa_supplicant bonescript.socket cloud9.socket cryptsetup.target
reboot

Install dependencies​

sudo apt-get install libopenjp2-7-dev libatlas-base-dev python3-venv

Now there are 2 ways to install BoneIO app.

Semi auto installation​

Follow on screen instruction.

bash -c "$(wget -qLO - https://github.com/boneIO-eu/app_bbb/raw/main/install_script.sh)"

Manual installation​

Preffered way.

Let's assume installing as default debian user in home directory and Python 3.7 as base.

Prepare VENV​

mkdir ~/boneio
python3 -m venv ~/boneio/venv
source ~/boneio/venv/bin/activate
pip3 install --upgrade boneio
cp ~/venv/lib/python3.7/site-packages/boneio/example_config/*.yaml ~/boneio/

Now edit ~/boneio/config.yaml

Run manually with debug flag​

source ~/boneio/venv/bin/activate
boneio run -c ~/boneio/config.yaml -dd

Create startup script​

Create file `~/boneio/boneio.service

[Unit]
Description=boneIO
After=multi-user.target

[Service]
Type=simple
ExecStart=/home/debian/boneio/venv/bin/boneio run -c /home/debian/boneio/config.yaml

[Install]
WantedBy=multi-user.target

Copy file to systemd and enable it.

sudo cp ~/boneio/boneio.service /lib/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now boneio