Cumulus.ini: Difference between revisions

2,181 bytes added ,  29 July 2021
m
m (→‎Optional Report Settings: Revert description back taking out text about editing a file that is part of release)
Since MX is being developed by someone who uses a Davis station, a lot of "Labels on the Settings Screens" mention "Davis" even if you have selected a different station, because the code was written by copy and paste!
 
===Selecting the weather station type determines which options are shown===
 
{| class="wikitable" border="1"
|-
 
===Airlink===
 
The details in this sub-section need to be checked by someone who uses the relevant hardware.
 
* Introduced Release
===Davis===
 
Two Wiki sub-sections, that need to be checked by by somebody who uses the relevant functionality:
 
 
===EasyWeather (Reading File instead of connecting to a Weather Station)===
 
This sub-section is based on what applied for the legacy software, assuming nothing has changed for MX.
 
* Introduced in a Legacy version
 
===Ecowitt GW1000 and Froggit DP1500 (and any equivalents) specific===
 
{{Template:WorkInProgressBanner}} An Ecowitt user needs to check/update this sub-section, it is understood significant changes are included in 3.12.0 beta builds, but the forum does not give away any details
 
* Introduced in release 3.2.0
 
===Fine Offset Stations===
 
 
{{Template:WorkInProgressBanner}} This table has not been populated yet
 
* Introduced in a Legacy version
|-
!style="width:30px" | Parameter Line Entry
!style="width:100px" | MX SectionIntroduced
!style="width:100px" | Shown on Settings page?
!style="width:20px100px" | DefaultMX Section
!style="width:60px" | Label on Settings page
!style="width:20px" | Default
!style="width:300px" | Description
|-
| FOReadAvoidPeriod=3
| MX release ??
| Only if Fine Offset selected
| Station Settings → Fine Offset Advanced Settings
| Read Avoid Period
| 3 (seconds)
| If previous setting enabled, MX will avoid reading the circular memory from the number of seconds specified before it expects Fine Offset to be writing to the circular memory, to the number of seconds specified after it expects Fine Offset to be writing to the circular memory
 
(One issue is that Fine Offset will move from one position to the next position in the circular memory, at the Fine Offset Logging Interval, but will delay this move by up to one minute, if the existing memory position is actually being updated by a read from the sensors and normally those updates happen every 40 seconds for non-solar sensors, and every 60 seconds for solar sensor)
|-
| ??
| MX release ??
| Only if Fine Offset selected
| Station Settings → Fine Offset Advanced Settings
| Set the Fine Offset Logger interval to match Cumulus MX interval
| 0 (disabled)
| Simple tick or not - labelled as "Experimental - use with caution"
* Tick (value shown as 1 in Cumulus.ini) for MX to attempt to "update the Davis interval" (I said copy and paste was used from Davis section!) to match the interval MX is using.
* Don't tick (value shown as 0 in Cumulus.ini) for no effect on your weather station
|}-
| FineOffsetReadTime=150
| MX release ??
| Only if Fine Offset selected
| Station Settings → Fine Offset Advanced Settings
| Request/Read Delay
| 150 (milliseconds)
| Adjust time (in milliseconds) between request for read, and actual attempt to read data via USB
|-
| ProductID=-1
| MX release ??
| Only if Fine Offset selected
| Station Settings → Fine Offset Advanced Settings
| USB Product Id (PID)
| -1 (default setting)
| Advanced setting if you don't want to leave it to MX to find your HID
|-
| SyncFOReads=0
| Legacy Cumulus
| Only if Fine Offset selected
| Station Settings → Fine Offset Settings
| Synchronise Reads
| 0 (disabled)
* Tick (value shown as 1 in Cumulus.ini) for MX to attempt to work out when your Fine Offset is writing data to the console log, so that MX does not read the Fine Offset circular memory when it is being updated
* Don't tick (value shown as 0 in Cumulus.ini) for MX to read the Fine Offset circular memory whenever it next wants data
Selecting this parameter has given some problems in earlier MX builds, so the code has recently been rewritten.
|-
| FOReadAvoidPeriod=3
| Read Avoid Period
| 3 (seconds)
| If previous setting enabled, MX will avoid reading the circular memory from the number of seconds specified before it expects Fine Offset to be writing to the circular memory, to the number of seconds specified after it expects Fine Offset to be writing to the circular memory
 
# The parameter was added for legacy releases, to try to reduce the occurrence of "lock-up" issues.
(One issue is that Fine Offset will move from one position to the next position in the circular memory, at the Fine Offset Logging Interval, but will delay this move by up to one minute, if the existing memory position is actually being updated by a read from the sensors and normally those updates happen every 40 seconds for non-solar sensors, and every 60 seconds for solar sensor)
# MX uses a different way to interrogate Fine Offset stations, originally ticking this could result in more reads being skipped, than actually processed, potentially updating just a few times a day, so it was best disabled!
|}
# The MX code relating to this parameter was rewritten 1n 3.11.0, but the developer labels this as an "attempt", so it may still be best to try to manage without enabling this setting
 
 
 
{{Template:WorkInProgressBanner}}
There are a number of settings in a MX sub-section called "Fine Offset Advanced Options". These are new settings, and have not been documented yet.
 
{| class="wikitable" border="1"
|-
| VendorID=-1
!style="width:30px" | Parameter Line Entry
| MX release ??
!style="width:100px" | Shown on Settings page?
| Only if Fine Offset selected
!style="width:100px" | MX Section
| Station Settings → Fine Offset Advanced Settings
!style="width:60px" | Label on Settings page
| USB Vendor Id (PID)
!style="width:20px" | Default
| -1 (default setting)
!style="width:600px" | Description
| Advanced setting if you don't want to leave it to MX to find your HID
|-
|}
 
 
 
{{Template:WorkInProgressBanner}} The following table has some gaps to fill in, needs a contributor who uses this type of weather station
 
* Introduced in a Legacy version
 
 
===La CrosseLaCrosse stations===
 
 
 
{{Template:WorkInProgressBanner}} The following table has some gaps to fill in, needs a contributor who uses this type of weather station
 
 
Oregon Scientific specific
 
{{Template:WorkInProgressBanner}} This table has not been populated yet, needs a contributor who uses this type of weather station
 
* Introduced for legacy Cumulus
5,838

edits