Creating and Configuring Serial Modem
Scenario: You want to configure the Serial Modem device.
Reference: For background information, see the reference section.
Workflow diagram:
Prerequisites:
- Perle device and GSM Terminal device are installed and configured.
- Certificate is created from System Management Console.
- System Manager is in Engineering mode.
- System Browser is in Management View.
Steps:
1 – Create and Start a GSM Modem Driver
- Depending on where to add the driver, select one of the following:
- Project > Management System > Servers > Main Server > Drivers
- Project > Management System > FEPs > [FEP Station] > Drivers
- In the Object Configurator tab, click New and select New GSM Modem Driver.
- In the New object dialog box, enter a unique name and description.
- Click OK.
- GSM Modem Driver displays in the System Browser below the Drivers node and is selected.
- In the Operation tab, navigate to the Driver Status property and click Start.
- The GSM Modem driver is created and started.
2 – Configure a GSM Modem Driver
- In the System Browser, select the GSM Modem driver and click the Driver Editor tab.
- (Optional) In the Driver Settings expander.
- In the Configuration Properties expander, proceed as follows:
- In the Device Request Timeout field, enter 10000 (value in milliseconds).
- In the Check Status Rate field, enter 30000 (value in milliseconds).
- In the Notification Integration expander, proceed as follows:
- In the Batch Size field, set the value as 10 (default is 100). Batch size specifies the size in which the request is processed by the driver. The batch size displays the number of devices to which Notification interacts in one instant. For example, if there are 100 devices on which a message has to be displayed and a batch size of 10 is entered, Notification will send the message to batches of 10 devices each.
- Enter a value into the Expected delivery time field (default is 5 seconds).
NOTE: Notification does not guarantee the message delivery will be completed within the time entered in the Expected delivery Time field. This value is solely used to compute delivery statistics indicating whether message delivery to the GSM Modem server was on-time or late.
On-Time or Late displays are based on the time it takes for Notification to deliver the message to the GSM Modem server. Not the time it takes to deliver the message to the actual recipient.
- Enter a value into the Input Messages Polling Interval field (default is 5 seconds).
- In the Acknowledgment reply action field, specify the optional action text to be appended with the notification message in different languages. Recipient users can acknowledge these messages using the id that is generated and displays along with the notification text. For example, to send the following notification message to an English user, "Fire in Second Floor, Room 203" and seek confirmation, enter the following text in the en-US field in the Acknowledgement reply action field "Reply {} to acknowledge and confirm.". In this case, the recipient will receive the following message, “Fire in Second Floor, Room 203. Reply XXX to acknowledge and confirm”. The {} is replaced with a numeric Reply ID. The recipient can send an acknowledgement to the received message using the reply id. In order to generate a reply ID for the corresponding message, ensure that the Acknowledgement reply action field has any one of the following characters within the curly braces, {}, {id}, {ID}, or {0}. For example, Reply {}, Respond {id}. If you do not specify any text in the Acknowledgment reply action field, then the text "Reply with {id}" is appended to the notification message and sent to the receiver. {id} is replaced with a numeric id.
- Click Save .
- The parameters are configured for the GSM Modem driver.
NOTE: In any of the following scenarios, it is recommended to restart the driver manually from GSM driver:
a. After changing GSM serial modem configuration when GSM driver is running.
b. After correcting the incorrect serial modem configuration on GSM serial modem snap-in.
3 – Create a GSM Modem Field Network
- Select Project > Field Networks.
- The Object Configurator tab displays in the Primary pane.
- Click New and select New GSM Modem Field Network.
- In the New Object dialog box, enter a name and description.
- Click OK.
- The GSM Modem Field Network node displays under the Field Networks node.
- The GSM Modem driver is automatically associated to the field network. In the Network Editor tab, under the Network Settings expander, you can see that the values are preselected, and the driver is already assigned.
NOTE 1: In case you are using Cinteron device as a GSM device, add key <STORAGE_USE> with value <MT> in the WCCOAGSMGtwDrv.exe.config file located at [installation drive:]\[installation folder]\[project]\bin.
NOTE 2: In case you are using SmartStart device as a GSM device, add key <STORAGE_USE> with value <SM> in the WCCOAGSMGtwDrv.exe.config file located at [installation drive:]\[installation folder]\[project]\bin.
4 – Create a Serial Modem Device
- Select Project > Field Networks > GSM Modem Field Network.
- Click the Network Editor tab.
- Click Create .
- In the New object dialog box, select the child type Serial Gateway Device and then enter a name and description.
- Click OK.
- In the Device Editor tab that displays, proceed as follows:
- In the Device Settings expander, enter a description.
- In the Configuration Properties expander, proceed as follows (For more information refer to the GSM Modem Device section in Notification Supported HW/SW Device Configurations Guide):
- In the Serial Port Number field, enter the valid COM port address of the device, with the format COM [unsigned integer number], for example, COM101.
- (Optional) Enter a value into the SIM PIN Code field.
Three incorrect SIM PIN code attempts lead to SIM block.
The SIM PUK is required to unblock it.
NOTE: You must contact the carrier (service provider) that issued the SIM card to obtain the PUK code.
- From the Device Mode drop-down list, select Operational so that the driver processes the messaging command and the device configuration change command, and performs status checks for the device. You can also select:
- Disabled: In this mode, the driver does not process the messaging command, or the device configuration change command, and can perform status checks for the device. The device remains in a disconnected state.
- Administrative: In this mode, the driver processes the device configuration change command and performs status checks for the device. The device will be in a Disconnected/Connected state based on the connection state.
- Select the type of Device Type that must be integrated.
- From the Modality drop-down list, select the type of delivery that can be performed by the device, for example, SMS.
- From the drop-down list, select the Baud Rate the device is using serially.
- From the drop-down list, select the Parity used by the device is.
- From the drop-down list, select the number of Stop Bits the device serial protocol is using.
- Select the number of Data Bits the device is using to communicate serially. The value range is 5 to 8 bits.
- Select the type of Flow Control mechanism used by the GSM Modem device.
- In the Test SMS Connection expander, you can send a test text message.
- Enter the phone number in the Phone number field.
- Enter the text message to be sent in the Message field.
- Click Send to send the test message.
- The sending result is displayed in the expander after the message is sent.
NOTE: While test SMS connection, set device mode as disabled for the remaining Serial and IP modems.
- Open the Routing Configuration expander and configure the parameters (see Routing Configuration Expander).
- Click Save .
- The user device type is automatically configured. In the Recipient Editor tab, under the User Device Types expander, you can see that the GSM Gateway Driver is set as the handling driver and modality is set as SMS.
5 – Configure Recipient User Devices
- You have added one or more users as Recipient Users.
- In the Recipient User Devices dialog box, from the Type drop-down list, select Personal Mobile Phone or Work Mobile Phone as a recipient device for the corresponding recipient user.
- In the Address field, enter the mobile number.
NOTE 1: In order to use message reply and escalation functionality, the mobile number configured in the recipient user device must have the following number format:
+[country code][number]. For example, +17327572923.
NOTE 2: The driver ignores all special characters in recipient user telephone numbers, such as (, ), -, /, and so on, except for a leading + sign that indicates an international number format.
- From the Preferred Delivery Method drop-down list, select SMS.
- Click OK.
- Associate the recipient with the message template (notification template).
- Associate the notification template with the incident template and initiate incidents.
- Once the incident is initiated, the recipient user in the message template (notification template) receives an SMS message with the content as described in the corresponding message template.
- For message templates with acknowledgment option, the recipient replies are collected by the Notification system.
- The recipients reply as per the configuration details in the Acknowledgment Reply Action field of the Notification Integration section of the GSM Modem driver.
Based on the recipients' replies, the appropriate status (Acknowledged
orNot Acknowledged
) displays in the Message Status section of the Browse snap-in.