airlabfaderstart:start
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
| airlabfaderstart:start [2019/05/29 14:02] – created support | airlabfaderstart:start [2021/11/30 15:42] (current) – support | ||
|---|---|---|---|
| Line 2: | Line 2: | ||
| **__Question: | **__Question: | ||
| **__Answer: | **__Answer: | ||
| + | \\ | ||
| + | -------- | ||
| + | \\ | ||
| + | ===== Basic instructions ===== | ||
| + | \\ | ||
| For the Control surface of the Airlab you can use the Airence SDK (Service Development Kit) at the | For the Control surface of the Airlab you can use the Airence SDK (Service Development Kit) at the | ||
| [[SupAirlab: | [[SupAirlab: | ||
| This SDK only works for the Control Surface of the Airlab.\\ | This SDK only works for the Control Surface of the Airlab.\\ | ||
| + | \\ | ||
| The Airlab sends the Fader start trough RS232 / Serial port to a computer.\\ | The Airlab sends the Fader start trough RS232 / Serial port to a computer.\\ | ||
| Some playout software have the option to read the information from a serial port.\\ | Some playout software have the option to read the information from a serial port.\\ | ||
| + | \\ | ||
| The message format on the Serial port looks like this:\\ | The message format on the Serial port looks like this:\\ | ||
| 0xAAAAAAAA | 0xAAAAAAAA | ||
| + | \\ | ||
| AA = Action\\ | AA = Action\\ | ||
| CC = Channel\\ | CC = Channel\\ | ||
| DD = Data\\ | DD = Data\\ | ||
| + | \\ | ||
| + | #define SERIAL_ON | ||
| + | #define SERIAL_CUE | ||
| + | #define SERIAL_START | ||
| + | #define SERIAL_STOP | ||
| + | \\ | ||
| + | \\ | ||
| + | ------- | ||
| + | \\ | ||
| + | ===== Protocol Airlab ===== | ||
| + | \\ | ||
| + | It is possible to use the serial port of the Airlab. This communication port is compatible with the RS-232 standard that is used on PC and MAC. This makes it possible to write your own application for the Airlab. On this page you'll find settings and the protocol.\\ | ||
| + | \\ | ||
| + | ^ Settings : ^ ^ | ||
| + | | BaudRate : | 57600 Baud | | ||
| + | | Data size : | 8 Bits | | ||
| + | | Parity : | None | | ||
| + | | Stopbit : | One | | ||
| + | \\ | ||
| + | The Protocol:\\ | ||
| + | \\ | ||
| + | The protocol is build up in a simple way, a message contains minimal 3 bytes. Which are defined as follows:\\ | ||
| + | \\ | ||
| + | ^ Byte ^ Message | ||
| + | | Byte 1 | Message type | | ||
| + | | Byte 2 | Channel number | ||
| + | | Byte 3 | Data | | ||
| + | | Byte 4+ | Extended data | | ||
| + | \\ | ||
| + | Here you'll find the message options:\\ | ||
| + | \\ | ||
| + | Example 1: 0x80 00 01 : | ||
| + | ^ Message | ||
| + | ^ 0x80 ^ 00 ^ 01 ^ | ||
| + | ^ On switch | ||
| + | \\ | ||
| + | Example 2: 0x85 00 01 : | ||
| + | ^ Message | ||
| + | ^ 0x85 ^ 00 ^ 01 ^ | ||
| + | ^ On Air 2 ^ Don't care ^ ON ^ | ||
| + | \\ | ||
| + | Example 2: 0x93 00 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 :\\ | ||
| + | Configuration per channel pushed 16 times on startup or on request!\\ | ||
| + | ^ Message | ||
| + | ^ 0x93 ^ 00 ^ 01 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ 00 ^ | ||
| + | ^ Channel configuration | ||
| - | #define SERIAL_ON | + | \\ |
| - | #define SERIAL_CUE | + | ON-switch message, only to Airlab: |
| - | #define SERIAL_START | + | ^ Message |
| - | #define SERIAL_STOP | + | | 0x80 | Channel number |
| + | | " | ||
| + | \\ | ||
| + | CUE-switch message, only to Airlab: | ||
| + | ^ Message | ||
| + | | 0x81 | Channel number | ||
| + | | " | ||
| + | \\ | ||
| + | START & STOP message, only from Airlab (its possible you receive this message more than once): | ||
| + | ^ Message | ||
| + | | 0x82 | Channel number | ||
| + | | 0x83 | Channel number | ||
| + | \\ | ||
| + | ONAIR1 message, only from Airlab (its possible you receive this message more than once): | ||
| + | ^ Message | ||
| + | | 0x84 | Don't care | Byte 1 = 0 | OnAir 1 off | | ||
| + | | " | ||
| + | \\ | ||
| + | ONAIR2 message, only from Airlab (its possible you receive this message more than once): | ||
| + | ^ Message | ||
| + | | 0x85 | Don't care | Byte 1 = 0 | OnAir 2 off | | ||
| + | | " | ||
| + | \\ | ||
| + | TIMER START, STOP, RESET message, only to Airlab: | ||
| + | ^ Message | ||
| + | | 0x90 | Channel number | ||
| + | | 0x91 | Channel number | ||
| + | | 0x92 | Channel number | ||
| + | \\ | ||
| + | MODULE SETUP message, to and from Airlab: | ||
| + | ^ Message | ||
| + | | 0x93 | Channel number | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | \\ | ||
| + | MASTER SETUP message, | ||
| + | ^ Message | ||
| + | | 0x94 | Don't care | Byte 0 = 0 | Auto CUE Reset disabled | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | \\ | ||
| + | CONFIG message, only from Airlab: | ||
| + | ^ Message | ||
| + | | 0x95 | Don't care | Byte 1 = 1 | Triple-input module in slot 1 | | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | | " | ||
| + | \\ | ||
| + | EEPROM STORE message, only to Airlab: | ||
| + | ^ Message | ||
| + | | 0x96 | Don't care | Don't care | Store settings in EEPROM | ||
| + | \\ | ||
| + | CHIPCARD STORE message, only to Airlab: | ||
| + | ^ Message | ||
| + | | 0x97 | Don't care | Don't care | Store settings in SmartCard | ||
| + | \\ | ||
| + | CARD INSERTED message, only from Airlab: | ||
| + | ^ Message | ||
| + | | 0x98 | Don't care | Byte 1 = 0 | No Card Inserted | ||
| + | | " | ||
| + | \\ | ||
| + | IDSTRING message, only from Airlab: | ||
| + | ^ Message | ||
| + | | 0x9A | Don't care | Byte 1-30 | ASCII Chars | | ||
| + | \\ | ||
| + | GET MODULE SETUP message, only to Airlab: | ||
| + | ^ Message | ||
| + | | 0xB3 | Channel number | ||
| + | \\ | ||
| + | GET MASTER SETUP message, only to Airlab: | ||
| + | ^ Message | ||
| + | | 0xB4 | Don't care | Don't care | Airlab returns message 0x94 | | ||
| + | \\ | ||
| + | GET CONFIG message, only to Airlab: | ||
| + | ^ Message | ||
| + | | 0xB5 | Don't care | Don't care | Airlab returns message 0x95 | | ||
| + | \\ | ||
| + | GET CARDINSERTED message, only to Airlab: | ||
| + | ^ Message | ||
| + | | 0xB8 | Don't care | Don't care | Airlab returns message 0x98 | | ||
| + | \\ | ||
| + | GET IDSTRING message, only to Airlab: | ||
| + | ^ Message | ||
| + | | 0xBA | Don't care | Don't care | Airlab returns message 0x9A | | ||
| + | \\ | ||
| + | ------- | ||
| + | \\ | ||
| + | ===== Source code ===== | ||
| + | \\ | ||
| + | As the Protocol doesn' | ||
| + | \\ | ||
| + | This will also help to check how the functions work.\\ | ||
| + | \\ | ||
| + | message format:\\ | ||
| + | | ||
| + | \\ | ||
| + | AA = Action\\ | ||
| + | CC = Channel\\ | ||
| + | DD = Data\\ | ||
| + | \\ | ||
| + | | ||
| + | #define SERIAL_CUE | ||
| + | #define SERIAL_START | ||
| + | #define SERIAL_STOP | ||
| + | #define SERIAL_ONAIR1 | ||
| + | #define SERIAL_ONAIR2 | ||
| + | \\ | ||
| + | #define TIMER_START | ||
| + | #define TIMER_STOP | ||
| + | #define TIMER_RESET | ||
| + | #define SERIAL_MODULESETUPDATA | ||
| + | \\ | ||
| + | Byte 0: TIMERLINEA\\ | ||
| + | Byte 1: TIMERLINEB\\ | ||
| + | Byte 2: TIMERMIC\\ | ||
| + | Byte 3: STARTLINEA\\ | ||
| + | Byte 4: STARTLINEB\\ | ||
| + | Byte 5: STARTMIC\\ | ||
| + | Byte 6: STARTFADER\\ | ||
| + | Byte 7: STARTON\\ | ||
| + | Byte 8: STARTCUE\\ | ||
| + | Byte 9: STARTPULS\\ | ||
| + | Byte 10: | ||
| + | Byte 11: | ||
| + | Byte 12: | ||
| + | Byte 13: | ||
| + | Byte 14: | ||
| + | Byte 15: | ||
| + | Byte 16: | ||
| + | Byte 17: | ||
| + | Byte 18: | ||
| + | Byte 19: | ||
| + | Byte 20: | ||
| + | Byte 21: | ||
| + | Byte 22: | ||
| + | Byte 23: | ||
| + | Byte 24: | ||
| + | Byte 25: | ||
| + | Byte 26: | ||
| + | Byte 27: | ||
| + | Byte 28: | ||
| + | \\ | ||
| + | #define SERIAL_MASTERSETUPDATA | ||
| + | \\ | ||
| + | Byte 0: | ||
| + | Byte 1: | ||
| + | Byte 2: | ||
| + | Byte 3: | ||
| + | \\ | ||
| + | #define SERIAL_CONFIG | ||
| + | \\ | ||
| + | BYTE 0: | ||
| + | BYTE 1: | ||
| + | BYTE 2: | ||
| + | BYTE 3: | ||
| + | BYTE 4: | ||
| + | BYTE 5: | ||
| + | BYTE 6: | ||
| + | BYTE 7: | ||
| + | BYTE 8: | ||
| + | BYTE 9: | ||
| + | BYTE 10: CHANNEL11\\ | ||
| + | BYTE 11: CHANNEL12\\ | ||
| + | BYTE 12: CHANNEL13\\ | ||
| + | BYTE 13: CHANNEL14\\ | ||
| + | BYTE 14: CHANNEL15\\ | ||
| + | BYTE 15: CHANNEL16\\ | ||
| + | \\ | ||
| + | #define STORE_EEPROM | ||
| + | #define STORE_SMARTCARD | ||
| + | #define CARD_INSERTED | ||
| + | #define SERIAL_IDSTRING | ||
| + | \\ | ||
| + | #define GETSERIAL_MODULESETUPDATA | ||
| + | #define GETSERIAL_MASTERSETUPDATA | ||
| + | #define GETSERIAL_CONFIG | ||
| + | \\ | ||
| + | #define GETCARD_INSERTED | ||
| + | \\ | ||
| + | #define GETSERIAL_IDSTRING | ||
| + | \\ | ||
| + | -- Addition for V2.0 (Director) | ||
| + | message format:\\ | ||
| + | | ||
| + | \\ | ||
| + | AA = Action\\ | ||
| + | CC = Telco channel\\ | ||
| + | DD = Data\\ | ||
| + | \\ | ||
| + | #define TODIRECTOR_TELCO_CONNECT | ||
| + | #define TODIRECTOR_TELCO_RING | ||
| + | #define TODIRECTOR_TELCO_CUE | ||
| + | #define TODIRECTOR_TELCO_MUTE | ||
| + | \\ | ||
| + | #define TODIRECTOR_FUNCTION | ||
| + | #define TODIRECTOR_CRMMUTE | ||
| + | #define TODIRECTOR_STUDIOMUTE | ||
| + | #define TODIRECTOR_CUE_BY_MIC_REMOTE | ||
| + | \\ | ||
| + | message format:\\ | ||
| + | | ||
| + | \\ | ||
| + | AA = Action\\ | ||
| + | CC = Telco channel\\ | ||
| + | DD = Data\\ | ||
| + | \\ | ||
| + | #define FROMDIRECTOR_TELCO_ON_CONNECT | ||
| + | #define FROMDIRECTOR_TELCO_MUTE | ||
| + | #define FROMDIRECTOR_TELCO_TB | ||
| + | \\ | ||
| + | #define FROMDIRECTOR_TB | ||
| + | #define TB_CONSOLE | ||
| + | #define TB_ALL | ||
| + | \\ | ||
| + | \\ | ||
| + | [[start: | ||
airlabfaderstart/start.1559131337.txt.gz · Last modified: 2019/05/29 14:02 by support