Software Installation¶

BeagleBone shortcut is BBB.

Connect BeagleBone to boneIO backplane and plug-in network cable.
Find BBB in your network.
Connect via ssh with username debian. Default password is temppwd.
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

sudo reboot

Add uEnv to enable all possible PINS¶

Edit /boot/uEnv.txt and uncomment following lines (eg by using nano)

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

sudo reboot

Install dependencies¶

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

There are 2 ways to install BoneIO app.

Semi auto installation¶

Semi auto installations script currently isn’t working. Please follow to manual installation. ~~Follow on screen instruction. If you read -devX version of the docs this way of installation won’t work!~~

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

Manual installation¶

Prerequisites

MQTT broker. You can install it either in HA or on controller itself.

Preffered way.

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

Prepare VENV¶

export BONEIOPATH=~/boneio
mkdir $BONEIOPATH
python3 -m venv $BONEIOPATH/venv
source $BONEIOPATH/venv/bin/activate
pip3 install --upgrade pip
pip3 install boneIO
cp $BONEIOPATH/venv/lib/python3.7/site-packages/boneio/example_config/*.yaml $BONEIOPATH/

If you want to install

Now edit ~/boneio/config.yaml

Run manually with debug flag¶

# export BONEIOPATH=~/boneio
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
Restart=on-success

[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