User manual BIAMP SPM522D RS-232

[. . . ] RS-232 Control of the Advantage SPM522D ________________________________________________________________________________________ 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 SPM522D Stereo Preamp/Mixer. This information is intended for advanced users - in particular for those who wish to develop their own computer programs to control the SPM522D. 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". [. . . ] This command essentially provides the SPM522D (when under computer control) with an unlimited number of button definitions. Syntax of Command: bbbbbbbbbbbbbbbb04dd! where: bbbbbbbbbbbbbbbb 04 dd ! = = = = Button Definition Data Structure (pseudo-hex) SPM522D Device Type Bitmask Device Number Bitmask (pseudo-hex) virtual-button command character (0x21) Syntax of Response: (no response) Example: 00455300004452000420!This example causes SPM522D number 6 to immediately execute the following button actions: Main - un-mute the output, select stereo source 2, mute Mic 1, mute Mic 2 Zone - un-mute the output, select stereo source 3, un-mute Mic 1, mute Mic 2. Comments: Computer Control of the Advantage SPM522D page 13 " define-button Description: The define-button command provides a new definition for the specified button number. The SPM522D will store this new button definition in its control button definition lookup table, replacing the definition that was there. Syntax of Command: bbbbbbbbbbbbbbbbnn04dd" where: bbbbbbbbbbbbbbbb nn 04 dd " = = = = = Button Definition Data Structure (pseudo-hex) Button Number + 128 (pseudo-hex) Device Type Bitmask (pseudo-hex) Device Number Bitmask (pseudo-hex) define-button command character (0x22) Syntax of Response: (no response) Example: 0000000000000031940408" This example causes SPM522D number 4 to redefine button number 20 (0x14) to enter Room Combining mode and recall preset mix 'A'. Comments: The decimal value 128 must be added to the Button number. This indicates to the SPM522D that this is the define-button form of the button-definition command. page 14 Computer Control of the Advantage SPM522D " get-button-definition Description: The get-button-definition command causes the SPM522D to return the definition of the specified button. The button definition will be returned in the Button Definition Data Structure format. Syntax of Command: nn04dd" where: nn 04 dd " = = = = Button Number + 64 (pseudo-hex) Device Type Bitmask (pseudo-hex) Device Number Bitmask (pseudo-hex) get-button-definition command character (0x22) Syntax of Response: bbbbbbbbbbbbbbbb where: bbbbbbbbbbbbbbbb = Button Definition Data Structure (pseudo-hex) Example: command: 5;0401" response: 0002000000020000 This example causes SPM522D number 1 to retrieve its button definition for control button number 27 (0x1B) and return it to the computer. In this example, the button definition was: increment the volume of Mic 1 in both the Main and Zone outputs. Comments: The decimal value 64 must be added to the Button number. This indicates to the SPM522D that this is the get-button form of the button-definition command. Computer Control of the Advantage SPM522D page 15 # define-source-settings Description: The define-source-settings command provides new treble, bass, and balance settings for the specified stereo source. The new settings are stored in the SPM522D's non-volatile configuration memory. If the specified source is the currently selected source for either the Main or Zone output, the new settings become effective immediately. Syntax of Command: ssssssssnn04dd# where: ssssssss nn 04 dd # Syntax of Response: = = = = = Stereo Source Data Structure Source number + 128 (pseudo-hex) Device Type Bitmask (pseudo-hex) Device Number Bitmask (pseudo-hex) define-source-settings command character (0x23) (no response) Example: 94669457820401# This example causes SPM522D number 1 to change its settings for stereo source 2 to: Main : bass boosted one step and treble cut one step, balance centered Zone : bass and treble flat, balance centered Comments: The decimal value 128 must be added to the Source number. This indicates to the SPM522D that this is the define-source-settings form of the source-settings command. page 16 Computer Control of the Advantage SPM522D # get-source-settings Description: The get-source-settings command causes the SPM522D to return the treble, bass, and balance settings for the specified stereo source. The settings will be returned in the Stereo Source Data Structure format. This includes the settings for both Main and Zone. Syntax of Command: nn04dd# where: nn 04 dd # Syntax of Response: = = = = Source number + 64 (pseudo-hex) Device Type Bitmask (pseudo-hex) Device Number Bitmask (pseudo-hex) get-source-settings command character (0x23) ssssssss where: ssssssss = Stereo Source Data Structure (pseudo-hex) Example: command: 420401# response: 94669466 This example causes SPM522D number 1 to retrieve its treble, bass, and balance settings for stereo source number 2 and return them to the computer. In this example, the source settings were: Main : bass and treble flat, balance center Zone : bass and treble flat, balance center Comments: The decimal value 64 must be added to the Source number. This indicates to the SPM522D that this is the get-source-settings form of the source-settings command. Computer Control of the Advantage SPM522D page 17 $ define-preset Description: The define-preset command provides settings for the specified preset. If either preset 5 (the Main "current mix") or preset 11 (the Zone "current mix") are specified, the new settings immediately go into effect. Otherwise, the new settings are simply stored in the SPM522D's non-volatile configuration memory for future recall. Syntax of Command: ppppppppppnn04dd$ where: pppppppppp nn 04 dd $ Syntax of Response: = = = = = Preset data structure Preset number + 128 (pseudo-hex) Device Type Bitmask (pseudo-hex) Device Number Bitmask (pseudo-hex) define-preset command character (0x24) (no response) Example: 00191?1<79830401$ This example causes SPM522D number 1 to change its settings for Main Preset 'C' to: Stereo Source 1 selected Mics 1 and 2 both enabled, with Mic 1 priority Main output volume set to volume step 28 Mic 1 volume set to maximum (volume step 31) Mic 2 volume set to volume step 25 Comments: The decimal value 128 must be added to the Preset number. This indicates to the SPM522D that this is the define-preset form of the preset-definition command. Preset numbers 1, 2, 3, 4 correspond to Main Presets 'A', 'B', 'C', 'D'. Preset numbers 7, 8, 9, 10 correspond to Zone Presets 'E', 'F', 'G', 'H'. page 18 Computer Control of the Advantage SPM522D $ get-preset-definition Description: The get-preset-definition command causes the SPM522D to return the settings for the specified preset. Preset number 5 refers to the Main "current mix" and preset number 11 refers to the Zone "current mix". Syntax of Command: nn04dd$ where: nn 04 dd $ Syntax of Response: = = = = Preset number + 64 (pseudo-hex) Device Type Bitmask (pseudo-hex) Device Number Bitmask (pseudo-hex) get-preset-definition command character (0x24) pppppppppp where: pppppppppp = Preset Data Structure (pseudo-hex) Example: command: 4;0401$ response: 18001?1?14 This example causes SPM522D number 1 to return its settings for the Zone "current mix" to the computer. In this example, the settings were: Stereo Source 4 selected, Ch. 5 Override not allowed, Mic 1 enabled, Zone output volume and Mic 1 volume both set to maximum (step 31), Mic 2 volume set to minimum (step 0), the most recently recalled Zone preset was 'F' (8). Comments: The decimal value 64 must be added to the Preset number. This indicates to the SPM522D that this is the get-preset-definition form of the preset-definition command. [. . . ] 0x76 do-button nibble 0x6 button 05 button 21 button 36 select 1, 2, 4 0x17 039. 0x77 do preset nibble 0x7 button 06 button 22 button 37 select 3, 4 0x18 040. 0x78 do volume nibble 0x8 button 07 button 23 button 38 select 1, 3, 4 0x19 041. 0x79 do tone nibble 0x9 button 08 button 24 button 39 select 2, 3, 4 0x1A 042. [. . . ]