18 · Anhang¶

Nachschlage-Referenz. Die Tabellen sind aus dem Firmware-Code abgeleitet – bei Code-Änderungen mitziehen.

Playmodi¶

Was die einzelnen Modi im Alltag bedeuten – mit Symbol und Beschreibung – steht in Kapitel 8 → Die Abspielmodi. Hier stehen nur die technischen IDs, wie sie in MQTT-Nachrichten, in der REST-API und in backup.txt auftauchen.

Kategorie	ID	Konstante
Einzeltrack	1 / 2 / 12	`SINGLE_TRACK` / `_LOOP` / `_OF_DIR_RANDOM`
Hörbuch (Position speicherbar)	3 / 4 / 16	`AUDIOBOOK` / `_LOOP` / `_RECURSIVE`
Ordner sortiert	5 / 7 / 15	`ALL_TRACKS_OF_DIR_SORTED` / `_LOOP` / `_RECURSIVE`
Ordner zufällig	6 / 9 / 17	`ALL_TRACKS_OF_DIR_RANDOM` / `_LOOP` / `_RECURSIVE`
Zufalls-Unterordner	13 / 14	`RANDOM_SUBDIRECTORY_…` (sortiert / zufällig)
Webradio	8	`WEBSTREAM`
Lokale m3u	11	`LOCAL_M3U`
MediaHub	18	`MEDIAHUB`
intern	0 / 10	`NO_PLAYLIST` / `BUSY`

Modifikationskarten¶

Karten, die eine Funktion auslösen statt Musik. Den vollständigen Katalog in Alltagssprache – sortiert nach Themen – findest du in Kapitel 8 → Modifikationskarten.

ID	Wirkung
100	Tasten + Encoder sperren
101 / 102 / 103 / 104	Sleep nach 15 / 30 / 60 / 120 min (+ LED-Dimm)
105	Sleep nach Ende des Tracks
106	Sleep nach Ende der Playlist
107	Sleep nach 5 Tracks
110 / 111	Endlosschleife Playlist / Track
120	LED-Nachtmodus (Helligkeit)
130	WLAN an/aus
140 / 141 / 142	BT-Senke / BT-Quelle / Modus durchschalten
150	FTP-Server aktivieren
151 / 152	IP-Adresse / Uhrzeit ansagen
153	Ambient-Light umschalten
154 / 155	LED-Helligkeit + / −

Steuer-Kommandos (Buttons / Rotary / MQTT)¶

Welche Taste ab Werk was tut, steht in Kapitel 9 → Tasten und Tastenkombinationen; zugewiesen werden die Kommandos in Kapitel 8 → Drehencoder & Taster.

ID	Kommando
170	Play/Pause
171 / 172	Vorheriger / Nächster Track
173 / 174	Erster / Letzter Track
175 / 176 / 177	Lautstärke: init / + / −
178	Batteriespannung messen
179	Deep-Sleep (sofort)
180 / 181	Sprung vor / zurück (Sprungweite im Webinterface einstellbar)
182 / 183	Stop / Neustart
184 / 185	Nächster / Voriger Ordner (rekursive Modi)
186	Sprung-Vorschau (nur Drehencoder-Geste)

Virtuelle RFID-Karten¶

Wozu sie gut sind und wie man sie auslöst, erklärt Kapitel 12 → Virtuelle RFID-Karten.

IDs 241–250 entsprechen den Karten 900000000001 … 900000000010.

MQTT-Topics¶

Muster: [<base_topic>/]device_id/topic[/<setter_token>]. Kommandos nutzen den Setter-Token (Default set), Status-Topics werden ohne ihn veröffentlicht. Alle Topics non-retained.

Topic	Richtung / Wertebereich	Bedeutung
`sleep`	Cmnd `0`/`OFF`; State `ON`/`OFF`	Ausschalten / Power-State
`rfid`	12 Ziffern	Karte emulieren / aktuelle Karte
`trackcontrol`	1–9	Stop/Play/Pause/Next/Prev/First/Last/Ordner±
`loudness`	0…max	Lautstärke setzen/melden
`sleep_timer`	`EOP`/`EOT`/`EO5T`/Minuten/`0`	Sleep-Timer setzen/melden
`sleep_timer_state`	JSON (State)	`{mode,remainingMinutes,remainingTracks}`; mode = OFF/MINUTES/EOT/EOP/EO5T
`lock_controls`	`ON`/`OFF`	Bedienelemente sperren
`repeatmode`	0–3	kein / Track / Playlist / beide
`led_brightness`	0–255	Neopixel-Helligkeit
`ambient_light`	`ON`/`OFF`	Ambient-Light
`track`	State	aktueller Track
`cover_changed`	State	Cover evtl. geändert
`state`	`Online`/`Offline`	Betriebszustand
`ipv4`	State	IP-Adresse
`pauseplay`	`idle`/`play`/`pause`	Wiedergabestatus
`playmode`	State	numerischer Playmode
`wifi_rssi`	State	WLAN-Signal (dBm)
`software_revision`	State	Firmware-Revision
`battery_voltage` / `battery_soc`	State	Spannung / Ladung % (falls Batteriemessung)

Beispiel: `sleep_timer_state`¶

Das Topic sleep_timer_state liefert den Schlaftimer als ein JSON-Objekt. Je nach Modus ist entweder remainingMinutes oder remainingTracks gesetzt (das jeweils andere Feld ist 0):

{"mode":"OFF","remainingMinutes":0,"remainingTracks":0}
{"mode":"MINUTES","remainingMinutes":29,"remainingTracks":0}
{"mode":"EOT","remainingMinutes":0,"remainingTracks":1}
{"mode":"EO5T","remainingMinutes":0,"remainingTracks":3}
{"mode":"EOP","remainingMinutes":0,"remainingTracks":7}

mode ist einer von OFF (kein Timer), MINUTES (Restminuten), EOT (Ende des Titels), EO5T (nach fünf Titeln) und EOP (Ende der Playlist). Bei EO5T/EOP zählt remainingTracks die verbleibenden Titel.

REST-API¶

Die vollständige REST-API ist als OpenAPI-Spezifikation direkt im Firmware-Repo gepflegt: REST-API.yaml. So bleibt sie mit dem Code synchron. (Optional später: als interaktive Swagger-Seite ins Handbuch einbetten.)

Verweise auf Forum-Threads¶

Changelog¶

Der aktuelle Changelog wird im Firmware-Repo gepflegt und dort fortlaufend ergänzt: changelog.md im dev-Branch – passend zu dem Stand, den dieses Handbuch beschreibt. Die Fassung im master-Branch enthält nur das, was bereits als Release veröffentlicht wurde.