AMX CAFE DUET V1.8 Instruction Manual page 61

Class Name: the class name for this field is defaulted to a combination of the
Device-Make and Device-Model. The Class Name should start with an
uppercase letter (up to 255 alpha-numeric characters). Text is required within
this field.
Example is: AmxSwitcher.
Available Devices: a list of available Duet devices (com.amx.duet.devicesdk)
that can be selected and then used to generate a new device class. This list of
available devices is pulled from the DeviceSDK.
9.
Click Next to save any changes and continue to the Override/Implement Methods
dialog (FIG. 33).
10.
Choose which methods you wish to override. These are the standard methods for the
device type. The SNAPI router calls these methods to allow NetLinx applications to
interact with the Java module.
ICSP information (such as channels, levels, strings, and commands) that conforms to
the SNAPI, invoke the appropriate methods. Check all the methods you wish to use
with your device.
Only override a method if you do not want the default base-class
behavior. If a base-class method is empty (i.e. has no
implementation), it is advised not to call it from your source code
since it might have an implementation and behavior in the future that
is inconsistent with your code.
At the very least, the Switcher will need a
operate. There are three methods of this name, each with a different signature. It's a
good idea to use all of them, to ensure cross-compatibility with other switchers. If
you utilize all the methods, you will have a much better chance at being able to
change switcher models without changing the main body of the application code.
11.
Under the Module portion of the tree (FIG. 33), it's a good idea to choose
handleAdvancedEvent( )
HandleAdvancedEvent
interpret the channel, level, or command sent by the application code.
Additionally,
called to send a device-specific protocol string directly to the device.
Therefore, passthru is formatted in the device-specific protocol to allow
device functions that have not been supported by an advanced or basic
function.
HandleAdvancedEvent
but are not supported by SNAPI.
12.
Click Finish to save your wizard configurations, set your build paths, and create your
project.
Café Duet v1.8 - User's Guide
.
is called when the SNAPI router is not able to
is advisable for a similar reason.
passthru( )
is for functions that are implemented by the module,
Creating a Sample Module
switchInputToOutput()
method to
is
passthru( )
55