Page 8 of 24 |
Map Descriptor Example 1 – Store data from incoming messages.
This example illustrates typical map descriptor uses to store data from panel generated messaged.
As all these map descriptors have their Clear_On_Reset field set to yes, when a panel reset message is received all the data in the controlled arrays will be set to zero When a point reports its own state as normal the driver will set the appropriate element of the appropriate array to zero to indicate the normal state..
Data is stored, first by finding a map descriptor with the correct circuit number. If the message doesn’t contain a circuit number then it is assumed to be from the panel itself. If a message contain a CKT number and no DEV number then the driver assumes the device number is zero. The storage location is based on the device number – it is used as an offset into the array.
Map_Descriptors |
| Data_Array_Name, | Data_Array_Offset, | Function, | Node_Name, | ckt | , | Dev, Length, Data_Type , Clear_On_Reset | ||||||
Map_Descriptor_Name, | ||||||||||||||
Panel_data | , | DA_STATUS | , | 000 | , | passive , | panel1 | , | Panel, | 0 | ,100 | , Any | , Yes | |
Ckt1_data01 | , | DA_STATUS | , | 200 | , | passive , | panel1 | , | 1 | , | 0 | ,100 | , Any | , Yes |
Ckt2_data01 | , | DA_STATUS | , | 400 | , | passive , | panel1 | , | 2 | , | 0 | ,100 | , Any | , Yes |
Ckt3_data01 | , | DA_STATUS | , | 600 | , | passive , | panel1 | , | 3 | , | 0 | ,100 | , Any | , Yes |
In this example all the data for all these circuits is stored in one array.
The offset is used to control the location in the array.
These map descriptors are all passive. We cannot poll the panel but we can wait passively for the panel to send us messages.
You need one map descriptor for each circuit / panel.
The length determines the number of devices that can be processed using the map descriptor.
Say a message for Ckt:2 Dev:20 is received. The driver looks at the device number and the length to see if the range of devices covers the incoming message. I this case the data would be stored at offset 20 in the map descriptor.
Because the Data Type is ‘Any’ the driver will set an array element
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com Tel: (408)