User manual BIAMP DRI RS-232

[. . . ] RS-232 Control of the Advantage DRI ________________________________________________________________________________________ Biamp Systems, 14130 N. W. Science Park, Portland, Oregon 97229 U. S. A. (503) 641-7287 an affiliate of Rauland-Borg Corp. Introduction This document contains technical information relating to computer control of the Biamp Advantage DRI Digital Remote Interface. This information is intended for advanced users - in particular for those who wish to develop their own computer programs to control the Advantage DRI. [. . . ] Each Advantage DRI's device number is assigned using rear-panel dip-switches. Except for broadcast commands, any particular Advantage DRI will respond to an Advanced Computer Control command only if bit 7 of the Device Type Bitmask is a `1' and the Device Number parameter matches its dip-switch settings. 21-Jul-97 Computer Control of the Advantage DRI page 7 Advanced Computer Control Data Structures Preset Mix Status Data Structure The data structure used for preset mixes consists of an array of 13 bytes (which are transmitted as 26 pseudo-hex characters). Mix[0] through mix[11] represent the volume level and mute status of channels 1 through 12. Mix[12] represents the status of the logic outputs, and also has other special meanings for the "current" mix. Advantage DRI Preset Mix Data Structure 13 -byte array with elements numbered mix[0] thru mix[12] (msb) 7 6 5 4 Mix Mod 3 2 1 (lsb) 0 Note: Bits 0-5 of this byte are only significant for the "current" mix (0x80). mix[12] (transmitted first) Logic Logic 2 1 Last Recalled Preset mix[11] mix[10] mix[9] mix[8] mix[7] mix[6] mix[5] mix[4] mix[3] mix[2]] mix[1] mix[0] (transmitted last) Mute CHANNEL 12 VOLUME (0-100) Mute AUX1 OUTPUT/CH. 11 VOLUME (0-100) Mute MAIN OUTPUT/CH. 10 VOLUME (0-100) Mute AUX INPUT/CH. 9 VOLUME (0-100) Mute CHANNEL 8 VOLUME (0-100) Mute CHANNEL 7 VOLUME (0-100) Mute CHANNEL 6 VOLUME (0-100) Mute CHANNEL 5 VOLUME (0-100) Mute CHANNEL 4 VOLUME (0-100) Mute CHANNEL 3 VOLUME (0-100) Mute CHANNEL 2 VOLUME (0-100) Mute CHANNEL 1 VOLUME (0-100) page 8 Computer Control of the Advantage DRI 21-Jul-97 The volumes specified in mix[0] thru mix[11] have a range of 0 (minimum volume) thru 100 (maximum volume, `64' in pseudo-hex). The Advantage DRI only recognizes evennumbered volume steps - if an odd number is specified for a volume, the Advantage DRI will round it down to the next lower even number. For example, volume level 75 and volume level 74 are exactly the same as far as the Advantage DRI is concerned. Seven data bits are required to specify a number in the range of 0 to 100. The eighth data bit (bit 7) is used to indicate the mute status for each channel. If bit 7 is a `1', the channel is muted (set to minimum volume) and the volume level specified in bits 0 thru 6 specify what volume level the channel will return to if it receives an un-mute command. Bit 6 of mix[12] indicates the status of logic output number 1 - a '1' in this bit means the logic output is on, and a '0' in this bit means the logic output is off. When the Advantage DRI is used to control and Advantage DLA93, logic output 1 connects to the DLA93's master/slave logic input. Turning off logic output 1 puts the DLA93 into master mode and turning on logic output 1 puts the DLA93 into slave mode. Bit 7 of mix[12] indicates the status of logic output number 2 - a '1' in this bit means the logic output is on, and a '0' in this bit means the logic output is off. When the Advantage DRI is used to control and Advantage DLA93, logic output 2 connects to the DLA93's automix/manual logic input. Turning off logic output 2 puts the DLA93 into automix (gated) mode and turning on logic output 2 puts the DLA93 into manual (non-gated) mode. When the preset mix being specified is the "current" mix (mix number 0x80), bits 0 thru 3 of mix[12] indicate which preset mix was the last mix recalled and bit 4 of mix[12] indicates whether or not the current mix has been modified since the last time a preset mix has been recalled. Advanced Computer Control Command Notation For the following descriptions of the Advanced Computer Control command set, the following conventions will be used. Each ASCII character which represents a pseudo-hex nibble will be shown in italics, with the following letters representing certain types of parameters: a d m n v a pseudo-hex nibble specifying an action code. one of the pseudo-hex nibbles in the device number which indicates which device the command is addressed to. one of the pseudo-hex nibbles occurring in the preset mix data structure. a pseudo hex nibble specifying a channel number, logic output number, or preset mix number. one of the pseudo-hex nibbles specifying a volume level. 21-Jul-97 Computer Control of the Advantage DRI page 9 # do-volume-action Description: The do-volume-action command causes the Advantage DRI to perform the specified volume action (volume up, volume down, toggle mute, mute, or un-mute) for the specified channel. Syntax of Command: an80dd# where: a = n = 80 dd # = = = Volume Action: 0 = NOP, 1 = vol down, 2 = vol up, 3 = toggle mute, 4 = mute, 5 = un-mute. Channel Number (pseudo-hex): 1 - 8 = channel 1 - 8. [. . . ] 0x78 ETX 004. 0x04 020. EOT 005. 0x05 021. ENQ 006. 0x06 022. ACK 007. 0x07 023. BEL 008. 0x08 024. 0x18 040. BS 009. CAN EM SUB ESC FS GS RS US 0x09 025. do-logic nibble 0x8 button 07 button 23 button 38 select 1, 3, 4 0x19 041. 0x79 do-preset nibble 0x9 button 08 button 24 button 39 select 2, 3, 4 0x1A 042. 0x7A get-status nibble 0xA button 09 button 25 button 40 select 1, 2, 3, 4 0x1B 043. nibble 0xB button 10 button 26 select none 0x1C 044. [. . . ]