Frontier Silicon Internetradio (FSAPI / UNDOK)

Geräteprofil · Multimedia

Hinweis: Dieses Profil ist nach der FSAPI-Beschreibung von Frontier Silicon und Mitschnitten eines echten Geräts erstellt.

Ein Radio bzw. Lautsprecher mit Frontier-Silicon-Modul, erkennbar an der Steuerung per UNDOK-App (oder älter: Hama Digitalradio, TechniSat CONNECT, Roberts ConnecT, Medion Lifestream, Revo, Sangean, Ruark, Silvercrest …).
Radio im selben Netz wie der nomos Server, Netzwerk-Standby bzw. Netzwerk im Standby verbunden lassen eingeschaltet (sonst ist das Radio im Standby nicht erreichbar und kann nicht über nomos eingeschaltet werden).
Die PIN des Radios (Werkseinstellung 1234, im Radio unter Systemeinstellungen → Netzwerk → NetRemote PIN-Setup).
Port 80/TCP (HTTP).

Dem Radio im DHCP-Server eine feste IP-Adresse geben
Skills → Add-ons: Profil importieren
Gerät anlegen, Name, IP-Adresse und PIN eintragen
VOLUMEMAX einstellen: die höchste Lautstärkestufe des Radios (Werkseinstellung 20). Abfragen mit
```
curl "http://_IP_/fsapi/GET/netRemote.sys.caps.volumeSteps?pin=1234"
```
Die Antwort <u8>21</u8> bedeutet Stufen 0–20 → VOLUMEMAX = 20 (also Antwort minus 1). Der Wert wird zur Kontrolle auch als Volume steps (ausgeblendet) angezeigt.

Test von einem Rechner im selben Netz (muss <status>FS_OK</status> liefern):

curl "http://_IP_/fsapi/GET/netRemote.sys.power?pin=1234"

State (state) — Ein/Standby, schaltbar (switchon / switchoff)
Playing (playing) — Radio ist an und spielt (Player-Status Playing)
Player state (status) — Idle / Buffering / Playing / Paused / Rebuffering / Error / Stopped
Mode (mode) — aktive Quelle als Nummer, umschaltbar (siehe unten)
Title (title) — Sender- bzw. Titelname
Info text (infotext) — Zusatztext (Radiotext, DAB-DLS, „Jetzt läuft“)
Artist (artist) — Interpret, sofern die Quelle ihn liefert
Volume (volume) — 0–100 %, setzbar; umgerechnet über VOLUMEMAX
Mute (mute) — Ton aus, schaltbar
Link quality (linkquality, ausgeblendet) — WLAN-Empfang 0–100 % (100 % bei LAN)
Volume steps (volumesteps, ausgeblendet) — Anzahl Lautstärkestufen laut Radio
Reachable (reachable) — das Radio hat auf die letzte Anfrage geantwortet

Aktionen: Play, Pause, Weiter, Zurück (bei Radio: nächster/vorheriger Sender bzw. Frequenz).

Die Nummern der Quellen sind je Gerät verschieden (z. B. 0 = Internetradio, 1 = Spotify, 3 = DAB, 4 = UKW, 5 = AUX). Liste des eigenen Geräts:

curl "http://_IP_/fsapi/LIST_GET_NEXT/netRemote.sys.caps.validModes/-1?pin=1234&maxItems=20"

Jeder Eintrag <item key="N"> mit seinem label ist eine Quelle; N ist die Mode-Nummer.

nomos fragt Ein/Aus, Lautstärke, Ton aus und Player-Status alle 10 s ab, Titel und Info-Text alle 15 s, Interpret und Quelle alle 30 s, den WLAN-Empfang alle 5 Minuten. Jeder Wert ist eine eigene kleine HTTP-Anfrage (das Radio kennt keine Sammelabfrage, die alle Geräte unterstützen). Nach einem Befehl aus nomos erscheint der neue Zustand mit der nächsten Abfrage.
Das Profil sendet die PIN bei jeder Anfrage und arbeitet ohne Session. So bleibt die UNDOK-App parallel nutzbar. Einige wenige Geräte verlangen eine Session und antworten ohne sie mit HTTP 404 — dann meldet nomos das Radio als nicht erreichbar, und das Profil funktioniert mit diesem Gerät nicht.
Falsche PIN: das Radio antwortet mit HTTP 403, nomos zeigt das Radio als nicht erreichbar.
Ist ein Textfeld leer (z. B. kein Interpret oder Radio im Standby), behält nomos den letzten Text.
Sonderzeichen in Titeln kommen so, wie das Radio sie im XML schickt (z. B. & statt &).
Die Lautstärke wird in Stufen übertragen: bei VOLUMEMAX = 20 entspricht eine Stufe 5 %; ein gesetzter Wert wird auf die nächste Stufe gerundet.
Presets und das Blättern in Senderlisten sind nicht enthalten (dafür müsste das Radio vorher in den Navigationsmodus geschaltet werden).