User`s guide

ManualsBrandsMassa ManualsComputer equipmentM3

MASSA PRODUCTS CORPORATION

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

APPENDIX B

Format for dia.yml

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). See an example below. It is very important that the syntax is maintained with same spaces and no tabs as shown in

this example. It is suggested that you download “Notepad ++” and set it up properly so that any tabs are converted to spaces. The “#”

character and all that follows on a line are comments and are not processed. Quote marks can be single or double as long as they

match. The driver below “loggers” is used for uploading data to the iDigi Cloud.

devices:

- driver: devices.xbee.xbee_device_manager.xbee_device_manager:XBeeDeviceManager

settings:

addr_dd_map: {}

worker_threads: 1

##########################################################################################

# NOTE: If dia controls are left out or preceded with the '#' symbol (comment line), then the specific function

# will be ignored and not executed. Enabling the xbee_program_awake setting will disable all other settings.

##########################################################################################

# Sensor #1 ##############################################################################

- name: M3-150-3b43

driver: devices.vendors.massa.m3_driver:M3Driver

settings:

# Main DIA related

extended_address: '00:13:a2:00:40:48:3b:4e!'

xbee_device_manager: 'xbee_device_manager'

# Sensor Settings

# sleep_interval_sec: 0 # units in seconds

# awake_time_sec: 31 # 20 sec min for most applications

# data_collection_interval_sec: 0 # units in sec (inactive for outgoing msg modes 5 and 6)

# outgoing_message_mode: 0 # limit 0-6

# auto_message_length: 8 # limit 1-8

# sensitivity: 'normal' # 'normal', 'high', 'very high', 'low', 'very low', 'custom'

# user_comment: '' # limit 32 ASCII characters

# comm_fail_boot: # Reboot sensor on failed Zigbee Ack / Unassoc. limits: 0, 4 – 254 awake periods, default = 0

# XBee settings

# pan_id: 0x0000000000000000 # limits 0x0000000000000000 to 0x000000007fffffff

# xbee_security: 'disable' # XBee Encryption enable EE register 'enabled' or 'disabled'

# xbee_security_key: 0x0000000000000000 # XBee (Link encryption key) KY register, 16 bytes

# poll_rate: 0 # XBee PO register, PO=0 for XBee FW 29A0 or greater

# node_discovery: 1 # XBee NO register, 0 or 1, set this to 1

# pan_conflict_threshold: 3 # XBee CR register, limits 1-0x3f, set this to 3

# device_options: 0 # XBee DO register, limits 0 or 4. 0 for first find association, 4 for strongest signal association (XBee 29A7 or greater)

# Routine control

# obtain_diagnostic_data: 'true' # 'true' to obtain waveforms or ‘false’ to disable. Recommended to enable sleep_interval_sec if this setting enabled.

# 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’ to clear sensor errors

# reboot_sensor: 'false' # ‘true’ to reboot sensor. Required after XBee firmware is updated

# log_status: 'false' # ‘true’ to output a 'status_log.txt' file that records autosend messages

# log_dia: 'false' # ‘true’ to output a 'dia_log.txt' file that reports sensor settings and driver version

##########################################################################################

# For additional sensors on the gateway, copy the sensor controls as seen in Sensor 1 above and edit the new control extended_address line with sensor’s

# MAC address and assign a new name (-name: ).

loggers: []

presentations:

- driver: presentations.rci.rci_handler:RCIHandler

settings: {}

- driver: presentations.idigi_db.idigi_db:iDigi_DB

settings:

channels: []

collection: ''

compact_xml: false

file_count: 20

filename: channel_readings

interval: 30

sample_threshold: 20

secure: true

- driver: presentations.console.console:Console

settings: {baudrate: 115200, device: /com/0, port: 4146, type: tcp}

- driver: presentations.embedded_web.web:Web

settings: {page: idigi_dia}

services: {}