ICX35-HWC: User Manual
ICX35-HWC: User Manual
ICX35-HWC: User Manual
USER MANUAL
Your Feedback Please
We always want you to feel that you made the right decision to use our products. If you have suggestions, comments,
compliments or complaints about our products, documentation, or support, please write or call us.
ProSoft Technology®, is a registered copyright of ProSoft Technology, Inc. All other brand or product names are or
may be trademarks of, and are used to identify products and services of, their respective owners.
Content Disclaimer
This documentation is not intended as a substitute for and is not to be used for determining suitability or reliability of
these products for specific user applications. It is the duty of any such user or integrator to perform the appropriate
and complete risk analysis, evaluation and testing of the products with respect to the relevant specific application or
use thereof. Neither ProSoft Technology nor any of its affiliates or subsidiaries shall be responsible or liable for
misuse of the information contained herein. Information in this document including illustrations, specifications and
dimensions may contain technical inaccuracies or typographical errors. ProSoft Technology makes no warranty or
representation as to its accuracy and assumes no liability for and reserves the right to correct such inaccuracies or
errors at any time without notice. If you have any suggestions for improvements or amendments or have found errors
in this publication, please notify us.
No part of this document may be reproduced in any form or by any means, electronic or mechanical, including
photocopying, without express written permission of ProSoft Technology. All pertinent state, regional, and local safety
regulations must be observed when installing and using this product. For reasons of safety and to help ensure
compliance with documented system data, only the manufacturer should perform repairs to components. When
devices are used for applications with technical safety requirements, the relevant instructions must be followed.
Failure to use ProSoft Technology software or approved software with our hardware products may result in injury,
harm, or improper operating results. Failure to observe this information can result in injury or equipment damage.
WARNING – EXPLOSION HAZARD – DO NOT DISCONNECT EQUIPMENT WHILE THE CIRCUIT IS LIVE OR
UNLESS THE AREA IS KNOWN TO BE FREE OF IGNITABLE CONCENTRATIONS.
WARNING – EXPLOSION HAZARD – SUBSTITUTION OF ANY COMPONENT MAY IMPAIR SUITABILITY FOR
CLASS I, DIVISION 2.
INSTRUCTIONS D'INSTALLATION:
CET APPAREIL EST UN DISPOSITIF DE TYPE OUVERT ET EST DESTINÉ A ETRE INSTALLÉ DANS UN
ENVIRONNEMENT ADAPTÉ AFIN QUE L'ÉQUIPEMENT SOIT ACCESSIBLE UNIQUEMENT AVEC
L'UTILISATION D'UN OUTIL.
Do not operate the ProSoft Technology Wireless products in areas where blasting is in progress, where explosive
atmospheres may be present, near medical equipment, near life support equipment, or any equipment which may be
susceptible to any form of radio interference. In such areas, the ProSoft Technology Wireless products MUST BE
POWERED OFF. The ProSoft Technology Wireless products can transmit signals that could interfere with this
equipment.
Do not operate the ProSoft Technology Wireless products in any aircraft, whether the aircraft is on the ground or in
flight. In aircraft, the ProSoft Technology Wireless products MUST BE POWERED OFF. When operating, the ProSoft
Technology Wireless products can transmit signals that could interfere with various onboard systems.
Note: Some airlines may permit the use of cellular phones while the aircraft is on the ground and the door is open.
The ICX35-HWC may be used at this time.
The driver or operator of any vehicle should not operate the ProSoft Technology Wireless products while in control of
a vehicle. Doing so will detract from the driver or operator's control and operation of that vehicle. In some states and
provinces, operating such communications devices while in control of a vehicle is an offense.
Page 3 of 131
Table of Contents
1 Start Here ................................................................................................................ 7
1.1 About the ICX35-HWC Industrial Cellular Gateway ............................................................. 7
1.1.1 Specifications ................................................................................................................... 8
1.2 Package Contents ................................................................................................................ 9
1.3 Jumpers ................................................................................................................................ 9
1.4 Reset (Power Cycle) Button ............................................................................................... 10
1.5 Power Requirements .......................................................................................................... 11
Page 4 of 131
6.1.2 Ethernet Bridge Network Setup ..................................................................................... 87
6.2 Importing the AOI................................................................................................................ 89
6.3 EtherNet/IP and SMS Text Message Features .................................................................. 91
6.3.1 ICX35-HWC Diagnostic Data Retrieval ......................................................................... 91
6.3.2 ICX35-HWC Diagnostic Counter Reset ......................................................................... 93
6.3.3 Sending SMS Text Messages from the ICX35-HWC .................................................... 94
6.3.4 Retrieving SMS Text Messages from the ICX35-HWC ................................................. 96
6.3.5 Clearing SMS Text Messages from the ICX35-HWC .................................................... 98
6.3.6 Rebooting the ICX35-HWC............................................................................................ 98
Page 5 of 131
11 Cellular Technology Definitions ........................................................................ 129
12 Support, Service & Warranty ............................................................................. 131
12.1 Contacting Technical Support ....................................................................................... 131
12.2 Warranty Information .................................................................................................... 131
Page 6 of 131
1 Start Here
1.1 About the ICX35-HWC Industrial Cellular Gateway
The ICX35-HWC Industrial Cellular Gateway provides secure wireless Ethernet and serial
connectivity to remote devices over 4G LTE cellular services with fallback to 3G. These devices
include PAC/PLCs, RTUs, DCS systems, instruments, electronic billboards and communication
towers.
The ICX35-HWC is ideal for programming and maintenance of remote equipment, remote data
collection, SCADA, and machine-to-machine (M2M) applications. It operates on LTE/GSM and
CDMA networks with a single device.
Page 7 of 131
1.1.1 Specifications
Cellular Modem
Specification Description
Cellular Technology LTE, GSM, UMTS/HSPA+, GPRS, EDGE, CDMA
Frequency/Bands
ICX35-HWC-A:
Frequency: 700 / 800 / 850 / 900 / 1700 / 1800 / 1900 / 2100 MHz
HSPA and HSPA+ Bands: 1,2,4,5,8
LTE Bands: 2,4,5,13,17,25
Quad-band EDGE/GPRS/GSM
CDMA/EVDO Bands: BC0, BC1, BC10
ICX35-HWC-E:
Frequency: 800 / 850 / 900 / 1800 / 1900 / 2100 / 2600 MHz
HSPA and HSPA+ Bands: 1,2,5,8
LTE Bands: 1,3,7,8,20
Quad-band EDGE/GPRS/GSM
Max Downlink Speeds Up to 100 Mbps maximum (network dependent)
Max Uplink Speeds Up to 50 Mbps maximum (network dependent)
Activation SIM Slot
Security OpenVPN client, IPSec client, IP Address Filtering
Physical
Specification Description
Enclosure Extruded aluminum with DIN clip
Dimensions (H x W x D) 5.52 x 2.06 x 4.37 in, 14.01 x 5.24 x 11.09 cm
Shock IEC 60068-2-27; 20G @ 11ms (Operational)
IEC 60068-2-27; 30G @ 11ms (Non-Operational)
Vibration IEC 60068-2-6; 10G, 10 to 150 Hz
Ethernet Port (1) 10/100 Base-T, RJ45 connector
Serial Port (1) DB9 female (serial tunneling & encapsulation)
Antenna Ports (2) Female RP-SMA connector. Antennas sold separately
Weight 14.5 oz (411 g)
Enclosure Extruded aluminum with DIN clip
Environmental
Specification Description
Operating Temperature IEC 60068 -40°F to +158°F (-40°C to +70°C)
Humidity IEC 60068-30 5% to 95%, with no condensation
External Power 10 to 30 VDC
Peak Power Consumption < 6W
Page 8 of 131
1.2 Package Contents
The following components are included with the ICX35-HWC and are required for installation
and configuration.
Important: Before beginning the installation, please verify all of the following items are present.
Qty. Part Name Part Number Part Description
1 ICX35-HWC Cellular Gateway ICX35-HWC 3G/4G LTE
1 2-pin Power Connector 002-0116 Power Connector
1 Connector Lever 357-0061 Wire installation tool
1 Jumper for rear pins 357-1517 Two-pin jumper
If any of these components are missing, please contact ProSoft Technology Support for
replacement parts.
1.3 Jumpers
The three jumpers on the back of the unit are described from top to bottom:
Jumper Position Description
(Not visible) Factory Use Only
The jumper should be kept on until the unit boots and becomes accessible. It remains at
this address as long as the jumper is in place, regardless of the LAN IP address
configured on the web server.
The ICX35-HWC reverts to the configured server address once the jumper is removed.
Resets the ICX35-HWC to factory defaults.
The jumper should be kept until all the LEDs start to slowly blink. At this point, the
jumper should be removed and the unit should be power cycled. After doing so, the front
panel LEDs blink continuously, but the unit will not operate any further. Remove this
jumper and power cycle the device to restore normal operations with factory defaults.
Page 9 of 131
1.4 Reset (Power Cycle) Button
The reset button is located at the bottom of the front panel of the ICX35-HWC.
Page 10 of 131
1.5 Power Requirements
The ICX35-HWC accepts voltages between 10 and 30 VDC, with an average power draw of 3
watts or less.
A detachable power connector comes with the radio, as shown below. The connector terminals
are labeled + (positive DC connection) and - (DC ground connection).
Important: When wiring the power connector supplied with the radio, be sure to observe the
proper polarity markings on the power connector. Wiring the connector incorrectly can cause
serious damage to the radio which will not be covered under the ProSoft warranty.
The Power Connector (ProSoft part number 002-0116) is shown on the left. Note the + and –
polarity markings. The connector lever (ProSoft part number 357-0061) shown on the right is
helpful for installing wires into the spring-loaded contacts inside power connector.
Note: The onsite chassis/earth connection derived from the AC side of the main system power
supply should not be connected to either negative or any other power terminal of ICX35-HWC.
Page 11 of 131
To use the connector lever, insert it into the connector as shown:
Press down on the installation tool to use it as a lever to open the connector’s contacts to insert
a wire. A properly-wired power connector is shown:
Page 12 of 131
2 Connecting to the ICX35-HWC
The configuration webpage is used to configure and manage the ICX35-HWC. First-time setup
must be performed over a wired network, where provider-specific cellular configuration details
are configured. Once initially set up, you can access the webserver over the LAN and cellular
networks (unless LAN access is disabled).
Key benefits of the web-based configurator include:
Note: For the initial or default ICX35-HWC login, after the default username and
password are used, the user will be prompted to change the password.
Page 13 of 131
The new password must comply with the following rules:
Password field must have between 8-40 characters.
Password must contain characters from three of the following four categories:
* Uppercase characters
* Lowercase characters
* Base 10 digits (0 through 9)
* Non-alphanumeric characters: .~`!@#$%^*()-+={}:?_
Note: After successful login with the new password, further password changes can only
be done from the Administrator > Access Control webpage.
Page 14 of 131
7. After successful login, the homepage displays data from the Status tab.
Page 15 of 131
2.2 Assigning a LAN IP Address
1. Select the Configuration tab and then select BASIC.
a) If YES, enable the DHCP SERVER option and select a DHCP Range of IP addresses
applicable to multiple end devices.
Page 16 of 131
• DHCP Range – This allows you to enter a range of IP addresses that can be addressed.
For example, if you have a number of devices connected to a remote ICX35-HWC, you
can enter the DHCP range to use on devices connected to the remote ICX35-HWC.
• Lease Time – Enter the desired lease time using seconds, minutes, or hours.
b) For each End Device, set the TCP/IPv4 properties (Found at Control Panel / Network
and Internet / Network Connections) as follows:
Page 17 of 131
7. In the ICX35-HWC configuration webpage, click APPLY. The page automatically redirects
to the new IP address if the IP address is changed.
8. Reset your PC back to its original IP address. This IP address should be on the same
subnet as the ICX35-HWC.
9. Close your browser and open a new session. Enter the new IP address of the ICX35-
HWC to access the configuration webpage. Add :8080 to specify the correct port
(192.168.0.250:8080).
Page 18 of 131
2.3 Connecting to Your Cellular Provider
The ICX35-HWC supports 3G GSM/GPRS and 4G LTE (where applicable) networks. It uses
your cellular provider as an ISP (Internet Service Provider) to connect to the Internet. All cellular
service connections require a Subscriber Identity Module (SIM) to be installed in the ICX35-
HWC. This includes connections to CDMA based services like Verizon (previously did not
require a SIM). Contact your service provider to obtain a SIM.
The SIM card slot is located on the front of the cellular gateway.
Page 19 of 131
1. Remove the SIM Card Slot cover by removing the two screws holding it into place.
2. Insert the SIM card (size 2FF, Mini-SIM) into the ICX35-HWC and cycle power. The SIM
card is read by the ICX35-HWC upon boot up.
3. Re-attach the SIM Card Slot cover.
4. Enter the APN (Access Point Name) in the Configuration > Basic, Gateway Settings.
The APN is provided by your cellular provider.
5. After the ICX35-HWC reboots, it establishes a link to your cellular provider network, also
called registering on the network, and then receives an IP address.
6. When the ICX35-HWC receives its IP address from the cellular provider, a connection to
the Internet or the cellular network is also available for computers or other devices to
connect directly to the ICX35-HWC.
7. The GSM network information is now displayed on the Status webpage.
Page 20 of 131
2.3.2 Connection Using CDMA
1. When the ICX35-HWC is powered on, it automatically searches for cellular service using
CDMA-based cellular technology.
2. The ICX35-HWC establishes a PPP (Point-to-Point Protocol or "dial" up connection) link
to the cellular network, also called registering on the network, and receives an IP address.
3. When the ICX35-HWC has received its IP address from the cellular provider, a
connection to the Internet or the cellular network is also available for computers or other
devices to connect directly to the ICX35-HWC.
4. The CDMA network information is now displayed on the Status webpage.
Page 21 of 131
2.3.4 SIM Card PIN Verification
The SIM Card PIN Verification enables the ICX35-HWC’s non-emergency functions. By default,
this feature is not enabled. The following steps show how to enable (and disable) this feature:
3. Enter a 4 to 8 digit PIN Code. You can display the digits by clicking the Show Characters
box.
4. You can save the PIN code in the configuration in an encrypted format by clicking the
Save PIN box.
Page 22 of 131
6. When successful, the following message displays:
7. To disable this feature, select Disable from step 2 above and continue through the steps.
Important: If the wrong PIN Code is entered and submitted more than three times, the
SIM card becomes blocked. (Notice the number of Remaining tries in the top right corner
of the SIM Settings area). The SIM card can be unblocked by entering a PUK code,
provided by the service provider (Example: AT&T). The next section discusses the
unblocking process.
When the SIM card is blocked, you will not be able to access the ICX35-HWC
configuration webpage via the WAN connection. You can connect via the LAN (Ethernet)
port until the SIM card is unblocked.
Page 23 of 131
2.3.5 Unblocking a SIM Card
If the wrong PIN Code is entered more than three times, the SIM card becomes blocked. During
this time, ICX35-HWC WAN (cellular) connectivity is disabled. The SIM PIN status shows “SIM
Blocked” on the Status > System Status webpage (WAN section). You can unblock it by
entering the PUK code assigned to the SIM card by your service operator.
1. To unblock the SIM card, click the Unblock link from the Status > System Status
webpage (WAN section).
Page 24 of 131
2. The link takes you to the Configuration > Basic webpage (SIM Settings section).
3. Contact your service provider to provide you with the PUK code. You will need the phone
number that is assigned to the SIM card.
Important: It is recommended to keep the PUK written down in a safe place from the
device. Entering an incorrect PUK code ten times in a row will permanently lock the SIM
card, requiring a new one.
4. Once you obtain the PUK code, enter the PUK Code and a New PIN Code.
5. Click Apply.
Page 25 of 131
6. Upon success, the following message is displayed:
7. The SIM Status is now Unlocked. PIN Verification can be enabled, as needed.
Page 26 of 131
2.4 Connecting to the Internet Using the ICX35-HWC
Internet connectivity through the ICX35-HWC is achieved using the following steps:
1. Connect the laptop LAN port to the Ethernet port on the ICX35-HWC.
2. On the laptop, set the TCP/IPv4 properties as follows:
Where:
• IP address = The assigned IP address of your laptop.
• Default gateway = The assigned IP address of the ICX35-HWC IP.
• Preferred DNS Server = 8.8.8.8 (Google)
• Alternate DNS Server = 8.8.4.4 (Google alternate)
3. Click OK.
4. Open your web browser on your laptop to connect to the internet.
Page 27 of 131
3 ICX35-HWC Webpage
There are three main tabs of the ICX35-HWC webpages:
Status
Configuration
Administrator
Page 29 of 131
3.2 Configuration Tab
3.2.1 Basic
The Configuration > Basic tab allows you to configure the Module and LAN settings.
Gateway Settings
Parameter Description
Module Name Name of ICX35-HWC on network
APN Access Point Name of the network path for cellular connectivity. This name is assigned
by your cellular network provider.
LAN Settings
Parameter Description
Mode Select Static or DHCP
IP Address IP address of the ICX35-HWC Ethernet port
Subnet Mask Subnet mask of the ICX35-HWC Ethernet port
DHCP Server Enables/Disables DHCP functionality
DHCP Range Used when DHCP Server is enabled. DHCP range of end devices
Lease Time Used when DHCP Server is enabled. Enter the lease time using seconds, minutes, or
hours. This setting depends on your cellular plan.
Static Lease Table Used when a list of specific clients, identified by their MAC addresses, need to be
reserved specific IP addresses. Add one static lease per client.
SIM Settings
Parameter Description
SIM Status Current state of SIM card. For more information, see SIM Card PIN Verification.
Unlocked – The ICX35-HWC’s non-emergency functions are enabled.
Locked – The non-emergency cellular functions are disabled and you must enter the
PIN Verification to enable them.
PIN Verification A 4 to 8 digit PIN used to unlock the non-emergency cellular functions of the SIM card.
Page 30 of 131
3.2.2 Advanced
The Configuration > Advanced tab allows you to configure the following:
Cellular Interface
Cellular Usage Tracking
DDNS
VPN
Serial / Encapsulation
NTP – Network Time Protocol
EIP – EtherNet/IP
Modbus TCP Agent
Connection Recovery
Page 31 of 131
Cellular Interface
Parameter Description
User Name (Optional) User Name for the connection
Password (Optional) Password for connection
Wait Between Reconnect The number of seconds to wait before trying to establish a reconnect. If this is set to
'0', the auto connection is disabled.
Authentication CHAP - Challenge Handshake Authentication Protocol
PAP - Password Authentication Protocol
PAP & CHAP - A mix of both methods
Roaming This setting prevents the device from connecting to a non-native network, helping to
prevent additional charges.
Keep Alive If enabled (0 denoting Disabled), this parameter sets the keep alive ping period time in
seconds. When Enabled, the two fields listed below appear.
Keep Alive Ping Address Time to keep a connected address connection alive
Keep Alive Ping Period Number of seconds to ping to ping address in order to keep a connection between a
cell tower and a module alive
Cellular Interface Disabling this parameter allows the ICX35-HWC to access the internet, including
ProSoft Connect through the LAN interface. This would disable the ICX35-HWC WAN
interface. SMS will still be available.
Note: Disabling Cellular Internet Access will enable internet access through the LAN
interface. The following features will be disabled:
LAN DHCP ServerOpenVPN
IPsec
Pass Through (End Device Address parameter is cleared)
Port Forwarding (All existing rules are cleared)
Note: Excluding the Keep Alive parameter, the ICX35-HWC reboots when updating other WAN
parameters (by clicking Apply).
Page 32 of 131
Cellular Usage Tracking
Note: The Cellular Usage Tracking feature is not an official value of the usage a carrier reports.
Due to possible differences in these values, cellular usage tracking should be used as an aid for
gauging how much data the system is using over a period rather than as a reliable method to
determine billing costs.
Parameter Description
Data Plan Limit Specifies whether or not the cellular data storage usage tracking feature is
enabled.
Plan Start Day Specifies the day of the month (1 to 28) that the data plan begins. For
example, AT&T service in the USA is billed from the 19th of the month through
the 18th of the following month. This is the day that the Usage Value Counter
resets on.
Plan Size Maximum number of megabytes (MB) or gigabytes (GB) of WAN data usage
before 3G communications are shut down until the next plan start day. You
can also choose Unlimited. It provides a visual status of how much data is
being used.
Stop Data After Plan Limit Reached Specifies whether or not the ICX35-HWC will voluntarily deactivate cellular
data if it reaches its data plan limit. You can select Disabled or Enabled.
If you select Disabled, the ICX35-HWC will attempt to transfer data even if the
Plan Size is exceeded, but the cellular data service provider may halt data,
reduce the data rate, or charge additional fees. A 10% buffer is automatically
used to help prevent data overages because the gateway usage number isn't
instantaneously updated and it may be possible that some amount of byte
count loss occurs due to a device reset.
If you select Enabled, the ICX35-HWC stops transferring data after the Plan
(size) limit is reached.
Page 33 of 131
DDNS
Dynamic DNS (DDNS) is a method of mapping WAN IP addresses that are assigned to a
domain name.
Parameter Description
Active This parameter specifies if dynamic DNS is disabled or to which provider it will update
information. (Disabled, DynDNS.org, No-IP.com)
Important: For providers like DynDNS.org, the Time to Live (TTL) value may affect how
long it takes an ICX35-HWC to see a change in IP address (for example, the IP address
changes because of a reboot). It may take the ICX35-HWC upwards of 30 minutes to see
the new address.
DDNS Server System name for DDNS service.
ICX35 Domain Name Specifies the domain that is updated with this gateway's current IP address.
User If the dynamic DNS provider requires a username, this parameter specifies what name is
sent to authorize the dynamic DNS transaction.
Password If the dynamic DNS provider requires a password, this parameter specifies the password
that is sent to authorize the dynamic DNS transaction.
Page 34 of 131
VPN
The Client drop-down list includes the following options:
Disable
OpenVPN
IPSec
OpenVPN
The Virtual Private Network (VPN) Tunnel allows you to access a private local network through
the ICX35-HWC.
If you select OpenVPN from the Client drop-down list, the following additional parameters
appear:
OpenVPN is an open source software application that implements virtual private network (VPN)
techniques for creating secure point-to-point or site-to-site connections in routed or bridged
configurations and remote access facilities. It uses a custom security protocol that utilizes
SSL/TLS for key exchange.
This document assumes you have access to a running OpenVPN server to generate the
required certificates and to authenticate through. Chapter 9 provides details on using OpenVPN.
Note: When applying new configuration parameters, adding or removing a server configuration,
all the existing connections will be recreated.
Page 35 of 131
Parameter Description
Default Gateway Interface to be used as a default gateway. By default, it is set to Cellular interface. It can
also be set to pass the traffic through one of the configured tunnels - OpenVPN Server
1.
Select the OpenVPN The OpenVPN Server instance that is being configured.
Server to be configured
TLS Renegotiation Time Transport layer Security renegotiation time in seconds. This controls how often the
underlying SSL/TLS session renegotiates. This provides additional security by frequently
rekeying the session keys. This is set to 3600 by default.
Server Address IP address or hostname of the VPN server. This is the IP Address that you are creating
the tunnel to. In the previous example, this is the public IP Address of the ICX35-HWC in
pass through mode that is being used as the default connection to the Linux server.
Server Port Service port number on the VPN server. The default port is 1194. This is the port number
for the OpenVPN. Port 1194 is the generally accepted default port designated for
OpenVPN. This is the port number that is used for the previous example.
Encryption Cypher Cipher used to encrypt data channel packets. The default value is BF-CBC. Some of the
ciphers that are supported by OpenVPN are not available in this list because they are
considered insecure. However, these can still be used by using a custom configuration
file.
Static Routes Static routes to remote networks to be specifically accessed through the configured
OpenVPN connection. A maximum of 3 static routes are supported per tunnel.
Enable User / Password Alternative authentication method based on username and password. Enter a Username
Authentication and Password.
Credential Files
Certificate Authority - VPN authentication that issues certificates for VPN, Secure
Internal Communication (SIC), and users.
Click the Choose File button to locate these files. Internally, they are renamed (Example:
file_OpenVPN_CA.crt), and stored in the appropriate Current File area.
Note: These Credential files are mandatory in order to enable OpenVPN. They can either
be uploaded individually or have their content added inline, within the custom
configuration file. If by mistake you uploaded them and also have them inline in the
configuration file, the files uploaded individually will take precedence.
Click the Choose File button to locate and upload a custom OpenVPN configuration file,
Custom Config File which overrides any credential files previously loaded. If you have not previously
uploaded any credential files, the Custom Configuration File should include them.
Protocol The protocol to use when connecting with the remote: TCP or UDP (default).
Page 36 of 131
Verification
Once the client and server are configured, the client creates a VPN tunnel through the server to
the LAN where the server resides. The Status webpage will indicate that an OpenVPN
connection is established.
You can now pass secured data between the two LAN devices. Verify this with a simple ping
from one LAN device to the other.
With two tunnels connected, the following information is shown at Status > System Status.
Page 37 of 131
IPSec
The VPN Tunnel Internet Protocol Security (IPsec) feature consists of protocols used for
authentication and encryption.
Important: IPSec tunnel does not work with Public Dynamic IP’s and DDNS names.
The IPSec option from the Client drop-down list displays the following parameters:
Parameter Description
Local Identifier Specifies the identifier to be used for the local side of the IPsec connection. This is used
during authentication of the tunnel. It is a free-form string, although typically it is a Fully
Qualified Domain Name, or an IP address. Max length is 28.
Note: Use the “@” prefix when the IPSec tunnel is established between two ICX35-
HWC’s. Example: @ICX35_local (This may be the local Module Name. If you are
establishing an IPSec tunnel with a network router that supports IPSec, no “@” prefix is
needed).
Remote Host Specifies the IPsec remote IP address.
Remote Identifier Specifies the identifier to be used for the remote site of the IPsec connection. This is
used during authentication of the tunnel. It is a free-form string, although typically, it is a
FQDN name, or an IP address. Max length is 28.
Note: Use the “@” prefix when the IPSec tunnel is established between two ICX35-
HWC’s. Example: @ICX35_remote (This may be the remote Module Name. If you are
establishing an IPSec tunnel with a network router that supports IPSec, no “@” prefix is
needed).
Remote Subnet IP Specifies the subnet address block on the LAN side of the remote peer. This parameter
must be specified in the CIDR notation (i.e., a number from 1 to 32).
Remote Subnet Mask Specifies the subnet mask on the LAN side of the remote peer.
Pre-shared Key Specifies the pre-shared key that must match between both ends of the VPN tunnel.
IPSec authenticates and encrypts each IP packet of a communication session. IPSec also
includes protocols for establishing mutual authentication between agents at the beginning of the
session and negotiation of cryptographic keys to be used during the session. This is an end-to-
end security scheme operating in the internet layer of the Internet Protocol Suite.
Page 38 of 131
Example
This example connects two devices on different subnets. The devices can be any LAN-based
devices that allow you to set the IP Address and Gateway IP address.
Page 39 of 131
Two ICX35-HWC radios and two PCs are used. Once the IPSec tunnel is created,
communications can occur between the two PCs. IPSec uses the concept of Local ID and
RemoteID to identify each device.
ICX35 #1 "West"
Parameter Description
Name ICX35-HWC #1 West
WAN IP WAN IP Address of ICX35-HWC #1
LAN IP 192.168.1.150
Local Identifier @West
Remote Host WAN IP Address of ICX35-HWC #2
Remote Identifier @East
Remote Subnet IP 192.168.0.0
Remote Subnet Mask 255.255.255.0
Preshared Key presharedkey (this can be any string)
ICX35 #2 "East"
Parameter Description
Name ICX35 #2 East
WAN IP WAN IP address of ICX35-HWC #2
LAN IP 192.160.0.230
Local Identifier @East
Remote Host WAN IP address of ICX35-HWC #1
Remote Identifier @West
Remote Subnet IP 192.168.1.0
Remote Subnet Mask 255.255.255.0
Preshared Key presharedkey (this can be any string)
Verification
Once all four devices are configured, the status webpage in both of the ICX35-HWC’s will
indicated that an IPSec VPN connection is made.
You can ping from one LAN device to the other to further verify that the connection is made.
Page 40 of 131
Serial / Encapsulation
The maximum file size to be transmitted or received at once on the serial port is 4096 bytes.
The Serial/Encapsulation feature uses IP port 30722 for both TCP and UDP configurations. This
port number is not user-configurable.
Parameter Description
Port Mode This parameter sets the scheme for the serial port (RS-232 only).
Page 41 of 131
Generic
The Generic option sends all serial data to a single destination.
Parameter Description
Role Network role for the encapsulation process (Master, Slave, Master/Slave)
Timeout Bits Length of time the gateway will wait when no further serial data is received before
encapsulating and transmitting data. (0 to 65535)
Port Type Type of IP connection (TCP or UDP) for the encapsulated data.
Parameter Description
Remote IP IP address of the Remote connection to which the encapsulated
data will be sent.
Page 42 of 131
Modbus RTU
The Modbus RTU option displays the following additional parameters:
Parameter Description
Role Network role for the encapsulation process (Master, Slave, Master/Slave).
Timeout Bits Sets the length of time the gateway will wait when no further serial data is received
before encapsulating and transmitting data (0 to 65535).
Port Type Type of IP connection (TCP or UDP) for the encapsulated data.
Page 43 of 131
If Slave is selected, the Encapsulation table is not visible. You can add an entry to the Client
Table list. Click on the Add Entry To Client Table List button.
The Remove Selected Entries button selects and removes entries from this list.
Page 44 of 131
Modbus ASCII
The Modbus ASCII option displays the following additional parameters:
Parameter Description
Role Network role for the encapsulation process (Master, Slave, Master/Slave).
Timeout Bits Sets the length of time the gateway will wait when no further serial data is
received before encapsulating and transmitting data (0 to 65535).
Port Type Type of IP connection (TCP or UDP) for the encapsulated data.
Page 45 of 131
If Slave is selected, the Encapsulation table is not visible. You can add an entry to the Client
Table list. Click on the Add Entry To Client Table List button.
The Remove Selected Entries button selects and removes entries from this list.
Page 46 of 131
Modbus RTU to TCP
The Modbus RTU to TCP option displays the following additional parameters.
Parameter Description
Role Specifies the network role for the encapsulation process (Master,
Slave).
Timeout Bits This parameter sets the length of time the gateway will wait when no
further serial data is received before encapsulating and transmitting
data (0 to 65535).
Port Type This parameter specifies the type of IP connection (TCP only) for
the encapsulated data.
Page 47 of 131
If Slave is selected, the Encapsulation table is not visible.
You can add an entry to the Client Table list. Click on the Add Entry To Client Table List
button.
The Remove Selected Entries button selects and removes entries from this list.
Page 48 of 131
Modbus ASCII to TCP
The Modbus ASCII to TCP option displays the following additional parameters.
Parameter Description
Role Specifies the network role for the encapsulation process (Master,
Slave).
Timeout Bits This parameter sets the length of time the gateway will wait when no
further serial data is received before encapsulating and transmitting
data (0 to 65535).
Port Type This parameter specifies the type of IP connection (TCP only) for the
encapsulated data.
Page 49 of 131
If Slave is selected, the Encapsulation table is not visible.
You can add an entry to the Client Table list. Click on the Add Entry To Client Table List
button.
The Remove Selected Entries button selects and removes entries from this list.
Page 50 of 131
DF1 Half-Duplex
The DF1 Half-Duplex option displays the following parameters.
Parameter Description
Role Specifies the network role for the encapsulation process (Master,
Slave).
Timeout Bits Sets the length of time the gateway will wait when no further serial
data is received before encapsulating and transmitting data (0 to
65535).
Port Type Only TCP connections are supported for this protocol selection.
DF1 Error Checking Specifies which type of error checking is used for DF1 data
messages (BCC or CRC).
Page 51 of 131
If Slave is selected, the Encapsulation table is not visible.
You can add an entry to the Client Table list. Click on the Add Entry To Client Table List
button.
The Remove Selected Entries button selects and removes entries from this list.
Page 52 of 131
DF1 Full-Duplex
The DF1 Full-Duplex option displays the following additional parameters.
Parameter Description
Role Specifies the network role for the encapsulation process (Master,
Slave).
Timeout Bits Sets the length of time the gateway will wait when no further serial
data is received before encapsulating and transmitting data (0 to
65535).
Port Type Only TCP connections are supported for this protocol selection.
DF1 Error Checking Specifies which type of error checking is used for DF1 data
messages (BCC or CRC).
Page 53 of 131
If Slave is selected, the Encapsulation table is not visible.
You can add an entry to the Client Table list. Click on the Add Entry To Client Table List
button.
The Remove Selected Entries button selects and removes entries from this list.
Page 54 of 131
DF1 Radio Modem
The DF1 Radio Modem option displays the following additional parameters:
Parameter Description
Role Specifies the network role for the encapsulation process (Master,
Slave).
Timeout Bits This parameter sets the length of time the gateway will wait when no
further serial data is received before encapsulating and transmitting
data (0 to 65535).
Port Type Only TCP connections are supported for this protocol selection.
DF1 Error Checking This parameter specifies which type of error checking is used for
DF1 data messages (BCC or CRC).
Page 55 of 131
If Slave is selected, the Encapsulation table is not visible.
You can add an entry to the Client Table list. Click on the Add Entry To Client Table List
button.
The Remove Selected Entries button selects and removes entries from this list.
Page 56 of 131
NTP – Network Time Protocol
This feature enables the Network Time Protocol to synchronize the clocks of data networks and
the ICX35-HWC.
Parameter Description
Enable NTP Enables the NTP feature.
NTP Server Serves time updates for the ICX35-HWC. Example: pool.ntp.org
NTP Mode Client - NTP process will query NTP server and update ICX35-HWC
system time.
Client/Server - NTP process will query NTP server and update
ICX35-HWC system time and resolve NTP requests from the LAN
clients.
Page 57 of 131
EIP – EtherNet/IP
The ICX35-HWC can run as an explicit message server and will respond to requests received
on the LAN. An SMS message can be sent to user(s) upon alarm.
Page 58 of 131
Modbus TCP Agent
The ICX35-HWC can run as a Modbus TCP/IP server to remote Modbus TCP/IP device(s).
Enabling the Modbus TCP Agent is a prerequisite for Diagnostics & SMS features. See Modbus
TCP/IP Communications for more information.
Parameter Description
Enable Agent Enables the Modbus TCP Agent feature
Listen Port The Modbus TCP/IP service port number
Note: When using both Serial Encapsulation and Modbus TCP Agent, the default Listen Port
configured for the Modbus TCP Agent needs to be changed to another value than 502.
Page 59 of 131
Connection Recovery
The Connection Recovery is used to trigger a reboot of the ICX35-HWC when there is a loss of
connectivity or if the ICX35-HWC stops communicating. The reboot trigger conditions are:
Parameter Description
Enable Connection Recovery Enables the Connection Recovery feature.
Endpoint Address Configure a known WAN IP address (Default 8.8.8.8, a known Google DNS
address). If the ICX35-HWC is not able to reach this WAN IP and the Endpoint
Timeout parameter is true, then the ICX35-HWC will reboot.
ProSoft Connect Timeout The time interval (in minutes) after which the ICX35-HWC will reboot if there is no
connectivity with ProSoft Connect. Maximum value: 1439 (23 hours, 59 minutes).
Endpoint Timeout The time interval (in minutes) after which the ICX35-HWC will reboot if the Endpoint
Address is not reachable.
Success Threshold (%) Percentage of successful attempts to reach the endpoint/ ProSoft Connect, for
which the ICX35-HWC does not reboot.
Page 60 of 131
3.2.3 Firewall
The Configuration > Firewall tab displays the following fields for Pass Through and Port
Forwarding.
Pass Through allows all traffic from a remote client device to be forwarded to the configured end
device (End Device Address parameter) connected to the ICX35-HWC LAN.
Port Forwarding allows a remote client device to access multiples server devices connected to
the ICX35-HWC LAN by associating each one of these devices to an ICX35-HWC port number.
Up to 10 mappings can be created.
Pass Through
Parameter Description
Status Enable or disable pass through status
End Device Address Used when DHCP is disabled. IP address of end device.
Page 61 of 131
Port Forwarding
Enable this feature by selecting ENABLE in the dropdown menu.
Parameter Description
Application Name of particular mapping
Protocol Packet delivery method (TCP, UDP, both)
IP Address IP address of the destination LAN device
From Port Range WAN port range through which data will be forwarded to each device
To Port Range LAN device port range listening for forwarded traffic
Exception Ports Lists the ports included in the From Port Range interval that are already in use by
services running on the ICX35-HWC, and will not be forwarded to the end device
connected to the LAN port.
When the fields above are complete, click the ADD button to load the parameters into the table.
To remove an existing mapping in the table, highlight it and click DELETE.
When complete, click APPLY.
Page 62 of 131
Example:
Page 63 of 131
3.3 Administrator Tab
The Administrator tab allows you to configure the password, back up the configuration, record
logs, install firmware, etc.
3.3.1 System
Parameter Description
Reboot Gateway Reboots the ICX35-HWC.
Configuration Backup * Saves the configuration to a file.
Configuration Restore * Loads the configuration to the module. The Choose File button
allows you to locate and select the configuration file that you want to
restore. The Restore button restores the file.
Reset Gateway to Default Configuration
Restores the ICX35-HWC to factory defaults – the previous
configuration is lost.
(*) The Username and Password are not backed up. When importing a configuration, the
current password remains unchanged.
Page 64 of 131
3.3.2 Access Control
Parameter Description
Web Access
Web Port Web access port number
Web Protocol HTTP or HTTPS
Web Access on WAN Allows or blocks webpage access from the WAN
Warning: ProSoft Connect currently uses port 443 to tunnel. Selecting port 443 will
prevent ProSoft Connect from functioning properly. HTTPS can function properly
using port 8080 or other ports.
User
User Name New login user name
Old Password Old login password
New Password New login password
Confirm Password Confirm new password
White List
Active Choose Enable or Disable. If you choose Enable, the unit displays the Add Entry to
WAN Whitelist button.
Page 65 of 131
Adding Entries to the Whitelist
Click on the ADD ENTRY TO WAN WHITELIST button. This unit displays a line entry in which
you can enter an IP address.
Whitelist entries can either be single IP addresses (e.g., 50.40.20.15) or IP addresses followed
by a CIDR netmask (e.g., 50.40.20.0/8) allowing subnets to be whitelisted via a single whitelist
entry. Whitelists only apply to the cellular (WAN) interface. No whitelist filtering is possible on
the LAN interface.
Since all VPN traffic is presumably between trusted hosts, whitelist entries are ignored (but not
deleted) when an OpenVPN or IPsec tunnel is configured.
Add your entry. Use the ADD ENTRY TO WAN WHITELIST button to add additional IPs.
To remove whitelist entries, click the checkbox of the entry and click on the REMOVE
SELECTED ENTRIES button. Click APPLY when done.
Page 66 of 131
HTTPS Warning Message
When HTTPS is enabled, you must enter the WAN or LAN IP address into your web browser in
the following format: https://xxx.xxx.xxx.xxx:8080
Depending on your browser, you may encounter a warning message. It warns that the page was
not securely loaded due to the unknown verification of a ProSoft site certificate.
You may need to add an exception in your browser to proceed to the ICX35-HWC webpage.
Google Chrome
Page 67 of 131
Firefox
Page 68 of 131
Internet Explorer
Safari
Page 69 of 131
3.3.3 Logs
Parameter Description
System Log Level (1 to 8) Specifies how much information is saved to the log file. Lower numbers limit the log
entries to more critical information, while higher numbers include information useful
for troubleshooting. Higher numbers include all entries associated with lower-level
numbers. This value can typically be left alone until instructed by a Technical
Support representative.
Number of Log Files(1 to 10) Specifies the number of log files to be recorded internally.
Refresh Performs a refresh of the log results
Show all Log Entries Refreshes and displays all log entries
Download Allows you to download and save the log to a file
Clear Logs Clears the recorded logs
Page 70 of 131
3.3.4 SMS
The SMS text message contents of the ICX35-HWC buffer can be viewed using this feature.
You can also send an SMS text message to a valid SMS recipient.
SMS Settings
Parameter Description
Message Center This is used to configure the Message Center Number used to send SMS.The
phone number is in international format (including prefixes and country code). It
can be entered in the following formats:
With or without preceding ‘+’ sign
With or without spaces
With or without dashes ‘-‘
With or without periods ‘.’
Warning: The new SMS Message Center Number will be written to the SIM card.
Please note the current number before continuing.
Page 71 of 131
Send SMS
Parameter Description
Recipient Recipient’s phone number in international format (including prefixes and country
code). It can be entered in the following formats:
With or without preceding ‘+’ sign
With or without spaces
With or without dashes ‘-‘
With or without periods ‘.’
Warning: The new SMS Message Center Number will be written to the SIM card.
Please note the current number before continuing.
SMS text message to be sent, up to 160 characters. It supports the GSM Basic
Message Character Set.
Note: Messages stored in the ICX35-HWC are retrieved using the FIFO rule: The first message
received is the first to be retrieved, and so on.
Received SMS
You can REFRESH or CLEAR the messages that have been received by the ICX35-HWC.
Sent SMS
You can REFRESH or CLEAR the messages that have been sent by the ICX35-HWC.
Page 72 of 131
3.3.5 Ping
You can ping a remote device to determine whether you can connect to it. Enter the WAN IP
address or hostname to be pinged and click PING.
Page 73 of 131
3.3.6 License
This section contains a list of the software contained in the ICX35-HWC. It includes the Open
Source Software and its license terms.
Page 74 of 131
4 ProSoft Connect
ProSoft Connect is a secure webpage interface to activate, setup VPN clients, invite team
members, and manage multiple ProSoft cellular radios on the network.
4.1 Activation
ProSoft Connect requires you to activate the ICX35-HWC upon initial use.
Note: During the activation process, the ACTIVATE button will be greyed out for 60
seconds.
3. A six-character alphanumeric Activation Key is generated. Record this key for later use.
4. Click on the www.prosoft.io link. Or open a new tab in your web browser, enter
"www.prosoft.io", then press ENTER.
5. Enter or create an account in the ProSoft Connect log-in screen.
6. Once logged in, you can take a tour of the features of the ProSoft Connect utility.
7. When ready, activate the ICX35-HWC within the tour, or you can click on the ADD A
GATEWAY button at the top of the screen. It will prompt you for the Activation Key.
8. Once the ICX35-HWC is activated, you can navigate to each tab on the left-hand side of
the page. Each tab contains a ‘lifesaver’ icon for a tutorial of the feature.
Page 76 of 131
5 Hardware Installation
The ICX35-HWC should be mounted in a position that allows easy access for the cables so they
are not bent, constricted, in close proximity to high amperage, or exposed to extreme
temperatures. The LEDs on the front panel should be visible for ease of operational verification.
Ensure that there is adequate airflow around the device but kept free from direct exposure to the
elements, such as sun, rain, dust, etc.
Caution: The ICX35-HWC is in a hardened case, and designed for use in industrial and
extreme environments. However, unless you are using cables expressly designed for such
environments, they can fail if exposed to the same conditions the ICX35-HWC can withstand.
Tip: When using a cable to an antenna placed away from the modem, minimize the length of
your cable. All gain from a more advantageous antenna placement can be lost with a long cable
to the modem.
5.2 Connecting the Radio to a Network Device
Page 78 of 131
5.2.1 Ethernet Cable Specifications
The recommended Ethernet cable is category 5 or better. A category 5 cable has four twisted
pairs of wire that are color-coded and cannot be swapped. The module only uses two of the four
pairs when running at 10 MBit or 100 MBit speeds.
The Ethernet port on the module is Auto-Sensing. Use either a standard Ethernet straight-
through cable or a crossover cable when connecting the module to an Ethernet hub, a
10/100/1000 Base-T Ethernet switch, or directly to a PC. The module will detect the cable type
and use the appropriate pins to send and receive Ethernet signals.
Ethernet cabling is like U.S. telephone cables but have eight conductors. Some hubs have one
input that can accept either a straight-through or crossover cable, depending on switch position.
In this case, ensure that the switch position and cable type agree.
Page 79 of 131
5.2.2 Serial Port Basics
RS-232
The use of hardware handshaking (control and monitoring of signal lines) depends on the
requirements of the networked device. If no hardware handshaking will be used, the cable to
connect to the port is as shown below:
If hardware handshaking is required, the cable to connect to the port is as shown below:
Page 80 of 131
5.3 LED Indicators
* The MS and NS LED’s are only enabled if the Ethernet/IP parameter is enabled in the Configuration tab of the
webpage.
Page 81 of 131
WWAN LED
LED State Description
Off Off ICX35-HWC is powered off
Solid Green On ICX35-HWC is powered and connected, but is not transmitting or
receiving.
Slow Blink Flashes at a steady, slow ICX35-HWC is powered and searching for a connection.
rate: 0.2 Hz (5 sec)
Faster Blink Flashes at a steady, fast ICX35-HWC is transmitting or receiving data.
rate: About 3 Hz (333 ms)
Note: The WWAN LED indicates a physical connection state between the ICX35-HWC and the
cell tower. It is not an indicator of a logical connection state. There may be a situation when you
may see a “Disconnect, will retry” indicator on the ICX35-HWC webpage, even when the
WWAN LED light is on (solid green). This indicates that the module was able to make a physical
connection to the tower, but the logical connection was not made between the ICX35-HWC and
the cellular provider.
Page 82 of 131
6 EtherNet/IP and SMS Text Messaging
The ICX35-HWC provides connectivity via the EtherNet/IP communications protocol as a Class
3 client. With this connectivity, PLC and SCADA software can monitor the diagnostics of the
ICX35-HWC.
The ICX35-HWC Add-On Instruction (AOI) file for RSLogix 5000 supports the following features:
Example application: The ICX35-HWC can be installed in a remote location with its LAN directly
connected to a PLC. The PLC code can monitor the values and if/when a value is out of range,
and SMS message is sent to a user via the ICX35-HWC. The user can then send a SMS back
to the PLC to clear the notification.
7. Click OK.
Page 84 of 131
6.1.1 Adding Ethernet Connectivity to the Project
Note: This section can be skipped if you have a CompactLogix processor with a built-in
Ethernet port.
1. You will need to add a 1756-ENBT Ethernet Bridge module to the project. In the
Controller Organizer window, select the Controller that was imported and click the right
mouse button to open a shortcut menu. On the shortcut menu, select New Module....
2. This action opens the Select Module Type dialog box. Select the 1756-ENBT under the
Communication Module Type Category and click Create.
3. Enter the Name, Slot, Revision, and IP Address of the 1756-ENBT module and click OK.
Page 85 of 131
4. The 1756-ENBT module now appears in the Controller Organizer window.
Page 86 of 131
6.1.2 Ethernet Bridge Network Setup
An Ethernet Bridge needs to be added to the 1756-ENBT module. For CompactLogix, connect
the Ethernet Bridge to the Ethernet port on the controller.
1. In the Controller Organizer window, click the right mouse button on the Ethernet icon to
open a shortcut menu. On the shortcut menu, choose New Module…
Note: For both ControlLogix and CompactLogix controllers, the Ethernet icon is located
under the controller icon.
2. This opens the Select Module Type dialog box. Select the ETHERNET-BRIDGE module
under the Communication directory and click Create.
3. This opens the New Module dialog box. Enter ‘ICX35’ as the Name
4. Enter the LAN IP address of the ICX35-HWC. This is the connection to the outside world
for the 1756-ENBT.
5. Click OK.
6. The ETHERNET-BRIDGE now appears in the Controller Organizer window under the
1756-ENBT module.
Page 87 of 131
7. Double click the ETHERNET-BRIDGE icon in the Controller Organizer window to open
the Module Properties window. Click on the Connection tab and check the Inhibit Module
box. Click OK.
Page 88 of 131
6.2 Importing the AOI
Note: When importing an ICX35-HWC AOI file into a new project, use the ICX35-HWC AOI v1.6
file from www.prosoft-technology.com. Also, the ICX35-HWC firmware version must be v1.2.2 or
later.
1. In the Controller Organizer window, expand the Tasks folder and subfolders until you
reach the MainProgram folder.
2. In the MainProgram folder, double-click to open the MainRoutine ladder.
3. Select an empty rung in the routine, and click the right mouse button to open a shortcut
menu. On the shortcut menu, choose Import Rungs...
4. Navigate to the location on your PC where you saved the Add-On Instruction (for
example, Desktop). Select the .L5X file and click the Import… button.
Page 89 of 131
5. This action opens the Import Configuration dialog box, showing the controller tags that will
be created.
6. Click OK to confirm the import. RSLogix will indicate that the import is in progress:
7. When the import is complete, the new rung with the Add-On Instruction will be visible as
shown in the following illustration.
8. The procedure has also imported new User Defined Data Types, Controller Tags, and the
Add-On instruction for your project.
9. Save the project. When ready, download the project to the processor.
Page 90 of 131
6.3 EtherNet/IP and SMS Text Message Features
6.3.1 ICX35-HWC Diagnostic Data Retrieval
The ICX35-HWC AOI can retrieve the ICX35-HWC status from the radio and display it in
RSLogix 5000.
Page 91 of 131
3. The ICX35-HWC status controller tags are defined below:
EtherNet/IP Class ID: 0xA1 (161)
Number of Instances: 1
Page 92 of 131
6.3.2 ICX35-HWC Diagnostic Counter Reset
The following ICX35-HWC status parameters can be reset to 0. They cannot be individually
reset.
ICX35.STATUS.Min_RSSI
ICX35.STATUS.Max_RSSI
ICX35.STATUS.Cell_Net_Disconnects
ICX35.STATUS.LAN_KBytes_Sent
ICX35.STATUS.LAN_KBytes_Received
ICX35.STATUS.WAN_KBytes_Sent
ICX35.STATUS.WAN_KBytes_Received
ICX35.STATUS.SMS_MSGs_Sent
ICX35.STATUS.SMS_MSGs_Received
ICX35.STATUS.SMS_MSGs_Rx_Free_Buffer_Counter
Page 93 of 131
6.3.3 Sending SMS Text Messages from the ICX35-HWC
Using the ICX35-HWC AOI, SMS text messages can be sent from the ICX35-HWC to SMS text
devices.
AT&T Users: For SMS texting functionality, you must power up the ICX35-HWC with the SIM
installed within 72 hours after AT&T activates the SIM card.
1. The text message contents are entered in the ICX35.SMS.WRITE.Message controller tag.
Click on the "..." box.
2. Enter the SMS text message characters in the String Browser dialog box. Click OK.
3. Enter the number SMS text recipient devices (up to 5 devices) in the
ICX35.SMS.WRITE.Phone_Count controller tag.
Page 94 of 131
4. Enter the SMS text message recipient/phone number(s) in the
ICX35.SMS.WRITE.Phone_Number_x controller tag(s).
Example: To send an SMS text message to phone number (800)111-2222, the format
should be entered into the ICX35.SMS.WRITE.Phone_Number_x controller tag array as
follows: +18001112222
6. To check if the SMS text message was sent, enable the ICX35.CONTROL.Get_Status
controller tag.
The ICX35.STATUS.SMS_MSGs_Sent controller tag increments by 1 when a SMS text
message is successfully sent.
Page 95 of 131
6.3.4 Retrieving SMS Text Messages from the ICX35-HWC
Using the ICX35-HWC AOI, SMS text messages that have been sent to the ICX35-HWC from
remote devices can be transferred into RSLogix 5000.
AT&T Users: For SMS texting functionality, you must power up the ICX35-HWC with the SIM
installed within 72 hours after AT&T activates the SIM card.
Security Tip: For increased security and to avoid spam, we recommend that you restrict or limit
the phone numbers allowed to send messages to the ICX35-HWC. Please note that some
cellular providers do not offer this capability.
2. The ICX35.SMS.READ controller tag array populates with the date/time, time zone,
phone number, and SMS text information from the ICX35-HWC internal buffer.
Page 96 of 131
Warning: The ICX35-HWC should not receive SMS messages faster than once every 30
seconds; otherwise it may repeatedly disconnect from the cellular network.
Warning: The ICX35-HWC must not buffer more than 500 received SMS messages before
transmission to RSLogix 5000; otherwise, new incoming messages will be discarded.
Check the number of free slots in the Rx buffer by continuously monitoring the
SMS_MSGs_Rx_Free_Buffer_Counter tag (Starting value is 500). The ICX35-HWC may buffer
SMS messages in case the messages are received from the cellular network faster than the
PLC polling rate. If a receiving PLC is offline during the sending of more than 250 SMS
messages, upon reconnection, it will only poll the last 250 received SMS messages.
For reliable communications, the number of free slots in the ICX35-HWC receive buffer should
be greater than ‘0’. Otherwise, messages received when the buffer is full are discarded.
Page 97 of 131
6.3.5 Clearing SMS Text Messages from the ICX35-HWC
This controller tag clears all SMS messages within the ICX35-HWC.
Note: This feature requires ICX35-HWC v1.4.78 firmware or later.
Note: Once triggered, it does not immediately clear the ICX35.SMS.READ.Message array. To
do this, you must trigger the ICX35.CONTROL.Read_SMS controller tag after the SMS text
messages have been cleared within the ICX35-HWC.
Page 98 of 131
7 Modbus TCP/IP Communications
7.1 ICX35-HWC Diagnostic Data Retrieval
The following table displays the read-only Modbus addresses of the ICX35-HWC diagnostics
information. Use Modbus Function Code 4 to read these values.
ICX35_ Modbus Address Data Type Description
Diag.RSSI 30001 SINT Current Signal Strength. Range -50 to -125 dBm
Value1 = -128
Diag.Min_RSSI * 30002 SINT Minimum Signal Strength. Range -50 to -125 dBm
Value1 = 127 (Set during initialization)
Diag.Max_RSSI * 30003 SINT Maximum Signal Strength. Range -50 to -125 dBm
Value1 = -128 (Set during initialization)
Diag.Cell_Net_State 30004 SINT Status of the connection to the cellular network.
0: Disconnect
1: Connecting
2: Connected
Value1 = 0 (Not connected)
Diag.MAC_Address 30005 to 30010 SINT[6] ICX35-HWC MAC ID. Value1 = Not available
Diag.WAN_IP 30011 to 30014 SINT[4] Cellular network IP. Value1 = 0.0.0.0
Diag.Cell_Net_Disconnects * 30015 to 30016 DINT Number of times ICX35-HWC is disconnected from
the cellular network since power on
Diag.LAN_KBytes_Sent * 30017 to 30018 DINT Number Kbytes sent on LAN since power on
Diag.LAN_KBytes_Received * 30019 to 30020 DINT Number of Kbytes received LAN since power on
Diag.WAN_KBytes_Sent * 30021 to 30022 DINT Number of bytes sent WAN since power on
Diag.WAN_KBytes_Received * 30023 to 30024 DINT Number of bytes received WAN since power on
Diag.SMS_MSGs_Sent * 30025 to 30026 DINT Number of SMS messages sent since power on
Diag.SMS_MSGs_Received * 30027 to 30028 DINT Number of SMS messages received since power on
Diag.SMS_MSGs_Free * 30029 to 30030 DINT Number of free slots in the Rx SMS buffer. Max 500
message storage.
Diag.Power_Year 30031 INT Power on time year
Diag.Power_Month 30032 INT Power on time month
Diag.Power_Day 30033 INT Power on time day
Diag.Power_Hour 30034 INT Power on time hour
Diag.Power_Min 30035 INT Power on time minute
Diag.Power_Sec 30036 INT Power on time seconds
Diag.Link_Days 30037 to 30038 DINT Link Time: Days of cellular connection. Value1 = 0
Diag.Link_Hours 30039 to 30040 DINT Link Time: Hours of cellular connection. Value1 = 0
Diag.Link_Min 30041 INT Link Time: Minutes of cellular connection. Value1 =
0
Diag.Link_Sec 30042 INT Link Time: Seconds of cellular connection. Value1 =
0
Diag.Data_Usage_Current_Month 30043 to 30044 DINT Data usage of current month in KB
Diag.Data_Usage_Previous_Month 30045 to 30046 DINT Data usage of last month in KB
Diag.Data_Usage_Current_Day 30047 to 30048 DINT Data usage for today in KB
Diag.Data_Usage_Previous_Day 30049 to 30050 DINT Data usage of previous day in KB
Diag.FW_Version 30051 to 30062 REAL ICX35-HWC firmware version
Diag.Phone_Number 30063 to 30071 SINT[18] ICX35-HWC cellular phone number
Diag.IMEI 30072 to 30081 SINT[20] ICX35-HWC IMEI number
Use Modbus Function Code 6 write a value of ‘1’ to 40001 in the ICX35-HWC.
1. SMS text message contents (40006): The ICX35-HWC can send up to 160 characters
(80 16-bit integers) per SMS text message. To load the text message string, use the
Modbus Function Code 16 to write to Modbus address starting at 40006 in the ICX35-
HWC.
2. SMS text message length (40004): Use the Modbus Function Code 6 to write the
number of characters (up to 160) to send.
3. Amount of phone numbers to send to (40005): Use the Modbus Function Code 6 to
write the amount of phone numbers that will be used.
4. Phone number entry (40086): Use the Modbus Function Code 16 to write the recipient’s
phone number including prefixes, country, code, etc. You can enter up to 5 phone
numbers, each starting at a different Modbus address (see table above).
5. Trigger the SMS text message (40003): When you are ready to send the SMS text
message, use the Modbus Function Code 6 to write a value of ‘1’ to 40003.
SMS text message contents (30121): Use the Modbus Function Code 4 to read from
ICX35-HWC Modbus address 30121. Each 16-bit Modbus address contains 2 characters
(1 byte each) of the SMS text message.
Example: A 100-character text message occupies 50 Modbus addresses.
SMS text phone number (30109): Use the Modbus Function Code 4 to read from ICX35-
HWC Modbus address 30109. Each (16 bit) Modbus address contains 2 characters (1
byte each) of the phone number.
SMS text date/time (30093): Use the Modbus Function Code 4 to read from ICX35-HWC
Modbus address 30093. Each (16 bit) Modbus address contains 2 characters (1 byte
each) of the time stamp.
In this scenario, the watchdog mechanism will reboot the device at the time interval
specified (minutes) in the configuration file (watchdog/datatimeout=1440). This is the 24
hour scenario. This is not configurable from the local UI.
In this scenario, the watchdog mechanism will reboot the device at the time interval
specified (minutes) in the configuration file (watchdog/psctimeout=60). This is
configurable from the local UI via the Prosoft Connect Timeout parameter.
3. No PSC connection
This scenario is activated if:
The device is active in ProSoft Connect;
The number of attempts to reach ProSoft Connect are less than the configured
threshold (watchdog/percentatagefail);
Data Plan Limit is enabled and Stop Data After Plan Limit Reached is disabled;
In this scenario, the watchdog mechanism will reboot the device at the time interval
specified (minutes) in the configuration file (watchdog/psctimeout=60). This is
configurable from the local UI via the Prosoft Connect Timeout parameter.
In this scenario, the watchdog mechanism will reboot the device at the time interval
specified (minutes) in the configuration file (watchdog/psctimeout=60). This is
configurable from the local UI via the Prosoft Connect Timeout parameter.
7. The PSC connection through the agent is compromised (no traffic through the
websockets connection, agent hangs)
This scenario is activated if:
The device is active in ProSoft Connect;
The agent process, which is responsible for the connection with ProSoft Connect is
hanged (ProSoft Connect and internet connection are up but there is an internal
issue with the agent software).
In this scenario, the watchdog mechanism will reboot the device at the time interval
specified (mintues) in the configuration file (watchdog/psctimeout=60). This is
configurable from the local UI via the Prosoft Connect Timeout parameter.
config/version=0
ddns/system=
ddns/mode=0
ddns/hostname=
ddns/username=
ddns/password=
ddns/ipcheckperiod=600
.....
watchdog/psctimeout is set to: 60
watchdog/datatimeout is set to: 1440
watchdog/enabled is set to: 1
watchdog/percentagefail is set to: 10
watchdog/endpointtimeout is set to: 15
watchdog/endpointaddr is set to: 8.8.8.8
watchdog/armed is set to: 0
.....
system/ntpport=123
system/eipenable=0
system/mbenable=0
system/mbport=502
ovpnroutes1/1=
ovpnroutes1/2=
Cases:
- No PSC connection
- No PSC connection and data plan left
- No PSC connection and usage monitoring disabled
- The PSC connection through the agent is compromised (no traffic through the
websockets connection, agent hangs)
Case:
- No PSC connection
C. watchdog/enabled=1
By default the watchdog mechanism is enabled in the configuration file (1=enabled;
0=disabled).
D. watchdog/percentagefail=10
This parameter shows the percentage of successful attempts to:
- Ping the configured endpoint address (check watchdog/endpointaddr parameter;
the default endpoint IP Address is 8.8.8.8)
- Reach https://www.prosoft.io/device-gateway/status
If out of 100 attempts there are 10 successful and 90 failed, the gateway will not
reboot. If the successful attempts are less than 10, the gateway will reboot.
E. watchdog/endpointtimeout=15
This is the time value expressed in minutes for the cases when the watchdog resets
itself after 15 minutes.
Cases:
- No connection to the configured endpoint address (check watchdog/endpointaddr
parameter; by default there is no endpoint configured).
- No PSC connection while endpoint address is reachable.
4. Once the desired watchdog configuration is set, you can load it back on the gateway from
the local UI.
The Gateway Firmware Install is for motherboard upgrades of the ICX35-HWC. This includes
the LED, serial/Ethernet port, and software upgrades.
The Radio Firmware Install is for daughterboard changes of the ICX35-HWC. It is for cellular
technology upgrades only.
Warning: If you are using an ICX35-HWC with ProSoft Technology’s Add-on Instruction for
Rockwell Automation Studio 5000 and wish to install the ICX35-HWC firmware to v1.2.2 or later,
the AOI v1.5 will no longer work. After the firmware install, you will also need to update the PLC
program with the new AOI v1.7.
The ICX35-HWC firmware can be found at the Gateway F/W Version parameter on the Status >
System Status webpage.
9.1 Gateway Firmware Install
Important: If the current firmware is older than v1.1 (Example: 766, 1.0, etc.), you will need to
upgrade to v1.1 first, then to latest firmware available. Please contact ProSoft Connect
customer support for the v1.1 firmware file.
1. Download the CDMA internal radio software file from the ICX35-HWC webpage at
www.prosoft-technology.com.
2. To install the internal radio software, follow the steps in the Radio Firmware Install
section.
Note: You can select to have ICX35-HWC radios shipped in the Verizon (CDMA) mode by
ordering part number ICX35-VZW when placing the order for the ICX35-HWC-A.
This chapter does not go into End Device configuration procedures since it is assumed the user
knows how to configure End Devices. However, examples are provided to show how the End
Device is configured along with the ICX35-HWC.
In this scenario, the user on the laptop wants to communicate with a ControlLogix rack.
To configure the ICX35-HWC, you must supply:
IP Address
Mask
Gateway IP Address
The IP Address of the end device must match the value entered in the End Device
Address parameter in the ICX35-HWC.
The gateway address on the end device must point to the ICX35-HWC IP Address and
Subnet Mask addresses.
In this scenario, Virtual OpenVPN addresses are assigned by the VPN server. If the end device
172.020.000.220 wants to communicate with 192.168.000.211, it must address the device
through the ICX35-HWC VPN address. The ICX35-HWC routes the request as it would a Pass
Through device.
You must establish standard End Device-to-End Device communications before attempting to
configure an OpenVPN tunnel.
The IP Address of the end device connected to ICX35-1 must match the value entered in
the End Device Address parameter in the ICX35-1.
The gateway address on the end device must point to the ICX35-1 IP Address and
Subnet Mask addresses.
The IP Address of the end device connected to ICX35-2 must match the value entered in
the End Device Address parameter in the ICX35-2.
The gateway address on the end device must point to the ICX35-2 IP Address and
Subnet Mask addresses.
Note: Certificate/keys are mandatory as separate files if a custom configuration file is not
used, or if a custom configuration file is provided but does not contain the certificates and
keys inline.
If the certificates and keys are provided both inline in the custom configuration file and
uploaded in the UI, the uploaded files will take precedence.
9. Click APPLY.
10. Perform the same procedure for the ICX35-2.
12. Enter the TLS Renegotiation Time in the appropriate field (see TLS).
13. Enter the OpenVPN server’s IP address in Server IP.
14. Enter the Server Port shown.
15. If user/password authentication is configured on the server, enable the User/Password
Authentication box and provide credentials in the User and Password fields.
16. Choose and upload the Credential Files. Your Server Administrator will provide you with
the certificate files and location.
17. Click APPLY.
Note: The Client Certificate and Client Key files are not used with this type of authentication.
Therefore, this type of authentication is less secure than the default method using certificates.
Note: All authentication methods (Username/Password, Certification, and Key) must be valid in
order for the client to connect to the server.
ProSoft Technology, Inc. is committed to providing the most efficient and effective support
possible. Before calling, please gather the following information to assist in expediting this
process:
Note: For technical support calls within the United States, ProSoft’s 24/7 after-hours phone
support is available for urgent plant-down issues.