Drucegrove DragonFly User Manual 1.4
Page 41
DragonFly Variables
The DragonFly software uses variables for dynamic display content. Variables can be referenced in XML files on the
SD card by encapsulating their name with percentage sign characters, ie
%
VAR1
%
.
Variable names should always be capitalised.
The following tables list all variables that have been pre-defined, and should be used where necessary over custom
variable names.
The following variable names are used for general and miscellaneous values and states. The ## characters should be
substituted with a numeric value between 01 and 99 (leading zeros are required), and the word “LIFT” can be
replaced by “ELEVATOR”:
Variable
Name
Variable
Description
Data
Type
LOCATION_CITY
The name of the city that the screen is located in
Text
LOCATION_SITE
The name of the site that the screen is located in
Text
LOCATION_BUILDING
The name of the building that the screen is located in
Text
LOCATION_DEPARTMENT
The name of the department that the screen is located in
Text
LOCATION_LIFT_GROUP
The name of the lift group that the screen is located in
Text
LOCATION_LIFT_NAME
The name of the lift that the screen is located in
Text
CURRENT_TEMPERATURE_FULL_VALUE
Current full temperature value from a sensor, including
decimal point and single digit fraction
Text
CURRENT_TEMPERATURE_INT_VALUE
Current temperature value from a sensor, represented as
a rounded down integer
Integer (-99 to 99)
CURRENT_TEMPERATURE_FRACTION_VALUE
Fractional part of the current temperature value from a
sensor, represented as a single digit integer
Integer (0 to 9)
CURRENT_TEMPERATURE_UNIT
Single character (C or F) representing the temperature
unit of measurement from a sensor
Text (1 character)
CURRENT_TEMPERATURE_EXPIRE_TIME
Date and time after which the current temperature from a
sensor is invalid
Date and Time
USER_MESSAGE
General user text (acts as an alias for USER_MESSAGE_00)
Text
USER_MESSAGE_##
General user text (## should be value between 00 and 99)
Text
The following variable names are used for general purpose inputs and outputs. For each variable name listed, the ##
characters should be substituted with a numeric address value between 01 and 63, and the
character replaced
with a numeric input value between 01 and 16 (leading zeros are required):
Variable
Name
Variable
Description
Data
Type
GPIO
##
_
Current state of input/output number
at address ##
Boolean
GPIO
##
_BINARY_VALUE
Integer value representing the binary value of the GPIO
at address ##
Integer
GPIO
##
_EXPIRE_TIME
Date and time after which the input states from address
## are invalid
Date and Time
