SMS Appliance Tag

Not counted towards your tag license limit.

While VTScada will always attempt to send the text message, there is no guarantee that your the cellular provider will deliver all messages. Use the SMS option of alarm notification with caution.

All SMS Appliance tags work in conjunction with VTScada's Alarm Notification System for sending text messages to a mobile cellular device, and receiving alarm acknowledgment back.

SMS messages are sent and received using an "SMS appliance", which is a cell phone (or "cell modem") tethered to a VTScada workstation via RS-232, Bluetooth, or USB. Any such "cell modem" should conform to ETSI TS 100 585, which is a part of the GSM standard applying to the AT command set for sending and receiving text messages. Devices that use the CDMA standard are not supported.

The SMS Appliance tag handles communications through an SMS appliance. The tag registers with the SMS Manager service as an SMS agent.

Because SMS appliances are usually installed as "modems" under MS Windows™, the configuration of the SMS Appliance tag enables the specification of this modem and the workstation to which the modem is attached. You may also set a security privilege, and if necessary, can mark the modem as disabled.

If running multiple applications (for example, hosted systems) then you cannot share modems, SMS devices, or Twilio accounts between applications. You must have independent modems or Twilio accounts for each application as their settings reside in the application layer.

The SMS Manager takes care of forwarding message requests to any registered SMS agents in a round-robin sequenceClosed The name of the hosting machine. It also provides a publisher for received SMS text messages. Code that subscribes to received messages will get notification of all received text messages. Subscribers are responsible for any filtering of received text messages.

The SMS Appliance tag will re-initialize the appliance once per minute to verify that it is still attached and functioning. Any error will result in a complete reset, which is repeated at a regular interval until the tag is disabled or a functioning device is available.

The SMS Appliance tag will queue messages to send so long as it is operating normally. Received messages are published immediately. If these should be queued, it is the responsibility of the subscriber to do so.

The Semtech AirLink SMS Appliance Tag are available specifically for SMS messages that are sent and received using a Semtech Airlink Router (formerly Sierra Wireless).

Text Encoding for SMS Appliance Tag

In legacy text mode, VTScada uses the T.50 (IRA) character set when sending SMS notifications using the SMS Appliance tag.

Disable SMSApplianceLegacyTextMode (Set to 0) to use enhanced text encoding.

In the enhanced text mode, VTScada uses the GSM 03.38 character set for SMS notifications. If a message contains a character that is not supported by the GSM 03.38 character set, VTScada automatically switches to UCS2 character set (UTF-16) encoding for that message. The UCS2 character set supports a broader range of characters, but each message requires more data to transmit, which may affect message length limits, bandwidth usage, and provider billing.

To avoid switching to the UCS2 character set for commonly used non-GSM characters, use the GSMTextSubstitution property to map unsupported characters to GSM 03.38 character set-compatible alternatives.

For a list of supported characters, refer to the GSM 03.38 specification.

Monitor SMS Appliance tag status

The value of the SMS Appliance tag can be used to monitor the device status. See the value from the tag browser or using any widget that can display a numeric or text value.

Value

Meaning

0 Initializing

1

Connected to cell modem

2

Sending an SMS Message

3

Receiving an SMS message

4

Checking the connection to the cell modem

5

Disabled

6

Workstation with modem is not available

7

Modem unavailable

The SMS Indicator Widget displays a graphic of an active SMS modem. It displays the name of the linked SMS Appliance tag or Semtech AirLink SMS Appliance tag, indicates when a message is being sent or received, displays the number of the device sending the message, and displays some status messages.

SMS Appliance tag error messages

Most error messages associated with SMS come from the network and are not defined in VTScada. For more information about any error message you might see, including those in the alarm history, use an Internet search engine.
CMEClosed Cellular Mobile Equipment errors passed through from the device are equipment-related while CMSClosed Cellular Mobile Switch errors are network-related.

SMS Appliance properties Settings tab

The Settings tab is used to identify the SMS appliance (SMS "modem") that will be used to send and receive messages.

Workstation Name

The name of the computer running the VTScada application, to which the SMS appliance is attached. (You must provide the computer name and not an IP address.) Workstation names must be no longer than 15 characters. Do not leave blank.

Name or Index on Workstation

The named workstation will be checked for devices. If more than one is found, you may select between them using this drop-down list. Names are preferred over index values, because the latter may change.

Privilege

Select a custom security privilege (Protect Pages and Output Tags) from this drop down to limit the operation of this control to only those operators who have been granted the matching security privilege.

In this case, "operation" refers to the ability to disable or enable the tag via the context menu. It does not affect whether SMS messages are sent while a user without the privilege is signed in.

Disable

Select this box to disable the device without removing it or deleting its configuration.

SMS Appliance properties Advanced tab

The fields in the Advanced tab are optional. These need not be set for most configurations and should be used only by developers who are familiar with the configuration of SMS devices.

In rare instances, a device might not use a standard configuration of 9600 baud, etc. Serial port configuration fields are provided for use when working with such a device.

PIN for SIM Card

If required, this will value will be assigned to you by your cellular provider. The password is preconfigured in most SIM cards.

SMS Gateway Number

If required, this number will be provided by your cellular provider. This number is preconfigured in most SIM cards.

Modem Initialization String

You may provide an initialization string, as specified in the user manual for your cell modem. This will be sent to the cell modem at the beginning of each initialization cycle.

In most cases, you do not need to provide this string to the tag.

Baud Rate

Change this field only if your device does not autobaud to 9600.

Data Bits, Stop Bits and Parity

If your device does not autobaud to 9600, you might also need to configure these other serial communication parameters.

Port Number

Use to specify the serial port if that information is not available via the installed drivers. A value set here will override any other port information.

SMS Appliance properties Display tab

When this tag is represented on screen by widgets that can use a Style Settings tag, you can save development time by choosing the Style Settings tag that holds the correct display configuration for this tag instance.

The default configuration will use System Style, the default style tag that is automatically part of every new VTScada application. If a Style Settings tag is an ancestor or else a sibling, it will become the new automatic default.