UDP Trigger App

Application Version: 2.0.0
Compatible Firmware: Flexa Firmware min. v2.3.0
Device Compatibility: Barionet M44

Application Purpose

The BM44 UDP Trigger App is an application designed for the Barionet M44 device that monitors digital inputs and sends UDP messages to remote targets when input states change. It provides a flexible, configurable way to trigger network notifications based on physical input events.

Core Functionality

Input Monitoring

• Monitors the built-in 4 digital inputs of the BM44

• Uses the BM44's IoMapping API for real-time state change notifications

• Only monitors inputs that have been configured with target destinations

Dual-State Messaging

• Input Close (0→1): Sends configurable "close" message when input transitions from open to closed

• Input Open (1→0): Sends configurable "open" message when input transitions from closed to open

• Separate messages allow different actions for different input states

• If no message is defined for a state nothing will be sent when the input transitions to that state

UDP Network Communication

• Sends UDP packets to multiple target IP addresses and ports

• Supports comma-separated target lists that can be defined for the 4 inputs (e.g., "192.168.1.10:8001,192.168.1.20:8002")

• Messages are automatically terminated with line feed (0x0A) for protocol compliance

Compatible Hardware

Primary Platform: The UDP Trigger Application is designed for Barionet M44 devices running the Flexa Firmware v2.3.0.

Installation Process

Installing the UDP Trigger App requires uploading a package file directly to your Barionet device through its web interface. This process is straightforward but requires careful attention to ensure proper installation.

NOTE: If your Barionet M44 is already running an application you must RESET TO DEFAULTS before proceeding and installing a new one.

Step 1: Access the Device Web Interface

1. Open your web browser and navigate to your Barionet device's IP address

2. Enter your administrator username and password when prompted

3. Wait for the main interface to load completely before proceeding

   

Step 2: Upload the Application Package

1. Navigate to the HOME tab in the main menu

2. Locate the "Upload" button next to “Install Package” within the page

3. Click the file selection button and browse to the “package.zip” which was downloaded from this page

4. Choose an appropriate version number for tracking purposes (this can be any number you prefer for identification)

5. Click the UPLOAD button to begin the installation process

Step 3: Device Reboot and Verification

After the upload completes, your Barionet device will automatically initiate a reboot sequence. This reboot is necessary to properly integrate the new application into the system. The reboot process typically takes 30..40s

1. Wait for the device to complete its reboot cycle

2. Reconnect to the web interface using the same IP address and credentials

3. Navigate back to the HOME tab

4. Verify that the UDP Trigger application appears with a status of "running"

   

Configuration Overview

Once successfully installed, the UDP Trigger app configuration interface becomes available through the UDP Trigger tab in your device's web interface. This dedicated configuration page provides access to all settings necessary to define messages to be sent on state changes for the 4 inputs.

Main Configuration Settings

For each Input the following configuration options are available:

UDP Target List

Comma separated list of IP Addresses that will receive the message via UDP when the corresponding input is closed.

Example: 192.168.1.2:12345,192.168.1.3:23456,192.168.1.4:12345

When the input changes state the defined message for the state transitioned into will be sent ot each member of the list.

IPv4 addresses supported including multicast and broadcast.

Message when Closed / Opened

This is the message to be sent via UDP to each member of the target list when the input transitions in the corresponding state.

The app appends automatically “\n” (LF - 0x0A) as termination character.

Syslog

This section is used to setup logging to an external syslog server. Particularly useful to monitor / track application’s operations or debugging in case of problems.

Software Disclaimer

IMPORTANT:

This software application ("Software") is provided "AS IS" without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the author, developer, or distributor be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the Software or the use or other dealings in the Software.

Use at Your Own Risk: The user assumes all responsibility and risk for the use of this Software. The author makes no representations or warranties regarding the accuracy, reliability, completeness, or timeliness of the Software or its suitability for any particular purpose.

No Support Obligation: The provision of this Software does not create any obligation to provide technical support, maintenance, updates, enhancements, or modifications. The Software is provided for educational and reference purposes only.

Third-Party Dependencies: This Software may utilize third-party libraries and components. The user is responsible for ensuring compliance with all applicable licenses and terms of use for such dependencies.

Network and Security: The user is solely responsible for implementing appropriate security measures and network configurations. The author is not responsible for any security vulnerabilities, data breaches, or network disruptions that may result from the use of this Software.

Compliance: Users are responsible for ensuring that their use of this Software complies with all applicable laws, regulations, and organizational policies in their jurisdiction.

Limitation of Liability: Under no circumstances shall the total liability of the author exceed zero dollars ($0.00) for any damages arising out of or related to the use of this Software.

By using this Software, you acknowledge that you have read, understood, and agree to be bound by the terms of this disclaimer.