Skip to content

Driver Vantage

Manuel edited this page Aug 30, 2026 · 2 revisions

Vantage

Running the Vantage driver under this one, configured by hand.

Generated by tools/build_drivers.py from the driver as installed on the machine that ran it. Do not edit by hand.

There is a web interface for all of this. It is on by default, and the driver prints its address when WeeWX starts:

INFO user.ultimatepush.driver: The web interface is at
http://1.2.3.4:8080/?token=abcdefg12345

Everything on this page can be done there instead, and one thing is much easier: deciding which reading goes into which database column. See Web interface.

What it is

Classes and functions for interfacing with a Davis VantagePro, VantagePro2, or VantageVue weather station

The smallest configuration that works

[Station]
    station_type = UltimatePush

[UltimatePush]
    driver = user.ultimatepush.driver

    [[hardware]]
        station_types = Vantage

        [[[Vantage]]]
            role = main

[Vantage]
    driver = weewx.drivers.vantage
    type = serial
    port = /dev/ttyUSB0

The [Vantage] section belongs to that driver and is read by it, exactly as it would be if it were the only driver WeeWX ran, so weectl device keeps working on it. What goes under [[hardware]] belongs to this one: see Hosted hardware.

Finding the port, or the address

Over a cable, the name to put in port is whichever device the adapter appears as:

ls -l /dev/serial/by-id/

Use the name under by-id rather than /dev/ttyUSB0. It is made from the adapter's own manufacturer and serial number, so it survives a reboot and anything else being plugged in.

Over the network, host is the console's address or hostname. Give it a fixed address in your router, or it will move and stop being found.

The web interface offers the serial devices this machine has as a list.

Every option

Straight out of weewx.drivers.vantage, with what its author wrote above each one.

type

Connection type: serial or ethernet serial (the classic VantagePro) ethernet (the WeatherLinkIP or Serial-Ethernet bridge)

One of serial, ethernet.

Default is serial.

port

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

Applies only when type is serial.

Default is /dev/ttyUSB0.

host

If the connection type is ethernet, an IP Address/hostname is required:

Applies only when type is ethernet.

Default is 1.2.3.4.

baudrate

Serial baud rate (usually 19200)

Default is 19200.

The driver's author rules this one off as rarely needing attention.

tcp_port

TCP port (when using the WeatherLinkIP)

Default is 22222.

The driver's author rules this one off as rarely needing attention.

tcp_send_delay

TCP send delay (when using the WeatherLinkIP):

Default is 0.5.

The driver's author rules this one off as rarely needing attention.

loop_request

The type of LOOP packet to request: 1 = LOOP1; 2 = LOOP2; 3 = both

One of 1, 2, 3.

Default is 1.

The driver's author rules this one off as rarely needing attention.

iss_id

The id of your ISS station (usually 1). If you use a wind meter connected to a anemometer transmitter kit, use its id

Default is 1.

The driver's author rules this one off as rarely needing attention.

timeout

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

Default is 4.

The driver's author rules this one off as rarely needing attention.

wait_before_retry

How long to wait before trying again (in seconds)

Default is 1.2.

The driver's author rules this one off as rarely needing attention.

max_tries

How many times to try before giving up:

Default is 4.

The driver's author rules this one off as rarely needing attention.

model_type

Vantage model Type: 1 = Vantage Pro; 2 = Vantage Pro2

One of 1, 2.

Default is 2.

The driver's author rules this one off as rarely needing attention.

driver

The driver to use:

Default is weewx.drivers.vantage.

More than one station

This driver is one station among however many others. Which of them fills outTemp, and where the rest of their readings go, is in Several stations.

Clone this wiki locally