Citect for Windows Driver Specification DanBuss DNIP Driver

Driver Design Specification
variables from other function blocks).
If bit 2 is set, then this variable will be of a ‘One Shot’ type. It will be read once (with same
priority as all other new variables) and then it will be updated very slowly (once per hour is
default, may be set in CITECT.INI)
08 The function block type that this variable belongs to.
21 The variable’s order in this function block (hex, it is equal to the last number in the template)
5 The DANBUSS variable type, used internally for conversion.
typedef enum MPTypes {
MP_MPBLOCKNAME, /* = 18 byte */
MP_AIPARAMETER, /* = 8 byte */
MP_DIPARAMETER, /* = 6 byte */
MP_AOPARAMETER, /* = 5 byte */
MP_DOPARAMETER, /* = 3 byte */
MP_ASPARAMETER, /* = 3 byte */
MP_DSPARAMETER, /* = 2 byte */
MP_PTRPARAMETER, /* = 4 byte */
MP_DATPARAMETER, /* = 2 byte */
MP_UTCPARAMETER /* = 4 byte */
} MPTypes;
4 Citect’s type, is used to indicate any special format for time presentation etc.
typedef enum CITypes {
CI_USERAW, // Results in the raw format, no conversion is made
CI_UTCDATE, // Results in date string, format 1997-11-21 from UTC
CI_UTCTIME, // Results in time string, format 21:15 from UTC
CI_TIME // Results in time string, format 21:15 from int
CI_STRWEEK // Results in time string, format 4 21:15 from int (4=weekday)
} CITypes;
This results in that this variable will be read only once (with very slow update, defaulted to once per
hour). The driver will read the complete function block into the cache element’s data area. This
means that if Citect asks for another variable within this function block at this device, it will read directly
from the cache element’s data area, and not from the device.This variable should not be a
ScanList member (a ScanList is the DANBUSS function that reads up to 36 variables in one request).
This variable can not be a ScanList member, though it causes the driver to read the entire
function block. The variable belongs to the function block type TIMCON (time program). The variable
is number 33 (0x21) in this function block, it is of the DANBUSS type Analog Output, and will be
converted to the CI_STRWEEK type in string format when passed to and from Citect.
DanBuss DNIP.doc 10