onairscreen:playoutone-led-en [astrastudio wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Drive the OnAirScreen ON AIR LED from PlayoutONE ======

[[https://www.aiir.com/|Aiir PlayoutONE]] can turn OnAirScreen **LED1** (factory label **ON AIR**) when **Data Controller** sees a mixer GPI (Axia, Wheatstone, serial) and runs ''RUNAPP'' with ''oas_send''.

This is **not** the current-title howto. Titles: [[onairscreen:playoutone-en|Show the current PlayoutONE title on OnAirScreen]].

API reference: [[oas:api|OnAirScreen API / UDP / HTTP / MQTT]]\\
Mixer GPI on a Raspberry Pi (no playout in between): [[onairscreen:manual-en|User Manual]] (GPIO)\\
Aiir: [[https://support.aiir.com/article/362-what-is-data-controller|Data Controller]], [[https://support.aiir.com/article/203-axia|Axia GPI]], [[https://support.aiir.com/article/392-commands|Commands]] (''RUNAPP'', ''IPCOMMAND'')

===== Two different “on air” signals =====

^ Signal ^ What it is ^ Use for LED1? ^
| Data Controller GPI (Axia pin, Wheatstone LIO, COM closure) | Desk tally into PlayoutONE | **Yes** — this is the studio lamp |
| ''ONAIR'' / ''OFFAIR'' / ''ONAIR CHANGE'' | Which **PC** is the on-air machine | No — studio take-over, not mic live |

[[https://support.aiir.com/article/1454-changing-on-air-studio-ip-command|ONAIR CHANGE]] is the wrong event for a lamp.

===== What OnAirScreen expects =====

^ Channel ^ Target (default) ^ Example ^
| HTTP | Port **8010** | ''http://OAS-IP:8010/?cmd=LED1:ON'' |
| UDP | Port **3310** | ''LED1:ON'' |

Same pattern for off: ''LED1:OFF''. OnAirScreen has **no** TCP command port — do not point ''IPCOMMAND'' at UDP **3310**.

On **Windows** test with ''oas_send.exe'' from the OnAirScreen license:

<code>
oas_send.exe --ip 192.168.23.5 "LED1:ON"
oas_send.exe --ip 192.168.23.5 "LED1:OFF"
</code>

Use ''oas_send-noconsole.exe'' from the same license in ''RUNAPP'' so no console flashes on air. If OnAirScreen runs on **the same PC**, use ''127.0.0.1''.

===== Recommended path: Data Controller GPI to RUNAPP =====

**1.** Data Controller running; mixer integration on (e.g. **Settings → Integrations** → Axia node). [[https://support.aiir.com/article/362-what-is-data-controller|What is Data Controller?]]

**2.** Two PlayoutONE **Commands** (Command Manager):

LED1 on (''RUNAPP'' path, then ''>'' then arguments — [[https://support.aiir.com/article/392-commands|RUNAPP]]):

<code>
RUNAPP C:\Path\To\oas_send-noconsole.exe>--ip 192.168.23.5 "LED1:ON"
</code>

LED1 off: same with ''LED1:OFF''. Adjust the path to where the OnAirScreen tools sit.

**3.** Data Controller **command matrix**: incoming GPI (Axia pin ON/OFF, Wheatstone SLIO, serial string) to those two commands. Pin **ON** / high → LED1 on; pin **OFF** / low → LED1 off. You can keep an existing “Play Next” mapping and add a second command for the lamp.

Axia GPIO capture: [[https://support.aiir.com/article/203-axia|Connecting to Axia nodes]].

Firewall: the PlayoutONE PC must reach OnAirScreen TCP **8010** (''oas_send'' uses HTTP) or UDP **3310**.

===== Option B — HTTP without oas_send =====

If you would rather hit the API from a one-liner:

<code>
RUNAPP C:\Windows\System32\curl.exe>-s "http://192.168.23.5:8010/?cmd=LED1:ON"
</code>

OnAirScreen still needs **GET**. There is no PlayoutONE “HTTP GET metadata output” for GPI — Monitor metadata is titles only ([[onairscreen:playoutone-en|title howto]]).

===== Notes =====

  * ''IPCOMMAND host:port TEXT'' opens a **TCP** socket and writes a string. That does not match OnAirScreen’s UDP command port. Prefer ''RUNAPP'' + ''oas_send''.
  * Raspberry Pi with a desk contact: GPIO in the [[onairscreen:manual-en|User Manual]] is shorter than Data Controller.
  * Questions: [[https://www.astrastudio.de/kontakt/|Contact]]

===== Other LED howtos =====

[[onairscreen:mairlist-led-en|mAirList]] · [[onairscreen:proppfrexx-led-en|ProppFrexx]] · [[onairscreen:myriad-led-en|Myriad Playout]] · [[onairscreen:playoutone-led-en|PlayoutONE]] · [[onairscreen:rodecaster-pro-ii-led-en|RØDECaster Pro II (MIDI)]]

Titles: [[onairscreen:mairlist-en|mAirList]] · [[onairscreen:radioboss-en|RadioBOSS]] · [[onairscreen:radiodj-en|RadioDJ]] · [[onairscreen:playoutone-en|PlayoutONE]] · [[onairscreen:stationplaylist-en|StationPlaylist]] · [[onairscreen:proppfrexx-en|ProppFrexx]] · [[onairscreen:myriad-en|Myriad Playout]] · [[onairscreen:zetta-en|RCS Zetta]]