AMX ALD-H48 instruction manual Adding Functions to Modules, Commands to The Device

Page 42

Advanced Programming

Adding Functions to Modules

Commands to The Device

This module supplies a mechanism to allow additional device features to be added to software using the module. This is the PASSTHRU command, which allows protocol strings to be passed through the module. The device-specific protocol must be known in order to use this feature.

As an example, suppose that a module for a projector has not implemented the 'white balance adjustment' feature. The command that the projector protocol requires is 03H, 10H, 05H, 14H, followed by a checksum. The documentation for the PASSTHRU command specifies that the module will automatically generate the checksum. In this case, the following string should be sent from the UI code to implement 'white balance adjustment'.

send_command vdvDevice, "'PASSTHRU-',$03,$10,$05,$14"

The reason to use PASSTHRU instead of sending a protocol string directly to the device port is that the device may require command queuing, calculation of checksums, or other internal processing, which would not be done if the string was sent directly. Because of this, it is best to filter all communication TO the device through the module. (The module documentation will indicate any processing that will be automatically done to the PASSTHRU string like checksum calculation.)

 

36

ALD-H48 Lighting Controller

 

 

 

Image 42
Contents ALD-H48 AMX Limited Warranty and Disclaimer Software License and Warranty Agreement Page Table of Contents Via Via Ethernet Overview Overview Downloading The ALD-H48 Workspace Setting The ALD-H48 IP AddressGetting Started Opening The ALD-H48 WorkspaceTransferring The ALD-H48 Project to a NetLinx Master Click Select AllUsing The Web Interface Addressing The Dimmers via The Web InterfaceDimmer Address Controlling Dimmers via The Web Dimmer ControlEstablishing And Modifying Scenes SceneModify Scene Establishing And Modifying Groups Modify GroupUsing The Touch Panel Pages Touch Panel MainDimmer Light Adjustment Setup SetupGroups Addressing DimmersCreating a Group Scenes ScenesCreating a Lighting Scene Using The Touch Panel Pages Advanced Programming IntroductionOverview Implementation DefinedevicePort Mapping Channel Assignment and FeedbackChannel Assignment and Feedback Command Interface ?FWVERSION KEYPADENABLE-1 KEYPADENABLE-2=STOP ?KEYPADADDR-1KEYPADREMOVEIDX-1 KEYPADREMOVEADDR-151?LIGHTADDR-1 LIGHTRAMP-1,UP LIGHTRAMP-1,STOP LIGHTLEVEL-1,102?LIGHTLEVEL-1 LIGHTREMOVEIDX-2 Lightremoveaddr?LIGHTSTATE-1 Reinit?VERSION Command Feedback KEYPADENABLE-1 KEYPADBTN-1,DOUBLECLICKLIGHTSTATE-1,ON Device Notes Programming Notes 14111 14112 11411114112 Commands to The Device Adding Functions to ModulesUpdating The ALD-H48 Firmware ViaVia Ethernet RevisionLast05/11/05