Page 1
Vantage Pro and Vantage Pro2 Serial Communication Reference Manual For Vantage Pro , Vantage Pro2 , Vantage Pro Plus and Vantage Pro2 Plus Weather Stations Davis Instruments Corp.
Page 2
Note: This document will be constantly updated along with our product development. Please check Davis Instruments’ website (www.davisnet.com) for the latest version. Vantage Pro is a registered trademark of Davis Instruments Corp. Vantage Pro2 is a registered trademark of Davis Instruments Corp.
Table of Contents I. Introduction ..........................4 II. Differences from WeatherLink for Monitor II................4 III. Differences from Vantage Pro to Vantage Pro 2 ..............5 IV. Waking up the Console......................5 V. Blackout Periods ........................6 VI. Command Formats........................6 VII.
Vantage Pro or Vantage Pro2 consoles (or Envoys) and a PC. This requires a WeatherLink for Vantage Pro data logger and connector. It is not possible to communicate with the console without it.
5. You must make sure that the console is awake before sending commands to it. III. Differences from Vantage Pro to Vantage Pro 2 The Vantage Pro2 serial support is almost the same as the Vantage Pro, but there are some important differences listed below.
1. Testing commands "TEST" Sends the string “TEST\n” back. "WRD"<0x12><0x4d>, ACK Responds with a weather station type that is backward compatible with earlier Davis weather products. "RXCHECK" Sends the Console Diagnostics report. "STRMON" Echos all of the data packets sent by sensor transmitters.
"STRMOFF" Stops sending sensor packets. "VER" Sends the firmware date code as a text string. "RECEIVERS" Sends the bit map of station IDs that the console can hear, This is not the byte for indicating what the console selects to listen from. "NVER"...
"BARDATA" Displays of the current barometer calibration parameters in text. 6. Clearing Commands "CLRLOG" Clears the archive data. "CLRALM" Clears all the alarm thresholds. "CLRCAL" Clears all the Temperature and Humidity calibration offsets. "CLRGRA" Clears all of the graph points on the Vantage console. "CLRVAR <Data variable-decimal>"...
<"TEST"<LF><CR> "WRD"<0x12><0x4d> It is the same command sequence used by earlier Davis weather stations to read the Station Type value. The station will respond with an <ACK> and then a one byte identifier, which can be one of these values:...
Page 10
“OK” message and Davis Talk data packets when received by the console until the STRMOFF command is given. For Vantage Pro, each packet contains six bytes and each byte is shown as a two-digit hex string per line, with a blank line between packets.
Page 11
"STRMOFF" It halts the flow of Davis Talk data packets started by the STRMON command. Note that this command is the only way to stop receiving Davis Talk data packets. Example: >"STRMOFF"<LF> <<LF><CR>"OK"<LF><CR> "VER" It sends the firmware date code as a text string. Some functions on the console are implemented differently in different firmware versions.
2. Current Data commands "LOOP <number of LOOP packets to send-decimal>" It sends the specified number of LOOP packets, 1 every 2 seconds. Console sleeps between each packet sent. The station responds with an <ACK> then with binary data packet every 2 seconds.
It sets the Yearly ET amount on the console Example (set the Yearly ET to 24.83 inchex): >"PUTET 2483"<LF> <<ACK> The console display shows yearly ET 24.83 inches. 3. Download Commands "DMP" It downloads the entire archive memory. See the sections IX.5 and IX.3 for more details on downloading data.
<<LF><CR>"OK"<LF><CR> "EEBRD <EE address-hex> < number of bytes to read-hex>" Reads data in binary format from the EEPROM. The data and CRC is given in binary format following an ACK response. See section XII for more details on accessing EEPROM data. Example (It reads three bytes from the EEPROM at location 0x32.) >"EEBRD 32 03"<LF>...
Page 15
It sets the elevation and barometer offset values when setting the barometer for a new location. <bar value to display (in Hg * 1000)-decimal> If you have a current barometer reading from a very reliable nearby reference, you can use this parameter to force the display to an exact setting.
<"BARCAL 0"<LF><CR> <"GAIN 1533"<LF><CR> <"OFFSET 18110"<LF><CR> Name Value in Explanation example 29.775 in Hg The most recent barometer measurement. ELEVATION 27 ft Elevation in feet DEW POINT 56 °F Dew point when the barometer measurement was taken VIRTUAL TEMP 63 °F Temperature used in correction formula (12 hour average) Humidity correction factor used in the formula 1.001...
Page 17
Example: >"CLRCAL"<LF> <"OK"<LF><CR> -- After some time passes -- <"DONE"<LF><CR> "CLRGRA" It clears all of the graph points on the Vantage console. Example: >"CLRGRA"<LF> <"OK"<LF><CR> -- After some time passes -- <"DONE"<LF><CR> "CLRVAR <Data variable-decimal>" It clears a rain or ET data value from the following table: Rain Variable Name Number ET Variable Name...
"CLRBITS" It clears the active alarm bits. They will reactivate if the alarm condition is still present. Example: >"CLRBITS"<LF> <<ACK> "CLRDATA" It clears all current data values to dashes. Example: >"CLRDATA"<LF> <<ACK> 7. Configuration Commands "BAUD <New baud rate-decimal>" It sets the console to a new baud rate. Valid values are 1200, 2400, 4800, 9600, 14400, and 19200.
Page 19
Example (Vantage responds with 5:17:42 am, January 28, 1998): >"GETTIME"<LF> <<ACK> ><42><17><5><28><1><98><2 Bytes of CRC> "GAIN <Gain State: '0' (off) or '1' (on)>" This command only works with the VantagePro station and is not currently implemented on the VantagePro 2 station. It sets the gain of the radio receiver, same as pressing the HI/LOW key on the console diagnostics screen.
Make sure to issue this command after you set the Latitude or Longitude, and after you change any of the Setup bits in the EEPROM (address 43 = 0x2B) especially the Rain collector type, Example (set a 10 minute archive interval): >"NEWSETUP"<LF>...
Page 21
Field Offset Size Explanation Next Record Location in the archive memory where the next data packet will be written. This can be monitored to detect when a new record is created. Barometer Current Barometer. Units are (in Hg / 1000). The barometric value should be between 20 inches and 32.5 inches in Vantage Pro and between 20 inches and 32.5 inches in both Vantatge Pro Vantage Pro2.
Page 22
Field Offset Size Explanation Forecast Rule number Time of Sunrise The time is stored as hour * 100 + min. Time of Sunset The time is stored as hour * 100 + min. "\n" <LF> = 0x0A "\r" <CR> = 0x0D Total Length Forecast Icons in LOOP packet Field...
Page 23
Field Byte Bit # Low inside hum alarm High inside hum alarm Time alarm Rain Alarms Currently active rain alarms. High rain rate alarm 15 min rain alarm Flash Flood alarm 24 hour rain alarm Storm total rain alarm Daily ET alarm Outside Alarms Currently active outside alarms.
2. HILOW data format The " " command sends a 436 byte data packet and a 2 byte CRC value. The data packet is HILOWS broken up into sections of related data values. Contents of the HILOW packet. Field Offset Size Explanation Barometer Section Daily Low Barometer Daily High Barometer...
Page 25
Field Offset Size Explanation Dew Point Section Day Low Dew Point Day Hi Dew Point Time Day Low Dew Point Time Day Hi Dew Point Month Hi Dew Point Month Low Dew Point Year Hi Dew Point Year Low Dew Point Wind Chill Section Day Low Wind Chill Time Day Low Chill...
Field Offset Size Explanation Indexes 11 – 14 = Soil Temperatures 1 – 4 Day Low Temperature (15 * 1) Day Hi Temperature (15 * 1) Time Day Low Temperature (15 * 2) Time Day Hi Temperature (15 * 2) Month Hi Temperature (15 * 1) Month Low Temperature...
Page 27
Temperature, Extra Humidity, High Solar, High UV, and forecast fields (reedOpen and reedClosed fields are removed). You can use the VER command and parse the date returned to determine the archive data format, or you can examine byte 42 in the archive record. In a Rev B record, it will have the value 0x00.
Page 28
Field Offset Size Dash Value Explanation Inside Humidity Inside Humidity at the end of the archive period Outside Humidity Outside Humidity at the end of the archive period Average Wind Speed Average Wind Speed over the archive interval. Units are (MPH) High Wind Speed Highest Wind Speed over the archive interval.
Field Offset Size Dash Value Explanation Solar Radiation 32767 Average Solar Rad over the archive period. Units are (Watts / m Number of Wind Samples Number of packets containing wind speed data received from the ISS or wireless anemometer. Inside Temperature 32767 Either the Average Inside Temperature, or the Final Inside Temperature over the archive period.
Field Offset Size Explanation LOW_TEMP_IN_ALARM Threshold is (data value – 90) °F HIGH_TEMP_IN_ALARM Threshold is (data value – 90) °F LOW_TEMP_OUT_ALARM Threshold is (data value – 90) °F HIGH_TEMP_OUT_ALARM 9 Threshold is (data value – 90) °F LOW_TEMP_ALARM 7 extra temps, 4 soil temps, 4 leaf temps HIGH_TEMP_ALARM 7 extra temps, 4 soil temps, 4 leaf temps LOW_HUM_IN_ALARM...
= (100*hour + minute); Use zero for both of these values (and the CRC) to force a full download. Send the command " " to the Vantage Pro DMPAFT When you get an <ACK> back, send the 2 byte vantageDateStamp, the 2 byte vantageTimeStamp, and a 2 byte CRC value calculated from them.
<<2 byte CRC> -- At this point verify the CRC and send either <ACK>, <0x21>, or <ESC> XI. CRC calculation The console uses the same CRC calculation that was used by earlier Davis Instruments weather stations. Page 32 of 52...
Page 33
The CRC checking used by the WeatherLink is based on the CRC-CCITT standard. The heart of the method involves a CRC-accumulator that uses the following formula on each successive data byte. After all the data bytes have been "accumulated", there will be a two byte CRC checksum that will get processed in the same manner as the data bytes.
Example, calculating the CRC in the DMPAFT example above: Old CRC Data byte Table index Table Value New CRC 0x0000 0xC6 (0x00 ^ 0xC6) = 0xC6 0xB98A (0x0000 ^ 0xB98A) = 0xB98A 0xB98A 0xCE (0xB9 ^ 0xCE) = 0x77 0x0E70 (0x8A00 ^ 0x0E70) = 0x8470 0x8470 0xA2...
Page 35
EEPROM address table Name Size Description BAR_GAIN These are the factory barometer calibration values. BAR_OFFSET Do not modify them! BAR_CAL Barometer Offset calibration. Use the "BAR=" command to set this value! HUM33 These are the factory inside humidity calibration values. HUM80 Do not modify them! LATITUDE...
Page 36
Name Size Description UNIT_BITS Barometer unit (bit 1:0): 0: 0.01 INCHES 1: 0.1 MM 2: 0.1 HPA 3: 0.1 MB Temperature unit (Bit 3:2): ◦ F (Whole degrees) ◦ F (Tenths of a degree) ◦ C (Whole degrees) ◦ C (Tenths of a degree) Elevation unit (Bit 4): 0: FEET 1: METERS...
Page 37
Name Size Description TEMP_OUT_CAL The setting range is from (-12.8 °F to 12.7 °F) with the most significant byte as the sign bit. TEMP_CAL 15 7 "extra" temperatures, 4 soil temperatures, and 4 leaf temperatures HUM_IN_CAL The inside humidity calibration value is ranged from 0 to 100%.
Name Size Description Graph Pointers See section XIV Graph data 3898 See section XIV Log Average Temperature 4092 Set this value to zero to enable logging of average temperature values. A non-zero value causes the temperature at the end of the archive period to be logged. Password CRC 4094 WeatherLink uses these two bytes to hold the CRC of a...
2. Setting the Time, Time Zone, and Daylight savings The " " and " " commands will get and set the time and date on the Vantage GETTIME SETTIME console, but you will need to use additional commands to set the time zone and daylight savings settings.
4. Setting up transmitter station ID's and retransmit function. The 16 bytes of EEPROM data at STATION_LIST, plus the USETX field, control what transmitters the Vantage will listen to. These can be set for both wireless and cabled consoles, but the cabled ISS will always transmit on ID 1. IMPORTANT!! You must use the "...
Page 42
In the same maner, the first extra temperature sensor should be assigned the value ZERO, the second should have the value 1, etc. The USETX field holds bitmapped information on the transmitters that the Vantage will actively listen to. Bit 0 corresponds with ID 1, Bit 1 with ID 2, etc. Set this value after you have made any modifications to the STATION_LIST field.
List of Station Types (Rev B and VantagePro 2): Station Name Station Type (hex) "standard" period Temperature Only Station Humidity Only Station Temperature/Humidity Station 3 Wireless Anemometer Station Rain Station Leaf Station Soil Station Soil/Leaf Station SensorLink Station * No station – OFF * Vantage Pro2 does not support SensorLink station type.
Page 44
Field Offset Size Explanation LOW_TEMP_OUT_ALARM The temperature alarm is in 1 unsigned byte in 1 °F resolution. It has an offset of +90°F so every number is positive. For example -32°F would be stored as 58°F (-32 + 90). If the alarm is not set, a 255 is stored.
100 % reception. This is a function of both the archive interval and the transmitter ID that is sending wind speed. The formula for Vantage Pro2 console is different from the one for Vantage Pro console. The formulas for determining the expected maximum number of packets containing wind speed...
Page 46
archive_in terval_min (for Vantage Pro2) + ID − Here archive_interval_min is the archive interval in minutes and ID is the transmitter ID number between 1 and 8. It is possible for the number of wind samples to be larger than the "expected" maximum value. This is because the maximum value is a long term average, rounded to an integer.
XIV. EEPROM Graph data locations for Vantage Pro Please note that some of the pointer values stored in the EEPROM may not be updated immediately, such as NEXT_10MIN_PTR and NEXT_15MIN_PTR. This is done to save EEPROM write cycles, since the EEPROM is good for 100,000 times of write. Those data will only be saved into the EEPROM at the beginning of each new month or when the console goes into setup mode.
XV. EEPROM Graph data locations for VP2 Please note that some of the pointer values stored in the EEPROM may not be updated immediately, such as NEXT_10MIN_PTR and NEXT_15MIN_PTR. This is done to save EEPROM write cycles, since the EEPROM is good for 100,000 times of write. Those data will only be saved into the EEPROM at the beginning of each new month or when the console goes into setup mode.
Need help?
Do you have a question about the Vantage Pro and is the answer not in the manual?
Questions and answers