User`s guide

MASSA PRODUCTS CORPORATION
Product Manual- April 24, 2012 10 M3 Wireless Ultrasonic Level Sensor
3.0 Operating Modes for Gateway and Sensor
3.1.17 Dia.yml Settings Description – XBee Poll Rate (PO)
The setting “poll_rate” in the dia.yml file is used to set the XBee’s Poll Rate (PO) register. Leaving this control line
out of the dia.yml, blank value, or incorrectly typed setting value will not access this radio setting. Set this value to 0.
poll_rate: 0
3.1.18 Dia.yml Settings Description – XBee Node Discovery Register (NO)
The setting “node_discovery” in the dia.yml file is used to set the XBee’s Node Discovery (PO) register. Leaving this
control line out of the dia.yml, blank value, or incorrectly typed setting value will not access this radio setting. Set this
value to 1.
node_discovery: 1
3.1.19 Dia.yml Settings Description – XBee PAN Conflict Threshold Register (CR)
The setting “pan_conflict_threshold” in the dia.yml file is used to set the XBee’s PAN Conflict Threshold (CR) register.
This setting is only available for XBee firmware releases 29A0 and greater. It is important to note that when upgrading
XBee firmware from earlier versions than 29A0, that this register be programmed to the default value of 3. Leaving
this control line out of the dia.yml, blank value, or incorrectly typed setting value will not access this radio setting.
Limits: 1 - 0x03f. Set this value to 3 (default).
pan_conflict_threshold: 3
3.1.20 Dia.yml Settings Description – XBee Device Options Register (DO) (FW releases 29A7 or greater)
The setting “device_options” in the dia.yml file is used to set the XBee’s Device Options (DO) register. This setting is
only available for XBee firmware releases 29A7 and greater. It is important to note that when upgrading XBee
firmware versions prior to 29A7, that this device options register be updated. Setting to 0 will associate to gateway on
first response. Setting it to 4 will associate to the gateway with strongest signal (when more than 1 gateway in range).
Leaving this control line out of the dia.yml, blank value, or incorrectly typed setting value will not access this radio
setting. Limits: 0 or 4. Set this value to 0 (default). After this setting has been updated, execute a sensor reboot. See
reboot_sensor setting.
device_options: 0
3.1.21 Dia.yml Settings Description – Clear Data History Records
The setting “clear_data_history” in the dia.yml file is used to clear all the sensors historical data records and will reset
the Event Number to 1. Enter 'true' to enable this setting. Leaving this control line out of the dia.yml, blank value, or
incorrectly typed setting value will not perform this function. Select 'true' or 'false'. Enclose with quotes.
clear_data_history: 'false'
3.1.22 Dia.yml Settings Description – Obtain Diagnostic Data (ultrasonic waveforms and historical records)
The setting “obtain_diagnostic_data” in the dia.yml file is used to obtain diagnostic data which includes waveforms and
other information that will be stored in gateway memory. Enter 'true' and boot gateway to acquire ultrasonic waveforms
and other information which will be stored in the gateway. Leaving this control line out of the dia.yml, blank value, or
incorrectly typed setting value will not perform this function. Select 'true' or 'false'. Enclose with quotes.
obtain_diagnostic_data: 'false'
NOTE: If the sleep setting is not enabled, the gateway will restore the previously stored sleep setting after diagnostic
data is obtained. If a gateway power cycle were to occur while obtaining diagnostic data, the sleep setting will be set
to zero. It is recommended that if this setting is enabled, the 'sleep_interval_sec' also be enabled and value set to your
application so it is properly restored.