From bd44bbdac20d82bc0559e1d9ff8bbea2edb80f62 Mon Sep 17 00:00:00 2001 From: Matthew Wall Date: Mon, 17 Mar 2014 15:30:11 +0000 Subject: [PATCH] fix table layout. minor html edits. --- docs/usersguide.htm | 94 +++++++++++++++++++++++++-------------------- 1 file changed, 52 insertions(+), 42 deletions(-) diff --git a/docs/usersguide.htm b/docs/usersguide.htm index 1e00084b..fff2f923 100644 --- a/docs/usersguide.htm +++ b/docs/usersguide.htm @@ -1882,7 +1882,7 @@ Options: 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 + 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-time Set the onboard clock to the current time. @@ -1977,14 +1977,14 @@ Davis Vantage EEPROM settings:

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.

-

Choose your archiving interval carefully! Once chosen, it cannot - be changed without messing up your statistics (highs and lows will be OK, but - averages and rms wind speed will be wrong).

+

Choose the archive interval carefully! 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).

Rain bucket type

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.1MM bucket (bucket code "2"), use the following:

+ 0.1 mm bucket (bucket code "2"), use the following:

$BIN_ROOT/wee_config_vantage --set-bucket=2

Dumping the logger memory

@@ -2074,16 +2074,19 @@ Mutating actions will request confirmation before proceeding.

(read_period) of 30 minutes (1800 seconds). To change the station's interval to 5 minutes, do the following:

$BIN_ROOT/wee_config_fousb --set-interval=5

-

Choose your archiving interval carefully! Once chosen, it - cannot be changed without messing up your statistics (highs and lows - will be OK, but averages and rms wind speed will be wrong).

+

Choose the archive interval carefully! 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).

Calibrating the pressure sensor

-

The pressure sensor in the Fine Offset stations measures absolute, or gauge pressure. - The absolute pressure may be off a bit when the station is at sea level (1 to 10 millibars), - but it will definitely be way off when the station is above sea level (as much as hundreds of millibars). - Weewx will compensate for the effects of altitude, but to do so, - it needs not only the altitude, but a calibrated station pressure.

+

The pressure sensor in the Fine Offset stations measures absolute, or + gauge pressure, but most weather services require a pressure adjusted to + sea level. The absolute pressure may be off a bit (1 to 10 millibars) + when the station is at sea level, but it will definitely be way off + (as much as hundreds of millibars) when the station is above sea level. + Weewx will compensate for the effects of + altitude, but to do so, it needs not only the altitude, but a calibrated + station pressure.

To calibrate the pressure sensor, specify a pressure_offset, in millibars, in weewx.conf. If you do not know what the offset should be, use the wee_config_fousb utility to calculate this offset given the station altitude and a valid sea-level pressure from a nearby known-correct station.

@@ -2221,9 +2224,9 @@ in humidity: 48.0 minutes (3600 seconds). To change the station's interval to 5 minutes, do the following:

$BIN_ROOT/wee_config_ws23xx --set-interval=5

-

Choose your archiving interval carefully! Once chosen, it - cannot be changed without messing up your statistics (highs and lows - will be OK, but averages and rms wind speed will be wrong).

+

Choose the archive interval carefully! 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).

Dumping the console memory

WS23xx stations store records in a circular buffer - once the @@ -2384,11 +2387,13 @@ mysql> GRANT select, update, create, delete, insert ON stats.* TO weewx@local [StdArchive] for details.

Running weewx

-

Weewx can be run either from the command line (useful - for diagnostic purposes because it will print out a summary of every LOOP data), - or as a daemon. When first trying weewx, it is - probably best to run it from the command line because you will be able to see - command line diagnostics, as well as log messages.

+

Weewx can be run either from the command line + (useful for diagnostic purposes because it will print out a summary of + every LOOP data), or as a daemon. When first trying + weewx, it is best to run it from the command + line because you will be able to see command line diagnostics, as well + as log messages. Once everything is working properly, run it as a + daemon.

Running from the command line

Weewx can easily be run from the command line. Start by making sure you have appropriate permissions to the serial port your @@ -2421,9 +2426,9 @@ kill -HUP pid # Send it a HUP signal done automatically. You can ignore this section.

Start by selecting the appropriate run script. They can be found under $WEEWX_ROOT/util/init.d/.

- +
- + @@ -2431,7 +2436,7 @@ kill -HUP pid # Send it a HUP signal - +
Debian/Ubuntu/Mint:Debian/Ubuntu/Mint: $WEEWX_ROOT/util/init.d/weewx.debian
$WEEWX_ROOT/util/init.d/weewx.redhat
SuSE:SuSE: $WEEWX_ROOT/util/init.d/weewx.suse
@@ -2440,9 +2445,9 @@ kill -HUP pid # Send it a HUP signal weewx installation (it should have been set to the correct value automatically by the install process, but it is worth checking).

Copy it to the proper location for your system:

- +
- + @@ -2450,14 +2455,14 @@ kill -HUP pid # Send it a HUP signal - +
Debian/Ubuntu/Mint:Debian/Ubuntu/Mint: cp $WEEWX_ROOT/util/init.d/weewx.debian /etc/init.d/weewx
cp $WEEWX_ROOT/util/init.d/weewx.redhat /etc/rc.d/init.d/weewx
SuSE:SuSE: cp $WEEWX_ROOT/util/init.d/weewx.suse /etc/init.d/weewx

Make sure the script is executable:

- +
- + @@ -2465,14 +2470,14 @@ kill -HUP pid # Send it a HUP signal - +
Debian/Ubuntu/Mint:Debian/Ubuntu/Mint: chmod +x /etc/init.d/weewx
chmod +x /etc/init.d/rc.d/weewx
SuSE:SuSE: chmod +x /etc/init.d/weewx

Create symbolic links in the run level directories:

- +
- + @@ -2480,7 +2485,7 @@ kill -HUP pid # Send it a HUP signal - +
Debian/Ubuntu/Mint:Debian/Ubuntu/Mint: update-rc.d weewx defaults 98
chkconfig weewx on
SuSE:SuSE: /usr/lib/lsb/install_initd /etc/init.d/weewx
@@ -2630,17 +2635,22 @@ sudo /etc/init.d/apache2 restart

Hardware problems

Establishing connectivity

-

If you are unable to get anything out of weewx, first - check that you have connectivity to your weather station. For the Davis stations, - you can use a terminal emulator (I like minicom because - it can be run from through a simple TTY connection) to run a simple test. Set - it up to communicate using the appropriate port and baudrate. For example

+

If you are unable to get anything out of weewx + first check that you have connectivity to your weather station. For the + Davis stations, you can use a terminal emulator to run a simple test. + Set it up to communicate using the appropriate port and baudrate. I + like minicom because it can be run from + through a simple TTY connection. The utility + screen also works well. For example:

minicom -b 19200 -D /dev/ttyUSB0
-

Then type in TEST, all in capital letters. It will - not echo the characters. Then hit the <enter> +

or, using screen:

+ 
screen /dev/ttyUSB0 19200
+

Then type in TEST, all in capital letters. It + will not echo the characters. Then hit the + <enter> key. It should echo back TEST.

-

If this works, then you have established connectivity with the Davis and - the problem must lie elsewhere.

+

If this works, then you have established connectivity with the Davis + and the problem must lie elsewhere.

Tips on making a system reliable

If you are having problems keeping your weather station up for long