The below sequence, tells gnhastd that the dimmer device 1B.D4.4C is currently set to 0.5, or 50%, and then disconnects from gnhastd.
upd uid:1B.D4.4C dimmer:0.5 disconnect
The below sequence tells gnhastd to find the collector for the 1B.D4.4C device, and to request it to change the status of the switch to ON, and then disconnects from gnhastd. This is a typical sequence you could use in a script via netcat, to turn a light on.
chg uid:1B.D4.4C dimmer:1.0 disconnect
Register a device with the server, or, tell the collector about a device
Register a group with the server, or, tell the collector about a group
Update the status of a device. Sent to, and by the server
Modify a setting of a device. (Currently only name, rrdname, hargs, and handler). Sent to and by the server.
Request a change in the status of a device. For example, ask for an outlet to be turned off. Sent to and by the server.
Request a list of devices from the server. Can give it arguments such as protocol, type, etc, to narrow the list. Devices are sent back to the collector as reg commands.
Server sends this to let the client know we are done sending it device names from an ldevs.
Request a list of groups from the server. Groups are sent back as regg commands.
Server sends this to let the client know we are done sending it group names from an lgrps.
Request a continuous stream of updates from the server for a particular device. rate argument sets the update speed in seconds. Updates are sent via the upd comamnd.
Ask for a single upd on a device, or devices
Ask for a single upd on a device, or devices, but reply in cacti format.
Disconnect form the gnhastd server
Tell the server the name of our client (needs client arg)
The unique identifier for this device
The human readable name for this device
The name of the field to store this value in, in an rrd file
The rate in seconds of an update (used by feed) (integer)
The device type. (integer)
The device protocol. Integer
The device subtype. Integer
The status of a switch. 0=off, 1=on. Integer
Status of a dimmer. 0.0-1.0 float
Temperature. Float
Humidity. Float
Light level in LUX. Float
Pressure. (air pressure) Float.
A speed value, used for windspeed for now. Float.
Wind direction
A count, for a counter type device. Integer.
Wetness, for leaf wetness sensors. Float.
Moisture. For soil moisture sensors. Float.
Wattseconds. (aka joules) Long long.
Voltage. Float.
Wattage. Float.
Amperage. Float.
Rain rate. Float.
For weather stations that report cloudy/overcast/etc. Integer, reports values of:
0 - sunny
1 - partly cloudy
2 - cloudy
3 - rainy
Client name. Used by collectors so gnhastd knows which collector is on which connection.
Used to determine scale of incoming data, or set scale of outgoing data. Currently supports the following scale values: temperature, barometer, length, speed, light. All scale values cont from zero, so, for temperature in celcius, send a "1" as the value. Integer.
Currently F, C, K, R. (count from 0)
Currently Inches, millimeters, millibars (of mercury for the in/mm).
Currently inches or millimeters
MPH, Knots, Meters/Sec, KPH.
Lux, Watts/Meter squared
Sensor high water mark. Float.
Sensor Low water mark. Float
Path to a handler routine. String.
Handler arguments. comma separated string of arguments. String. Example:
argument1,argument2
Flow rate. Float
Distance. Float
For alarm devices. Integer, reports values of:
0 - Alarm Ready
1 - Alarm Stay
2 - Alarm Night/Stay
3 - Alarm Instant Max
4 - Alarm Away
5 - Alarm Fault
int64 number
Percentage. Float
Sound volume. Float
Countdown timer. Counts to zero automatically in seconds. Unsigned int
Thermostat mode. Integer, reports values of:
0 - Off
1 - Heat
2 - Cool
3 - Auto
Themostat state. Integer, reports values of:
0 - Idle
1 - Heating
2 - Cooling
3 - Lockout
4 - Error
Small number. 0-255
Group list. Comma separated list of group UID's
Device list. Comma separated list of device UID's