bmedicke / aruna

✨🧵 Raspberry Pi based LED strip control (with individual LEDs)

see https://github.com/bmedicke/smart-mirror for another React project

Aruna

Raspberry Pi based LED strip control (with individual LEDs)

• front-to-back.py
• back-to-hardware.py
• setup
• running it
• supplemental
  • Power Circuit Diagramm
  • Pin Layout
  • terminology
  • useful links
  • useful repos

front-to-back.py

• connects Home Assistant via MQTT to the database

back-to-hardware.py

• translates database changes to the physical world

setup

# install docker:
curl -fsSL https://get.docker.com -o get-docker.sh
sh ./get-docker.sh
rm get-docker.sh

# install docker-compose and postgres:
apt install docker-compose postgresql -y

# we only need it for the cli tools:
systemctl disable --now postgresql

# create and activate virtual environment:
python3 -m venv env
source env/bin/activate

# on rpi4 you might get an error about multiple
# definitions while installing rpi.gpio,
# to avoid them use the flag:
export CFLAGS=-fcommon

# upgrade/install libs:
pip install --upgrade adafruit-blinka
pip install --upgrade adafruit-circuitpython-neopixel
pip install --upgrade black

# [binary] version not yet supported for ARM.
pip install --upgrade 'psycopg[pool]'

running it

# start db and adminer:
docker-compose up -d

supplemental

Power Circuit Diagramm

Pin Layout

terminology

• entity
  • sensors, automations, switches, scenes
• device
  • physical objects (that might have multiple entities)

useful links

• Device Registry
• HA MQTT Light Schemas
  • template: the one tasmota uses
  • default: no flashing, transitions
  • json: all features
    • demo usage
• async-notifications with psycopg
  • get notified of db-updates
  • empty queries and performance impact
• psycopg writeup

useful repos

• https://github.com/bokub/rgb-light-card (Lovelace custom card for RGB lights)