crt - weewx/weewx GitHub Wiki

Cumulus Real-Time

This is an extension to weewx that emits data to a file in the format used by Cumulus realtime.txt. The format for the realtime.txt file is maintained at the cumulus web site:

http://cumuluswiki.wxforum.net/a/Realtime.txt

Download

wget -O weewx-crt.zip https://github.com/matthewwall/weewx-crt/archive/master.zip

How to Install

  1. Run the extension installer:
weectl extension install=weewx-crt.zip
  1. Modify weewx.conf:
    [CumulusRealTime]
        filename = /var/tmp/realtime.txt
        unit_system = METRIC # options are US, METRIC, METRICWX
  1. Restart weewx
sudo systemctl stop weewx
sudo systemctl start weewx

Verify

The realtime.txt file should be modified on each LOOP. For some stations the update will happen more often than others. For example, Vantage sensors update as often as every 2.5 seconds, whereas FineOffset stations never update more often than 48 seconds.

The file should contain something like this:

25/01/15 05:53:40 -1.3 80 -4.3 9.8 9.0 225 0.0 0.0 989.7 SW 2 km/h C mb cm
8.2 2.2 3.4 3.4 0.0 20.6 40 -5.8 -0.6 -1.0 05:15 -1.3 05:50 10.6 05:35
18.5 05:35 989.7 05:35 989.3 05:05 3.0.1 0 14.6 -1.3 -4.4 NULL NULL NULL
249 0.0 0 0 0 WSW 384 meter -4.6 0.2 0.0 0

Options

binding - The binding determines whether the file will be updated with every LOOP packet or archive record. Possible values are loop or archive. Default is loop

filename - The full path of the file. Default is /var/tmp/realtime.txt

date_separator - The character for separating day, month, and year. Default is /

none - The string to use when there is no value. Default is NULL

sunny_threshold - The cutoff value that determines whether the sun is shining. The threshold is a value between 0 and 1, inclusive. It is compared against the ratio of actual solar radiation and theoretical maximum solar radiation to determine if the weather is sunny. Default is 0.75.

unit_system - The unit system to use in realtime.txt. Options include US, METRIC, and METRICWX. Default is to use the unit system of the weewx database.

wind_units - The units to use for wind-related data in realtime.txt. Options include meter_per_second, mile_per_hour, km_per_hour, and knot. Default is to use the units defined in the unit system.

temperature_units - The units to use for temperature data in realtime.txt. Options include degree_C and degree_F. Default is to use the units defined in the unit system.

pressure_units - The units to use for pressure data in realtime.txt. Options include hPa, mbar, and inHg. Default is to use the units defined in the unit system.

cloudbase_units - The units to use for cloud base in realtime.txt. Options include foot and meter. Default is to use the units for altitude in the unit system.

Software

The software can be found on GitHub at https://github.com/matthewwall/weewx-crt