Driver status

The following table enumerates many of the weather stations that are known to work with weewx. If your station is not in the table, check the pictures at the supported hardware page — it could be a variation of one of the supported models. You can also check the station comparison table — sometimes new models use the same communication protocols as older hardware.

The maturity column indicates the degree of confidence in the driver. For stations marked Tested, the station is routinely tested as part of the release process and should work as documented. For stations not marked at all, they are "known to work" using the indicated driver, but are not routinely tested. For stations marked Experimental, we are still working on the driver. There can be problems.

1. Davis "Vantage" series of weather stations, including the VantagePro2™ and VantageVue™, using serial, USB, or WeatherLinkIP™ connections. Both the "Rev A" (firmware dated before 22 April 2002) and "Rev B" versions are supported.
2. Oregon Scientific WMR-100 stations. Tested on the Oregon Scientific WMR100N.
3. Oregon Scientific WMR-200 stations. Tested on the Oregon Scientific WMR200.
4. Oregon Scientific WMR-300 stations. Tested on the Oregon Scientific WMR300A.
5. Oregon Scientific WMR-9x8 stations. Tested on the Oregon Scientific WMR968.
6. Fine Offset 10xx, 20xx, and 30xx stations. Tested on the Ambient Weather WS2080.
7. La Crosse WS-23xx stations. Tested on the La Crosse 2317.
8. La Crosse WS-28xx stations. Tested on the La Crosse C86234.
9. Hideki Professional Weather Stations. Tested on the Meade TE923.
10. ADS WS1 Stations. Tested on the WS1.
11. PeetBros Ultimeter Stations. Tested on the Ultimeter 2000.
12. RainWise Mark III Stations. Tested on the CC3000.
13. AcuRite Weather Stations. Tested on the 01036RX.

AcuRite

According to Acurite, the wind speed updates every 18 seconds. The wind direction updates every 30 seconds. Other sensors update every 60 seconds.

In fact, because of the message structure and the data logging design, these are the actual update frequencies:

• wind speed: 18 seconds
• outdoor temperature, outdoor humidity: 36 seconds
• wind direction, rain total: 36 seconds
• indoor temperature, pressure: 60 seconds
• indoor humidity: 12 minutes (only when in USB mode 3)

The station emits partial packets, which may confuse some online services.

The AcuRite stations do not record wind gusts.

Some consoles have a small internal logger. Data in the logger are erased when power is removed from the station.

The console has a sensor for inside humidity, but the values from that sensor are available only by reading from the console logger. Due to instability of the console firmware, the weewx driver does not read the console logger.

USB Mode

The AcuRite stations have a setting called "USB Mode" that controls how data are saved and communicated:

The AcuRite console must be set to USB mode 3 or 4 in order to work with the weewx driver.

Communication via USB is disabled in modes 1 and 2. Mode 4 is more reliable than mode 3; mode 3 enables logging of data, mode 4 does not. When the console is logging it frequently causes USB communication problems.

The default mode is 2, so after a power failure one must use the console controls to change the mode before weewx can resume data collection.

The 02064 stations are always in USB mode 4.

Configuring with wee_device

The wee_device utility cannot be used to configure AcuRite stations.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

Each packet contains a subset of all possible readings. For example, one type of packet contains windSpeed, windDir and rain. A different type of packet contains windSpeed, outTemp and outHumidity.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

CC3000

The CC3000 data logger stores 2MB of records.

When the logger fills up, it stops recording.

When weewx starts up it will attempt to download all records from the logger since the last record in the archive database.

The driver does not support hardware record generation.

The CC3000 data logger may be configured to return data in METRIC or ENGLISH units. These are then mapped to the weewx unit groups METRICWX or US, respectively.

Configuring with wee_device

Invoking wee_device with the --help option

wee_device /home/weewx/weewx.conf --help

will produce something like this:

Using configuration file /home/weewx/weewx.conf
Using CC3000 driver version 0.11 (weewx.drivers.cc3000)
Usage: wee_device [config_file] [options] [--debug] [--help]

Configuration utility for weewx devices.

Options:
  -h, --help            show this help message and exit
  --debug               display diagnostic information while running
  -y                    answer yes to every prompt
  --info                display weather station configuration
  --current             display current weather readings
  --history=N           display N records (0 for all records)
  --history-since=N     display records since N minutes ago
  --clear-memory        clear station memory
  --reset-rain          reset the rain counter
  --get-clock           display station clock
  --set-clock           set station clock to computer time
  --get-interval        display logger archive interval, in minutes
  --set-interval=N      set logging interval to N minutes (0-60)
  --get-units           show units of logger
  --set-units=UNITS     set units to METRIC or ENGLISH
  --get-dst             display daylight savings settings
  --set-dst=mm/dd HH:MM,mm/dd HH:MM,MM
                        set daylight savings start, end, and amount
  --get-channel         display the station channel
  --set-channel=CHANNEL
                        set the station channel

Be sure to stop weewx first before using. Mutating actions will request
confirmation before proceeding.

Action --info

Display the station settings with --info

wee_device --info

This will result in something like:

firmware: Rainwise CC-3000 Version: 1.3 Build 006 Sep 04 2013
time: 2014/06/02 08:22:17
units: ENGLISH
memory: 251372 bytes, 4334 records, 12%
interval: 1

Action --set-interval

Set the archive interval. CC3000 loggers ship from the factory with an archive interval of 1 minutes (60 seconds). To change the station's interval to 5 minutes, do the following:

wee_device --set-interval=5

Action --history

Display the latest N records from the CC3000 logger memory. Use a value of 0 to display all records.

Action --clear-memory

Use --clear-memory to erase all records from the logger memory.

Action --set-units

The CC3000 can display data in either ENGLISH or METRIC unit systems. Use --set-units to specify one or the other.

The CC3000 driver automatically converts the units to maintain consistency with the units in weewx.

Action --set-channel

Rainwise stations transmit on one of four channels. If you have multiple instrument clusters within a kilometer or so of each other, you should configure each to use a different channel. In the instrument cluster, remove the cover and set the DIP switches 0 and 1. Use --set-channel to a value of 0-3 to match that of the instrument cluster.

Action --reset-rain

Use --reset-rain to set the rain counter to zero.

Action --set-clock

Set the station clock to match the date/time of the computer.

Action --set-dst

Set the station start, end, and amount of daylight savings.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

¹ The radiation and UV data are available only with the optional solar radiation sensor.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

FineOffsetUSB

The station clock can only be set manually via buttons on the console, or (if the station supports it) by WWVB radio. The FineOffsetUSB driver ignores the station clock since it cannot be trusted.

The station reads data from the sensors every 48 seconds. The 30xx stations read UV data every 60 seconds.

The 10xx and 20xx stations can save up to 4080 historical readings. That is about 85 days of data with the default recording interval of 30 minutes, or about 14 days with a recording interval of 5 minutes. The 30xx stations can save up to 3264 historical readings.

When weewx starts up it will attempt to download all records from the console since the last record in the archive database.

Polling mode and interval

When reading 'live' data, weewx can read as fast as possible, or at a user-defined period. This is controlled by the option polling_mode in weewx.conf.

[FineOffsetUSB]
    polling_mode = ADAPTIVE

[FineOffsetUSB]
    polling_mode = PERIODIC
    polling_interval = 60

Data format

The 10xx/20xx consoles have a data format that is different from the 30xx consoles. All of the consoles recognize wind, rain, temperature, and humidity from the same instrument clusters. However, some instrument clusters also include a luminosity sensor. Only the 30xx consoles recognize the luminosity and UV output from these sensors. As a consequence, the 30xx consoles also have a different data format.

Since weewx cannot reliably determine the data format by communicating with the station, the data_format configuration option indicates the station type. Possible values are 1080 and 3080. Use 1080 for the 10xx and 20xx consoles. The default value is 1080.

For example, this would indicate that the station is a 30xx console:

[FineOffsetUSB]
    ...
    data_format = 3080

Configuring with wee_device

Invoking wee_device with the --help option

wee_device /home/weewx/weewx.conf --help

will produce something like this:

FineOffsetUSB driver version 1.7
Usage: wee_device [config_file] [options] [--debug] [--help]

Configuration utility for weewx devices.

Options:
-h, --help           show this help message and exit
--debug              display diagnostic information while running
-y                   answer yes to every prompt
--info               display weather station configuration
--current            get the current weather conditions
--history=N          display N records
--history-since=N    display records since N minutes ago
--clear-memory       clear station memory
--set-time           set station clock to computer time
--set-interval=N     set logging interval to N minutes
--live               display live readings from the station
--logged             display logged readings from the station
--fixed-block        display the contents of the fixed block
--check-usb          test the quality of the USB connection
--check-fixed-block  monitor the contents of the fixed block
--format=FORMAT      format for output, one of raw, table, or dict

Mutating actions will request confirmation before proceeding.

Action --info

Display the station settings with the --info option.

wee_device --info

This will result in something like:

Fine Offset station settings:
                    local time: 2013.02.11 18:34:28 CET
                  polling_mode: ADAPTIVE

                  abs_pressure: 933.3
                   current_pos: 592
                  data_changed: 0
                    data_count: 22
                     date_time: 2007-01-01 22:49
                 hum_in_offset: 18722
                hum_out_offset: 257
                            id: None
                 lux_wm2_coeff: 0
                       magic_1: 0x55
                       magic_2: 0xaa
                         model: None
                     rain_coef: None
                   read_period: 30
                  rel_pressure: 1014.8
                temp_in_offset: 1792
               temp_out_offset: 0
                      timezone: 0
                    unknown_01: 0
                    unknown_18: 0
                       version: 255
                     wind_coef: None
                     wind_mult: 0

Highlighted values can be modified.

Action --set-interval

Set the archive interval. Fine Offset stations ship from the factory with an archive interval (read_period) of 30 minutes (1800 seconds). To change the station's interval to 5 minutes, do the following:

wee_device --set-interval=5

Action --history

Fine Offset stations store records in a circular buffer — once the buffer fills, the oldest records are replaced by newer records. The 1080 and 2080 consoles store up to 4080 records. The 3080 consoles store up to 3264 records. The data_count indicates how many records are in memory. The read_period indicates the number of minutes between records. wee_device can display these records in space-delimited, raw bytes, or dictionary format.

For example, to display the most recent 30 records from the console memory:

wee_device --history=30

Action --clear-memory

To clear the console memory:

wee_device --clear-memory

Action --check-usb

This command can test the quality of the USB connection between the computer and console. Poor quality USB cables, under-powered USB hubs, and other devices on the bus can interfere with communication.

To test the quality of the USB connection to the console:

wee_device --check-usb

Let the utility run for at least a few minutes, or possibly an hour or two. It is not unusual to see a few bad reads in an hour, but if you see many bad reads within a few minutes, consider replacing the USB cable, USB hub, or removing other devices from the bus.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

¹ The radiation data are available only from 30xx stations. These stations include a luminosity sensor, from which the radiation is approximated.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

TE923

Some station models will recognize up to 5 remote temperature/humidity sensor units. Use the hardware switch in each sensor unit to identify sensors. Use the sensor_map in weewx.conf to associate each sensor with a database field.

The station has either 208 or 3442 history records, depending on the model. That is just over a day (208 records) or about 23 days (3442 records) with an archive interval of 5 minutes.

The TE923 driver will read history records from the station when weewx starts up, but it does not support hardware record generation.

Configuring with wee_device

Invoking wee_device with the --help option

wee_device /home/weewx/weewx.conf --help

will produce something like this:

Using configuration file /home/weewx/weewx.conf
Using TE923 driver version 0.21 (weewx.drivers.te923)
Usage: wee_device [config_file] [options] [--debug] [--help]

Configuration utility for weewx devices.

Options:
  -h, --help            show this help message and exit
  --debug               display diagnostic information while running
  -y                    answer yes to every prompt
  --info                display weather station configuration
  --current             get the current weather conditions
  --history=N           display N history records
  --history-since=N     display history records since N minutes ago
  --minmax              display historical min/max data
  --get-date            display station date
  --set-date=YEAR,MONTH,DAY
                        set station date
  --sync-date           set station date using system clock
  --get-location-local  display local location and timezone
  --set-location-local=CITY|USR,LONG_DEG,LONG_MIN,E|W,LAT_DEG,LAT_MIN,N|S,TZ,DST
                        set local location and timezone
  --get-location-alt    display alternate location and timezone
  --set-location-alt=CITY|USR,LONG_DEG,LONG_MIN,E|W,LAT_DEG,LAT_MIN,N|S,TZ,DST
                        set alternate location and timezone
  --get-altitude        display altitude
  --set-altitude=ALT    set altitude (meters)
  --get-alarms          display alarms
  --set-alarms=WEEKDAY,SINGLE,PRE_ALARM,SNOOZE,MAXTEMP,MINTEMP,RAIN,WIND,GUST
                        set alarm state
  --get-interval        display archive interval
  --set-interval=INTERVAL
                        set archive interval (minutes)
  --format=FORMAT       formats include: table, dict

Be sure to stop weewx first before using. Mutating actions will request
confirmation before proceeding.

Action --info

Use --info to display the station configuration:

wee_device --info

This will result in something like:

Querying the station for the configuration...
        altitude: 16
           bat_1: True
           bat_2: True
           bat_3: True
           bat_4: True
           bat_5: True
        bat_rain: True
          bat_uv: False
        bat_wind: True
        latitude: 43.35
       longitude: -72.0
     version_bar: 23
     version_rcc: 16
     version_sys: 41
      version_uv: 20
    version_wind: 38

Action --current

Use --current to display the current status of each sensor:

wee_device --current

This will result in something like:

Querying the station for current weather data...
        dateTime: 1454615168
        forecast: 5
             h_1: 41
       h_1_state: ok
             h_2: 48
       h_2_state: ok
             h_3: None
       h_3_state: no_link
             h_4: None
       h_4_state: no_link
             h_5: None
       h_5_state: no_link
            h_in: 44
      h_in_state: ok
            rain: 2723
      rain_state: ok
             slp: 1012.4375
       slp_state: ok
           storm: 0
             t_1: 13.9
       t_1_state: ok
             t_2: 21.5
       t_2_state: ok
             t_3: None
       t_3_state: no_link
             t_4: None
       t_4_state: no_link
             t_5: None
       t_5_state: no_link
            t_in: 22.85
      t_in_state: ok
              uv: None
        uv_state: no_link
       windchill: None
 windchill_state: invalid
         winddir: 12
   winddir_state: invalid
        windgust: None
  windgust_state: invalid
       windspeed: None
 windspeed_state: invalid

Action --set-interval

TE923 stations ship from the factory with an archive interval of 1 hour (3600 seconds). To change the station's interval to 5 minutes (300 seconds), do the following:

wee_device --set-interval=300

Action --history

Use the --history action to display records from the logger in tabular or dictionary format.

For example, to display the most recent 30 records in dictionary format:

wee_device --history=30 --format=dict

Action --clear-memory

Use --clear-memory to erase all records from the logger memory.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

Some stations support up to 5 remote temperature/humidity sensors.

¹ The UV data are available only with the optional solar radiation sensor.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

Ultimeter

The Ultimeter driver operates the Ultimeter in Data Logger Mode, which results in sensor readings every 1/2 second or so.

The Ultimeter driver ignores the maximum, minimum, and average values recorded by the station.

Configuring with wee_device

The wee_device utility cannot be used to configure Ultimeter stations.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

¹ The rain and rainRate are available only on stations with the optional rain sensor.

² Pressure, inside temperature, and inside humidity data are not available on all types of Ultimeter stations.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

Vantage

The Davis Vantage stations include a variety of models and configurations. The weewx driver can communicate with a console or envoy using serial, USB, or TCP/IP interface.

Configuring with wee_device

Invoking wee_device with the --help option

wee_device /home/weewx/weewx.conf --help

will produce something like this:

Using configuration file /home/weewx/weewx.conf
Using Vantage driver version 3.0.8 (weewx.drivers.vantage)
Usage: wee_device [config_file] [--help] [--info] [--clear-memory]
    [--set-interval=MINUTES] [--set-altitude=FEET] [--set-barometer=inHg]
    [--set-bucket=CODE] [--set-rain-year-start=MM]
    [--set-offset=VARIABLE,OFFSET]
    [--set-transmitter-type=CHANNEL,TYPE,TEMP,HUM]
    [--set-time] [--set-dst=[AUTO|ON|OFF]]
    [--set-tz-code=TZCODE] [--set-tz-offset=HHMM]
    [--set-lamp=[ON|OFF]] [--dump] [--logger_summary=FILE]
    [--start | --stop]

Configures the Davis Vantage weather station.

Options:
  -h, --help            show this help message and exit
  --debug               display diagnostic information while running
  -y                    answer yes to every prompt
  --info                To print configuration, reception, and barometer
                        calibration information about your weather station.
  --clear-memory        To clear the memory of your weather station.
  --set-interval=MINUTES
                        Sets the archive interval to the specified number of
                        minutes. Valid values are 1, 5, 10, 15, 30, 60, or
                        1200.
  --set-altitude=FEET   Sets the altitude of the station to the specified
                        number of feet.
  --set-barometer=inHg  Sets the barometer reading of the station to a known
                        correct value in inches of mercury. Specify 0 (zero)
                        to have the console pick a sensible value.
  --set-bucket=CODE     Set the type of rain bucket. Specify '0' for 0.01
                        inches; '1' for 0.2 MM; '2' for 0.1 MM
  --set-rain-year-start=MM
                        Set the rain year start (1=Jan, 2=Feb, etc.).
  --set-offset=VARIABLE,OFFSET
                        Set the onboard offset for VARIABLE inTemp, outTemp,
                        extraTemp[1-7], inHumid, outHumid, extraHumid[1-7],
                        soilTemp[1-4], leafTemp[1-4], windDir) to OFFSET
                        (Fahrenheit, %, degrees)
  --set-transmitter-type=CHANNEL,TYPE,TEMP,HUM
                        Set the transmitter type for CHANNEL (1-8), TYPE
                        (0=iss, 1=temp, 2=hum, 3=temp_hum, 4=wind, 5=rain,
                        6=leaf, 7=soil, 8=leaf_soil, 9=sensorlink, 10=none),
                        as extra TEMP station and extra HUM station (both 1-7,
                        if applicable)
  --set-time            Set the onboard clock to the current time.
  --set-dst=AUTO|ON|OFF
                        Set DST to 'ON', 'OFF', or 'AUTO'
  --set-tz-code=TZCODE  Set timezone code to TZCODE. See your Vantage manual
                        for valid codes.
  --set-tz-offset=HHMM  Set timezone offset to HHMM. E.g. '-0800' for U.S.
                        Pacific Time.
  --set-lamp=ON|OFF     Turn the console lamp 'ON' or 'OFF'.
  --start               Start the logger.
  --stop                Stop the logger.
  --dump                Dump all data to the archive. NB: This may result in
                        many duplicate primary key errors.
  --logger-summary=FILE
                        Save diagnostic summary to FILE (for debugging the
                        logger).

Be sure to stop weewx first before using. Mutating actions will request
confirmation before proceeding.

Action --info

Use the --info option to display the current EEPROM settings:

wee_device --info

This will result in something like:

Davis Vantage EEPROM settings:

    CONSOLE TYPE:                   VantagePro2

    CONSOLE FIRMWARE:
      Date:                         Dec 11 2012
      Version:                      3.12

    CONSOLE SETTINGS:
      Archive interval:             300 (seconds)
      Altitude:                     700 (foot)
      Wind cup type:                large
      Rain bucket type:             0.01 inches
      Rain year start:              10
      Onboard time:                 2014-09-25 07:41:14

    CONSOLE DISPLAY UNITS:
      Barometer:                    inHg
      Temperature:                  degree_F
      Rain:                         inch
      Wind:                         mile_per_hour

    CONSOLE STATION INFO:
      Latitude (onboard):           45.7
      Longitude (onboard):          -121.6
      Use manual or auto DST?       AUTO
      DST setting:                  N/A
      Use GMT offset or zone code?  ZONE_CODE
      Time zone code:               4
      GMT offset:                   N/A

    TRANSMITTERS:
      Channel 1:                    iss
      Channel 2:                    (N/A)
      Channel 3:                    temp (as extra temperature 1)
      Channel 4:                    (N/A)
      Channel 5:                    (N/A)
      Channel 6:                    (N/A)
      Channel 7:                    (N/A)
      Channel 8:                    (N/A)

    RECEPTION STATS:
      Total packets received:       10670
      Total packets missed:         128
      Number of resynchronizations: 0
      Longest good stretch:         934
      Number of CRC errors:         651

    BAROMETER CALIBRATION DATA:
      Current barometer reading:    29.834 inHg
      Altitude:                     700 feet
      Dew point:                    55 F
      Virtual temperature:          59 F
      Humidity correction factor:   27
      Correction ratio:             1.025
      Correction constant:          +0.000 inHg
      Gain:                         0.000
      Offset:                       -47.000

    OFFSETS:
      Wind direction:               +0 deg
      Inside Temperature:           +0.0 F
      Inside Humidity:              +0%
      Outside Temperature:          +0.0 F
      Outside Humidity:             +0%
      Extra Temperature 1:          +0.0 F

The console version number is available only on consoles with firmware dates after about 2006.

Highlighted values can be modified using the various wee_device commands below.

Action --clear-memory

This command will clear the logger memory after asking for confirmation.

Action --set-interval

Use this command to change the archive interval of the internal logger. Valid intervals are 1, 5, 10, 15, 30, 60, or 120 minutes. However, if you are ftp'ing lots of files to a server, setting it to one minute may not give enough time to have them all uploaded before the next archive record is due. If this is the case, you should pick a longer archive interval, or trim the number of files you are using.

An archive interval of five minutes works well for the Vantage stations. Because of the large amount of onboard memory they carry, going to a larger interval does not have any real advantages.

Example: to change the archive interval to 10 minutes:

wee_device --set-interval=10

Action --set-altitude

Use this command to set the console's stored altitude. The altitude must be in feet. Example:

wee_device --set-altitude=700

Action --set-barometer

Use this command to calibrate the barometer in your Vantage weather station. To use it, you must have a known correct barometer reading for your altitude. In practice, you will either have to move your console to a known-correct station (perhaps a nearby airport) and perform the calibration there, or reduce the barometer reading to your altitude. Otherwise, specify the value zero and the station will pick a sensible value.

Action --set-bucket

Normally, this is set by Davis, but if you have replaced your bucket with a different kind, you might want to reconfigure. For example, to change to a 0.1 mm bucket (bucket code "2"), use the following:

wee_device --set-bucket=2

Action --set-rain-year-start

The Davis Vantage series allows the start of the rain year to be something other than 1 January. For example, to set it to 1 October:

wee_device --set-rain-year-start=10

Action --set-offset

The Davis instruments can correct sensor errors by adding an offset to their emitted values. This is particularly useful for Southern Hemisphere users. Davis fits the wind vane to the Integrated Sensor Suite (ISS) in a position optimized for Northern Hemisphere users, who face the solar panel to the south. Users south of the equator must orient the ISS's solar panel to the north to get maximal insolation, resulting in a 180° error in the wind direction. The solution is to add a 180° offset correction. You can do this with the following command:

wee_device --set-offset=windDir,180

Action --set-transmitter-type

If you have additional sensors for your Vantage station, you can configure them using your console. However, if you have a Davis Weather Envoy receiver, it will not have a console! As an alternative, wee_device can do this using the command --set-transmitter-type.

For example, to add an extra temperature sensor to channel 3, do the following:

wee_device --set-transmitter-type=3,1,2

This says to turn on channel 3, set its type to 1 ("Temperature only"), and have it show up in the database as extraTemp2. Here's another example, this time for a combined temperature / humidity sensor:

wee_device --set-transmitter-type=5,3,2,4

This will add the combined sensor to channel 5, set its type to 3 ("Temperature and humidity"), and it will show up in the database as extraTemp2 and extraHumid4.

The --help option will give you the code for each sensor type.

Action --set-dst

Use the command to tell your console whether or not daylight savings time is in effect, or to have it set automatically based on the time zone.

Action --set-tz-code

This command can be used to change the time zone. Consult the Vantage manual for the code that corresponds to your time zone.

You can set either the time zone code or the time zone offset, but not both.

For example, to set the time zone code to Central European Time (code 20):

wee_device --set-tz-code=20

Action --set-tz-offset

If you live in an odd time zone that is perhaps not covered by the "canned" Davis time zones, you can set the offset from UTC using this command.

You can set either the time zone code or the time zone offset, but not both.

For example, to set the time zone offset for Newfoundland Standard Time (UTC-03:30), use the following:

wee_device --set-tz-offset=-0330

Action --set-lamp

Use this command to turn the console lamp on or off.

Action --start

Use this command to start the logger. There are occasions when an out-of-the-box logger needs this command.

Action --stop

Use this command to stop the logger. I can't think of a good reason why you would need to do this, but the command is included for completeness.

Action --dump

Generally, weewx downloads only new archive records from the on-board logger in the Vantage. However, occasionally the memory in the Vantage will get corrupted, making this impossible. See the troubleshooting section Weewx generates HTML pages, but it does not update them. The fix involves clearing the memory but, unfortunately, this means you may lose any data which might have accumulated in the logger memory, but not yet downloaded. By using the --dump command before clearing the memory, you might be able to save these data. Stop weewx first, then

wee_device --dump

This will dump all data archived in the Vantage memory directly to the database, without regard to whether or not they have been seen before. Because the command dumps all data, it may result in many duplicate primary key errors. These can be ignored.

Action --logger-summary FILE

This command is useful for debugging the console logger. It will scan the logger memory, recording the timestamp in each page and index slot to the file FILE.

Example:

wee_device --logger-summary=/var/tmp/summary.txt

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

WMR100

The station emits partial packets, which may confuse some online services.

Configuring with wee_device

The wee_device utility cannot be used to configure WMR100 stations.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

Each packet contains a subset of all possible readings. For example, a temperature packet contains extraTempN and batteryStatusN, a rain packet contains totalRain and rainRate.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

WMR200

The station emits partial packets, which may confuse some online services.

When weewx starts up it will attempt to download all records from the console since the last record in the archive database.

Configuring with wee_device

The wee_device utility cannot be used to configure WMR200 stations.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

Each packet contains a subset of all possible readings. For example, a temperature packet contains extraTempN and batteryStatusN, a rain packet contains totalRain and rainRate.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

WMR300

A single WMR300 console supports 1 wind, 1 rain, 1 UV, and up to 8 temperature/humidity sensors.

The WMR300 sensors send at different rates:

The console contains the pressure sensor. The console reports pressure every 15 minutes.

The station emits partial packets, which may confuse some online services.

When weewx starts up it will attempt to download all records from the console since the last record in the archive database. This can take as much as couple of hours, depending on the number of records in the logger and the speed of the computer and disk.

Configuring with wee_device

The wee_device utility cannot be used to configure WMR300 stations.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

Each packet contains a subset of all possible readings.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

WMR9x8

The station includes a data logger, but the driver does not read records from the station.

The station emits partial packets, which may confuse some online services.

Configuring with wee_device

The wee_device utility cannot be used to configure WMR9x8 stations.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

Each packet contains a subset of all possible readings. For example, a temperature packet contains extraTempN and batteryStatusN, a rain packet contains totalRain and rainRate.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

WS1

The WS1 stations produce data every 1/2 second or so.

Configuring with wee_device

The wee_device utility cannot be used to configure WS1 stations.

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

WS23xx

The hardware interface is a serial port, but USB-serial converters can be used with computers that have no serial port. Beware that not every type of USB-serial converter will work. Converters based on ATEN UC-232A chipset are known to work.

The station does not record wind gust or wind gust direction.

The hardware calculates windchill and dewpoint.

The station has 175 history records. That is just over 7 days of data with the factory default history recording interval of 60 minutes, or about 14 hours with a recording interval of 5 minutes.

When weewx starts up it will attempt to download all records from the console since the last record in the archive database.

Configuring with wee_device

Invoking wee_device with the --help option

wee_device /home/weewx/weewx.conf --help

will produce something like this:

WS23xx driver version 0.21
Usage: wee_device [config_file] [options] [--debug] [--help]

Configuration utility for weewx devices.

Options:
  -h, --help         show this help message and exit
  --debug            display diagnostic information while running
  -y                 answer yes to every prompt
  --info             display weather station configuration
  --current          get the current weather conditions
  --history=N        display N history records
  --history-since=N  display history records since N minutes ago
  --clear-memory     clear station memory
  --set-time         set the station clock to the current time
  --set-interval=N   set the station archive interval to N minutes

Mutating actions will request confirmation before proceeding.

Action --info

Display the station settings with the --info option.

wee_device --info 

This will result in something like:

buzzer: 0
connection time till connect: 1.5
connection type: 15
dew point: 8.88
dew point max: 18.26
dew point max alarm: 20.0
dew point max alarm active: 0
dew point max alarm set: 0
dew point max when: 978565200.0
dew point min: -2.88
dew point min alarm: 0.0
dew point min alarm active: 0
dew point min alarm set: 0
dew point min when: 978757260.0
forecast: 0
history interval: 5.0
history last record pointer: 8.0
history last sample when: 1385564760.0
history number of records: 175.0
history time till sample: 5.0
icon alarm active: 0
in humidity: 48.0
...

Action --set-interval

WS23xx stations ship from the factory with an archive interval of 60 minutes (3600 seconds). To change the station's interval to 5 minutes, do the following:

wee_device --set-interval=5

Warning!
Changing the archive interval will clear the station memory.

Action --history

WS23xx stations store records in a circular buffer — once the buffer fills, the oldest records are replaced by newer records. The console stores up to 175 records. The history number of records indicates how many records are in memory. The history interval indicates the number of minutes between records.

For example, to display the latest 30 records from the console memory:

wee_device --history=30

Action --clear-memory

To clear the console memory:

wee_device --clear-memory

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service

WS28xx

weewx communicates with a USB transceiver, which communicates with the station console, which in turn communicates with the sensors. The transceiver and console must be paired and synchronized.

The station has 1797 history records. That is just over 6 days of data with an archive interval of 5 minutes.

When weewx starts up it will attempt to download all records from the console since the last record in the archive database.

The WS28xx driver sets the station archive interval to 5 minutes.

The WS28xx driver does not support hardware archive record generation.

Pairing

The console and transceiver must be paired. Pairing ensures that your transceiver is talking to your console, not your neighbor's console. Pairing should only have to be done once, although you might have to pair again after power cycling the console, for example after you replace the batteries.

There are two ways to pair the console and the transceiver:

1. The weewx way. Be sure that weewx is not running. Run the configuration utility, press and hold the [v] button on the console until you see 'PC' in the display, then release the button. If the console pairs with the transceiver, 'PC' will go away within a second or two.

   wee_device --pair
   
   Pairing transceiver with console...
   Press and hold the [v] key until "PC" appears (attempt 1 of 3)
   Transceiver is paired to console

2. The HeavyWeather way. Follow the pairing instructions that came with the station. You will have to run HeavyWeather on a windows computer with the USB transceiver. After HeavyWeather indicates the devices are paired, put the USB transceiver in your weewx computer and start weewx. Do not power cycle the station console or you will have to start over.

If the console does not pair, you will see messages in the log such as this:

ws28xx: RFComm: message from console contains unknown device ID (id=165a resp=80 req=6)

Either approach to pairing may require multiple attempts.

Synchronizing

After pairing, the transceiver and console must be synchronized in order to communicate. Synchronization will happen automatically at the top of each hour, or you can force synchronization by pressing the [SET] button momentarily. Do not press and hold the [SET] button - that modifies the console alarms.

When the transceiver and console are synchronized, you will see lots of 'ws28xx: RFComm' messages in the log when debug=1. When the devices are not synchronized, you will see messages like this about every 10 minutes:

Nov  7 19:12:17 raspi weewx[2335]: ws28xx: MainThread: no contact with console

If you see this, or if you see an extended gap in the weather data in the weewx plots, press momentarily the [SET] button, or wait until the top of the hour.

When the transceiver has not received new data for awhile, you will see messages like this in the log:

Nov  7 19:12:17 raspi weewx[2335]: ws28xx: MainThread: no new weather data

If you see 'no new weather data' messages with the 'no contact with console' messages, it simply means that the transceiver has not been able to synchronize with the console. If you see only the 'no new weather data' messages, then the sensors are not communicating with the console, or the console may be defective.

Alarms

When an alarm goes off, communication with the transceiver stops. The WS28xx driver clears all alarms in the station. It is better to create alarms in weewx, and the weewx alarms can do much more than the console alarms anyway.

Configuring with wee_device

Invoking wee_device with the --help option

wee_device /home/weewx/weewx.conf --help

will produce something like this:

WS28xx driver version 0.33
Usage: wee_device [config_file] [options] [--debug] [--help]

Configuration utility for weewx devices.

Options:
  -h, --help           show this help message and exit
  --debug              display diagnostic information while running
  -y                   answer yes to every prompt
  --check-transceiver  check USB transceiver
  --pair               pair the USB transceiver with station console
  --info               display weather station configuration
  --set-interval=N     set logging interval to N minutes
  --current            get the current weather conditions
  --history=N          display N history records
  --history-since=N    display history records since N minutes ago
  --maxtries=MAXTRIES  maximum number of retries, 0 indicates no max

Mutating actions will request confirmation before proceeding.

Action --pair

The console and transceiver must be paired. This can be done either by using this command, or by running the program HeavyWeather on a Windows PC.

Be sure that weewx is not running. Run the command:

wee_device --pair

Pairing transceiver with console...
Press and hold the [v] key until "PC" appears (attempt 1 of 3)
Transceiver is paired to console

Press and hold the [v] button on the console until you see 'PC' in the display, then release the button. If the console pairs with the transceiver, 'PC' will go away within a second or two.

If the console does not pair, you will see messages in the log such as this:

ws28xx: RFComm: message from console contains unknown device ID (id=165a resp=80 req=6)

Pairing may require multiple attempts.

After pairing, the transceiver and console must be synchronized in order to communicate. This should happen automatically.

Action --info

Display the station settings with the --info option.

wee_device --info

This will result in something like:

alarm_flags_other: 0
alarm_flags_wind_dir: 0
checksum_in: 1327
checksum_out: 1327
format_clock: 1
format_pressure: 0
format_rain: 1
format_temperature: 0
format_windspeed: 4
history_interval: 1
indoor_humidity_max: 70
indoor_humidity_max_time: None
indoor_humidity_min: 45
indoor_humidity_min_time: None
indoor_temp_max: 40.0
indoor_temp_max_time: None
indoor_temp_min: 0.0
indoor_temp_min_time: None
lcd_contrast: 4
low_battery_flags: 0
outdoor_humidity_max: 70
outdoor_humidity_max_time: None
outdoor_humidity_min: 45
outdoor_humidity_min_time: None
outdoor_temp_max: 40.0
outdoor_temp_max_time: None
outdoor_temp_min: 0.0
outdoor_temp_min_time: None
pressure_max: 1040.0
pressure_max_time: None
pressure_min: 960.0
pressure_min_time: None
rain_24h_max: 50.0
rain_24h_max_time: None
threshold_storm: 5
threshold_weather: 3
wind_gust_max: 12.874765625
wind_gust_max_time: None

Station data

The following table shows which data are provided by the station hardware and which are calculated by weewx.

H indicates data provided by Hardware
D indicates data calculated by the Driver
S indicates data calculated by the StdWXCalculate Service