Descripción de weewx.conf

[jantoni]

Esto es una introducción al fichero de configuración
En ningún momento pretende ser una guía eshaustiva
Si quieres profundizar acude al manual de usuario y al manual de personalización


Dado que he manifestado que no voy a crear más imágenes para WeeWX y Raspberry, empiezo a describir con todo el detalle que permiten lo poco que sé. WeeWX puede hacer mucho, pero muchísimo más de lo que yo he explicado hasta ahora.

Empezamos con la descripción del fichero de configuración general de WeeWX, es decir weewx.conf

Este fichero suele estar en el directorio /etc/weewx

[jantoni]

Este es el encabezamiento del fichero.

Por lo general, no se toca, salvo que tengamos problemas.

Código: [Seleccionar]

# $Id: weewx.conf 2901 2015-02-05 21:15:03Z tkeffer $
#
# WEEWX CONFIGURATION FILE
#
# Copyright (c) 2009-2014 Tom Keffer <tkeffer@gmail.com>
# See the file LICENSE.txt for your full rights.

##############################################################################

# This section is for general configuration information

# Set to 1 for extra debug info, otherwise comment it out or set to zero.
debug = 0

# Root directory of the weewx data file hierarchy for this station.
WEEWX_ROOT = /

# How long to wait before timing out a socket (FTP, HTTP) connection:
socket_timeout = 20

# Do not modify this - it is used by setup.py when installing and updating.
version = 3.1.0

##############################################################################

debug = 0  El nivel de información y errores en el log es el estándar.
debug = 1  La cantidad de información de los procesos y los errores será intensiva. Ojo, los ficheros de log pueden adquirir tamaños considerables

El resto de valores no deben tocarse, salvo que realmente sepas lo que estás haciendo.

Esta es la sección más corta de todas[/list]

[jantoni]

A continuación vamos a ver la sección donde decimos a Weewx que tipo de estación meteorológica va a manejar y algunos datos importantes.

Esta sección es sencilla y cortita.

Código: [Seleccionar]

##############################################################################

[Station]
    # This section is for information about your station

    # Description of the station location.
    location = Rivas-Vaciamadrid

    # Latitude and longitude in decimal degrees
    latitude = 40.3562475
    longitude = -3.5201664

    # Altitude of the station, with unit it is in. This is downloaded from
    # from the station if the hardware supports it.
    altitude = 630, meter

    # Set to type of station hardware.  There must be a corresponding stanza
    # in this file with a 'driver' parameter indicating the driver to be used.
    station_type = Vantage

    # If you have a website, you may specify an URL
    station_url = http://www.jantoni.es/weewx2

    # The start of the rain year (1=January; 10=October, etc.). This is
    # downloaded from the station if the hardware supports it.
    rain_year_start = 1

    # Start of week (0=Monday, 6=Sunday)
    week_start = 0


##############################################################################
location = Rivas-Vaciamadrid       Evidentemente es la descripción de donde está ubicada la estación

latitude = 40.3562475                 La latitud de la ubicación en grados decimales.
longitude = -3.5201664               La longitud de la ubicación en grados decimales. Este es positivo, Oeste es negativo

altitude = 630, meter                   Indicamos la altura DE LA CONSOLA y la unidad de medida (meter o feet) en metros o pies

station_type = Vantage                Indicamos que clase de estación usamos dentro de las admitidas por Weewx. El nombre debe coincidir con alguna de ellas.

[jantoni]

Esta es la sección de configuración de las estaciones Davis Vantage Pro2 y Davis Vantage Vue.

Esta sección es común para ambas y configura tanto los Weatherlink serie, los Weatherlink usb y los Weatherlink IP

Código: [Seleccionar]

[Vantage]
    # This section is for a Davis VantagePro2, VantageVue or WeatherLinkIP

    # Connection type: serial or ethernet
    #  serial (the classic VantagePro)
    #  ethernet (the WeatherLinkIP)
    type = serial

    # If the connection type is serial, a port must be specified:
    #   Debian, Ubuntu, Redhat, Fedora, and SuSE:
    #     /dev/ttyUSB0 is a common USB port name
    #     /dev/ttyS0   is a common serial port name
    #   BSD:
    #     /dev/cuaU0   is a common serial port name
    port = /dev/ttyAMA0
    #    port = /dev/ttyUSB0

    # If the connection type is ethernet, an IP Address/hostname is required:
    host = 1.2.3.4

    ######################################################
    # The rest of this section rarely needs any attention.
    # You can safely leave it "as is."
    ######################################################

    # Serial baud rate (usually 19200)
    baudrate = 19200

    # TCP port (when using the WeatherLinkIP)
    tcp_port = 22222

    # TCP send delay (when using the WeatherLinkIP):
    tcp_send_delay = 1

    # The id of your ISS station (usually 1)
    iss_id = 1

    # How long to wait for a response from the station before giving up (in
    # seconds; must be greater than 2)
    timeout = 5

    # How long to wait before trying again (in seconds)
    wait_before_retry = 1.2

    # How many times to try before giving up:
    max_tries = 4

    # The driver to use:
    driver = weewx.drivers.vantage

type = serial           Pondremos serial para los WL serie y los WL USB, ya que este último, en realidad es solo un conversor.
type = ethernet      Para los Weathelink IP

port = /dev/ttyUSB0         Esto será en la inmensa mayoría de los casos. En algunas ocasiones podrá ser otro número distinto de cero, porque nuestro ordenador detecte otro puerto Serie-USB.

Si usáis un ordenador que disponga de puerto RS232 y lo utilizáis para el WeatherLink Serie, debéis indicar el puerto. Por lo general será el /dev/ttyS0, /dev/ttyS1, etc, etc

Veis que en mi fichero aparece /dev/ttyAMA0. Ese es el puerto serie estándar de Raspberry PI (en los contactos del GPIO) que podrán usar directamente aquellos que tengan una consola Davis con firmware previo al 3.0, es decir, funciona sin datalogger.

Si tenéis dudas sobre cual es el puerto que tenéis que poner, podéis usar este comando:

Código: [Seleccionar]

dmesg | grep tty*
Os aparecerán, además del ttyAMA0, que siempre está presente, los adaptadores serie que tengáis conectados, incluido el datalogger, con su numeración. Si el ordenador tiene puertos RS232 estándar, también aparecerán identificados.

host = 1.2.3.4       Aquí indicamos la dirección IP del Weatherlink-IP

Si la consola está en una ubicación remota, debéis poner la dirección IP pública de la ubicación donde esté instalada y abrir el puerto correspondiente del router remoto.

Como indica el fichero original de configuración, el resto de parámetros se cambia muy raras veces, y es mejor no tocarlos salvo que sepas lo que haces.

Quizás el único parámetro sea:

iss_id = 1     que identifica que ISS debe leer la consola. Salvo que tengáis varias Davis en la misma ubicación, lo normal es que siempre sea 1.

[jantoni]

La siguiente sección que explicamos es la que controla las Oregon WMR88, WMR88A, WMR100, WMR100N,WMR180, WMR180A y WMRS200. OJO, OJO OJO......NO WMR200

Código: [Seleccionar]

[WMR100]
    # This section is for the Oregon Scientific WMR100

    # The station model, e.g., WMR100, WMR100N, WMRS200
    model = WMR100

    # How long a wind record can be used to calculate wind chill (in seconds)
    stale_wind = 30

    # The driver to use:
    driver = weewx.drivers.wmr100
Esta sección no se tocará prácticamente NUNCA, salvo el modelo de estación

model = WMR100        Es un texto. No tiene ninguna verificación. Unicamente se pone para identificar el tipo de estación en las páginas web generadas.

[jantoni]

La siguiente sección es para la Oregón WMR200         no WMRS200

Código: [Seleccionar]

[WMR200]
    # This section is for the Oregon Scientific WMR200

    # The station model, e.g., WMR200, WMR200A, Radio Shack W200
    model = WMR200

    # The driver to use:
    driver = weewx.drivers.wmr200
En modelo aplicamos lo mismo que he indicado en la sección de WMR100

Si pones WMR200 maravillosa, en la página web aparecerá WMR200 maravillosa

Es decir, no tiene ninguna aplicación más que visual en las páginas web generadas.

La sección de WMR200 no tiene ningún ajuste.

[jantoni]

En la sección siguiente se dedica a las Oregon 918,928, 968 y todas sus variantes en marcas como Huger, Radio Shack, etc, etc

Código: [Seleccionar]

[WMR9x8]
    # This section is for the Oregon Scientific WMR918/968

    # Connection type. For now, 'serial' is the only option.
    type = serial

    # Serial port such as /dev/ttyS0, /dev/ttyUSB0, or /dev/cuaU0
    port = /dev/ttyUSB0

    # The station model, e.g., WMR918, Radio Shack 63-1016
    model = WMR968

    # The driver to use:
    driver = weewx.drivers.wmr9x8
type = serial       Es la única opción

Port = /dev/ttyUSB0      Lee la descripción en la sección Davis.

model = VMR968        Se aplica lo mismo dicho en la sección WMR100 y WMR200

[jantoni]

Y ahora nos metemos con la configuración de la Fine Offset. Recordad que es el fabricante de las PCE FSW-20 y que también se venden con mil marcas mas.

Código: [Seleccionar]

[FineOffsetUSB]
    # This section is for the Fine Offset series of weather stations.

    # The station model, e.g., WH1080, WS1090, WS2080, WH3081
    model = WS2080

    # The polling mode can be PERIODIC or ADAPTIVE
    #    polling_mode = PERIODIC
    polling_mode = ADAPTIVE

    # How often to poll the station for data, in seconds
    # Este parametro es innecesario si usamos ADAPTIVE
    #    polling_interval = 60

    # The pressure calibration offset, in hPa (millibars)
    pressure_offset = 1

    # The driver to use:
    driver = weewx.drivers.fousb
model = WS2080   lo mismo indicado en las anteriores secciones. este campo solo nos vale para indicar la marca de nuestra estación. Podemos poner, sin problema, PCE FWS-20

pollíng_mode = ADAPTIVE
polling_mode = PERIODIC

ADAPTIVE significa que, cada vez que se genere un registro en la consola, se registrará por parte de Weewx
PERIODIC significa que, cada X segundos (indicados por polling_interval) Weewx se conecta a la consola y lee el último registro.

Personalmente he usado ambos métodos y no he encontrado diferencias en la fiabilidad del sistema.

polling_interval = 60  El periodo de tiempo en segundos que Weewx usará para conectarse a la consola y leer el último registro. Si usas ADAPTIVE deshabilitalo poniendo una # delante del campo.

Si alguno tiene en sus archivos un campo:

pressure_offset = 0       este parámetro dejó de funciona en la versión 3.0, por lo que salvo que tengas una versión 2.6.x o 2.7.x lo uedes borrar de tu archivo. Si tienes una versión 2.6 o 2.7 con este parámetro ajustas un offset de presión en hPa, puede ser positivo o negativo.

[jantoni]

Las siguientes secciones son para las LaCrosse series WS-2300 y WS-2800

Código: [Seleccionar]

[WS23xx]
    # This section is for the La Crosse WS-2300 series of weather stations.

    # Serial port such as /dev/ttyS0, /dev/ttyUSB0, or /dev/cuaU0
    port = /dev/ttyUSB0

    # The station model, e.g., 'LaCrosse WS2317' or 'TFA Primus'
    model = LaCrosse WS23xx

    # The pressure calibration offset, in hPa (millibars)
    pressure_offset = 0

    # The driver to use:
    driver = weewx.drivers.ws23xx

##############################################################################

[WS28xx]
    # This section is for the La Crosse WS-2800 series of weather stations.

    # Radio frequency to use between USB transceiver and console: US or EU
    # US uses 915 MHz, EU uses 868.3 MHz.  Default is US.
    transceiver_frequency = US

    # The station model, e.g., 'LaCrosse C86234' or 'TFA Primus'
    model = LaCrosse WS28xx

    # The pressure calibration offset, in hPa (millibars)
    pressure_offset = 0

    # The driver to use:
    driver = weewx.drivers.ws28xx
Los campos port, model y pressure_offset son idénticos a lo indicado anteriormente, por lo que es de aplicación en la misma medida.

El único campo a comentar es, en el caso de las WS2800:

transceiver_frecuency = US
transceiver_frecuency = EU

Que evidentemente es para decir que frecuencias usa la consola para comunicarse.

[jantoni]

La siguiente sección que comentamos es la correspondiente a la estación TE923. Bajo este nombre de driver Weewx se comunica con otras mil estaciones con nombre y modelo diferente.

Personalmente, siempre las he denominado Honeywell ya que los sensores, originalmente, eran construidos por esta empresa.

Actualmente, este driver controla estaciones como las Mebus, Honeywell, Hideki, TFA Nexus y Sinus, Ventus W831, etc, etc, etc

Salvo que tengamos sensores adicionales a los suministrados de manera estándar, no tocaremos ningún parámetro, ya que los campos de configuración se refieren a los sensores adicionales. Esta estación puede tener multitud de sensores termohigrométricos.

El campo model ya lo hemos explicado hasta la saciedad. Pondremos el nombre de nuestra estación.

Código: [Seleccionar]

[TE923]
    # This section is for the Hideki TE923 series of weather stations.

    # The station model, e.g., 'Meade TE923W' or 'TFA Nexus'
    model = TE923

    # The driver to use:
    driver = weewx.drivers.te923

    # The default configuration associates the channel 1 sensor with outTemp
    # and outHumidity.  To change this, or to associate other channels with
    # specific columns in the database schema, use the following maps.
    [[sensor_map]]
        # Map the remote sensors to columns in the database schema.
        outTemp = t_1
        outHumidity = h_1
        extraTemp1 = t_2
        extraHumid1 = h_2
        extraTemp2 = t_3
        extraHumid2 = h_3
        extraTemp3 = t_4
        # WARNING: the following are not in the default schema
        extraHumid3 = h_4
        extraTemp4 = t_5
        extraHumid4 = h_5

    [[battery_map]]
        txBatteryStatus = batteryUV
        windBatteryStatus = batteryWind
        rainBatteryStatus = batteryRain
        outTempBatteryStatus = battery1
        # WARNING: the following are not in the default schema
        extraBatteryStatus1 = battery2
        extraBatteryStatus2 = battery3
        extraBatteryStatus3 = battery4
        extraBatteryStatus4 = battery5

[jantoni]

A continuación la sección para las estaciones Peet Bros Ultimeter.

No voy a dejar de aprovechar la ocasión para volver a decir, que he tenido una de ellas y no me han gustado. Pero eso es otra historia.

En este driver, no hay que configurar más que el puerto a usar.

Código: [Seleccionar]

[Ultimeter]
    # This section is for the PeetBros Ultimeter series of weather stations.

    # Serial port such as /dev/ttyS0, /dev/ttyUSB0, or /dev/cuaU0
    port = /dev/ttyUSB0

    # The station model, e.g., Ultimeter 2000, Ultimeter 100
    model = Ultimeter

    # The driver to use:
    driver = weewx.drivers.ultimeter
port = /dev/ttyUSB0      Ya explicado anteriormente. Mira en la sección de Davis Vantage para ver la descripción.

model = Ultimeter          igual que lo comentado anteriormente, es el modelo de la estación.

[jantoni]

La siguiente sección es para estaciones bastante minoritarias, las WS1 y la CC3000

La WS1 es prácticamente idéntica a las FineOffset, pero no son inalámbricas. Los sensores de viento y de preciipitación, son idénticos a la FineOffset, no así el de temperatura.

La CC3000 y MKIII de RainWise son estaciones del otro extremo, es decir minoritarias por su elevado precio.

Código: [Seleccionar]

[WS1]
    # This section is for the ADS WS1 series of weather stations.

    # Serial port such as /dev/ttyS0, /dev/ttyUSB0, or /dev/cuaU0
    port = /dev/ttyUSB0

    # The driver to use:
    driver = weewx.drivers.ws1

##############################################################################

[CC3000]
    # This section is for RainWise MarkIII weather stations and CC3000 logger.

    # Serial port such as /dev/ttyS0, /dev/ttyUSB0, or /dev/cuaU0
    port = /dev/ttyUSB0

    # The station model, e.g., CC3000 or CC3000R
    model = CC3000

    # The driver to use:
    driver = weewx.drivers.cc3000
Tanto los campo model y port ya se han explicado bastantes veces.

[jantoni]

La siguiente sección es del modo simulador.

No me detendré, es casi autoexplicativo y no tiene mucha utilidad.

Código: [Seleccionar]

[Simulator]
    # This section is for the weewx weather station simulator

    # The time (in seconds) between LOOP packets.
    loop_interval = 2.5

    # The simulator mode can be either 'simulator' or 'generator'.
    # Real-time simulator. Sleep between each LOOP packet.
    mode = simulator
    # Generator.  Emit LOOP packets as fast as possible (useful for testing).
    #mode = generator

    # The start time. If not specified, the default is to use the present time.
    #start = 2011-01-01 00:00

    # The driver to use:
    driver = weewx.drivers.simulator

[jantoni]

A partir de este momento, comienza la configuración más compleja.

Código: [Seleccionar]

[StdRESTful]
    # This section is for uploading data to sites using RESTful protocols.

    [[StationRegistry]]
        # To register this weather station, set this to True:
        register_this_station = True

    [[AWEKAS]]
        # This section is for configuring posts to AWEKAS

        # If you wish to do this, uncomment the following username and password
        # lines and fill them with your username and password:
        username = pepito
        password = pajarito

    [[CWOP]]
        # This section is for configuring posts to CWOP

        # If you wish to do this, make sure the following line is uncommented
        # and filled out with your station ID:
        station = EA5XX

        # If you are an APRS (radio amateur) station, you will need a passcode:
        passcode = 12345

    [[PWSweather]]
        # This section is for configuring posts to PWSweather.com

        # If you wish to do this, uncomment the following station and password
        # lines and fill them with your station and password:
        station = pepito
        password = pajarito

    [[WOW]]
        # This section is for configuring posts to WOW

        # If you wish to do this, uncomment the following station and password
        # lines and fill them with your station and password:
        #station =
        #password =

    [[Wunderground]]
        # This section is for configuring posts to the Weather Underground

        # If you wish to do this, uncomment the following station and password
        # lines and fill them with your station and password:
        station = pepito
        password = pajarito

        # Set the following to True to have weewx use the WU "Rapidfire"
        # protocol. Not all hardware can support it. See the User's Guide.
        rapidfire = True

En esta sección vamos a configurar los servicios web a los que vamos a mandar datos

En [[StationRegistry]] tan solo le indicamos a Weewx que queremos aparecer en el mapa de estaciones de Weewx

Solo hay dos opciones:

register_this_station = True
register_this_station = False

La página donde aparecen las estaciones Weewx que así lo desean es http://weewx.com/stations.html

A continuación nos aparecen todos los servicios web que podemos mandar datos.

La estructura es la misma en todos ellos.

Si queremos mandar datos, por lo general la estructura es:

station = elnombreocodigodeestacion
password = laquenoshayandado

Si no queremos mandar datos, tan solo tenemos que poner una # delante de cada campo.

#station =
#password =

Particularidades:

En el caso de Awekas, el campo station se sustituye por username

En Wunderground tenemos el campo:

rapidfire = True
rapidfire = False

Si no tienes una estación que actualice los datos cada pocos segundos, como las Davis, ponlo a False. El ponerlo en True implica mandar datos a Wunderground cada pocos segundos. Ojo con las estaciones que manden datos por 3G, ponerlo en False o se comerá la tarifa de datos.

CWOP. Esta red es la misma de APRS. Por ello si eres radioaficionado debes indicar en station tu indicativo de radioaficionado y en password un código numérico. Este código es el mismo que debes obtener para otros programas de APRS.

[jantoni]

Lo vamos complicando un poco más, pero tampoco mucho.

Código: [Seleccionar]

[StdReport]
    # This section specifies what reports, using which skins, to generate.

    # Where the skins reside, relative to WEEWX_ROOT:
    SKIN_ROOT = /etc/weewx/skins

    # Where the generated reports should go, relative to WEEWX_ROOT:
    HTML_ROOT = /var/www/weewx

    # The database binding indicates which data should be used in reports
    data_binding = wx_binding

    # Each subsection represents a report you wish to run.

    [[StandardReport]]
        # See the customizing guide to change the units, plot types and line
        # colors, modify the fonts, display additional sensor data, and other
        # customizations.  Many of those changes can be made here by overriding
        # parameters, or by modifying templates within the skin itself.

        # The StandardReport uses the 'Standard' skin, which contains the
        # images, templates and plots for the report.
        skin = Standard

#    #[[[Units]]]
    #    [[[[Groups]]]]
    #        group_altitude = meter
    #        group_speed2 = meter_per_second2
    #        group_pressure = mbar
    #        group_rain = mm
    #        group_rainrate = mm_per_hour
    #        group_temperature = degree_C
    #        group_degree_day = degree_C_day
    #        group_speed = meter_per_second

    [[FTP]]
        # FTP'ing the results to a webserver is treated as just another report,
        # albeit one with an unusual report generator!
        skin = Ftp

        # If you wish to use FTP, uncomment and fill out the next four lines:
        user = pi
        password = raspberry
        server = 192.168.0.78
        path = /var/www/weewx

        # Set to True for a secure FTP (SFTP) connection. Not all servers
        # support this:
        secure_ftp = False

        # If you wish to upload files from something other than what HTML_ROOT
        # is set to above, then reset it here:
        #HTML_ROOT = /var/www/weewx

        # Most FTP servers use port 21, but if yours is different, you can
        # change it here
        port = 21

        # Set to 1 to use passive mode, zero for active mode:
        passive = 1

    [[RSYNC]]
        # rsync'ing to a webserver is treated as just another report
        skin = Rsync

        # If you wish to use rsync, you must configure passwordless ssh using
        # public/private key authentication from the user account that weewx
        # runs as to the user account on the remote machine where the files
        # will be copied.
        #
        # The following determine where files will be sent:
        #server = replace with your server name, e.g, www.threefools.org
        #path = replace with the destination directory (e.g., /weather)
        #user = replace with your username

        # Rsync can be configured to remove files from the remote server if
        # they don't exist under HTML_ROOT locally.  USE WITH CAUTION: if you
        # make a mistake in the remote path, you could could unintentionally
        # cause unrelated files to be deleted. Set to 1 to enable remote file
        # deletion, zero to allow files to accumulate remotely.
        delete = 0

    [[SteelSeries]]
        skin = ss
        HTML_ROOT = /var/www/weewx/ss

En esta sección, indicamos a Weewx que informes y usando que "skin", se van a generar.

Usaré la palabra "skin", ya que su traducción nunca me ha gustado. Para aquel que no sepa de que va, lo podemos traducir como aspecto, capa, piel, yo que sé. Su traducción literal sería la de piel, pellejo, etc.

SKIN_ROOT = /etc/weewx/skins aquí indicaremos el directorio donde se encuentran todos los "skin"

HTML_ROOT = /var/www/weewx indicaremos el directorio donde se van a guardar los informes y páginas web que generemos

data_binding = wx_binding  Este parámetro no lo tocaremos, bajo peligro de muerte :-)

En [[StandardReport]] configuraremos los informes que iremos generando. Es decir, aquellos que podremos ver en nuestra página web.

skin = Standard     El informe StandardReport usará el skin Standard. Hay multitud de skins ya programados. Tu también puedes programar tu propio skin. En la wiki de weewx puedes descargar diferentes skins https://github.com/weewx/weewx/wiki