Massa M3 User Manual
  1. Manuals
  2. Brands
  3. Massa Manuals
  4. Gateway
  5. M3
  6. User manual

Massa M3 User Manual

Wireless tank level sensor and digi gateway
Hide thumbs Also See for M3:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Quick Manual
Massa Model M3 Wireless
Tank Level Sensor and Digi Gateway
User's Guide
.
Product Manual - April 24, 2012
M3 Wireless Ultrasonic Level Sensor

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the M3 and is the answer not in the manual?

Questions and answers

Related Manuals for Massa M3

Summary of Contents for Massa M3

  • Page 1 Massa Model M3 Wireless Tank Level Sensor and Digi Gateway User’s Guide Product Manual - April 24, 2012 M3 Wireless Ultrasonic Level Sensor...

  • Page 2: Table Of Contents

    Troubleshooting Guide North America The M3 Sensor complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (i.) this device may not cause harmful interference and (ii.) this device must accept any interference received, including interference that may cause undesired operation.

  • Page 3: Overview And General Operation

    2.0 Gateway Basic Settings The Digi International Gateway, models X2 or X4, needs to be set up to be used with the M3 Sensor. This includes configuring for an Ethernet or WiFi connection, configuring gateway’s XBee settings, loading python programs, and configuring server connection to receive the data.
  • Page 4 1 minute. Note that sensors will be required to rejoin each time awake cycle, which will slightly use more battery power in this type of application. Click the Apply button to accept all the settings. Product Manual- April 24, 2012 M3 Wireless Ultrasonic Level Sensor...
  • Page 5 The files indicated here are required to set up and operate the M3 Sensors. They can be obtained from www.massa.com. The dia.yml file will need to be edited to configure the M3 Sensors to operate with your gateway. See Section 3.0 for more information.

  • Page 6: Operating Modes For Gateway And Sensor

    3.1 Configuring Sensor Settings & Other Controls The controls for the gateway operating mode are found in the dia.yml file which is processed by the Massa Python driver (m3_driver.py). This dia.yml can be set up to program sensor’s registers, program Xbee’s registers, obtain diagnostic information, program the sensor’s application firmware, and program the XBee radio.

  • Page 7: Operating Modes For Gateway And Sensor

    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”...
  • Page 8 Very High setting while very strong signals and applications with short sensing ranges can consider settings in the Very Low direction. Customized settings is an option on more difficult applications, consult Massa Products for support. Leaving this control line out of the dia.yml, blank value, or incorrectly typed setting value will not access this sensor setting.
  • Page 9 (such as a ladder in a tank). Obtain Custom diagnostic waveforms in an empty tank then consult Massa Products for support in setting up a custom setting for your application. 3.1.11 Dia.yml Settings Description – Custom Ultrasonic Signal Sensitivity Settings The sensitivity settings listed here allow customization of the thresholds and timing for target detection on the ultrasonic signal for more difficult applications.
  • Page 10 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 Product Manual- April 24, 2012 M3 Wireless Ultrasonic Level Sensor...
  • Page 11 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. Product Manual- April 24, 2012 M3 Wireless Ultrasonic Level Sensor...

  • Page 12: Firmware Update

    Python manage files memory prior to activation. Leaving this control line out of the dia.yml, blank value, or incorrectly typed filename or incorrect model number within filename will not perform this function. Values: firmware bin files, see www.massa.com. Enclose with quotes. program_m3_firmware_file: 'M3-150V31-21.bin' (example) NOTE: If the sleep setting is not enabled, the gateway will restore the previously stored sleep setting after firmware programming.
  • Page 13 Section 3.1.26. Upon successfully changing the settings, revert back to listening only mode. See section 3.1 for configurable sensor settings. You may configure multiple sensors at a time with the yml file. Product Manual- April 24, 2012 M3 Wireless Ultrasonic Level Sensor...
  • Page 14 'obtain_diagnostic_data' setting is enabled, the 'sleep_interval_sec' also be enabled and value set to your application so it is properly restored. Shown here are 2 waveform files created from the M3/150 sensor (file extension ending in the .M3). As indicated in Appendix A, the M3/150 will obtain 2 waveforms while the M3/95 and M3/50 Sensors will obtain 4 waveforms.
  • Page 15 3.2.5 Enabling gateway serial port for use with M3 Software application (X4 Gateways only) The M3 Software application is set up to communicate directly with an X4 Gateway’s serial port.

  • Page 16: Sensor Xbee Firmware Update

    3.2.6 Sensor XBee Firmware Update Follow the steps below to program sensors XBee firmware. You should obtain the firmware from either massa.com or from digi.com. Xbee firrmware has an “ebl” file extension. NOTE: Update only one Sensor XBee firmware at a time.

  • Page 17: 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).
  • Page 18 Hosting sites can obtain and mange your data that could include sending you notification on tank level, alarms, and such to your PC or mobile device. For more information, contact Massa Products or Digi International. Product Manual- April 24, 2012 M3 Wireless Ultrasonic Level Sensor...

  • Page 19: Appendix A

    ▬ ► Waveform to save Transmit Transmit Transmit Transmit Sensor Model Gain Gain Gain Gain cycles cycles cycles cycles M3/150 and M3/150is high M3/95 and M3/95is high high M3/50 high Product Manual- April 24, 2012 M3 Wireless Ultrasonic Level Sensor...

  • Page 20: Led Behavior

    To restart a sleeping sensor, remove battery and then press the commission button for several seconds. Reinstall battery. Firmware Releases As of this writing, gateway Xbee firmware is 21A0 and sensor is 29A0. See massa.com for the most up to date releases including sensor firmware.
  • Page 21 Sensor XBee radio settings (FW ver 29A0): Scan Channels (SC) = 0x1ffe Node Identifier (NI) = Massa M3/xxx (this is specific to sensor model type, 150, 95, 50, 150is, or 95is) Device Type Identifier (DD) = 0x30201 Node Discovery Option (NO) = 1...

  • Page 22: Appendix B

    # clear_data_history: 'false' # select 'true' to clear sensor history # program_m3_firmware_file: 'M3-150V31-21.bin' # see massa.com for most up to date sensor FW ver. Recommended to enable sleep_interval_sec if this setting enabled. # keep_xbee_awake: 'false' # ‘true’ to keep sensor awake 5 minutes, ‘false’ to disable keep sensor awake function # clear_errors: 'false' # ‘true’...

  • Page 23: Appendix C

    MASSA PRODUCTS CORPORATION APPENDIX C Digi Gateway & Massa M3 Sensor Placement Strategies If you had been previously evaluating this kit in your lab environment, it is now time to move the gateway in a permanent location that will give the best possible wireless performance.
  • Page 24 MASSA PRODUCTS CORPORATION APPENDIX C (continued) Digi Gateway & Massa M3 Sensor Placement Strategies This example shows a much taller tank with a gateway placed high overhead. Here the tractor trailer does not impede the radio signals. In this scenario, a chain link fence is between sensor and gateway.

  • Page 25: Appendix D Fresnel Zone

    Most cased the reflected signal would be low in sensitivity and may not be an issue. Product Manual- April 24, 2012 M3 Wireless Ultrasonic Level Sensor...

  • Page 26: Appendix E Outgoing Auto-Message Message Format

    <bit2> Temperature Probe; 0=Internal (default), 1=User Programmed value) <bit1> Min Distance Processing; 0=Disabled, 1=Enabled (default) <bit0> Range Bytes Resolution; 0= ÷128 (models M3/150 & M3/95), 1= ÷64 (model M3/50) <RangeLSB><RangeMSB>: Ultrasonic Range (in inches). Resolution for model M3/150 and M3/95: RangeMSB:RangeLSB ÷ 128.

  • Page 27: Appendix F

    When the dia.yml configures obtain_diagnostic_data_enable: 'false', waveforms and other data are stored in the gateway. Save the file from the gateway to your PC and use the M3 Application software (see www.massa.com) to recall each waveform. See plot below of a typical waveform.

  • Page 28: Sensor Settings

    Ultrasonic sensitivity set to normal. Consult factory for other settings in more difficult sensing applications. □ Massa python driver version 1.0 or greater. For version number, see log file dia_log.txt when dia executed. □ Application program “Notepad ++” is a very helpful in making sure your dia.yml has the proper spaces and tabs set to identify the controls to the dia.

  • Page 29: Troubleshooting Guide

    - Poor sensor/gateway placement - low battery voltage Sensors do not rejoin Upgrade Massa Python driver 0.53 or greater which will perform a Gateway power cycle and Xbee gateway upon awake Xbee network reset upon gateway boot when NC=10. Sensor "Number of remaining children"...

Table of Contents