Switch  (value, state.) .   

A structure reporting a percentage level or load value and a discrete on/off state. Separate fields report the percentage value and state. This type should be used for both discrete (on/off) and analog control.

The value field is used to control the load's value, i.e. position, speed, or intensity, the state field being used to control whether the load is on or off (enabled or disabled).

When used as the output of a discrete sensor device, the OFF state is represented by a SNVT_switch network variable with state = FALSE and value = 0. The other discrete states are represented by state = TRUE and value > 0. When used as the output of a two-state sensor device, the ON state is represented by state = TRUE and value = 200 (meaning 100%).

When used as the input of a two-state discrete actuator, a SNVT_switch network variable with state = TRUE will be interpreted as the ON state if value > 0, and as the OFF state if value = 0. Additionally, a SNVT_switch input network variable with state = FALSE should be interpreted as the OFF state, whether or not value = 0. A state value of 0xFF indicates the switch value is undefined.

Input Network Variable

value (raw)
2-state interpretation
off (0; 0)
off (0; 1)
> 0
on (200; 1)
-1 (0xFF)
invalid (no action)

Output Network Variable

value (raw)
2-state interpretation
200 (0xC8)
0 .. 200 (0 .. 0xC8)
(any valid value)
-1 (0xFF)
invalid (no action)


Resource Set: Standard 00:00:00:00:00:00:00:00-0
Index: 95
Obsolete: no
Size: 2
Programmatic Name: SNVT_switch
Neuron C Type:
valueValue  (% of full level.) .   
unsigned short
Minimum: 0
Maximum: 200
Scaling (A,B,C): 5,  -1,  0
Scaled value: 5 *10 -1 *(Raw+0)
Resolution: 0.5
stateState  (state code.) .  This field can either be -1 (NULL), 0 (OFF), or 1 (ON). 
signed short
Minimum: -1
Maximum: 1
Invalid: -1
Scaling (A,B,C): 1,  0,  0
Scaled value: 1 *10 0 *(Raw+0)
Resolution: 1

SNVT_switch:  text("%f %d", value, state)

Used by:

SCPTaudibleLevel  SCPTbrightness  SCPTdefltBehave  SCPTlinkPowerDetectEnable  SCPTprimeVal  SCPTpwrUpState  SCPTscrollSpeed  SCPTsecondVal  SFPTactuateDriveFan  SFPTactuateLight  SFPTairQualityControl  SFPTaudibleFireIndicator  SFPTautomaticLightController  SFPTautomaticSolarControl  SFPTautomaticTransferSwitch  SFPTautomaticTwilightControl  SFPTboilerController  SFPTcalendar  SFPTchannelContinuityMonitor  SFPTchannelMonitor  SFPTchilledCeilingController  SFPTchiller  SFPTclothesWasherDomestic  SFPTconstantLightControl  SFPTconstantLightController  SFPTcontrolDriveActuatorFan  SFPTdamperActuator  SFPTdataLogger  SFPTdaylightDependentLighting  SFPTdewpointMonitoring  SFPTdischargeAirController  SFPTelevatorArrivalGong  SFPTelevatorDirectionLantern  SFPTelevatorFireSystemsPort  SFPTelevatorHallLantern  SFPTelevatorPositionIndicator  SFPTelevatorVoiceAnnouncer  SFPTenergyModeSelection  SFPTenergyModeSelectionWithStartOpt  SFPTentryExit  SFPTfanCoilUnit  SFPTfanControl  SFPTfrostSensor  SFPTfunctionSelection  SFPTgeneratorSet  SFPThardwiredFireAlarmShutdown  SFPThardwiredFullVentilation  SFPThardwiredGasDetectionShutdown  SFPThardwiredRecirculation  SFPThardwiredSafetyInstrumentedSystemSIS  SFPTheatPump  SFPThvacValvePositioner  SFPTlampActuator  SFPTlightActuator  SFPTlightControl  SFPTmodemController  SFPTnodeObject  SFPToccupancyController  SFPToutdoorLuminairController  SFPTpartitionWallControl  SFPTpartitionWallController  SFPTprecipitationDetection  SFPTpriorityControl  SFPTpullStationFireInitiator  SFPTpumpController  SFPTrainSensor  SFPTrefrigDisplayCaseControllerEvaporator  SFPTsccAHU  SFPTsccChilledCeiling  SFPTsccCommandModule  SFPTsccFanCoil  SFPTsccHeatPump  SFPTsccRadiator  SFPTsccRooftop  SFPTsccSelfContained  SFPTsccUnitVentilator  SFPTsccVAV  SFPTsceneController  SFPTscheduler  SFPTsinglePhaseSubMeter  SFPTslatTracking  SFPTsmokeFireInitiatorConvent  SFPTsmokeFireInitiatorIntelli  SFPTspaceComfortController  SFPTstairwellLightControl  SFPTsunblindActuator  SFPTsunblindController  SFPTswitch  SFPTtemperatureControl  SFPTthermalFireInitiator  SFPTthermostat  SFPTtwilightControl  SFPTunitHeater  SFPTunitVentilatorController  SFPTuniversalFireIndicator  SFPTuniversalFireInitiator  SFPTvariableAirVolume  SFPTvariableSpeedMotorDrive  SFPTvisibleFireIndicator  SFPTwallUnit  SFPTweatherProtection  SFPTwindowMonitoring