5,838
edits
Cumulus.ini (preserving history): Difference between revisions
→Section: MQTT: new
(→Section: MQTT: new) |
|||
|
=== Section: Solar ===
Set mostly in solar block at foot of Station Settings screen
{| class="wikitable" border="1"
|-
|UseBlakeLarsen=0
| Called B/l on screen. Set this to 1 if you have a Blake-Larsen Sun Recorder, and you want Cumulus to get today's sunshine hours from it. You need to configure the Blake-Larsen software to put the SRsunshine.dat file into the Cumulus data folder so that Cumulus can read it.
|}
=== MQTT ===
MQTT (Message Queuing Telemetry Transport) is a machine-to-machine (M2M)/"Internet of Things" connectivity protocol.
[[File:Badge vMx.png]] This section is only applicable to Cumulus MX and only available from version 3.5.0 (build 3071)
Most settings are on the '''Internet Settings''' screen in either the MQTT section or one of the two '''Send message''' sections, but some require editing Cumulus.ini while MX is stopped.
{| class="wikitable" border="1"
|-
!style="width:150px" | Parameter Line Entry
!style="width:600px" | Function
|-
|style="background:lightgray;"|[Solar]
|style="background:lightgray;"|Section Name - the following parameters are set from the Solar Setup dialog in Cumulus
|-
|Server=
|Note there is no default. The MQTT section is used to enter your server name or the IPv4 or IPv6 address to find your server
|-
|Username=
|This is optional. The MQTT section is used to enter the username if one is needed for updating your server
|-
|Password=
|This is optional. The MQTT section is used to enter any password needed for that username
|-
|Port=1883
|Note default. The settings screen is used to enter which port is used to connect to your server
|-
|UseTLS=0
|Transport Layer Security (TLS), and its now-deprecated predecessor, Secure Sockets Layer (SSL), are cryptographic protocols designed to provide communications security over a computer network. This tick box on settings screen indicates whether TLS support is required, default is not (0), set to 1 if modern security protocol is being used
|-
|IPversion=0
| (0=default, 4=IPv4, 6=IPv6) - This parameter must be added to this Cumulus.ini section, it cannot be edited on a screen.
|-
|EnableDataUpdate=0
|This tick box on the settings screen in the '''Send message on data update''' section provides an easy way to stop/start the updating without losing other settings. Default is unticked as most people do not use this functionality.
|-
|UpdateTopic=CumulusMX/DataUpdate
|This feature in the '''Send message on data update''' section is where you specify the name to give to the update message
|-
|UpdateTemplate=DataUpdateTemplate.txt
|In the CumulusMX/mqtt folder there is a default template with a file name specified by the default value of this parameter. In that default file <tt>{"time":"<#timehhmmss>","windspeed":<#wlatest rc=y>,"winddir":<#bearing>}</tt> will send wind readings in case for example you want to close something when it is windy. If you create your own file, you can put its name in the '''Send message on data update''' section
|-
|EnableInterval=0
|This tick box on the settings screen in the '''Send message at fixed intervals''' section provides an easy way to stop/start this type of updating without losing other settings. Default is unticked as most people do not use this functionality.
|-
|IntervalTime=600
|This text box in the '''Send message at fixed intervals''' section is where you enter the time between messages in seconds, the default is 600 meaning every ten minutes.
|-
|IntervalTopic=CumulusMX/Interval
|This feature in the '''Send message at fixed intervals''' section is where you specify the name to give to the fixed interval update message
|-
|IntervalTemplate=IntervalTemplate.txt
|In the CumulusMX/mqtt folder there is a default template with a file name specified by the default value of this parameter. In that default file <tt>{"time":"<#timehhmmss>","temp":<#temp rc=y>,"humidity":<#hum>}</tt> will send temperature and humidity readings in case for example you want to open something when it feels uncomfortable. If you create your own file, you can put its name in the '''Send message at fixed intervals''' section
|}
| |||