Pioneer Legacy Smart-Home-Integration, kostenlos und Open Source
Control older Pioneer AV receivers (2009-2015, IP control on port 8102 or 23).
Veröffentlicht von daviddu26
- Geräte
- Version 1.0.7
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
This integration drives older Pioneer AV receivers from Gladys (about 2009 to 2015: VSX-5xx to VSX-11xx, SC, SC-LX, and the Elite models of the same years). They use the legacy Pioneer IP control protocol on port 8102 (or 23 on some models). Recent Pioneers (2016 and later) speak the Onkyo protocol: use the Onkyo integration for them.
Everything stays local: Gladys talks to the receiver directly on your network, no account, no cloud.
Before you start
- Connect the receiver to the network.
- Turn on Network Standby in the receiver's menu. Without it, the receiver drops the network in standby and Gladys cannot switch it on.
- Preferably give it a fixed IP (DHCP reservation).
Adding a receiver
- Open the Discovery tab and click Scan. Gladys looks for the Pioneer receivers on your network (UPnP), checks they answer the protocol, and detects what each one can do.
- Add the receivers found. A model with a zone 2 or a zone 3 shows up with one device per zone.
Your receiver does not show up? It may sit on another network (VLAN), or its UPnP is off. Type its IP address in Receiver addresses (several separated by commas), save, then scan again. The Check an IP address button tells at once whether an address is a supported receiver.
Even when added by its IP, a receiver keeps its identity if its address changes: it is recognized by its UPnP id when it has one.
Configuration
- Receiver addresses: only for receivers the scan does not find.
- Maximum volume (%): Gladys never raises the volume above it, whatever a slider, a button or a scene asks. 80 % by default.
- Input names: most models cannot report their input names. Rename them
as
code=namepairs, e.g.25=Apple TV, 05=TV. Models that can report their names show them on their own.
What you get
For every zone:
- Power (on / standby)
- Volume from 0 to 100 % (100 % = the receiver's maximum, 87 % = 0 dB), Volume up and Volume down, Mute
- Input: the list of inputs
For the main zone, also:
- Listening mode: the mode groups of the remote (Auto surround, Auto/Direct, Stereo, Standard, Advanced). A group recalls its last used mode; sent again less than 2 seconds later, it moves to the next mode, like the remote.
- Current listening mode (text), on the models that can report it.
Changes made with the remote or the front panel show up in Gladys at once: the receiver reports them on its own.
Dashboard
- To control the receiver, add it to Gladys' standard Devices widget: an on / standby switch, a volume slider, lists for the input and the listening mode, and the mute and volume ± buttons.
- To see its state at a glance, add the Receiver status widget (Pioneer Legacy section) and pick the receiver, or the zone: power, volume (live), sound (on or muted) and current input.
Configuration buttons
- Check an IP address: model, port and detected features.
- Test the connections: the state of every receiver added.
- Send a command: any command of the Pioneer protocol, with the receiver's
answer. Examples:
?P(power),?V(volume),25FN(input 25),0112SR(EXTENDED STEREO directly, on the models that accept it).
Scenes
The Send a Pioneer command action sends a raw command to the chosen receiver. The receiver's answer is available to the next actions.
Commands used
The codes come from Pioneer's official "AVR IP & RS-232" command sheets.
| Function | Main zone | Zone 2 | Zone 3 |
|---|---|---|---|
| Power on / off | PO / PF | APO / APF | BPO / BPF |
| Power state | ?P → PWRx | ?AP → APRx | ?BP → BPRx |
| Volume up / down | VU / VD | ZU / ZD | YU / YD |
| Volume state | ?V → VOLxxx | ?ZV → ZVxx | ?YV → YVxx |
| Mute on / off | MO / MF | Z2MO / Z2MF | Z3MO / Z3MF |
| Select an input | xxFN | xxZS | xxZT |
| Input state | ?F → FNxx | ?ZS → Z2Fxx | ?ZT → Z3Fxx |
An unknown command gets no error, just silence.
Troubleshooting
| Problem | Hint |
|---|---|
| The scan does not find the receiver | Type its IP in Receiver addresses. |
| "Recent receiver (Onkyo protocol)" | Use the Onkyo integration. |
| "Unreachable" | Network Standby on? Port 8102 reachable across your networks? |
| The volume stops going up | It reached the Maximum volume of the configuration. |
| The Advanced mode is the wrong one | It recalls the last Advanced mode: set it once. |
For more detail, set LOG_LEVEL=debug: the logs show every line exchanged
with the receiver.
Konfigurationseinstellungen
Diese Einstellungen fragt Pioneer Legacy in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Before you start | section | Nein | For Pioneer receivers from about 2009 to 2015 (VSX-5xx to VSX-11xx, SC, SC-LX...). Turn on Network Standby on the receiver, then click Scan in the Discovery tab: the receivers on your network are found automatically. Recent Pioneers (2016+) use the Onkyo integration instead. |
| Receiver addresses (optional) | string | Nein | Only for a receiver the scan does not find (other network, UPnP off): its IP address, several separated by commas. |
| Maximum volume (%) | number | Nein | Gladys never raises the volume above this level, on every receiver and zone. 100 % is the receiver's maximum (+12 dB); 87 % is 0 dB. |
| Input names (optional) | string | Nein | Rename inputs as code=name pairs separated by commas. Most models cannot report their input names. |
So installierst du Pioneer Legacy in Gladys
- Öffne in Gladys Integrationen: Pioneer Legacy erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/daviddu26/gladys-pioneer-legacy:1.0.7) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/daviddu26/gladys-pioneer-legacy.
Pioneer Legacy benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Pioneer Legacy ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von daviddu26 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation