# Fine Offset Weather Station Binding

This binding is for weather stations manufactured by Fine Offset (opens new window). These weather stations are white labeled products which are re-branded by many distribution companies around the world. Some of these brands are e.g.:

  • Aercus
  • Ambient Weather
  • Ecowitt
  • Frogitt
  • Misol
  • Pantech
  • Sainlogic
  • Steinberg Systems
  • Waldbeck Halley

Here is a product picture of how this Weather Station looks like:

WH2650

This binding works offline by implementing the wire protocol (opens new window) of the WiFi gateway device.

# Supported Things

  • weatherstation: A Fine Offset gateway device with the ThingTypeUID fineoffsetweatherstation:weatherstation wich supports the wire protocol (opens new window) e.g.:
    • HP2550
    • HP3500
    • GW1000
    • GW1001
    • GW1002
    • GW1003
    • GW1100
    • WN1900
    • WN1910
    • WH2350
    • WH2600
    • WH2610
    • WH2620
    • WH2650 (tested)
    • WH2680
    • WH2900
    • WH2950
  • sensor: A Fine Offset sensor which is connected to the bridge with the ThingTypeUID fineoffsetweatherstation:sensor. Since the gateway collects all the sensor data and harmonizes them, the sensor thing itself will only hold information about the signal and battery status. This is a list of sensors supported by the protocol:
    • WH24 - 7-in-1 weather station, Sensor for wind speed & direction, solar radiation & light, temperature, humidity, rainfall
    • WH25 - 3-in-1 sensor temperature, humidity, pressure
    • WH26 - 2-in-1 sensor temperature, humidity
    • WH31 - 2-in-1 sensor temperature, humidity
    • WH34 - External temperature sensor
    • WH35 - Leaf wetness sensor
    • WH40 - Rainfall sensor
    • WH41 - Outdoor air quality sensor
    • WH45 - Air quality sensor
    • WH51 - Soil moisture sensor
    • WH55 - Water leak detection sensor
    • WH57 - Lightning detection sensor
    • WH65 - 7-in-1 weather station for wind speed & direction, solar radiation & light, temperature, humidity and rainfall
    • WH68 - 4-in-1 weather station - Solar-powered sensor for wind speed & direction, solar radiation & light
    • WH80 - 6-in-1 weather station - Ultrasonic sensor for wind speed & direction, solar radiation & light, temperature & humidity
    • WH90 - A new weather station

# Discovery

This binding support discovery of Fine Offset gateway devices by sending a broadcast message.

# Thing Configuration

# gateway Thing Configuration

Name Type Description Default Required Advanced
ip text The Hostname or IP address of the device N/A yes no
port integer The network port of the gateway 45000 yes no
pollingInterval integer Polling period for refreshing the data in seconds 16 yes yes
discoverInterval integer Interval in seconds to fetch registered sensors, battery status and signal strength 900 yes yes

# sensor Thing Configuration

Name Type Description Default Required Advanced
sensor text The name of sensor attached to the gateway (multiple sensors of the same type may have different names according to the bound channel) N/A yes no

Valid sensors:

  • WH24
  • WH65
  • WH68
  • WH80
  • WH40
  • WH25
  • WH26
  • WH31_CH1
  • WH31_CH2
  • WH31_CH3
  • WH31_CH4
  • WH31_CH5
  • WH31_CH6
  • WH31_CH7
  • WH31_CH8
  • WH51_CH1
  • WH51_CH2
  • WH51_CH3
  • WH51_CH4
  • WH51_CH5
  • WH51_CH6
  • WH51_CH7
  • WH51_CH8
  • WH41_CH1
  • WH41_CH2
  • WH41_CH3
  • WH41_CH4
  • WH57
  • WH55_CH1
  • WH55_CH2
  • WH55_CH3
  • WH55_CH4
  • WH34_CH1
  • WH34_CH2
  • WH34_CH3
  • WH34_CH4
  • WH34_CH5
  • WH34_CH6
  • WH34_CH7
  • WH34_CH8
  • WH45
  • WH35_CH1
  • WH35_CH2
  • WH35_CH3
  • WH35_CH4
  • WH35_CH5
  • WH35_CH6
  • WH35_CH7
  • WH35_CH8
  • WH90

# Channels

# gateway Channels

Channel Type Read/Write Description
temperature-indoor Number:Temperature R Indoor Temperature
temperature-outdoor Number:Temperature R Outdoor Temperature
temperature-dew-point Number:Temperature R Dew Point
temperature-wind-chill Number:Temperature R Perceived Temperature
temperature-heat-index Number:Temperature R Heat Index
humidity-indoor Number:Dimensionless R Humidity Inside
humidity-outdoor Number:Dimensionless R Humidity Outside
pressure-absolute Number:Pressure R Absolute Pressure
pressure-relative Number:Pressure R Relative Pressure
direction-wind Number:Angle R Wind Direction
speed-wind Number:Speed R Wind Speed
speed-gust Number:Speed R Gust Speed
rain-event Number:Length R Amount of Rainfall At the last Rain
rain-rate Number:VolumetricFlowRate R Rainfall Rate
rain-hour Number:Length R Rainfall Current Hour
rain-day Number:Length R Rainfall Today
rain-week Number:Length R Rainfall this Week
rain-month Number:Length R Rainfall this Month
rain-year Number:Length R Rainfall this Year
rain-total Number:Length R Rainfall Total
illumination Number:Illuminance R Light Intensity
irradiation-uv Number:Intensity R UV Irradiation
uv-index Number:Dimensionless R UV Index
wind-max-day Number:Speed R Maximum Wind Speed Today
temperature-channel-1 Number:Temperature R Temperature Channel 1
temperature-channel-2 Number:Temperature R Temperature Channel 2
temperature-channel-3 Number:Temperature R Temperature Channel 3
temperature-channel-4 Number:Temperature R Temperature Channel 4
temperature-channel-5 Number:Temperature R Temperature Channel 5
temperature-channel-6 Number:Temperature R Temperature Channel 6
temperature-channel-7 Number:Temperature R Temperature Channel 7
temperature-channel-8 Number:Temperature R Temperature Channel 8
humidity-channel-1 Number:Dimensionless R Humidity Channel 1
humidity-channel-2 Number:Dimensionless R Humidity Channel 2
humidity-channel-3 Number:Dimensionless R Humidity Channel 3
humidity-channel-4 Number:Dimensionless R Humidity Channel 4
humidity-channel-5 Number:Dimensionless R Humidity Channel 5
humidity-channel-6 Number:Dimensionless R Humidity Channel 6
humidity-channel-7 Number:Dimensionless R Humidity Channel 7
humidity-channel-8 Number:Dimensionless R Humidity Channel 8
temperature-soil-channel-1 Number:Temperature R Soil Temperature Channel 1
temperature-soil-channel-2 Number:Temperature R Soil Temperature Channel 2
temperature-soil-channel-3 Number:Temperature R Soil Temperature Channel 3
temperature-soil-channel-4 Number:Temperature R Soil Temperature Channel 4
temperature-soil-channel-5 Number:Temperature R Soil Temperature Channel 5
temperature-soil-channel-6 Number:Temperature R Soil Temperature Channel 6
temperature-soil-channel-7 Number:Temperature R Soil Temperature Channel 7
temperature-soil-channel-8 Number:Temperature R Soil Temperature Channel 8
temperature-soil-channel-9 Number:Temperature R Soil Temperature Channel 9
temperature-soil-channel-10 Number:Temperature R Soil Temperature Channel 10
temperature-soil-channel-11 Number:Temperature R Soil Temperature Channel 11
temperature-soil-channel-12 Number:Temperature R Soil Temperature Channel 12
temperature-soil-channel-13 Number:Temperature R Soil Temperature Channel 13
temperature-soil-channel-14 Number:Temperature R Soil Temperature Channel 14
temperature-soil-channel-15 Number:Temperature R Soil Temperature Channel 15
temperature-soil-channel-16 Number:Temperature R Soil Temperature Channel 16
moisture-soil-channel-1 Number:Dimensionless R Soil Moisture Channel 1
moisture-soil-channel-2 Number:Dimensionless R Soil Moisture Channel 2
moisture-soil-channel-3 Number:Dimensionless R Soil Moisture Channel 3
moisture-soil-channel-4 Number:Dimensionless R soil Moisture Channel 4
moisture-soil-channel-5 Number:Dimensionless R Soil Moisture Channel 5
moisture-soil-channel-6 Number:Dimensionless R Soil Moisture Channel 6
moisture-soil-channel-7 Number:Dimensionless R Soil Moisture Channel 7
moisture-soil-channel-8 Number:Dimensionless R Soil Moisture Channel 8
moisture-soil-channel-9 Number:Dimensionless R Soil Moisture Channel 9
moisture-soil-channel-10 Number:Dimensionless R Soil Moisture Channel 10
moisture-soil-channel-11 Number:Dimensionless R Soil Moisture Channel 11
moisture-soil-channel-12 Number:Dimensionless R Soil Moisture Channel 12
moisture-soil-channel-13 Number:Dimensionless R soil Moisture Channel 13
moisture-soil-channel-14 Number:Dimensionless R Soil Moisture Channel 14
moisture-soil-channel-15 Number:Dimensionless R Soil Moisture Channel 15
moisture-soil-channel-16 Number:Dimensionless R Soil Moisture Channel 16
air-quality-24-hour-average-channel-1 Number:Density R PM2.5 Air Quality 24 Hour Average Channel 1
air-quality-24-hour-average-channel-2 Number:Density R PM2.5 Air Quality 24 Hour Average Channel 2
air-quality-24-hour-average-channel-3 Number:Density R PM2.5 Air Quality 24 Hour Average Channel 3
air-quality-24-hour-average-channel-4 Number:Density R PM2.5 Air Quality 24 Hour Average Channel 4
air-quality-channel-1 Number:Density R PM2.5 Air Quality Channel 1
air-quality-channel-2 Number:Density R PM2.5 Air Quality Channel 2
air-quality-channel-3 Number:Density R PM2.5 Air Quality Channel 3
air-quality-channel-4 Number:Density R PM2.5 Air Quality Channel 4
water-leak-channel-1 Switch R Water Leak Detection Channel 1
water-leak-channel-2 Switch R Water Leak Detection Channel 2
water-leak-channel-3 Switch R Water Leak Detection Channel 3
water-leak-channel-4 Switch R Water Leak Detection Channel 4
lightning-distance Number:Length R Lightning Distance
lightning-time DateTime R Time of last Lightning Strike
lightning-counter Number R Lightning Strikes Today
temperature-external-channel-1 Number:Temperature R External Temperature Sensor Channel 1
temperature-external-channel-2 Number:Temperature R External Temperature Sensor Channel 2
temperature-external-channel-3 Number:Temperature R External Temperature Sensor Channel 3
temperature-external-channel-4 Number:Temperature R External Temperature Sensor Channel 4
temperature-external-channel-5 Number:Temperature R External Temperature Sensor Channel 5
temperature-external-channel-6 Number:Temperature R External Temperature Sensor Channel 6
temperature-external-channel-7 Number:Temperature R External Temperature Sensor Channel 7
temperature-external-channel-8 Number:Temperature R External Temperature Sensor Channel 8
sensor-co2-temperature Number:Temperature R Temperature (CO2-Sensor)
sensor-co2-humidity Number:Dimensionless R Humidity (CO2-Sensor)
sensor-co2-pm10 Number:Density R PM10 Air Quality (CO2-Sensor)
sensor-co2-pm10-24-hour-average Number:Density R PM10 Air Quality 24 Hour Average (CO2-Sensor)
sensor-co2-pm25 Number:Density R PM2.5 Air Quality (CO2-Sensor)
sensor-co2-pm25-24-hour-average Number:Density R PM2.5 Air Quality 24 Hour Average (CO2-Sensor)
sensor-co2-co2 Number:Dimensionless R CO2
sensor-co2-co2-24-hour-average Number:Dimensionless R CO2 24 Hour Average
leaf-wetness-channel-1 Number:Dimensionless R Leaf Moisture Channel 1
leaf-wetness-channel-2 Number:Dimensionless R Leaf Moisture Channel 2
leaf-wetness-channel-3 Number:Dimensionless R Leaf Moisture Channel 3
leaf-wetness-channel-4 Number:Dimensionless R Leaf Moisture Channel 4
leaf-wetness-channel-5 Number:Dimensionless R Leaf Moisture Channel 5
leaf-wetness-channel-6 Number:Dimensionless R Leaf Moisture Channel 6
leaf-wetness-channel-7 Number:Dimensionless R Leaf Moisture Channel 7
leaf-wetness-channel-8 Number:Dimensionless R Leaf Moisture Channel 8

# sensor Channels

Channel Type Read/Write Description
signal Number R The sensors signal strenght
batteryLevel Number R The sensors battery level
lowBattery Switch R The sensors battery status

# Full Example

This is an example configuration for the WH2650 gateway

weatherstation.things:

Bridge fineoffsetweatherstation:gateway:3906700515 "Weather station" [ip="192.168.1.42", port="45000", discoverInterval="900", pollingInterval="16"] {
	Thing sensor WH25 "WH25" [sensor="WH25"]
	Thing sensor WH65 "WH65" [sensor="WH65"]
}

weatherstation.items:

Group WH25 "WH25"  <Sensor> ["Sensor"]
Number SignalWH25        "Signal WH25"      <QualityOfService> (WH25) ["Measurement", "Level"] { channel="fineoffsetweatherstation:sensor:3906700515:WH25:signal" }
Switch BatteryStatusWH25 "Low Battery WH25" <LowBattery>       (WH25) ["Energy", "LowBattery"] { channel="fineoffsetweatherstation:sensor:3906700515:WH25:lowBattery" }

Group WH65 "WH65"  <Sensor> ["Sensor"]
Number SignalWH65 "Signal WH65" <QualityOfService> (WH65) ["Measurement", "Level"] { channel="fineoffsetweatherstation:sensor:3906700515:WH65:signal" }
Switch BatteryStatusWH65 "Low Battery WH65" <LowBattery> (WH65) ["Energy", "LowBattery"] { channel="fineoffsetweatherstation:sensor:3906700515:WH65:lowBattery" }

Group gOutdoor "Outdoor" ["Location"]
Number:Temperature        weather_temperature_outdoor  "Outdoor Temperature"                 <Temperature> (gOutdoor) ["Measurement", "Temperature"] { channel="fineoffsetweatherstation:gateway:3906700515:temperature-outdoor" }
Number:Temperature        weather_temperature_indoor   "Inside temperature"                  <Temperature>            ["Measurement", "Temperature"]  { channel="fineoffsetweatherstation:gateway:3906700515:temperature-indoor" }
Number:Dimensionless      weather_humidity_indoor      "Humidity inside"                     <Humidity>               ["Measurement", "Humidity"]     { channel="fineoffsetweatherstation:gateway:3906700515:humidity-indoor" }
Number:Pressure           weather_pressure_absolute    "Absolute pressure"                   <Pressure>    (gOutdoor) ["Measurement", "Pressure"]     { channel="fineoffsetweatherstation:gateway:3906700515:pressure-absolute" }
Number:Pressure           weather_pressure_relative    "Relative pressure"                   <Pressure>    (gOutdoor) ["Measurement", "Pressure"]     { channel="fineoffsetweatherstation:gateway:3906700515:pressure-relative" }
Number:Dimensionless      weather_humidity_outdoor     "Humidity outside"                    <Humidity>    (gOutdoor) ["Measurement", "Humidity"]     { channel="fineoffsetweatherstation:gateway:3906700515:humidity-outdoor" }
Number:Angle              weather_direction_wind       "Wind direction"                      <Wind>        (gOutdoor) ["Measurement", "Wind"]         { channel="fineoffsetweatherstation:gateway:3906700515:direction-wind" }
Number:Speed              weather_speed_wind           "Wind speed"                          <Wind>        (gOutdoor) ["Measurement", "Wind"]         { channel="fineoffsetweatherstation:gateway:3906700515:speed-wind" }
Number:Speed              weather_speed_gust           "Gust speed"                          <Wind>        (gOutdoor) ["Measurement", "Wind"]         { channel="fineoffsetweatherstation:gateway:3906700515:speed-gust" }
Number:Illuminance        weather_illumination         "Light intensity"                     <Sun>         (gOutdoor) ["Measurement", "Light"]        { channel="fineoffsetweatherstation:gateway:3906700515:illumination" }
Number:Intensity          weather_irradiation_uv       "UV radiation"                        <Sun>         (gOutdoor) ["Measurement", "Light"]        { channel="fineoffsetweatherstation:gateway:3906700515:irradiation-uv" }
Number:Dimensionless      weather_uv_index             "UV Index"                            <Sun>         (gOutdoor) ["Measurement", "Light"]        { channel="fineoffsetweatherstation:gateway:3906700515:uv-index" }
Number:Speed              weather_max_day              "Maximum wind speed today"            <Wind>        (gOutdoor) ["Measurement", "Wind"]         { channel="fineoffsetweatherstation:gateway:3906700515:wind-max-day" }
Number:VolumetricFlowRate weather_rain_rate            "Rainfall rate"                       <Rain>        (gOutdoor) ["Measurement", "Rain"]         { channel="fineoffsetweatherstation:gateway:3906700515:rain-rate" }
Number:Length             weather_rain_day             "Rainfall today"                      <Rain>        (gOutdoor) ["Measurement", "Rain"]         { channel="fineoffsetweatherstation:gateway:3906700515:rain-day" }
Number:Length             weather_rain_week            "Rainfall this week"                  <Rain>        (gOutdoor) ["Measurement", "Rain"]         { channel="fineoffsetweatherstation:gateway:3906700515:rain-week" }
Number:Length             weather_rain_month           "Rainfall this month"                 <Rain>        (gOutdoor) ["Measurement", "Rain"]         { channel="fineoffsetweatherstation:gateway:3906700515:rain-month" }
Number:Length             weather_rain_year            "Rainfall this year "                 <Rain>        (gOutdoor) ["Measurement", "Rain"]         { channel="fineoffsetweatherstation:gateway:3906700515:rain-year" }
Number:Length             weather_rain_event           "Amount of rainfall at the last rain" <Rain>        (gOutdoor) ["Measurement", "Rain"]         { channel="fineoffsetweatherstation:gateway:3906700515:rain-event" }