User manual BIAMP VRAM RS-232 annexe 1

[. . . ] Serial Control of the Advantage VRAM _______________________________________________________________________________________ Biamp Systems, 10074 S. W. (503) 641-7287 an affiliate of Rauland-Borg Corp. Introduction This document contains information for the serial control of the Advantage VRAM (Variable Resource Auto Mixer) and the Advantage VRAMeq, (Variable Resource Auto Mixer with equalizer). Specifically, this document tries to inform those looking to write their own software controls for the Advantage VRAM. It is assumed that the reader has some familiarity with standard programming practices, binary and hexadecimal numbers, the ASCII character set, asynchronous serial data connections, and RS-232 interfaces. [. . . ] To adjust one of these bits (for instance to mute or un-mute a channel) , use the bitwise-operator command. Syntax of Command: vvssttaa80dd) where vv ss tt aa 80 dd ( Syntax of response: = = = = = = = Bits to clear (00 to ??[pseudo-hex]; 00 indicates nothing to toggle) Memory address (0 to 95d; 00 to 5?[pseudo-hex]) Device type bitmask for Advantage VRAM Device number bitmask (1 to 63d; 00 to 3?[pseudo-hex]) bitwise-operator command character no response Example: command: 0000803<8007( response: (none) Here the mute bit of the main volume control (memory location 3< [pseudo-hex]) is toggled. command 0040003<8007( response (none) This example sets the phantom power on for channel 1. Comments: It is easiest to think of the settings in binary, using the data from the memory map notes, and then convert the setting to pseudo-hex. Serial Control of the Advantage VRAM 12 ) increment-decrement-memory (firmware dates 7/23/98 and later) Description: Sometimes it is desired to adjust a value in device memory by increasing or decreasing it one step. A common application of this would be to adjust the main or auxiliary volume. Syntax of Command: ooffaa80dd) where oo = Upper or lower limit, depending on direction of change (limited by setting to be incremented, 0 to 23d for preamp 0 to 31d for fader 0 to 30d for eq tone 0 to 15d for eq frequency) Increment or decrement (00 or 01; 00 is decrement, 01 increment) Memory address (32 to 96d; 20 to 60 [pseudo-hex]) Device type bitmask for Advantage VRAM Device number bitmask (1 to 63d; 00 to 3?[pseudo-hex]) increment-decrement-memory command character ff aa 80 dd ) Syntax of response: = = = = = no response Example: command: 02003<8007) response: (none) This example sets the lower bound as 02, and then decreases memory location 3< [pseudo-hex] by one. Repeated use of this command will force the fader to its lower limit of 2d steps from the bottom. Comments: The increment / decrement command is limited to preamp gains, volume, and equalizer faders only. Serial Control of the Advantage VRAM 13 * polling-status Description: In order to give the user a glimpse into the current status of the Advantage VRAM and Advantage VRAMeq, the polling-status command can be used. When directed, this command will return information regarding the mix status of the device, it's auxiliary and main analog to digital levels, as well as the presence of clipping, activity of the logic output, auxiliary and main outputs. Syntax of Command: 80dd* where 80 dd * Syntax of response: = = = Device type bitmask Device number bitmask (1 to 63d; 00 to 3?[pseudo-hex]) polling-status command character ppyyzzcclluumm where pp yy zz cc ll uu mm = = = = = = = Last preset and communication bit used with BiampWin (first nibble is for Biamp use only, second nibble indicates current preset, 0 to ?[pseudo-hex]) Auxiliary analog to digital converter level (level ranges from 00 to ??[pseudo-hex]) Main analog to digital converter level (level ranges from 00 to ??[pseudo-hex]) Clipping presence (high bit indicates presence, 00 or 01) Logic output status (binary high bit indicates active, 00 to ??[pseudo-hex]) Auxiliary output status (binary high output indicates channel active, 00 to ??[pseudohex]) Main output status (binary high output indicates channel active, 00 to ??[pseudo-hex] Serial Control of the Advantage VRAM 14 Example: command: 8002* response: 292:2;00000303 In this example, a Advantage VRAM (device number 2) reports that it's last preset was 9. The 2 appearing before the 9 is used by BiampWin for communication purposes. The auxiliary and main a/d converter levels are 42 and 43d, or about 16% of max. Finally, both the auxiliary and main outputs are being fed by channels 1 and 2 (03 translates to 00000011b, indicating that the first two channels are on). Comments: Preset: If the last preset selected was 16d, (the startup preset) and a communication bit is set, there can be some confusion. Preset 16d, without a communication bit has a pseudo-hex value of 10, or 00010000b. However, when a communication bit is set, say, bit 8, the resultant binary is 10010000, or 90 [pseudo-hex]. In all cases other than preset 16d the communication bits always remain in the most significant nibble and the preset remains in the least significant nibble. [. . . ] 0x0E 030. m n o select 3 } 0x7E write memory nibble 0xD button 12 button 28 select 2 0x1E 046. 0x0F 031. ~ 0x7F set defaults nibble 0xE button 13 button 29 select 1, 2 0x1F 047. 0x6F 127. SI DEL Serial Control of the Advantage VRAM 21 Address 00 01 02 03 0 1 2 3 Used for storage of Auto (gated) to main status Main out channel on or off Auto (gated) to aux status Aux out channel on or off Byte Controls Value Ranges Corresponds to 0 not auto (gated), 1 auto (gated) Ch. 1 to 8, from lsb to msb. Each bit 0 or 1, bit only active when coinciding 0 off, 1 on controls one channel bit in byte 2 is value 0 Ch. 1 to 8, from lsb to msb. [. . . ]