User`s guide

MASSA PRODUCTS CORPORATION

Product Manual- April 24, 2012 14 M3 Wireless Ultrasonic Level Sensor

3.0 Operating Modes for Gateway and Sensor

3.2.4 Sensor Application Firmware Update

First, obtain the sensor’s application firmware from Massa

Products web site and upload it as shown here stored in the

Python Configuration Manage Files location. Firmware

versions less than 29.x will also require loading M3-

BootloaderV3.bin into gateway as seen here. Create a new yml

file named dia_m3_firmware_update.yml and enable the

program setting as shown here for model M3/150 sensor:

program_m3_firmware_file: 'M3-150V29-17.bin'

NOTE: Enable only one sensor’s program firmware setting

at a time.

NOTE: If the sleep setting is not enabled, the gateway will

restore the previously stored sleep setting after firmware

programming. If a gateway power cycle were to occur during

programming, 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.

In the Auto-start Settings menu, check the enable box for “dia.py

dia_m3_firmware_update.yml” and reboot the gateway. When the sensor

wakes up, it will begin uploading firmware. Upon completion, a dia log

file named “dia_log.txt” will be created, or append to an existing one, and

report if it has successfully uploaded the firmware.

When successfully programmed, uncheck the Enable box for firmware

uploading and return to the listening mode dia.yml (or another function) to

prevent the sensor from having its firmware uploaded a second time on

any subsequent gateway boots.

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. This is an alternate method of accessing sensors

settings, utilizing the diagnostic tools, and update firmware locally. Load

“massa_gateway_appl.py” then enable it in the Auto-start Settings UI.

Reboot the gateway to enable the serial port.

Uncheck “Access the command line interface” in the Serial Services UI

and set up for custom serial port setting: Baud Rate=9600, Data Bits=8,

Parity=none, Stop Bits=1, and Flow Control=none. The M3 application

software can be obtained at www.massa.com.