The device complies with regulations and industrial standards in force in the Czech Republic and
the European Union. The device has been tested and is supplied in working order. To keep the device in this condition, it is necessary to adhere to the following safety and maintenance instructions.
Never remove the device cover if the relay terminals are connected to the electrical network!
Using the device in a manner other than prescribed by the manufacturer may cause its safeguards
to fail!
The power supply outlet or disconnection point must be freely accessible.
The device must not be used in particular under any of the following conditions:
• The device is noticeably damaged
• The device does not function properly
• Unfastened parts can move inside
the device
• The device has been exposed to
moisture or rain
• The device has been serviced by
unauthorized personnel
The manufacturer warrants the device only if it is powered by the supplied power adapter or an
approved power supply.
If you have any problems with installing or operating the device, please contact technical support:
• The power adapter or power supply cable
are noticeably damaged
• If the device is used in a manner other than
designed for, the protection provided by the
device may fail.
• The local electrical system must include
a power switch or a circuit breaker and
overcurrent protection.
Formanská 296
Prague, 149 00
Czech Republic
When contacting technical support, please keep at hand the exact type of your device (at the type plate)
and, if possible, the firmware version (see later in this manual).
2
HWg-SMS-GW3
Safety information
Page 3
Table of contents
Safety information 2
Recommended connection 4
Technical parameters 5
Mechanical parameters 6
Restarting into the default settings (Load to defaults) 6
First start 7
Connecting the cables 7
IP address settings – HWg Config 7
Open the WEB setup of the device 8
WEB interface 9
Home 9
SMS Queue 10
General Setup 11
Time 12
GSM Modem 13
SNMP 14
System 15
Using SensDesk.com service 17
Using SMS gateway with Nagios 19
Installation 19
Nagios settings 20
Using the product with your application 22
Table of contents
HWg-SMS-GW3
Damocles2
3
Page 4
Recommended connection
SMS-GW3 LTE allows sending of alarm SMS messages from any number of connected HW group
devices via a single GSM modem with netGSM.
Poseidon2
4002
SMS-GW3 LTE
IP Watchdog2
Industrial
Setting up SMS-GW3 LTE with devices that support it:
1) Insert a SIM card.
2) Launch HWg Config and get the assigned IP address (DHCP).
3) Try to send a SMS from the web interface.
Ring + SMS
SMS
SMS
4) Enter IP address of the unit SMS-GW3 LTE + port (80 in default).
5) Enter 2× phone number of an SMS messages recipient and try
sending a test SMS.
Note: SMS-GW3 LTE is compatible with the following devices: Damocles2, HWg-PWR, HWg-WLD,
IPWatchdog2, Poseidon2, STE2, WLD2.
4
HWg-SMS-GW3
Recommended connection
Page 5
Technical parameters
Ethernet
InterfaceRJ45 (10BASE-T) – 10 Mbps or 10/100 Mbps network compatible
TypeMain device power input (typically 400 mA + external devices)
Connector
Class 4 (33 dBm
Class 1 (30 dBm
Class E2 (27 dBm
Class E2 (26 dBm
Class 3 (24 dBm +1/-3 dB) for WCDMA bands
Class 3 (23 dBm
1× barrel jack (2.1 mm, outer diameter 5.5 mm)
1× terminal block
+
2 dB) for GSM900
+
2 dB) for DCS1800
+
3 dB) for GSM900 8-PSK
-
+
3 dB) for DCS1800 8-PSK
-
+
2 dB) for LTE FDD bands
-
LED status indicators
PowerGreen – power OK
ModemBlue – activity on GPRS
StatusYellow – blinking if device is OK
AlarmRed – error on device
LINK & ActivityYellow – ethernet connectivity
Physical parameters
Temperature rangeOperating: -10 to 65 °C / Storage: -25 to 85 °C
MTBF> 90 000 hours
Dimensions / Weight92 × 76 × 31 [mm] / 300 g
EMCFCC Part 15, Class B, CE - EN 55022, EN 55024, EN 61000
Technical parameters
HWg-SMS-GW3
Damocles2
5
Page 6
Mechanical parameters
36,3 mm
76,0 mm
31,0 mm
SIM Card
Ethernet
120,0 mm
106,0 mm
92,2 mm
SMS-GW3 LTE
Alarm
Modem
Status
Power
Reset
GSM
Power 9-30V
Restarting into the default settings (Load to defaults)
• Restarting into the default settings via HWg Config – right-click the MAC address of the device in HWg Config. Within the first 60 seconds after powering up the device the factory settings can be restored through HWg Config.
6
HWg-SMS-GW3
Mechanical parameters
Page 7
First start
Connecting the cables
• Note down the MAC address of the device, printed on the side of the unit.
• Connect HWg-SMS-GW to the Ethernet network.
• Plug the power adapter and connect it to a connector on the device.
• Green POWER LED will light up.
• If the connection to Ethernet network is working, LINK LED will light up (orange light on RJ45
connector) and it then flashes during the data transmission (Activity signalisation).
Connectors
• Power – connect the power adapter (9-30 V).
• USB – a connector for service purposes.
• Ethernet – network/data connector.
• GSM SIM – a SIM card socket.
• GSM – an SMA connector for connecting an external antenna.
• Reset – reset button for restoring the factory default settings.
LED indication
• Power (green) – power supply connected.
• Status (yellow) – flashes slowly if the device is working correctly.
• Alarm (red) – device / modem error. Lights up if out of signal, flashes in case of SIM card errors
(incorrect PIN entered, etc.).
• Modem (blue) – flashes during SMS sending.
• Link Activity (yellow LED on the Ethernet connector) – flashes during network activity.
• Link OK (green LED on the Ethernet connector) – light on when connected to Ethernet.
IP address settings – HWg Config
The software HWg-Config can be downloaded from http://www.HW-group.com Software -> HWg-Config.
• Start HWg-Config by clicking on its icon – software will automatically search for connected
devices.
• Search for the devices by clicking the Find Devices icon (Start search).
HWg Config searches for devices in your LAN. Clicking on a MAC address of the device opens
a window with basic network parameters settings.
Network parameters of the device
• DHCP is enabled by default.
• Set IP address / HTTP port (80).
• Set the mask of your network.
• Gateway IP address for the local network.
Save the settings with Apply Changes button.
First start
HWg-SMS-GW3
Damocles2
7
Page 8
Open the WEB setup of the device
Enter IP address of the device directly into an internet browser.
Or open the web setup via HWg-Config. Click the underlined IP address, or through the context
menu (as shown on the picture).
Click
8
HWg-SMS-GW3
First start
Page 9
WEB interface
Home
Base Information
• Device name – User-defined name. This can be set on the General Setup tab.
• Time – Unit time – settings can be changed on the Time tab. Correct time is usually obtained
from an online server.
• Date – Unit date – settings can be changed on the Time tab. Correct date is usually obtained
from an online server.
• Network registration – information on registration of the unit to an operator's GSM network.
• Signal Quality – GSM signal level. This information can be used for resolving network problems.
• Operator Name – name of the operator to which the GSM modem is connected.
SMS Queue
An overview of messages queued for sending. Sent messages are not shown here anymore.
• ID – ID of the outgoing message.
• Phone Number – recipient's phone number.
• Type – message type (SMS or dialing the number).
• Retries – number of unsuccessful retries.
• Message – message text.
WEB interface
HWg-SMS-GW3
Damocles2
9
Page 10
SMS Queue
Displays the queues of incoming and outgoing messages. Messages already sent are not
shown here.
SMS Input Queue
Displays the incoming message queue.
• ID – ID of the incoming message.
• Phone Number – sender's phone number.
• Time – delivery time of the incoming message.
• Message – incoming message text.
• Action – the message can be deleted by pressing Delete.
• Input queue delete all entry – link to delete all queued incoming messages.
SMS Output Queue
Displays the outgoing message queue.
• ID – ID of the outgoing message.
• Phone Number – recipient's phone number.
• Type – message type (SMS or dialing the number).
• Retries – number of unsuccessful retries.
• Message – message text.
10
HWg-SMS-GW3
WEB interface
Page 11
General Setup
Base
• Device Name – Custom-selected name (HWg-SMS-GW3) – helps to distinguish between diffe-
rent SMS-GW3 LTEs in one network.
• WWW Info Text – text of a footer in WWW interface – useful for example for entering data centre
administrator’s contact details.
Network Setup
• DHCP – enables automatic setting of an IP address by a DHCP server, if available – enabling and
disabling this function depends on actual requirements of the network users and administrators.
• IP Address – IP address of the SMS-GW3 LTE – assigned by the network administrator.
• Network Mask – assigned by the network administrator.
• Gateway – IP address of a default gateway – assigned by the network administrator.
• DNS Primary / DNS Secondary – IP address of a DNS server – assigned by the network administrator.
• HTTP Port – port number where the built-in WWW server listens – changing the port number
is necessary for example if more devices are accessible from outside the network through
arouter. Please consult any changes in this setting with your network administrator. Port set
to 80 in default.
WEB interface
HWg-SMS-GW3
Damocles2
11
Page 12
WWW Security
Username / Password – login details used for accessing SMS-GW3 LTE settings.
NetGSM (SOAP) security
Username / Password – username and password for sending text messages over SOAP.
Time
Current Time
• Time – shows actual time.
• Date – shows actual date.
SNTP Setup
• SNTP server address – IP address or a domain address of a time server – in default time.nist.gov.
• Interval – interval of a time synchronisation with a server.
• Summertime – allows DST switching - required for correct logging of the measured values and
events. Necessary for correct data logging.
12
HWg-SMS-GW3
WEB interface
Page 13
• Time Zone – sets the time zone where the SMS-GW3 LTE is located – used for setting the
correct system time. Necessary for correct data logging.
• Synchronize Time – used for an immediate synchronisation with a time server. Can be also used
to test the entered settings.
Time Setup
Time Setup section allows you to enter actual time and date manually, in case you cannot use
the synchronisation with a time server. This information is erased after loosing the power supply.
GSM Modem
Information
• Network registration – information on registration of the unit to an operator's GSM network.
• Signal Quality – GSM signal level. This information can be used for resolving network problems.
• Operator Name – name of the operator to which the GSM modem is connected.
• SMS Service Center Address – information obtained from the SIM card. Used for verifying the com-
munication with the SMS centre
• Number of SMS – number of messages sent.
WEB interface
HWg-SMS-GW3
Damocles2
13
Page 14
• Number of failures SMS – number of unsent messages (invalid phone number etc.).
• Number of Ringout – number of dialed calls.
• Number of failures Ringout – number of unsuccessfully dialed calls (invalid phone number etc.).
Configuration
• SIM PIN – if the SIM is protected with a PIN, enter it here.
• Roaming enable – enables or disables SMS-GW3 operation in roaming. With roaming disabled,
the gateway only works in the home carrier's network; this avoids undesired roaming costs.
Enabled roaming may increase stability e.g. near country borders.
• SMS http GET Enable – enables the sending of SMS over HTTP GET. Using HTTP GET is a security
risk, consider it carefully.
For details, see: https://www.hw-group.com/support/how-to-send-sms-via-hwg-sms-gw3
• Manual network – allows manual selection of the mobile network to use.
Test SMS
• Tel Number – test message recipient's phone number.
• Text – test message text.
• Send SMS Test – button to send a test SMS to the specified phone number.
• Ringout Test – button to try to dial the specified phone number.
SNMP
14
HWg-SMS-GW3
WEB interface
Page 15
General SNMP Settings
• System Name – device name, corresponds with the device name set on the General setup tab.
• System Location – system location, for instance „IT room, 2nd floor“.
• System Contact – system administrator contact details, for instance his email address.
• SNMP port – port settings for communication with SNMP protocol [161].
SNMP Access
Defines authorisation and user group names for work with a Poseidon device.
• Community – text name of the group, to which the rights are assigned to (Public and Private
in default).
• Read – assigns to a community the rights to read the variables over SNMP.
• Write – assigns to a community the rights to write into the variables over SNMP.
• Enable – enables or disables a certain group.
• Show OID keys table – lists all available SNMP OIDs including their use.
System
System tab offers access to main system details such as uptime and firmware version. It also
offers restart options or tools for firmware update.
WEB interface
HWg-SMS-GW3
Damocles2
15
Page 16
Download
• Backup bin configuration – by clicking the link you can save the actual SMS-GW3 LTE configura-
tion and later restore this configuration.
• Backup xml configuration – by clicking the link you can save the actual SMS-GW3 LTE configura-
tion and later restore this configuration.
• Online staus in XML – current device state in XML format.
• SNMP MIB Table – SNMP MIB file – address of a MIB file, containing definition of SNMP variables.
Syslog
Syslog server IP Address – address of the Syslog server.
System
• Product Name – name (type) of the device.
• Serial Number – device's serial number.
• MAC Address – device's MAC address for wired connections.
• Modem IMEI –IMEI address of the modem for GSM connection.
• Version – firmware version. Diagnostic information for troubleshooting.
• Build – assembly diagnostic information for troubleshooting.
• Compile time – firmware compilation time. Diagnostic information for troubleshooting.
• UpTime – uptime since last power-on or reset of the device. Diagnostic information for trouble-
shooting.
• Demo mode – activated demo mode disables changes in configuration of your device. Visitors
can freely browse all pages of the WWW interface in this mode but they cannot make any
changes. The device can be then made available on a public network without any risk of problems with settings.
• Read available version – displays the latest firmware version available at the HW group upgrade
server.
• Start Network Upgrade – initiates firmware upgrade from the HW group upgrade server.
• Upload Firmware or Configuration – allows users to upload new firmware or a configuration file.
Uploaded configuration may not be compatible in case the difference between firmware releases is too large.
Factory Default
Restores the factory default settings. The default IP address is 192.168.10.20 and both login
and password are not set.
System Restart
Resets the device.
16
HWg-SMS-GW3
WEB interface
Page 17
Using SensDesk.com service
SensDesk.com service is an online portal for HW group IP sensors monitoring.
SensDesk.com can send email notifications in case an alarm is detected. SMS-GW3 LTE can be
used for sending SMS notifications.
1
Set IP address of your HWg-SMS-GW in the account settings:
SensDesk.com: My Account >> Edit
Using SensDesk.com service
HWg-SMS-GW3
Damocles2
17
Page 18
2
Set the recipient phone number for each single sensor, for sending alarm SMS messages from:
SensDesk.com: Sensors >> Edit
Note: SMS-GW3 LTE must be accessible on a public IP address in order to send SMS alarms from your
SensDesk.com account.
18
HWg-SMS-GW3
Using SensDesk.com service
Page 19
Using SMS gateway with Nagios
Sending notifications from Nagios using SMS gateway SMS-GW3 LTE.
A plug-in for SMS-GW3 LTE, created in cooperation with Netways, allows sendong SMS
messages from Nagios system.
SMS
Plugin config
SMS-GW3 LTE
SMS
Nagios plug-in notify-poseidon-sms.pl takes notifications about changes on the monitored devices and transfers them via HTTP protocol to HWg-SMS-GW, which then sends an SMS message.
Installation
The following steps are based on standard Ubuntu server installation process Some folders or
commands can vary due to different Linux distribution used.
1
Download the notify-poseidon-sms.pl plug-in from https://www.netways.org/projects/plugins/files
do adresáře /usr/lib/nagios and set the setup rights.
nagios-server:~# cd /usr/lib/nagios
nagios-server:~# wget https://www.netways.org/attachments/download/262/notify-poseidon-sms.pl
nagios-server:~# chmod a+x notify-poseidon-sms.pl
Using SMS gateway with Nagios
HWg-SMS-GW3
Damocles2
19
Page 20
2
Send a test SMS to verify the functions of the plug-in and SMS-GW3 LTE. Parametr -H specifies
an IP address of the SMS-GW3 LTE device designated for sending the SMS messages. Enter
the recipients phone number for receiving the message using the -D parameter.
In case the plug-in start fails and an error message shows Can't locate LWP.pm, it is necessary
to install a Perl module LWP for HTTP protocol support. This can be done on Ubuntu or Debian
by a command:
Note: The whole command_line definition text has to be in one line in order to work correctly.
Note, do not forget to change the -H parameter to an actual IP address (eventually to a DNS name)
of your HWg-SMS-GW device.
SMS text is assembled by the -M parameter. A list of supported variables (macros) can be found
on http://nagios.sourceforge.net/docs/3_0/macrolist.html
2
Define contacts and contact groups for SMS messaging in a file:
/etc/nagios3/conf.d/contacts_nagios.cfg.
20
HWg-SMS-GW3
Using SMS gateway with Nagios
Page 21
define contact {
contact_name
alias
service_notification_period
host_notification_period
service_notification_options
host_notification_options
service_notification_commands
host_notification_commands
pager
Note: In case you want to send notifications to multiple phone numbers, create a contact for every
phone number and enter each contact into a memebers parameters in a contactgroup (divided with , ).
In case you are using a standard Nagios configuration and want to add SMS sending for all devices and services, do not create a contactgroup and add only peter-gsm to the admins group.
The setup is then complete and the notifications will be sent also via SMS after restarting the
Nagios service (points 3 and 4).
define contactgroup {
contactgroup_name
alias
members
admins
Nagios Administrators
root, peter-gsm
}
Using SMS gateway with Nagios
HWg-SMS-GW3
Damocles2
21
Page 22
3
Adding SMS notification options to selected sevices and services can be done in their
definition, by adding a contact_groups parameter, for example:
define host {
use
host_name
alias
address
contact_groups
generic-host
localhost
localhost
127.0.0.1
admins,sms
}
define service {
use
host_name
service_description
check_command
}
contact_groups
generic-service
localhost
Disk Space
check_all_disks!20%!10%
admins,sms
Note: Contacts are usually defined in the device's or service's templates, adding contact_groups parameters
will rewrite the pre-set template. This example is based in a standard settings of an admins contact group,
which uses e-mails for sending notifications. Only SMS messages will be sent after adding "contact_groups
sms" parameter.
4
A restart of Nagios needed to activate the changes.
nagios-server:~# service nagios3 restart
Using the product with your application
HWg-SMS-GW communicates over LAN via a netGSM protocol built on HTTP.
In case you want to use this product with your application, use the HWg-SDK
(Software Development Kit). The SDK kit cotnains commented examples of
the source codes for various programming languages.