Skip to content

Latest commit

 

History

History
82 lines (55 loc) · 4.53 KB

Davis-Binding.md

File metadata and controls

82 lines (55 loc) · 4.53 KB

Binding is based on the Serial Communication Reference Manual from Davis. Most Davis weather stations should be supported, so far the Binding is tested with Vantage Pro 2.

For installation of the binding, please see Wiki page [[Bindings]].

Binding Configuration

First you need to define your Davis weather station he openhab.cfg file (in the folder '${openhab_home}/configurations').

######################## Davis weather stations ###########################

# serial port of the Weather station connected to
davis:port=/dev/ttyS0

# refresh inverval in milliseconds (optional, defaults to 10000)
#davis:refresh=

The davis:port value is the path from the serial device of the weather station. For windows systems it is COMx

The davis:refresh value is the refresh interval. Refresh value is optional parameter.

Examples, how to configure your Davis device:

davis:port=/dev/ttyS0
#davis:refresh=

Item Binding Configuration

In order to bind an item to the device, you need to provide configuration settings. The easiest way to do so is to add some binding information in your item file (in the folder configurations/items`). The syntax of the binding configuration strings accepted is the following:

davis="<value-key>"

The value-key corresponds a value from the Davis weather station. See complete list below.

The following value-keys are available:

String StationType    	"StationType: [%s]" 	        { davis="station_type" }
Number Receivers		"Receivers: [%.0f]"	        { davis="receivers" }
Number TransmitterBattery	"Transmitter Battery [%.1f]"	{ davis="transmitter_battery_status" } 
Number ConsoleBattVoltage	"Console Battery [%.2f V]"	{ davis="console_battery_voltage" } 

DateTime Date		"Date [%1$tA, %1$td.%1$tm.%1$tY]"   { davis="time" }

Number InsideTemp		"Inside Temp [%.1f °C ]"	{ davis="inside_temp" } 
Number OutsideTemp		"Outside Temp [%.1f °C ]"	{ davis="outside_temp" } 
Number DewPoint		"Dew Point [%.1f °C ]"	        { davis="dew_point" } 
Number HeatIndex		"Heat Index [%.1f °C ]"	        { davis="heat_index" } 
Number WindChill		"Wind Chill [%.1f °C ]"	        { davis="wind_chill" } 
Number THSWIndex		"THSW Index[%.1f °C ]"	        { davis="thsw_index" } 

Number InsideHumidity	"Inside Humidity [%.0f %% ]"	{ davis="inside_humidity" }
Number OutsideHumidity	"Outside Humidity [%.0f %% ]"	{ davis="outside_humidity" }

String BarTrend		"Barometer Trend [%s]"	        { davis="bar_trend" }
Number Barometer		"Barometer [%.0f hPa]"	        { davis="barometer" }

Number WindSpeed		"Wind Speed [%.1f km/h]"	{ davis="wind_speed" }
Number WindSpeed10minAvg	"Wind Speed 10min Avg [%.1f km/h]"	{ davis="wind_speed_10min_avg" }
Number WindDirection	"Wind Direction [%.0f °]"	{ davis="wind_direction" }
Number WindSpeed10minHiRes		"Wind Speed 10min Avg HiRes [%.1f km/h]"	{ davis="wind_speed_10min_avg_hires" }
Number WindSpeed2minHiRes		"Wind Speed 10min Avg HiRes [%.1f km/h]"	{ davis="wind_speed_2min_avg_hires" }
Number WindSpeed10minGustHiRes	"Wind Speed 10min Avg HiRes [%.1f km/h]"	{ davis="wind_speed_10min_gust_hires" }
Number WindDirectionGust		"Wind Direction Gust [%.0f °]"			{ davis="wind_direction_10min__gust" }

Number RainRate		"Rain Rate [%.1f mm/h ]"	{ davis="rain_rate" } 
Number Rain15min		"Rain Rate [%.1f mm/h ]"	{ davis="last_15min_rain" } 
Number Rainlast1h		"Rain Rate [%.1f mm/h ]"	{ davis="last_hour_rain" } 
Number Rainlast24h		"Rain Rate [%.1f mm/h ]"	{ davis="last_24h_rain" } 

Number UVIndex		"UV Index [%.1f ]"		{ davis="uv" } 
Number Solar		"Solar Radiation [%.0f W/m²]"	{ davis="solar_radiation" } 


String firmware_date	"Firmware Date: [%s]"		{ davis="firmware_date" }
String firmware_version	"Firmware Version: [%s]"	{ davis="firmware_version" }

String rx_total		"RX Packets total: [%s]"	{ davis="rx_count_total" }
String rx_missed		"RX Packets missed: [%s]"	{ davis="rx_count_missed" }
String rx_resync		"RX Resyncs: [%s]"		{ davis="rx_count_resync" }
String rx_consec		"RX Packets received in a row without error: [%s]"  { davis="rx_count_consecutive" }
String rx_crc		"RX Packets CRC failes: [%s]"	{ davis="rx_count_crc" }

All value-keys are readonly.