6. Error codes

The HiSPARC weather station data acquisition program generates status/error messages in ‘Status messages & error reports’ tab to inform you about the progress of the start/end process and when errors occur. Here is a screenshot of this screen, below is explained what you can see here.

_images/weatherdaq_status.png

The Status/Error tab (click to enlarge)

6.1. Status

The ‘Status station’ block (left lower corner) provides some (crucial) general information:

  • Weather station connected? tells whether the connection between pc and weather station console is properly working
  • Buffer connected? is required for data transmission in DAQ mode
  • PC time = Console time? indicates whether the pc and console-display are synchronised
  • Run-time error refers to a fatal error that occurred (see error messages)
  • GPS time correction refers to the offset between pc clock and the GPS time as obtained by your cosmic ray set-up
  • GPS time last data indicates the last time data is read from the weather station console

Status indoor and outdoor sensors show which of the sensors (you have to make a selection on the ‘Settings’ tab!) is read out correctly (green), fails (red) or is not part of you set of sensors (grey - depends on your hardware/selection)

The voltage on the batteries in the weather station console is sampled. For most console models this provides accurate information on whether the back-up batteries need to be replaced. Some models give a random voltage when no batteries are inserted. Make sure that your console indeed has healthy batteries!

6.2. Messages

The ‘Status messages & error reports’ window logs relevant information after (re-)start of the weather station. The messages inform you about occurrences in the system. In addition to the following messages (which are usually the result of user interference):

Start HiSPARC weather station DAQ.
Stop HiSPARC weather station DAQ.
Restart weather station from user initialisation file.
Re-initialise weather station from default initialisation file

6.2.1. Status (1xx)

Status messages may be issued which inform about the initialisation process of the weather station or document when the user pressed a button. They also confirm whether an action was successfully executed. When ‘DAQ MODE’ is selected, the status messages are logged and automatically stored into the central database at Nikhef for error tracking purposes. Status messages range from 101 - 199:

  1. Copied ‘HiSPARC_Weather_default.ini’ to ‘HiSPARC_Weather_user.ini’
  2. ‘HiSPARC_Weather_user.ini’ file is used for initialisation.
  3. User ignores ‘STOP PROGRAM’, continue...
  4. Weather station parameters wil be initialised; please wait...
  1. HiSPARC weather station connected through ‘USB WeatherLink’.
  2. HiSPARC weather station ‘USB WeatherLink’ is closed.
  3. HiSPARC weather station connected through ‘Serial Port WeatherLink’.
  4. HiSPARC weather station ‘Serial port WeatherLink’ is closed.
  1. Settings will be written to the weather station console; please wait...
  1. User pressed ‘HELP’ button in serial connection/USB dialogue.
  2. User modified station connection settings in serial/USB dialogue; changes have been saved.
  3. Switched to ‘DAQ MODE’.
  4. User pressed ‘STOP PROGRAM’ button.
  5. (New) settings have been saved.
  6. User pressed ‘CALIBRATE’ button; please wait until settings have been uploaded...
  7. User skips weather station calibration, continue...
  8. User pressed ‘RESET’ button but skips reset.
  9. User pressed ‘HELP’ button.
  10. Switched to ‘STOP DAQ’ mode.
  11. Weather station DAQ starts in ‘DAQ MODE’.
  1. Calibration: latitude and/or longitude have not been modified.
  2. Calibration: temperature and/or humidity offset(s) have not been modified.
  3. Calibration: sea level barometer and/or station elevation have not been modified.
  4. Calibration: wind direction offset has not been modified.
  1. Weather station console successfully initialised.
  1. Weather sensor units are correctly set; no modifications required.
  1. Rain collector model correctly set (‘0.2 mm’); no modification required.
  1. Wind cup size correctly set (‘large’); no modification required.
  1. Time on weather station console correctly set (= pc time); no modification required.
  1. Calibration: station latitude and longitude match console settings; no adjustment required.
  1. Calibration: wind direction offset matches console settings; no adjustment required.
  1. Calibration: temperature and humidity offset(s) match console settings; no adjustment required.

6.2.2. Warnings (2xx)

Warning messages inform about successfully actions and/or non-fatal errors. There are various reasons why a warning is issued. When ‘DAQ MODE’ is selected, the status messages are logged and automatically stored into the central database at Nikhef for problem analyses. Warning messages range from 201 - 299. Their meaning is explained below:

  1. No GPS time correction in HiSPARC.ini (correction = 0 s)!
  2. PC clock time error in HiSPARC.ini (GPS time correction is set to 0 s)!
  3. Error in GPS time stamp in HiSPARC.ini (GPS time correction is set to 0 s)!
  4. Unknown message in HiSPARC.ini (GPS time correction is set to 0 s)!

Reason: the weather station is used in ‘stand-alone mode’, that is, there is no GPS time information generated by the HiSPARC cosmic ray station. The HiSPARC DAQ program calculates the time difference between GPS and local pc-clock (both programs need to be running on the same pc!) in order to synchronise cosmic ray time-stamps and weather station measurements. Switching on the HiSPARC DAQ system automatically enforces correct synchronisation (every 10 minutes the offset is adjusted).

  1. Time difference too large in HiSPARC.ini (GPS time correction is set to 0 s)!

Reason: GPS is (not yet) producing the correct time (self-survey not completed or not yet done). Check the GPS of your cosmic ray set-up!

  1. Cannot open HiSPARC weather station connection through ‘USB WeatherLink’!
  2. Cannot close HiSPARC weather station connection through ‘USB WeatherLink’!

Reason: USB connection between pc and weather station console was found, but failed!

  1. Cannot open HiSPARC weather station connection through ‘Serial Port WeatherLink’!
  2. Cannot close HiSPARC weather station connection through ‘Serial Port WeatherLink’!

Reason: Serial connection (or serial to USB converter) between pc and weather station console failed!

  1. Station ID = 0; please select a valid station number!

Reason: You have to provide a valid station number. In general this is the same number as your cosmic ray station

  1. Serial COM port number = 0; please select a valid port number!

Reason: You make use of a serial connection or serial to USB converter that generates a COM port on your pc. You have to select number associated with the correct COM port. You may obtain this number by analysing your hardware (‘Apparatenbeheer’) under Windows.

  1. Try automatic reconnection to HiSPARC weather station console!

Reason: Connection between pc and weather station console failed; the program tries repair the connection

  1. Please check your internet connection; cannot reach HiSPARC document server!

Reason: You pressed the ‘HELP’ button and cannot obtain the help-file since either the internet connection is down or the document server is (temporarily) not available

  1. User pressed ‘STOP PROGRAM’ button in serial/USB dialogue!
  2. Overflow event queue for buffer database; 1 event is lost!

Reason: In rare cases this may occur during the ‘manual’ calibration procedure while the program continues to receive data from the weather station console and may run out of memory. Throwing away events prevents the system from crashing (in any case you are not running in ‘DAQ MODE’).

  1. Overflow event queue for front panel graphs!

Reason: Should never occur, used for debugging purposes

226. No modification(s); proposed calibration parameters equal calibration parameters on console!

  1. User pressed ‘RESET’ button; restart with default settings!

Following set of warning messages may hint at either a bad connection between pc and and weather station console or a problem with the console (firmware/hardware) itself:

  1. Failed to set timeout/read weather station and/or DLL/Firmware version/date, will retry!
  2. Failed to initialise weather sensor units, will retry!
  3. Failed to set rain collector model to ‘0.2 mm’, will retry!
  4. Failed to set wind cup size to ‘large’, will retry!
  5. Failed to synchronise pc clock and weather station clock, will retry!
  6. Calibration: failed to set latitude and/or longitude, will retry!
  7. Calibration: failed to set temperature and/or humidity offset(s), will retry!
  8. Calibration: failed to set sea level barometer and/or station elevation, will retry!
  9. Calibration: failed to set wind direction offset, will retry!
  1. Failed to initialise weather station console, will retry!
  1. Weather sensor units have successfully been modified!
  1. Rain collector model has successfully been set to ‘0.2 mm’!
  1. Wind cup size has successfully been set to ‘large’!
  1. Time on weather station console has successfully been set to pc time!
  1. Calibration: station latitude and/or longitude have successfully been modified!
  1. Calibration: wind direction offset has successfully been modified!
  1. Calibration: temperature and/or humidity offset(s) have successfully been modified!
  1. Calibration: sea level barometer value and station elevation have successfully been reset to factory settings!
  1. Calibration: sea level barometer value has successfully been modified!
  1. Calibration: station elevation has successfully been modified!

6.2.3. Errors (3xx)

Vast majority of error messages are fatal and will force the weather station data acquisition to stop. When ‘DAQ MODE’ is selected - depending on which part of the initialisation phase has successfully completed -, the error messages are logged and automatically stored into the central database at Nikhef for error tracking purposes. For error messages related to hardware and firmware versions, please consult the Davis website and check carefully(!) whether you may update/restore the firmware trough the serial/USB link (see: http://www.davisnet.com/support/weather/downloads/software_frmwr.asp). Error messages range from 301 - 399. Their meaning is explained below:

  1. Path to HiSPARC weather station DAQ software has not been found!

Reason: Software is not properly installed; executable is missing or mis-placed

  1. Initialisation file ‘HiSPARC.ini’ has not been found!

Reason: see 301; (general) initialisation file is missing or mis-placed

  1. Initialisation file ‘HiSPARC_Weather_default.ini’ has not been found!

Reason: see 301; initialisation file with default settings is missing or mis-placed

  1. Failed copying ‘HiSPARC_Weather_default.ini’ to ‘HiSPARC_Weather_user.ini’!

Reason: may hint at authorisation problems for the account since the file can not be written

  1. Error in reading parameters from HiSPARC.ini!

Reason: (general) initialisation file may be outdated (old version) or corrupted

  1. Lost connection to weather station; will automatically try to reconnect!

Reason: Connection between pc and weather station console failed; the program tries repair the connection

  1. Cannot connect to buffer database!

Reason: Most likely, the MySQL program is not running; after verifying that all software is correctly installed, restart your computer

  1. Failed to initialise weather station supporting software library (DLL), quit!

Reason: Should never occur, used for debugging purposes or hints at software installation problem

  1. This weather station model is not supported!

Reason: Only Davis Vantage weather stations are supported for now...

Following errors may occur when the connection between pc and weather station console failed or is timed-out, firmware (in the console) is incompatible with the action the program tries to execute or the console has a hardware problem. Try to reset the console (remove power - including batteries! - ) and restart the pc

  1. Failed to initialise weather station console several times, quit!
  1. Failed to read weather sensor units!
  2. Failed to write weather sensor units!
  3. Failed to read weather sensor units after modification!
  4. Failed to match weather sensor units after write/read operation!
  1. Failed to read rain collector model!
  2. Failed to write rain collector model!
  3. Failed to read rain collector model after modification!
  4. Failed to match rain collector model after write/read operation!
  5. Failed to set rain collector model (‘0.2 mm’) on console!
  6. Failed to read rain collector model from console after modification!
  7. Failed to match rain collector model from console after modification!
  8. Failed to read rain collector model from console!
  1. Failed to read wind cup size!
  2. Failed to write wind cup size!
  3. Failed to read wind cup size after modification!
  4. Failed to set wind cup size to ‘large’; please check/modify cup size on the weather station console!
  1. Failed to read time from weather station console!
  2. Failed to write pc time to weather station console!
  3. Failed to read time from weather station console after modification!
  4. Failed to match time from weather station console after write/read operation!

Following errors may occur while trying to load (calibration) parameters into the weather station console. The success of some of the (calibration) actions may depend on (a general statement can not be made here):

  • console hardware version
  • console firmware version (firmware should be March 2004 Rev. B or later)
  • errors in software interface from Davis (bugs in LabView code interface nodes)
  1. Calibration: failed to read station latitude and/or longitude!
  2. Calibration: failed to write station latitude!
  3. Calibration: failed to write station longitude!
  4. Calibration: failed to read station latitude and/or longitude after modification!
  5. Calibration: failed to match station latitude and/or longitude after write/read operation!
  6. Calibration: failed to read wind direction offset!
  7. Calibration: failed to write wind direction offset!
  8. Calibration: failed to read wind direction offset after modification!
  9. Calibration: failed to match wind direction offset after write/read operation!
  1. Calibration: temperature and/or humidity offset(s) out of range!
  2. Calibration: failed to load temperature and/or humidity calibration data from console!
  3. Calibration: failed to write temperature and/or humidity offset(s) after modification!
  4. Calibration: failed to store temperature and/or humidity offset(s) into console!
  5. Calibration: failed to match temperature and/or humidity offset(s) after write/read operation!
  6. Calibration: failed to write sea level barometer value and/or station elevation!
  7. Calibration: failed to read sea level barometer value and/or station elevation!
  8. Failed to set sea level barometer and station elevation; please check/modify them on the weather station console!
  9. Calibration: failed to write sea level barometer value!
  10. Calibration: failed to read sea level barometer value after modification!
  11. Calibration: failed to match sea level barometer value after write/read operation!
  12. Calibration: failed to write station elevation!
  13. Calibration: failed to read station elevation after modification!
  14. Calibration: failed to match station elevation after write/read operation!

Table Of Contents

Previous topic

5. Graphs

Next topic

7. LabView Development

This Page