User manual BIAMP DRI RS-232

[. . . ] RS-232 Control of the Advantage DRI ________________________________________________________________________________________ Biamp Systems, 14130 N. W. (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. It is assumed that the reader is an experienced programmer and has some familiarity with standard programming practices, binary and hexadecimal numbers, the ASCII character set, asynchronous serial data communications, and RS-232 interfaces. Hexadecimal, ASCII-Hex, and "Pseudo-Hex" Numbers Throughout this document, hexadecimal numbers shall be represented by preceding the number with "0x". [. . . ] 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. Device Type Bitmask (pseudo-hex) Device Number (pseudo-hex) do-volume-action command character (0x23) Syntax of Response: (no response) Example: 2:8001# This example causes Advantage DRI number 1 to increase the main output volume by one step. Comments: The Advantage DRI supports 51 discrete volume levels or steps: 0 (minimum volume) thru 100 (maximum volume) in increments of 2. On a 0 - 100 scale, each volume up or volume down command increments or decrements the volume by 2 (one step). The typical execution time for the do-volume-action command is 5 milliseconds (not including the time required to transmit the command string). page 10 Computer Control of the Advantage DRI 21-Jul-97 $ define-preset-mix Description: The define-preset-mix command provides a new definition for the specified preset mix. [. . . ] 0x75 get-preset nibble 0x5 button 04 button 20 button 35 select 2, 4 0x16 038. 0x76 get/set-volume nibble 0x6 button 05 button 21 button 36 select 1, 2, 4 0x17 039. 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. [. . . ]