AMX RMS 3.0, Руководство пользователя

Страница: 38 / 104

Custom Device Monitoring Programming
30
RMS NetLinx Programmer’s Guide
RMSCommon.axi
RMSCommon.axi is an included file designed to help perform many device
monitoring tasks. This file provides device-monitoring constants, functions that
generate device monitoring SEND_COMMANDs to RMS, as well as providing a
"callback" function for important device monitoring RMS events.
In order to use this include file, your program will need to define the RMS device
and a couple of functions. The include file sends commands to and creates an
event for the RMS device, vdvRMSEngine. You must create this device in your
program. In your code, the device definition needs to be defined as:
DEFINE_DEVICE
vdvRMSEngine = 33001:1:0
The virtual device number needs to be unique and not conflict with any other
virtual device defined in your program.
RMS will notify your program when it is time to register devices and parameters
and when the administrator resets a parameter from the RMS console. RMS
sends these events to your program as a string from vdvRMSEngine. The event
processing section in this include file will process these strings, parse the
parameters and call a function in your program to notify you of the event. These
functions need to be defined in your program whether you use them or not,
otherwise the compiler will generate an error since it cannot find these functions.
The two functions you need to include are:
RMSDevMonRegisterCallback()
This function is called when RMS engine module connects to the RMS server.
Since the RMS engine module does not store any information about monitored
devices and their parameters, this information must be sent to the RMS only
when the module is connected to the server. If you want to add any custom device
monitoring code, you can register your device and parameters in this function. In
your code, the function needs to be defined as:
DEFINE_FUNCTION RMSDevMonRegisterCallback()
{
}