Repository navigation
Releases: Eibelucas/Kiosk-Satellite-SIP
Release list
26.10.18 - Custom SIP extensions
The native plugin and gateway now accept numeric device extensions with 1–79 digits, including 6000–6299. This removes the original 100–199 implementation restriction reported in #7. The 79-digit limit fits the bundled Asterisk 80-byte extension buffer including its terminating NUL.
- Custom extensions work in plugin registration, device editors and incoming ring groups.
- The bundled gateway retains extension 100 for existing clients and reserves 600 for the local echo test. Configured device identities cannot fall through to external provider routing.
- Existing device passwords and three-digit extensions remain valid. The gateway still supports up to 99 additional devices.
- The gateway includes separate administration pages for SIP accounts, numbers, kiosks, contacts, network and diagnostics, with migration of existing settings and explicit application of saved drafts.
Update both the Kiosk Satellite plugin and Home Assistant app when using the bundled gateway. Users of a separate PBX only need the plugin update.
Validation covers native loopback SIP, real Asterisk registration and ring groups with extensions 6000 and 6299, gateway configuration, secret retention, desktop/mobile editor workflows and installable package format. No live provider call is required by the automated tests.
26.10.16 — SIP Phone: wake word coordination and PBX-only RTP
SIP Phone for Kiosk Satellite 26.10.16
- Rename the plugin to SIP Phone for Kiosk Satellite while preserving its ID and existing settings.
- Use English metadata and default UI text; select Language → Deutsch for German call controls and status messages.
- Temporarily mute wake word before a user places or answers a call, wait for listening to stop, and restore the previous mute state after hangup, cancellation, or failure. Incoming ringing alone does not mute it.
- Restrict the SDP RTP destination to the resolved PBX address and connect the RTP socket to that endpoint.
- Remove the unused web-phone plugin class and obsolete test wording.
Active Voice Satellite turns and intercom still block or end calls. If the host cannot mute wake word or release its microphone, pause wake word in Kiosk Satellite before calling. End calls before disabling or updating the plugin; interruption after host access is revoked can require manually restoring the wake word mute switch.
Automated checks exercise the mute lifecycle, cancellation races, media redirection rejection, SIP signaling, and package format. Physical microphone release and latency on Android devices still require device testing.
26.10.15 — Correct plugin icon resolution
Kiosk Satellite SIP 26.10.15
Fix the plugin icon reference so Kiosk Satellite resolves the packaged 256 × 256 PNG correctly. The manifest names icon.png; the release ZIP contains assets/icon.png.
Includes the official Install in Kiosk Satellite badge and English installation instructions introduced in 26.10.14. Call behavior and gateway configuration are unchanged.
26.10.14 — Plugin icon and installation instructions
Kiosk Satellite SIP 26.10.14
- Add a 256 × 256 phone icon to the plugin manifest and installable package.
- Add the official Install in Kiosk Satellite badge and manual installation instructions to the README.
- Validate the icon and package contents before release uploads.
The plugin and Home Assistant OS add-on share version 26.10.14. This release does not change call behavior or gateway configuration.
26.10.13 — Native SIP dialer and multi-device support
Version 26.10.13 introduces a native SIP dialer for Kiosk Satellite. A floating phone button opens number entry, and outgoing calls connect directly through the Asterisk telephone server. The call view shows the destination, status, duration, mute, and hangup controls.
The Home Assistant OS add-on supports multiple SIP devices with separate extensions and passwords. Ringing targets can be selected for each external phone number. Answering on one device stops the others from ringing.
Additional changes:
- Centered phone, close, and delete icons.
- Number entry and the keypad are hidden during a call.
- Separate RTP reception and audio playback with a bounded PCM queue.
- Smaller Android buffer requests; actual call latency remains device- and network-dependent.
Updating: Update the plugin and add-on separately. When switching from the previous web phone launcher, enter the HAOS address, SIP port, extension, and device password once in the plugin. The regular plugin ID remains kiosk-satellite-sip. Add-on 26.10.12 remains compatible with one registration on extension 100; multiple devices require 26.10.13.
Known limitations: Shared microphone management with Voice Satellite, native contacts, DTMF, TLS/SRTP, hold, and transfer are not implemented. A measured comparison of end-to-end latency is not yet available. Automated checks cover SIP protocol behavior, audio buffering, package format, backend behavior, and multiple devices on Asterisk.
26.10.12: Anrufernummer bei eingehenden Kiosk-Anrufen
Eingehende Kiosk-Anrufe zeigen jetzt die vom Anbieter übermittelte Anrufernummer statt des Kontonamens wie „Hauptrufnummer“.
- Die Audio-Brücke verwendet die eingehende Asterisk-Anrufernummer für die KS-Anrufanzeige.
- Nummernunterdrückung bleibt wirksam: Anonym bei unterdrückter Nummer, Unbekannter Anrufer bei fehlender oder ungültiger Nummer.
- Keine neue Speicherung von Anrufernummern in Konfiguration, Status oder Protokollen.
- Rufnummerneinstellungen, ausgehender Ablauf, Audio und Durchsage-Berechtigungen bleiben erhalten.
Aktualisierung: Für die Korrektur das HAOS-Add-on auf 26.10.12 aktualisieren und neu starten. Das Plugin steht ebenfalls in Version 26.10.12 bereit. Anschließend einen eingehenden Anruf am eigenen Gerät prüfen.
Softwaretests verwenden ausschließlich fiktive Anruferdaten und einen simulierten Kiosk. Die Anzeige auf dem echten Gerät und mit dem eigenen Anbieter muss noch bestätigt werden.
Der Release-Workflow erstellt Plugin-ZIP, Manifest und SHA-256-Datei automatisch.
26.10.11 – Wähltasten und direkter Kontakte-Zugriff
Die Telefonseite startet jetzt direkt mit den Wähltasten und verzichtet auf den großen Erklärungstext oben.
- Überschrift und Textblock entfernt; der Verbindungsstatus steht kompakt in der Seitenleiste.
- Wähltasten erscheinen bereits vor dem Laden der Kontakte. Ein verspäteter Kontaktabruf überschreibt die gewählte Ansicht nicht.
- Neuer Plugin-Befehl Kontakte öffnen für direkten Zugriff auf Kontakte und Favoriten. Ein Kontakt bereitet die Nummer vor; erst Anrufen mit Bestätigung fordert den Anruf an.
- Audio-/Registrierungsprüfung, Bestätigung und CSRF-Schutz bleiben erhalten. Gespeicherte Einstellungen, Kontakte und SIP-/Audio-Abläufe bleiben unverändert.
Grenze: Telefonkontakte werden nicht in die native KS-Gegensprechliste eingetragen. Die aktuelle SDK-1-Schnittstelle bietet dafür keinen Zugriff. Eine native Integration benötigt eine Erweiterung von Kiosk Satellite selbst.
Aktualisierung: HAOS-Add-on und Kiosk-Plugin auf 26.10.11 aktualisieren und die Telefonseite neu laden. Telefon öffnen zeigt die Wähltasten, Kontakte öffnen die Kontaktliste.
Die Darstellung am echten Kiosk ist noch zu prüfen. Der Release-Workflow erzeugt Plugin-ZIP, Manifest und SHA-256-Datei automatisch.
26.10.10 – Responsive Übersicht und Telefonseite
Die Einrichtung und Telefonseite nutzen breite Kiosk-Bildschirme besser und ordnen sich auf schmalen Displays untereinander an.
- Formular und Verbindungsstatus stehen auf breiten Displays nebeneinander. Zusammengehörige Eingaben nutzen zwei Spalten.
- Kontakte erscheinen in mehreren Spalten. Rufnummer, Suche und Ansichten stehen in einer kompakten Seitenleiste; das Wählfeld behält große Tasten.
- Weiterführende Testhinweise sind aufklappbar. Kiosk-Verbindungsprüfung und lokaler Echo-Test bleiben direkt erreichbar.
- Die Anleitung beschreibt Kiosk-Audio ohne zusätzliche Anmeldung von SIP-Telefon 100 und den sicheren lokalen Echo-Test.
- Eine zeitabhängige Kollision im isolierten SIP-Test wurde durch gestaffelte Registrierung und kurze Test-Wiederholungen behoben; Produktionszeiten bleiben unverändert.
Gespeicherte Einstellungen sowie SIP- und Audio-Abläufe bleiben unverändert. Die Darstellung am echten Kiosk ist noch zu prüfen.
Aktualisierung: Für die neue Oberfläche das HAOS-Add-on auf 26.10.10 aktualisieren und die Telefonseite neu laden. Das Kiosk-Plugin kann separat über den Plugin-Manager aktualisiert werden.
Der Release-Workflow erstellt automatisch die Plugin-ZIP, das Manifest und die SHA-256-Prüfsumme.
26.10.9 · Native Kiosk-Satellite-Audio-Verbindung
Audio-Ziel Kiosk Satellite Intercom im HA-Onboarding: native Anrufanzeige, Mikrofon und Lautsprecher eines konfigurierten Kiosk-Geräts. Die Brücke verbindet Asterisk AudioSocket (8 kHz) mit dem Intercom-WebSocket (16 kHz). Normale Anrufe klingeln zuerst am Kiosk; erst nach dem Annehmen wird verbunden. Separate Durchsagen behalten Absenderliste, PIN und Dauerlimit und senden kein Kiosk-Mikrofon zurück. SIP-Telefon 100 bleibt als alternative Audio-Ausgabe erhalten.
Einrichtung: HA-Add-on auf 26.10.9 aktualisieren und neu starten. Unter Telefon → Audio-Ziel → Kiosk Satellite Intercom die eigene Kiosk-IP, den Identitätsport (meist 2324), denselben Intercom-Schlüssel und einen freien HAOS-Rückrufport (Standard 8090) eintragen. Der dynamische Kiosk-Intercom-Port wird aus dessen Identität übernommen. Am Kiosk Intercom und Mikrofon erlauben, für Gegensprechen Hands free wählen. Speichern, Verbindung prüfen, lokalen Kiosk-Echo-Test starten und am Kiosk annehmen. Alle Schritte stehen in kiosk_sip/DOCS.md. Zugangsdaten bleiben lokal.
Prüfung: 121 Konfigurations-/API-/Protokolltests, JavaScript-Syntax, amd64-Container-Build, Portkonflikte, lokale SIP-/DNS-/RTP-Tests und echter Asterisk-FastAGI/AudioSocket-Echo-Test mit simuliertem Kiosk. Mikrofon-Testton wird bidirektional zurückgegeben; Auflegen hinterlässt keine Anrufkanäle. Es wird kein externer Testanruf gewählt. Plugin-ZIP, identisches Manifest und SHA-256 werden automatisch angehängt.
Grenzen: Ein konfiguriertes Kiosk-Gerät, lokales HTTP/WS. TLS-Intercom wird abgewiesen und nicht automatisch umgestellt. Mikrofon, Lautsprecher, Berechtigungen und Akustik des eigenen Android-Geräts müssen vor Ort mit dem Echo-Test geprüft werden.
26.10.8 · Heimnetz-Prüfung im Onboarding
Die Einrichtung unterscheidet jetzt eine öffentliche Geräte-IP, ein unzulässiges Heimnetz, ein unpassendes Subnetz und Netz-/Broadcast-Adressen. Bei der Ersteinrichtung wird kein Beispielnetz vorbelegt; die Zusammenfassung zeigt das eingetragene Heimnetz mit Netzmaske. Bestehende Anschlussdaten und SIP-Funktionen bleiben erhalten.
Prüfung: 99 Konfigurations-/API-Tests, JavaScript-Syntax, amd64-Container-Build, Portkonflikt-Test und lokale SIP-/DNS-/RTP-Tests erfolgreich. Plugin-ZIP, Manifest und SHA-256 werden automatisch angehängt.
Für diese Korrektur das HA-Add-on aktualisieren. Die direkte Audio-Brücke zu Kiosk Satellite Intercom ist in dieser Version noch nicht enthalten.