Overview
:
This
mxm provides serial remote control to the BSS Soundweb devices.
Product Features
Soundweb is a set of audio processing units, which can be
linked by a digital communications network. The units are
completely flexible: you program the signal paths and block
diagram of the processing using a PC, choosing the processing
blocks from an extensive library.
( See
"> http://www.bss.co.uk/ " for more details ).
> Top
Installation
(MXM) :
No special
installation is required.
The MxM uses the Soundweb/Serial protocol.
The controls that have to be remoted must be placed in
the "serial window" of the Sounweb designer software.
The "set value" and "read value" commands
of the MxM use the groups and ids of the Soundweb/AMX protocol,
and the "raw message" command uses the handles
and methods of the Soundweb serial sdk.
See > Soundweb
SDK documentation.
> Top
Creation
(Device) :
Device
creation window :

- The serial communication setup is defined in the bottom
of the window.
- The Timeout is the error management of the serial communication.
- On the top is the list of controls that contains the name
of the controls that this device commands.
- The remove button lets the user delete a control.
- The add and edit buttons open a dialog window where the
controls can be edited.
Each time a control is created, a system variable representing
its value is also created.
Edit control window

-
The ID is the one used to communicate with the control (the
same as in the PANJA protocol used for AMX, see the documentation
in Soundweb Designer).
- The Control Name is the internal name used by the MxM
commands.
Important
note : the ID is used by the "Set value" command
and the monitoring of control variables, but when using
"Raw message" commands, it is the handle which
is used, not the ID ( see the command description )

The
types of controls are the Soundweb/AMX protocol types :
button, level, toggle, led, preset, spin, level, source.
(See > Soundweb
SDK documentation).
> Top
Commands
(List Of) :
Set
value:
Raw
message:
Description
: To send a message not included in the Soundweb/AMX
protocol.
Parameters :
Handle
: [Type : Integer] : Handle of the control.
Method : [Type : String] : A string with 8 characters
representing the method to call in hexadecimal format
(> see
sdk documentation).
Integer value : [Type : Integer] : New value.
Usage
:
Handles : They
do not exist until you have compiled your design file
(.SDF) in Soundweb designer. Once compiled, you can
find them by moving the mouse over the object in the
design and the handle will appear in the status bar
which is in the bottom left of the main Soundweb designer
window. This is one of the places where an application
would normally tell you what buttons do as you pass
the mouse pointer over them.
Methods : Besides
the method value, you can click on the wizzard button
to access the file that contains the list of methods.
This file is located in the MXM directory of Manager
and you can update it easily if you need it, because
it is a text file.
(See > Soundweb
SDK documentation) .
Reset
all:
Description
: To reset the devices and retrieve the value of all
the controls.
Parameters :
Count of boxes: [Type : Integer] : The count of
units that the design contains.
Usage : The MxM will send a RAW_MSG with the method
00000011 to the handles 00000001, 00100001; 00200001,
...(until count of boxes is reached). This will force
the units to send back the values of their exported controls.
Fade
level :
Description
: To fade the value of a level in a specified time.
Parameters :
Control
name : [Type : Enum] : Name of the control. (the
enum contains only the list of the control with "level"
type that has been entered in the setup of the device)
Value : [Type : Integer] : New value to reach.
Fade time: [Type : Time] : Time for reaching
the value.
> Top
Variables
(List Of) :
Status
:
Type
: Enum.
Description : Current status of the device.
Available Values :
"Iddle" : No action.
"Busy" : Sending and waiting for a response
"Error : Port com used" : The com port could not be opened.
"Error : Timeout" : No response of the Soundweb.
"Error : Command refused" : The last command has received
a "NACK".
"Error : Illegal method" : The format of the method is
not correct.
Control
variables :
Type
: Integer.
Each control has a corresponding variable called DeviceName.ControlName
Note : At statup, you can poll allthe values
by calling "Reset all". Afterwards, each time
that a control is changed, by the MxM or by another controller,
the value is reflected into the variable.
> Top
Support
(Difference with previous versions) :
V 1.0.1:
- Added: Support for Showmaster.
V 1.0.2:
- Modified: serial port is now opened when the device activity is enabled (i.e. when the project switches to Debug or Run mode).
V 1.0.3:
- Added: Support for Showmaster Pro.
> Top
|