Cumulus.ini (preserving history): Difference between revisions

m
Line 912: Line 912:
|-
|-
|ClockSettingHour=4
|ClockSettingHour=4
|Configuration file only setting, controls what hour of the day the SyncDavisClock activity will take place if it is enabled.
|Configuration file read-only setting, controls what hour of the day the SyncDavisClock activity will take place if it is enabled.
*4 = 04:00 (default value)
*4 = 04:00 (default value)
*0-23 = 00:00 to 23:00
*0-23 = 00:00 to 23:00
Line 932: Line 932:
|-
|-
|VP2SleepInterval=500
|VP2SleepInterval=500
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.
|This read-only parameter is the period which Cumulus waits between reads of the data from Davis stations, the value is in milliseconds. The default if the parameter has not been added manually to the file is 500 ms; if you suspect that data is being missed, you could add this parameeter, manually reducing this figure. For VirtualVP users, tests revealed that VP2SleepInterval = 1100 seems to work the best. It updates every two seconds with few exceptions. See note in ''readme.txt'' about VP2SleepInterval - in v1.9.3 release it is around line 50. Related FAQ: [[FAQ#My_Davis_station_shows_a_higher_maximum_wind_speed_than_Cumulus]]
This is the period which Cumulus waits between reads of the data from Davis stations, the value is in milliseconds. The default is 500 ms; if you suspect that data is being missed, you could try reducing this figure. For VirtualVP users, tests revealed that VP2SleepInterval = 1100 seems to work the best. It updates every two seconds with few exceptions. See note in ''readme.txt'' about VP2SleepInterval - in v1.9.3 release it is around line 50. Related FAQ: [[FAQ#My_Davis_station_shows_a_higher_maximum_wind_speed_than_Cumulus]]
|-
|-
|VPClosedownTime=x
|VPClosedownTime=x
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen. x is the number of seconds after the start of the re-connect attempts that you want the program to close itself (added v.1.8.5 b.726).
|This read-only parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen. x is the number of seconds after the start of the re-connect attempts that you want the program to close itself (added v.1.8.5 b.726).
|-
|-
|VP2PeriodicDisconnectInterval=0
|VP2PeriodicDisconnectInterval=0
Line 945: Line 944:
|-
|-
|DavisCalcAltPress=1
|DavisCalcAltPress=1
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.  Davis stations calculate Sea Level Pressure from Station Pressure using a formula based on several parameters such as temperature, humidity, etc, rather than just using altitude as most other stations. CWOP require 'Altimeter Pressure' to be uploaded, i.e. a value calculated simply using altitude.
|This read-only parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.  Davis stations calculate Sea Level Pressure from Station Pressure using a formula based on several parameters such as temperature, humidity, etc, rather than just using altitude as most other stations. CWOP require 'Altimeter Pressure' to be uploaded, i.e. a value calculated simply using altitude.


'''Note for MX''', use of the LOOP2 (see [[Cumulus.ini_(Beta)#Section:_Station| here]]) means s.l.p. can be obtained from the Davis station.
[[File:Badge vMx.png]]'''Note for MX''', use of the LOOP2 (see [[Cumulus.ini_(Beta)#Section:_Station| here]]) means s.l.p. can be obtained from the Davis station.


{{Version badge 1}}'''The following note applies to Cumulus 1.x.x:''' The station does not provide this value directly, nor the station pressure, so Cumulus 1.x.x has to read some extra data once a minute in order to do the calculation. This can take several seconds, so it means that a 'normal' data reading may be missed.  
{{Version badge 1}}'''The following note applies to Cumulus 1.x.x:''' The station does not provide this value directly, nor the station pressure, so Cumulus 1.x.x has to read some extra data once a minute in order to do the calculation. This can take several seconds, so it means that a 'normal' data reading may be missed.  
Line 962: Line 961:
|-
|-
|DavisRainCollectorModel=X
|DavisRainCollectorModel=X
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen. (Available from Build 1096 of version 1.9.4)
|This read-only parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen. (Available from Build 1096 of version 1.9.4)
Option to specify rain collector model for Davis stations for situations where the Davis DLL is unable to read it from station, and your rain figures in Cumulus are incorrect as a result (can happen when using Virtual VP, for example).
Option to specify rain collector model for Davis stations '''for situations where the Davis DLL is unable to read it from station''' (what it reads from station is default if this parameter is not present), and your rain figures in Cumulus are incorrect as a result (can happen when using Virtual VP, for example).
Value X is an integer from 0 to 5 with the following meanings:
Value X is an integer from 0 to 5 with the following meanings:
*0 = 0.1 inch
*0 = 0.1 inch
Line 978: Line 977:
|-
|-
|RestartIfDataStops=0
|RestartIfDataStops=0
|{{Version badge 1}}This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.
|[[File:Badge vMx.png]]This parameter is not available in MX.
Cumulus 1 attempts to restart itself if it has had no data from the station for 60 seconds. Davis stations can use this option explained in the [[#La_Crosse_specific:|La Crosse]] table if Cumulus sometimes fails to read information from the logger. As it says in the help, it may not fix the connection problem, but at least it stops Cumulus logging, so once you have fixed the problem it will download the missing data when you start it up again.


This parameter is not available in MX.
{{Version badge 1}}This read-only parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.
*0 (default) = Cumulus will just stop logging, and processing data, if it has had no data from the Davis station for 60 seconds. As it says in the Cumulus 1 help, use of this parameter may not fix a connection problem. With this default setting a connection problem stops Cumulus logging, so once you have fixed the problem it will download the missing data when you start it up again.
*1 = Cumulus 1 attempts to restart itself if it has had no data from the station for 60 seconds. Davis stations can use this option explained in the [[#La_Crosse_specific:|La Crosse]] table if Cumulus sometimes fails to read information from the logger. Again, this may not fix the problem, but this setting does force Cumulus to have another attempt after making a new connection on start up.
|-
|-
|Port=0
|Port=0
Line 990: Line 990:
|-
|-
|UseDavisLoop2=1
|UseDavisLoop2=1
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.
|{{Version badge 1}} Not applicable.
 
[[File:Badge vMx.png]]This read-only parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.
   
   
The current MX code uses ''LOOP2'' for two purposes. First, it uses the 'peak 10-minute gust' value, to avoid the problem where a gust might be missed, and secondly it uses the 'absolute pressure' value to make calculation of 'altimeter pressure' easier and more accurate. This is mainly used if you upload to CWOP.
The current MX code uses ''LOOP2'' for two purposes. First, it uses the 'peak 10-minute gust' value, to avoid the problem where a gust might be missed, and secondly it uses the 'absolute pressure' value to make calculation of 'altimeter pressure' easier and more accurate. This is mainly used if you upload to CWOP.
Line 1,006: Line 1,008:
|-
|-
|ForceVPBarUpdate=0
|ForceVPBarUpdate=0
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.  The default (value=0) is to assume standard barometer updates on Davis stations. Set to 1, by adding ForceVPBarUpdate=1 in [Station] section to force more frequent barometer updates on Davis stations. Steve says "Having checked the code, I see it asks for 20 packets from the 'LOOP2' if the barometer forcing is on, otherwise it stops receiving LOOP data after 50 packets". Added in build 3042 (January 2017). Note that ForceVPBarUpdate=1 is only useful on very old versions of the console firmware.
|This read-only parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.  The default (value=0) is to assume standard barometer updates on Davis stations. Set to 1, by adding ForceVPBarUpdate=1 in [Station] section to force more frequent barometer updates on Davis stations. Steve says "Having checked the code, I see it asks for 20 packets from the 'LOOP2' if the barometer forcing is on, otherwise it stops receiving LOOP data after 50 packets". Added in build 3042 (January 2017). Note that ForceVPBarUpdate=1 is only useful on very old versions of the console firmware.
|-
|-
|DavisIncrementPressureDP=0
|DavisIncrementPressureDP=0
|(from version 3.0.0 build 3042) A Cumulus.ini setting to turn off the 'extra' decimal place in pressure values on Davis stations. To limit the pressure to 1 decimal for mb/hPa and 2 for inHg, add this to the [Station] section
|[[File:Badge vMx.png]](from version 3.0.0 build 3042) A Cumulus.ini setting to turn off the 'extra' decimal place in pressure values on Davis stations. To limit the pressure to 1 decimal for mb/hPa and 2 for inHg, add this to the [Station] section
|-
|-
|VPrainGaugeType=0
|VPrainGaugeType=0
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.  The default is to assume that people using MM units to display rain in Cumulus have a Metric Rain Adapter fitted to their rain gauge so it tips for every 0.2mm, and those selecting inches as their unit have the unmodified 0.01" rain gauge. This parameter over-rides that assumption, but note that conversion rounding errors will then occur.
|This read-only parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.  The default is to assume that people using MM units to display rain in Cumulus have a Metric Rain Adapter fitted to their rain gauge so it tips for every 0.2mm, and those selecting inches as their unit have the unmodified 0.01" rain gauge. This parameter over-rides that assumption, but note that conversion rounding errors will then occur.


Specifies the units selected on your Vantage Pro Rain Gauge.  Set to 0 for a 0.2mm gauge and 1 for a 0.01" gauge.
Specifies the units selected on your Vantage Pro Rain Gauge.  Set to 0 for a 0.2mm gauge and 1 for a 0.01" gauge.
Line 1,019: Line 1,021:
|-
|-
|DataLogging=0
|DataLogging=0
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen. Default is 0, change to 1 for more detailed Davis logging.
|[[File:Badge vMx.png]]Set in options section of station settings page. Default is 0, change to 1 for more detailed Davis logging.
   
   
*0 (default) = Cumulus MX will not add extra logging.
*0 (default) = Cumulus MX will not add extra logging.
Line 1,026: Line 1,028:
|-
|-
|AutoUpdateIpAddress=1
|AutoUpdateIpAddress=1
|(read-only, you cannot edit this on station settings screen, you must type it directly into file) default = 1, set to 0 to switch off the WLL autodetection of IP address. This is a workaround for a WLL firmware bug that does not update the IP address when it changes using DHCP.
|[[File:Badge vMx.png]](read-only, you cannot edit this on station settings screen, you must type it directly into file) default = 1, set to 0 to switch off the WLL autodetection of IP address. This is a workaround for a WLL firmware bug that does not update the IP address when it changes using DHCP.
|-
|-
|ZeroConfig
|ZeroConfig
|set this on station settings screen; to enable/disable the entry/update of the stations IP address via auto-discovery
|[[File:Badge vMx.png]]set this on station settings screen; to enable/disable the entry/update of the stations IP address via auto-discovery
|}
|}


5,838

edits