User`s guide

MASSA PRODUCTS CORPORATION
Product Manual- April 24, 2012 6 M3 Wireless Ultrasonic Level Sensor
3.0 Operating Modes for Gateway and Sensor
3.1.1 Dia.yml Settings Description - name
The setting “name” in the dia.yml file is used to identify the sensor to the device server. A naming suggestion to best
help identify a sensor in multiple tanks is to use the sensor model number followed by the sensor’s MAC address or
tank number or serial number as indicted. Limit: 32 characters, no quotes.
name: M3-150-7A563B40 or M3-150-7A563B40-Tank1 (these are examples)
3.1.2 Dia.yml Settings Description - driver
This is the python driver for the Massa M3 sensor “m3_driver” located in the dia.zip file.
driver: devices.vendors.massa.m3_driver:M3Driver
3.1.3 Dia.yml Settings Description – Xbee extended address
The setting “extended_address” in the dia.yml file identifies the sensor for the driver. Enter the entire MAC address as
seen on the label on the sensor or as found in the discovery process. Use lower case for the alpha characters and end
with an exclamation point and enclose with quotes. Add additional sensors by separating them by commas.
extended_address: '00:13:a2:00:40:48:3b:4e!'
3.1.4 Dia.yml Settings Description – Xbee device manager
The setting “xbee_device_manager” found in the dia.yml file is used to specify the Xbee manager. Quotes required.
xbee_device_manager: 'xbee_device_manager'
3.1.5 Dia.yml Settings Description – Sleep Interval
The setting “sleep_interval_sec” in the dia.yml file controls the XBee radio sleep period. For Modes 1-3 the sensor will
wake up radio to send status information and is independent of the rate to which data is acquired (see
data_collection_interval_sec setting). For Modes 5 and 6, the sensor will obtain new range and status information, then
wake up the radio and send it to the gateway. The recommended sleep interval settings are 1, 2, 4, 8, or 12 hours. See
appendix for battery life estimates with different Sleep Interval settings. No radio communications can occur while
sensor is sleeping (red LED off). Leaving this control line out of the dia.yml, blank value, or incorrectly typed setting
value will not access this sensor setting. Limits: 0, 12 – 88474 seconds.
sleep_interval_sec: 0 (seconds)
NOTE: If this sleep setting is programmed to a non-zero value, program the outgoing_message_mode to non-zero as well.
3.1.6 Dia.yml Settings Description – Awake Time
The setting “awake_time_sec” in the dia.yml file controls the XBee radio ON time after the sleep timer has expired.
Communications occurs during this period and will be indicated by the red LED blinking every 2 seconds.
Recommended setting is 25 seconds. Leaving this control line out of the dia.yml, blank value, or incorrectly typed
setting value will not access this sensor setting. Limits: 12 – 600 seconds.
awake_time_sec: 0 (seconds)
3.1.7 Dia.yml Settings Description – Data Collection Interval
The setting “data_collection_interval_sec” in the dia.yml file controls the rate at which an ultrasonic range
measurement and other status information are collected. This setting is ignored when the Outgoing Message Mode
register is set to 5 or 6 which uses the Sleep Interval to obtain range and status. For more information, see Section
3.1.8. Leaving this control line out of the dia.yml, blank value, or incorrectly typed setting value will not access this
sensor setting. Limits: 0, 10 – 16777215 seconds.
data_collection_interval_sec: 0 (seconds)