Technical information

The RMS Enterprise SDK (v4)
25
RMS Enterprise - NetLinx Programmer’s Guide
The RmsSourceUsage.axi Include File contains the necessary source usage virtual device definition, a location to register each
source tracked asset to a source index number, and several convenience functions to help manage the selected (active) source asset
states.
The code snippets below illustrates the NetLinx code required to integrate the RmsSourceUsageMonitor module. (This is located
inside the RmsSourceUsage.axi)
First, a source usage NetLinx virtual device must be defined. This virtual device will be used to communicate with the source
usage monitor module.
DEFINE_DEVICE
// define virtual device for RMS source usage
vdvRMSSourceUsage = 33002:1:0 // RMS Source Usage Monitor
The RmsSourceUsageMonitor module must be defined, passing in the RMS NetLinx virtual device along with the newly created
source usage virtual device.
//
// Source Usage Monitoring Module
//
// - include only one of these source usage modules if you wish to support
// source usage monitoring for assets.
//
DEFINE_MODULE 'RmsSourceUsageMonitor' mdlRmsSourceUsageMonitorMod(vdvRMS,vdvRMSSourceUsage);
Shortly after the program starts, each source tracked asset/device needs to be registered to a specific source tracking index number:
(***********************************************************)
(* STARTUP CODE GOES BELOW *)
(***********************************************************)
DEFINE_START
// wait 5 seconds before assigning sources
WAIT 50
{
#WARN 'Assign all assets that should participate in source usage tracking here ...'
FIG. 13 RMS SDK File Dependencies - Source Usage Implementation