mirror/weewx
1
0
Fork 0
mirror of https://github.com/weewx/weewx.git synced 2026-06-09 17:45:24 -04:00
Code Issues Packages Projects Releases Wiki Activity

document wee_config_device

Browse Source
This commit is contained in:
Matthew Wall
2014-11-09 16:50:41 +00:00
parent 0813241de1
commit f463d9fed6
1 changed files with 109 additions and 263 deletions
Download Patch File Download Diff File Expand all files Collapse all files

372
docs/usersguide.htm
View File

@@ -2032,85 +2032,30 @@ report_services = weewx.engine.StdPrint, weewx.engine.StdReport
difference in execution speed and memory use.</p>
<h1 id="configuring_hardware">Configuring station hardware</h1>
<p>This section describes how to configure some of the more popular station hardware, using
configuration utilities supplied with weewx. Directions follow for</p>
<ul>
<li><a href="#wee_config_vantage">Davis Vantage stations</a></li>
<li><a href="#wee_config_fousb">Fine Offset 10xx, 20xx, and 30xx stations</a></li>
<li><a href="#wee_config_ws23xx">La Crosse WS23xx stations</a></li>
<li><a href="#wee_config_ws28xx">La Crosse WS28xx stations</a></li>
<li><a href="#wee_config_cc3000">RainWise CC3000 data logger</a></li>
</ul>
<p>This section describes how to configure some of the more popular
station hardware.</p>
<p>Some stations can be configured using the
<span class='code'>wee_config_device</span> utility supplied with weewx.
This utility uses code in the hardware-specific driver to set EEPROM
constants, read station memory, set the station archive interval, set
the altitude, configure rain bucket types, and many other options,
depending on the hardware.</p>
<p>Note that some stations cannot be configured by software at all,
and some stations are only partly configurable by software.</p>
<p>Run the utility with the <span class='code'>--help</span> option
to see which options are available.</p>
<p class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --help </p>
<p>The utility requires a <span class='code'>weewx.conf</span> file.
If no file is specified, it will look for
<span class='code'>weewx.conf</span> in the standard location. If
your configuration file is in a non-standard location, specify the
path to the configuration file as the first argument. For example,</p>
<p class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device /path/to/weewx.conf --help </p>
<h2 id="wee_config_vantage">Davis Vantage</h2>
<p>Weewx comes with a configuration utlity, <span class="code">wee_config_vantage</span>,
that can set many of the on-board EEPROM constants in the Davis Vantage stations,
such as its archive interval, altitude, rain bucket type, <em>etc.</em> </p>
<p>Run it with <span class="code">--help</span> as an option to see its usage: </p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --help </pre>
<p>This will print out something like:</p>
<pre class="tty">Usage: wee_config_vantage: [config_file] [--help] [--info] [--clear]
[--set-interval=SECONDS] [--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
--config=FILE use configuration file FILE
--info To print configuration, reception, and barometer
calibration information about your weather station.
--clear To clear the memory of your weather station.
--set-interval=SECONDS
Sets the archive interval to the specified number of
seconds. Valid values are 60, 300, 600, 900, 1800,
3600, or 7200.
--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
--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).
Mutating actions will request confirmation before proceeding.
</pre>
<p>It is useful to run it with the <span class="code">--info</span> option to
see what the current EEPROM settings are on your station: </p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --info </pre>
<p>Use the <span class="code">--info</span> option to display the
current EEPROM settings: </p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --info </pre>
<p>This will print out something like: </p>
<pre class="tty">Using configuration file /home/weewx/weewx.conf.
Querying...
@@ -2123,12 +2068,12 @@ Davis Vantage EEPROM settings:
Version: 3.12
CONSOLE SETTINGS:
<span class="highlight"> Archive interval: 300 (seconds)
Altitude: 700 (foot)</span>
<span class="highlight">Archive interval: 300 (seconds)</span>
<span class="highlight">Altitude: 700 (foot)</span>
Wind cup type: large
<span class="highlight"> Rain bucket type: 0.01 inches
Rain year start: 10
Onboard time: 2014-09-25 07:41:14</span>
<span class="highlight">Rain bucket type: 0.01 inches</span>
<span class="highlight">Rain year start: 10</span>
<span class="highlight">Onboard time: 2014-09-25 07:41:14</span>
CONSOLE DISPLAY UNITS:
Barometer: inHg
@@ -2139,21 +2084,21 @@ Davis Vantage EEPROM settings:
CONSOLE STATION INFO:
Latitude (onboard): 45.7
Longitude (onboard): -121.6
<span class="highlight"> 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</span>
<span class="highlight">Use manual or auto DST? AUTO</span>
<span class="highlight">DST setting: N/A</span>
<span class="highlight">Use GMT offset or zone code? ZONE_CODE</span>
<span class="highlight">Time zone code: 4</span>
<span class="highlight">GMT offset: N/A</span>
TRANSMITTERS:
<span class="highlight"> 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)</span>
<span class="highlight">Channel 1: iss</span>
<span class="highlight">Channel 2: (N/A)</span>
<span class="highlight">Channel 3: temp (as extra temperature 1)</span>
<span class="highlight">Channel 4: (N/A)</span>
<span class="highlight">Channel 5: (N/A)</span>
<span class="highlight">Channel 6: (N/A)</span>
<span class="highlight">Channel 7: (N/A)</span>
<span class="highlight">Channel 8: (N/A)</span>
RECEPTION STATS:
Total packets received: 10670
@@ -2163,8 +2108,8 @@ Davis Vantage EEPROM settings:
Number of CRC errors: 651
BAROMETER CALIBRATION DATA:
<span class="highlight"> Current barometer reading: 29.834 inHg
Altitude: 700 feet</span>
<span class="highlight">Current barometer reading: 29.834 inHg</span>
<span class="highlight">Altitude: 700 feet</span>
Dew point: 55 F
Virtual temperature: 59 F
Humidity correction factor: 27
@@ -2174,22 +2119,21 @@ Davis Vantage EEPROM settings:
Offset: -47.000
OFFSETS:
<span class="highlight"> 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</span></pre>
<span class="highlight">Wind direction: +0 deg</span>
<span class="highlight">Inside Temperature: +0.0 F</span>
<span class="highlight">Inside Humidity: +0%</span>
<span class="highlight">Outside Temperature: +0.0 F</span>
<span class="highlight">Outside Humidity: +0%</span>
<span class="highlight">Extra Temperature 1: +0.0 F</span></pre>
<p>The console version number is available only on consoles with firmware
dates after about 2006.</p>
<p><span class="highlight">Highlighted</span> values can be changed using this utility.</p>
<p>For example, to change the archive interval to 10 minutes (600 seconds):</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --set-interval=600</pre>
<p><span class="highlight">Highlighted&nbsp;</span> values can be changed using this utility.</p>
<h3 id="vantage_time_zone">Time zone</h3>
<p>To set the time zone code to Central European Time (code 20):</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --set-tz-code=20</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --set-tz-code=20</pre>
<p class="warning">You can set either the time zone code <em>or</em> the
time zone offset, but not both. </p>
<p>Other parameters can be set in a similar manner.</p>
<h3 id="vantage_archive_interval">Archive interval</h3>
<p>Valid archive intervals for the Davis Vantage stations are 60,
@@ -2199,30 +2143,34 @@ Davis Vantage EEPROM settings:
archive record is due. If this is the case, you should pick an
archive interval of at least 300 seconds, or trim the number of
files you are using.</p>
<p>I have found that a five minute (300 seconds) archive interval 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. </p>
<p>To change the archive interval to 10 minutes (600 seconds):</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --set-interval=600</pre>
<p>I have found that a five minute (300 seconds) archive interval 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. </p>
<h3 id="vantage_rain_bucket_type">Rain bucket type</h3>
<p>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 &quot;2&quot;), use the following:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --set-bucket=2</pre>
<p>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 &quot;2&quot;), use the
following:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --set-bucket=2</pre>
<h3 id="vantage_configuring_additional_sensors">Configuring additional sensors</h3>
<h3 id="vantage_configuring_additional_sensors">Additional sensors</h3>
<p>If you have additional sensors for your Vantage station, you
can configure them using your console. However, if you have
a <a href="http://www.davisnet.com/weather/products/weather_product.asp?pnum=06316">Davis
Weather Envoy receiver</a>, it will not have a console! As an alternative,
the <span class='code'>weewx</span>
utility <span class="code">wee_config_vantage</span> lets
utility <span class="code">wee_config_device</span> lets
you do this from the command line.</p>
<p>For example, to add an extra temperature sensor to channel 3, do the following:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --set-transmitter-type=3,1,2</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --set-transmitter-type=3,1,2</pre>
<p>This says to turn on channel 3, set its type to 1 ("Temperature only"), and have it show up in the
database as <span class="code">extraTemp2</span>. Here's another example, this time for a combined
temperature / humidity sensor:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --set-transmitter-type=5,3,2,4</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --set-transmitter-type=5,3,2,4</pre>
<p>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 <span class="code">extraTemp2</span> and <span class="code">extraHumid4</span>.</p>
@@ -2240,7 +2188,7 @@ Davis Vantage EEPROM settings:
180&deg; offset correction. You can do this with the following
command:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --set-offset=windDir,180</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --set-offset=windDir,180</pre>
<h3 id="vantage_dumping_the_logger_memory">Dumping the logger memory</h3>
<p>Generally, <span class="code">weewx</span> downloads only new archive
@@ -2252,7 +2200,7 @@ Davis Vantage EEPROM settings:
lose any data which might have accumulated in the logger memory, but not
yet downloaded. By using the <span class="code">--dump</span> command
before clearing the memory, you might be able to save these data. </p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --dump</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --dump</pre>
<p>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 <em>all</em> data, it may result in many
@@ -2260,26 +2208,30 @@ Davis Vantage EEPROM settings:
<h2 id="wee_config_wmr100">WMR100</h2>
<p>There is no configuration utility in <span class='code'>weewx</span>
for the WMR100 stations.</p>
<p>The station emits partial packets, which may confuse some online services.</p>
<p>The <span class='code'>wee_config_device</span> utility cannot
configure WMR100 stations.</p>
<p>The station emits partial packets, which may confuse some online
services.</p>
<h2 id="wee_config_wmr200">WMR200</h2>
<p>There is no configuration utility in <span class='code'>weewx</span>
for the WMR200 stations.</p>
<p>The <span class='code'>wee_config_device</span> utility cannot
configure WMR200 stations.</p>
<p>When <span class='code'>weewx</span> starts up it will attempt to
download all records from the console since the last record in the
archive database.
</p>
<p>The station emits partial packets, which may confuse some online services.</p>
<p>The station emits partial packets, which may confuse some online
services.</p>
<h2 id="wee_config_wmr9x8">WMR9x8</h2>
<p>There is no configuration utility in <span class='code'>weewx</span>
for the WMR9x8 stations.</p>
<p>The station includes a data logger, but the driver does not read records from the station.</p>
<p>The station emits partial packets, which may confuse some online services.</p>
<p>The <span class='code'>wee_config_device</span> utility cannot
configure WMR9x8 stations.</p>
<p>The station includes a data logger, but the driver does not read
records from the station.</p>
<p>The station emits partial packets, which may confuse some online
services.</p>
<h2 id="wee_config_fousb">Fine Offset 10xx, 20xx, 30xx</h2>
@@ -2297,41 +2249,9 @@ Davis Vantage EEPROM settings:
console, or (if the station supports it) by WWVB radio. The fousb
driver ignores the station clock since it cannot be trusted.</p>
<p>The configuration utility <span class='code'>wee_config_fousb</span> is
designed to diagnose and configure Fine Offset stations.</p>
<p>Run it with <span class='code'>--help</span> as an option to see its usage:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_fousb --help </pre>
<p>This will print out something like:</p>
<p class='tty'>Usage: wee_config_fousb [config_file] [options] [--help]
Configuration utility for Fine Offset weather stations.
Options:
-h, --help show this help message and exit
--config=FILE use configuration file FILE
--info display weather station configuration
--check-pressures query station for pressure sensor data
--check-units compare raw and converted LOOP packets
--check-usb test the quality of the USB connection
--check-fixed-block monitor the contents of the fixed block
--fixed-block display the contents of the fixed block
--live display live readings from the station
--logged display logged readings from the station
--history-since=N display records since N minutes ago
--history=N display N records
--format=FORMAT format for output, one of raw, table, or dict
--set-clock set station clock to computer time
--set-pressure=P set relative pressure to P hPa (mbar)
--set-interval=N set logging interval to N minutes
--clear-memory clear station memory
--slp=SLP calculate pressure offset from sea level pressure SLP
-y answer yes to every prompt
--debug display diagnostic information while running
Mutating actions will request confirmation before proceeding.</p>
<p>Display the station settings with the <span class='code'>--info</span>
option.</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_fousb --info </pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --info </pre>
<p>This will result in something like this:</p>
<pre class='tty'>Fine Offset station settings:
local time: 2013.02.11 18:34:28 CET
@@ -2360,25 +2280,25 @@ Mutating actions will request confirmation before proceeding.</p>
version: 255
wind_coef: None
wind_mult: 0</pre>
<p><span class="highlight">Highlighted&nbsp;</span> values can be modified with the <span class='code'>wee_config_fousb</span> utility.</p>
<p><span class="highlight">Highlighted&nbsp;</span> values can be modified with the <span class='code'>wee_config_device</span> utility.</p>
<h3 id="fo_changing_the_archive_interval">Changing the archive interval</h3>
<p>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:</p>
<p class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_fousb --set-interval=5</p>
<p class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --set-interval=5</p>
<h3 id="fo_dumping_the_console_memory">Dumping the console memory</h3>
<p>Fine Offset stations store records in a circular buffer &mdash; 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 <span class='code'>data_count</span> indicates how many records are in memory. The <span class='code'>read_period</span> indicates the number of minutes between records. <span class='code'>wee_config_fousb</span> can display these records in space-delimited, raw bytes, or dictionary format.</p>
<p>Fine Offset stations store records in a circular buffer &mdash; 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 <span class='code'>data_count</span> indicates how many records are in memory. The <span class='code'>read_period</span> indicates the number of minutes between records. <span class='code'>wee_config_device</span> can display these records in space-delimited, raw bytes, or dictionary format.</p>
<p>For example, to display the most recent 30 records from the console memory:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_fousb --history=30</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --history=30</pre>
<p>To clear the console memory:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_fousb --clear-memory</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --clear-memory</pre>
<h3>Checking the USB quality</h3>
<p>Use the <span class='code'>wee_config_fousb</span> utility to test the quality of the USB connection between computer and console. Poor quality USB cables, under-powered USB hubs, and other devices on the bus can interfere with communication.</p>
<p>Use the <span class='code'>wee_config_device</span> utility to test the quality of the USB connection between computer and console. Poor quality USB cables, under-powered USB hubs, and other devices on the bus can interfere with communication.</p>
<p>To test the quality of the USB connection to the console:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_fousb --check-usb</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --check-usb</pre>
<p>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.</p>
<h3 id="polling_mode_and_the_polling_interval">Polling mode and the polling interval</h3>
@@ -2432,32 +2352,10 @@ Mutating actions will request confirmation before proceeding.</p>
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.</p>
<p>The configuration utility <span class='code'>wee_config_ws23xx</span> is
designed to diagnose and configure WS23xx stations.</p>
<p>Run it with <span class='code'>--help</span> as an option to see its usage:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_ws23xx --help </pre>
<p>This will print out something like:</p>
<pre class='tty'>Usage: wee_config_ws23xx [config_file] [options] [--debug]
Configuration utility for WS-23xx weather stations.
Options:
-h, --help show this help message and exit
--config=FILE configuration file
--info display weather station configuration
--current get the current weather conditions
--history-since=N display history records since N minutes ago
--history=N display N history records
--set-time set the station clock to the current time
--set-interval=N set the station archive interval to N minutes
--clear-memory clear station memory
-y answer yes to every prompt
--debug display diagnostic information while running
Mutating actions will request confirmation before proceeding.</pre>
<p>Display the station settings with the <span class='code'>--info</span>
option.</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_ws23xx --info </pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --info </pre>
<p>This will result in something like this:</p>
<pre class='tty'>Driver version 0.6
Querying the station for the configuration...
@@ -2489,12 +2387,9 @@ in humidity: 48.0
<p>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:</p>
<p class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_ws23xx --set-interval=5</p>
<p class="warning"><b>Choose the archive interval carefully! </b>Once
chosen, it cannot be changed without messing up the statistics (highs
and lows will be OK, but averages and RMS wind speed will be wrong). </p>
<p class="warning">Changing the recording interval will clear the station
memory.</p>
<p class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --set-interval=5</p>
<p class="warning"><strong>Warning!</strong><br/>
Changing the recording interval will clear the station memory.</p>
<h3 id="ws23xx_dumping_the_console_memory">Dumping the console memory</h3>
<p>WS23xx stations store records in a circular buffer - once the
@@ -2505,9 +2400,9 @@ in humidity: 48.0
<span class='code'>history interval</span> indicates the number of
minutes between records.</p>
<p>For example, to display the latest 30 records from the console memory:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_ws23xx --history=30</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --history=30</pre>
<p>To clear the console memory:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_ws23xx --clear-memory</pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --clear-memory</pre>
@@ -2525,29 +2420,6 @@ in humidity: 48.0
</p>
<p>The WS28xx driver does not support hardware archive record
generation.</p>
<p>The configuration utility <span class='code'>wee_config_ws28xx</span> is
designed to diagnose and configure WS28xx stations.</p>
<p>Run it with <span class='code'>--help</span> as an option to see its usage:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_ws28xx --help </pre>
<p>This will print out something like:</p>
<pre class='tty'>Usage: wee_config_ws28xx [config_file] [options] [--debug]
Configuration utility for WS-28xx weather stations.
Options:
-h, --help show this help message and exit
--config=FILE configuration file
--check-transceiver check USB transceiver
--pair pair the USB transceiver with a station console
--info display weather station configuration
--current get the current weather conditions
--history-since=N display history records since N minutes ago
--history=N display N history records
--format=FORMAT format for history, one of raw, table, or dict
--maxtries=MAXTRIES maximum number of retries, 0 indicates no max
--debug display diagnostic information while running
Mutating actions will request confirmation before proceeding.</pre>
<h3>Pairing</h3>
<p>The console and transceiver must be paired. Pairing ensures that your
@@ -2607,8 +2479,8 @@ Mutating actions will request confirmation before proceeding.</pre>
<h2 id="wee_config_te923">TE923</h2>
<p>There is no configuration utility in <span class='code'>weewx</span>
for the TE923 stations.</p>
<p>The <span class='code'>wee_config_device</span> utility cannot
configure TE923 stations.</p>
<p>The station has either 200 or 3300 history records, depending on
the model. That is just over a day (200 records) or about 23 days
(3300 records) with an archive interval of 5 minutes.</p>
@@ -2624,8 +2496,8 @@ Mutating actions will request confirmation before proceeding.</pre>
<h2 id="wee_config_ultimeter">Ultimeter</h2>
<p>There is no configuration utility in <span class='code'>weewx</span>
for the Ultimeter stations.</p>
<p>The <span class='code'>wee_config_device</span> utility cannot
configure Ultimeter stations.</p>
<p>The Ultimeter driver operates the Ultimeter in Data Logger Mode,
which results in sensor readings every 1/2 second or so.</p>
<p>The Ultimeter driver ignores the maximum, minimum, and average
@@ -2633,8 +2505,8 @@ Mutating actions will request confirmation before proceeding.</pre>
<h2 id="wee_config_ws1">WS1</h2>
<p>There is no configuration utility in <span class='code'>weewx</span>
for the WS1 stations.</p>
<p>The <span class='code'>wee_config_device</span> utility cannot
configure WS1 stations.</p>
<p>The WS1 stations produce data every 1/2 second or so.</p>
@@ -2647,33 +2519,10 @@ Mutating actions will request confirmation before proceeding.</pre>
units as defined within <span class='code'>weewx</span>. However, the
CC3000 driver will convert to the appropriate units for the
<span class='code'>weewx</span> configuration.</p>
<p>The configuration utility <span class='code'>wee_config_cc3000</span> is
designed to diagnose and configure RainWise CC3000 data loggers.</p>
<p>Run it with <span class='code'>--help</span> as an option to see its usage:</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_cc3000 --help </pre>
<p>This will print out something like:</p>
<p class='tty'>Usage: wee_config_cc3000 [config_file] [options] [--help]
Configuration utility for RainWise CC3000 data logger.
Options:
-h, --help show this help message and exit
--config=FILE use configuration file FILE
--info display weather station configuration
--current display current weather readings
--history=N display N records (specify 0 for all records)
--set-clock set station clock to computer time
--set-units=UNITS set units to METRIC or ENGLISH
--set-interval=N set logging interval to N minutes
--clear-memory clear station memory
-y answer yes to every prompt
--debug display diagnostic information while running
Mutating actions will request confirmation before proceeding.
</p>
<p>Display the station settings with the <span class='code'>--info</span>
option.</p>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_cc3000 --info </pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --info </pre>
<p>This will result in something like this:</p>
<pre class='tty'>firmware: Rainwise CC-3000 Version: 1.3 Build 006 Sep 04 2013
time: 2014/06/02 08:22:17
@@ -2685,10 +2534,7 @@ interval: 1</pre>
<p>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:</p>
<p class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_cc3000 --set-interval=5</p>
<p class="warning"><b>Choose the archive interval carefully! </b>Once
chosen, it cannot be changed without messing up the statistics (highs
and lows will be OK, but averages and RMS wind speed will be wrong). </p>
<p class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --set-interval=5</p>
<h1 id="configuring_mysql">Configuring MySQL</h1>
@@ -3225,10 +3071,10 @@ ACTION=="add",ATTRS{idVendor}=="05ad",ATTRS{idProduct}=="0fba",MODE="0666",SYMLI
This will cause the console software to internally reboot. In one case this
has fixed the problem without data loss.</li>
<li>If all else fails, clear the memory of the console using the utility
<span class="code">wee_config_vantage</span>. This may cause loss of data, but
<span class="code">wee_config_device</span>. This may cause loss of data, but
usually works. Adjust paths as necessary:</li>
</ol>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_vantage --clear </pre>
<pre class="tty"><span class="symcode">$BIN_ROOT</span>/wee_config_device --clear </pre>
<p>See also the section <em><a href="#Dumping_the_logger_memory">Dumping
the logger memory</a></em>, which may help you avoid data loss.</p>
<h3>3rd party Vantage connectors</h3>
@@ -3493,7 +3339,7 @@ Dec 30 10:54:17 saga weewx[10035]: wxengine: Using archive interval of 1800</p>
in <span class="code">weewx.conf</span> does not match the station's
hardware interval, <span class="code">weewx</span> defers to the
station's interval.</p>
<p>Use the appropriate <a href="#configuring_hardware"><span class="code">wee_config_XXX</span></a> utility to change the station's interval.</p>
<p>Use the appropriate <a href="#configuring_hardware"><span class="code">wee_config_device</span></a> utility to change the station's interval.</p>
<h3 id='spikes'>Spikes in the graphs</h3>
<p>Occasionally you may see anomalous readings, typically manifested as