v3.1: Native Home Assistant Integration & Pi 5 Support

[MichaelB2018]

v3.1 - Feature Release

v3.0 was a pure modernization release - it upgraded frontend libraries, restructured the backend, and cleaned up technical debt, with no goal of adding new functionality.

v3.1 is a feature release, largely focused on adding native Home Assistant support.

New Features

Home Assistant Custom Component

• Native HA integration with config flow UI - no YAML needed
• Cover entities with open / close / stop / position control
• Automatic 30-second polling via DataUpdateCoordinator
• Stop button only shown while a shutter is moving
• HACS-compatible (installable as a custom repository)
• Communicates directly with the Pi-Somfy web API - no MQTT broker required

Home Assistant Supervisor Add-on

• Run Pi-Somfy on the same Pi as Home Assistant - no separate device needed
• Debian Bookworm base with GPIO access
• Builds both pigpio and lgpio from source

Raspberry Pi 5 Support (Experimental)

• Auto-detection via /proc/device-tree/model, /dev/gpiochip4, /proc/cpuinfo
• lgpio library for the Pi 5 RP1 chip, with gpiochip4 to gpiochip0 fallback
• Original pigpio code path preserved unchanged for Pi 1-4

Backend Improvements

• New /getStatus and /setPosition HTTP endpoints
• paho-mqtt now optional (only needed with -m flag)
• MQTT loop_start() background thread fix

Documentation

• Home Assistant Integration section (now Section 7, recommended)
• MQTT section updated (Section 8, still fully supported)
• Upgrade instructions for existing users