User`s guide

MASSA PRODUCTS CORPORATION
Product Manual- April 24, 2012 9 M3 Wireless Ultrasonic Level Sensor
3.0 Operating Modes for Gateway and Sensor
3.1.12 Dia.yml Settings Description – User Comment
The setting “user_comment” in the dia.yml file allows descriptive information to be programmed into the sensor. Up to
32 ASCII characters can be placed into the sensor. Leaving this control line out of the dia.yml, blank value, or
characters other than ASCII will not access this sensor setting. Limits: up to 32 ASCII characters within quotes. A
space or no space between the quote will program 32 spaces into these sensor comment registers. Enclose with quotes.
user_comment: ' '
3.1.13 Dia.yml Settings Description – Zigbee Ack / Unassociated Failure to Boot Sensor
The setting “comm_fail_boot” allows for fail safe operation by rebooting sensor in cases of consecutive failed Zigbee
Acknowledge message or Unassociated state with gateway that occur on awake cycles. Suggested setting for a reboot
is 24 hours and timing is based on the Sleep Setting (sleep_interval_sec). For example, if sleep setting is 4 hours, set
this register to 6 for sensor to reboot on 6 consecutive awake cycles that cannot communicate with gateway (for 24
hours). Limits: 0, 4 – 254. “0” disables this feature. Invalid values (1, 2, 3 & 255) will be default to 0.
comm_fail_boot: 0
3.1.14 Dia.yml Settings Description – XBee PAN ID (ID)
The setting “pan_id” in the dia.yml file programs the XBee’s PAN ID register. Sensors are shipped from the factory
with its PAN ID set to zero, which by definition, will commission to any gateway (any PAN ID). It is suggested that if
more than one gateway and sensor system is used within RF range of each other, that each gateway and associated
sensor(s) be programmed with their own unique non-zero PAN ID. Set this value to the same non-zero PAN ID as seen
in your Gateway’s XBee PAN ID. Leaving this control line out of the dia.yml, blank value, or incorrectly typed setting
value will not access this radio setting. Limits: 0 - 0x000000007fffffff
pan_id: 0x0000000000000000
NOTE: Once the sensor’s PAN ID has been changed after rebooting the gateway in the “Configure Sensor Settings” mode, the
gateway’s PAN ID will need to be changed with this newly assigned PAN ID so that you can continue to communicate with the
sensor. If the Deep Sleep register is zero, the sensor will default to a 1 minute sleep mode and may take up to 1 hour to rejoin the
gateway. If the Deep Sleep register is non-zero and the Outgoing Message Mode is 1,2, 5 or 6, then sensor will rejoin upon the next
wake up cycle. See Section 2.3 to change the gateway’s PAN ID.
3.1.15 Dia.yml Settings Description – XBee Encryption Enable (EE)
The setting “xbee_security” in the dia.yml file is used to set the XBee’s Encryption Enable (EE) register. To activate
sensor Xbee security, enter 'enable' and enter a security value in the 'xbee_security_key' setting (see section 3.1.16).
Leaving this control line out of the dia.yml, blank value, or incorrectly typed setting value will not access this radio
setting. The gateway’s XBee “Encryption Enable (EE)” register will need to be set to '1' as well. Select 'enable' or
'disable'. Enclose with quotes.
xbee_security: 'disable'
3.1.16 Dia.yml Settings Description – XBee Encryption Key (KY)
The setting “xbee_security_key” in the dia.yml file is used to set the XBee’s Encryption Key (KY) register. This key
will be loaded into XBee if xbee_security: 'enable'. The gateway’s XBee “Link encryption key (KY)” register will need
to be set to the same value as you have set here. Leaving this control line out of the dia.yml, blank value, or invalid
value will not access this radio setting. Limits: 16 byte hexadecimal string.
xbee_security_key: 0x0000000000000000