Cloud Sensor Commands
Below are the cloud sensor related commands.
Syntax: cloudsensoron
This command initiates communication with the cloud sensor. The variable CLOUDSENSORTYPE sets the type of cloud sensor used: 1 is original Boltwood, 2 is new Boltwood II, 3 is AAG Cloudwatcher, 4 is a cloud sensor simulator (which is always clear skies!).
If this operation is successful, the variable CLOUDSENSORCONNECTED is set to "true". All cloud sensor related commands must be preceded by this command.
Syntax: cloudsensoroff
This command terminates communication with the Cloud Sensor and sets the variable CLOUDSENSORCONNECTED to "false".
Syntax: getcloudsensordata
This command queries the cloud sensor for its data and sets the following variables relevant to the installed cloud sensor: SKYSTATE, SKYTEMPERATURE, CLOUDYTHRESHOLD, VERYCLOUDYTHRESHOLD, AMBIENTTEMPERATURE, WINDSPEED, SKYBRIGHTNESS, and HUMIDITY. It does not wait for new data - the variable CLOUDSENSORDATAAGE (in seconds) should be checked to ensure recent data. If CLOUDSENSORIGNOREWETNESS is true, the wetness sensor is ignored. The variable CLOUDERROR is set accordingly.
When using the cloud sensor simulator (CLOUDSENSORTYPE=4), all variables are unchanged except for SKYSTATE which is updated given the current SKYTEMPERATURE and CLOUDYTHRESHOLD/VERYCLOUDYTHRESHOLD variables.
Syntax: setcloudsensordata
This command sets the sky temperature thresholds used by the cloud sensor to distinguish between a clear and cloudy sky and a cloudy and very cloudy sky based on the variables CLOUDYTHRESHOLD and VERYCLOUDYTHRESHOLD respectively. The variable CLOUDERROR is set accordingly.