IEC_BACNET_LIGHTING_COMMAND (STRUCT)

TYPE IEC_BACNET_LIGHTING_COMMAND : STRUCT

A lightinmg command data structure contains the additional parameters used to request special lighting commands with specific behaviors. A Property Contents containing data of this type will have its tag equal to DATA_TYPE_LIGHTING_COMMAND.

InOut:

Name

Type

Comment

mask

IEC_BACNET_UNSIGNED

Mask of flags which define which member of this struct is valid. Possible flags are: LIGHTING_COMMAND_LEVEL_PRESENT_FLAG, LIGHTING_COMMAND_RAMP_PRESENT_FLAG, LIGHTING_COMMAND_STEP_PRESENT_FLAG, LIGHTING_COMMAND_FADETIME_PRESENT_FLAG and LIGHTING_COMMAND_PRIORITY_PRESENT_FLAG.

operation

IEC_BACNET_LIGHTING_OPERATION

This field is an enumeration of type BACNET_LIGHTING_OPERATION that defines the lighting operation desired.

targetLevel

IEC_BACNET_REAL

This field of type REAL represents the target lighting output level in the normalized range (0.0%�100.0%).

rampRate

IEC_BACNET_REAL

This field of type REAL represents the rate of change in percent-per-second for ramp operations. The range of allowable ramp-rate values is 0.1 to 100.0 inclusive. If this field is not specified, then the value of Default_Ramp_Rate specifies the ramp rate to be used.

stepIncrement

IEC_BACNET_REAL

This field of type REAL represents the percent amount to be added to Present_Value when stepping. The range of allowable values is 0.1% to 100.0% inclusive. If this field is not specified, then the value of Default_Step_Increment specifies the step increment to be used.

fadeTime

IEC_BACNET_UNSIGNED

This field of type Unsigned represents the time in milliseconds over which the fade operations take place. The range of allowable fade-time values is 100 ms to 86400000 ms (1 day) inclusive. If this field is not specified, then the value of Default_Fade_Time specifies the fade time to be used.

priority

IEC_BACNET_UNSIGNED

This field of type Unsigned (1..16) represents the priority values 1 (highest priority) through 16 (lowest priority). If this field is not specified, then the value of Lighting_Command_Default_Priority specifies the priority to be used.