Releases · sijah/Square_PI

v2.0.0 — 2026-06-20

bt-setup.sh has been removed. Bluetooth setup is now built into install.sh
and is enabled with the --with-bt flag. Any automation or documentation
referencing bt-setup.sh should be updated.

Unified installer — install.sh --with-bt now handles the full stack:
TAS5805M driver, MPD, myMPD, and Bluetooth A2DP in a single run.
BlueALSA v4 compatibility — Fixed startup crash on Raspberry Pi OS Bookworm
where bluez-alsa-utils v4.3.x rejected the --codec=AAC flag (AAC is not
compiled into the Bookworm package). BlueALSA now starts with -S -p a2dp-sink
(SBC only).
rfkill fix — Bluetooth adapter soft-block is now automatically cleared
during install and persisted across reboots via /etc/rc.local. Previously
the adapter powered on with Soft blocked: yes after reboot and was not
discoverable.
Reliable BT device name — Bluetooth device name is now set via both
/etc/bluetooth/main.conf and bluetoothctl system-alias. Previously, if the
Pi hostname was not SquarePi, the device appeared under the hostname instead
of the configured name.
bluealsa-aplay — No longer overrides the stock systemd unit. The
Bookworm stock unit is correct and is now simply enabled. The previous
custom unit used wrong flags and conflicted with the stock service.

BlueALSA service crash loop (Invalid BT codec name: AAC) on
bluez-alsa-utils v4.x — fixed by dropping AAC from the ExecStart override.
BT adapter not discoverable after reboot due to rfkill soft block — fixed by
adding rfkill unblock bluetooth and hciconfig hci0 up to /etc/rc.local.
squarepi-bt-agent.service not created when bt-setup.sh exited early at
the BlueALSA step — fixed; agent is now installed as part of the main flow
after BlueALSA is confirmed running.

SBC is the only supported Bluetooth codec. AAC requires a custom build of
BlueALSA and is not available in the Raspberry Pi OS Bookworm package.
Tested on Raspberry Pi Zero 2W, Raspberry Pi OS Lite Bookworm,
bluez-alsa-utils v4.3.1.