OperaMetrix
Documentation

SMS Teltonika Module

Complete Module Documentation

Everything you need to install, configure, and use the SMS Teltonika Module with your industrial gateways.

Download ModuleBack to Module

Overview

The SMS Teltonika Module enables on-premise SMS notifications using industrial Teltonika SMS gateways. This documentation covers hardware setup, module installation, and configuration for reliable SMS alerting without cloud dependencies.

Installation

System Requirements

Before installing the SMS Teltonika Module, ensure you have:

  • Ignition Version: 8.0 or higher
  • Teltonika Gateway: TRB140, TRB142, TRB145, RUT240, RUT950, RUTX09, or RUTX11
  • SIM Card: Active SIM with SMS capabilities
  • Network: TCP/IP connectivity between Ignition server and gateway
  • Cellular Coverage: Mobile network coverage at gateway location

Teltonika Gateway Setup

Configure your Teltonika gateway before installing the module:

  1. Power up the gateway and connect to its web interface (default: 192.168.1.1)
  2. Insert SIM card and verify cellular connectivity
  3. Enable SMS API in Services > Mobile Utilities > SMS Gateway
  4. Configure network settings to ensure the gateway is reachable from your Ignition server
  5. Note the gateway IP address - you'll need this for module configuration
  6. Set API credentials if using authentication (recommended)

Installing the Module

Follow these steps to install the SMS Teltonika Module:

  1. Download the module file (.modl) from your OperaMetrix account
  2. Log into your Ignition Gateway
  3. Navigate to Config > System > Modules
  4. Click Install or Upgrade a Module
  5. Select the downloaded .modl file
  6. Accept the license agreement
  7. The module will appear in the modules list once installed

Configuration

Configuring Gateway Connection

Connect the module to your Teltonika gateway:

  1. In Ignition, go to Config > Alarming > Notification
  2. Create a new notification profile of type Teltonika SMS
  3. Configure the connection settings:

Creating a Notification Profile

Configure the notification profile settings:

  1. Name: A descriptive name (e.g., "Plant Floor SMS")
  2. Connection Timeout: Time to wait for gateway response (default: 10 seconds)
  3. Retry Count: Number of retry attempts for failed sends (default: 3)
  4. Retry Delay: Time between retry attempts (default: 5 seconds)
  5. Test Connection: Use the test button to verify connectivity

Message Configuration

Configure SMS message settings:

  • Message Encoding: Use Unicode for international characters, GSM for basic ASCII
  • Max Message Length: 160 characters (GSM) or 70 characters (Unicode) per segment
  • Concatenation: Enable to send longer messages as multiple SMS segments
  • Sender ID: Some networks allow custom sender IDs (check with your carrier)
Example Message Templatetext
ALARM: {name}
Level: {priority}
Value: {eventValue}
Time: {eventTime|dateFormat("dd/MM HH:mm")}

Usage

Adding to Alarm Pipelines

Integrate Teltonika SMS into your alarm notification pipelines:

  1. Open your project in Ignition Designer
  2. Navigate to the Alarm Notification Pipeline
  3. Add a Notification block
  4. Select your Teltonika SMS profile
  5. Configure contact information to return phone numbers in international format
Contact Info Expressionpython
# Return maintenance team phone numbers
def getMaintenanceTeam():
    return [
        "+33612345678",  # Team Lead
        "+33698765432",  # Technician 1
        "+33611223344"   # Technician 2
    ]

Setting Up Redundancy

Configure multiple gateways for high availability:

  1. Create separate notification profiles for each gateway
  2. In your alarm pipeline, use a Fallback block
  3. Configure the primary gateway as the first notification
  4. Configure backup gateway(s) as fallback notifications
  5. Set appropriate timeout values to trigger failover

Scripting Functions

Send SMS programmatically using the module's scripting functions:

Send SMS via Scriptpython
# Send a single SMS via Teltonika gateway
system.teltonika.sendSMS(
    profileName="Plant Floor SMS",
    phoneNumber="+33612345678",
    message="Manual inspection required at Station 5"
)

# Send with custom timeout
system.teltonika.sendSMS(
    profileName="Plant Floor SMS",
    phoneNumber="+33612345678",
    message="Urgent: Temperature exceeds threshold",
    timeout=5000  # 5 second timeout
)

Troubleshooting

Gateway Connection Issues

Problem: Cannot connect to Teltonika gateway

Solutions: 1. Verify the gateway IP address and port are correct 2. Check network connectivity: ping 3. Ensure no firewall is blocking the connection 4. Verify the gateway's SMS API is enabled 5. Check API credentials if authentication is enabled 6. Try accessing the gateway web interface to verify it's responding

SMS Not Being Sent

Problem: SMS messages are queued but not delivered

Solutions: 1. Check SIM card is properly inserted and has credit/plan 2. Verify cellular signal strength on the gateway (check gateway status page) 3. Confirm the phone number format is correct (include country code) 4. Check the gateway's SMS outbox for queued/failed messages 5. Verify the SIM PIN is disabled or correctly configured 6. Test SMS sending from the gateway web interface directly

Network Configuration

Problem: Intermittent connectivity or timeouts

Solutions: 1. Use static IP for the Teltonika gateway 2. Ensure the gateway is on the same VLAN or has proper routing 3. Increase connection timeout in profile settings 4. Check for IP conflicts on your network 5. Consider using a dedicated network for critical infrastructure 6. Monitor gateway uptime and cellular signal quality

Ready to Get Started?

Download the SMS Teltonika Module and enable on-premise SMS alerting for your facility.

Download ModuleContact Support