User`s guide

MASSA PRODUCTS CORPORATION
Product Manual- April 24, 2012 16 M3 Wireless Ultrasonic Level Sensor
4.0 Application Setup Example
Application Example - Managing a tank farm
The M3 Sensors are supplied programmed to stay awake and will commission to any gateway (unless gateway security
enabled or child table at max). This will be indicated by the sensor’s red LED blinking every 2 seconds. Typical
applications will have the sensors programmed for long sleep periods (1hr, 4hrs, 12hrs or more) to maintain battery life
(see Appendix A). When programmed, sensors will awake and send status information to the gateway which in turn will
send the information to a server (cloud or local). Setting up sensors and gateways to have their PAN ID’s programmed to
similar non-zero values will maintain that sensors stay associated with an assigned gateway and not join other gateways
(when other gateways are in vicinity). Follow the steps below to properly set up your sensor and includes suggestions to
obtain diagnostic data when evaluating a new tank for the very first time.
Procedure:
1) DO NOT POWER SENSORS AT THIS TIME.
2) Configure Digi Gateway as indicated by their instructions so you have an Ethernet connection. Use Digi’s Discovery
application to get to their Web UI.
3) If there are plans to ever have another gateway in the area, you should change the gateway’s XBee Extended PAN
identifier for the XBee network. See page 3.
4) Load all the python files from www.massa.com into your gateway.
5) Load a sample dia.yml (from www.massa.com) on your PC to edit the parameters as follows:
a) Enter the MAC address of your sensor on the “extended_address” line to the same value as Step 3.
b) Set other settings as seen in Appendix B
c) If you have additional sensors, copy settings and edit MAC and NAME parameters. Also edit the PAN ID to
the non-zero value the gateway was programmed to.
d) Load the edited dia.yml back into the manage python files (see page 4)
e) Power sensor now
f) Re-boot gateway for pan id to be programmed into sensor. Sensors should stay commissioned going from
PAN ID=0 to PANID=your new non-zero value.
g) If evaluating a new tank, it is recommended to run diagnostics mode to obtain diagnostic data (ultrasonic
waveforms) from the sensor. Data should be obtained with the tank empty, ½ full, and full. This data should
be archived so that it can be used later to evaluate any problematic tanks. See section 3.2.3 for getting this
data.
h) To view waveforms, use the M3 Software Application, see Appendix F for a waveform description, but for
support, contact Massa Products Corporation.
6) If the gateway was close by to the tank during setup and now you are ready to determine a permanent location of the
gateway, you should program the sensor to send automated messages relatively fast (every few minutes). These
messages will contain the RF signal strength. See Appendix C to observe the radio signal strength and where best to
place the gateway as typically it will be more difficult to move the tank. Set up the dia.yml with the following
settings:
a) Obtain the dia.yml from gateway
b) Set sample_rate_sec: 120
c) Set sleep_rate_sec: 120
d) Set awake_time_sec: 31
e) Set outgoing_message_mode: 2
f) Load the edited dia.yml back into the manage python files (see page 4)
g) Re-boot gateway for settings to be programmed into sensor