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.

InOut:

Name

Type

Comment

mask

IEC_BACNET_UINT

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_UINT

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_PRIORITY_LEVEL

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.