GSM/Edge Provisioning with ConnectPort X2e SE (Smart Energy) Cellular Gateways
Mobile Setup Process
For GSM-based devices, the mobile setup process is as follows.
- Obtain an account with your carrier of choice. The carrier will provide a SIM card and account information, such as the APN and possibly a username and password for the account.
- Install the SIM card in the device.
- Using a small screwdriver, remove the SIM card cage labeled SIM.
- Insert the SIM card in the card cage, with the card oriented as shown in the drawing. Make sure card is firmly inserted into the card cage.
- Replace the cage in the slot until it clicks.
- Power on the device.
- Navigate to the web interface by pressing the button on the gateway face plate. You have about 10 seconds from the time you press the reset button to open the web interface, after which it becomes inaccessible again.
- Go to the Configuration > Mobile Connectivity page. Within the Current Settings section, enter the connection settings for the cellular modem in the device. This information should be available from your service provider and varies by service provider. In some cases, a username, password, or PIN are not necessary.
- Enter the Access Point Name (APN).
- Enter the username and the password, if provided.
- Enter the SIM PIN, if provided.
- Click Apply to save the mobile connectivity information to the Gateway.
Note: SMS settings are enabled by default.
- Go to the Administration > Mobile Status page.
- The device should then be able to connect to the mobile network. The status fields on the Administration > Mobile Status fields will change to reflect the connectivity status.
- If the device successfully connects to the networks, two key connectivity status fields should read as follows: SIM Pin State: READY and Connection state: Connected, as in the example below.
If the device does not connect to the network, you do not see SIM Pin State
on the Mobile Status page, and/or the Connection state
field has any other value than Connected
, additional setup and troubleshooting is necessary.9. Once the gateway is connected to the internet/Digi Device Cloud, the Smart Energy network can now be formed.
IMPORTANT: The Router variant of this model must be successfully joined to a Smart Energy network before proceeding. Please contact the Utility or owner of the Smart Meter (or other Coordinator) if unsure how to add your Router to the network. The Router must be powered ON when being added or removed on a Smart Energy network.
Create/login to a Device Cloud Account:
1. Go to: http://www.digi.com/cloud/digi-device-cloud.
2. Click FREE DEVELOPER EDITION ACCOUNT to create a new developer Device Cloud account.
3. Go to https://devicecloud.digi.com and login with your new Device Cloud credentials.
Add Gateway(s) to Device Cloud Account:
1. Navigate to the Device Management menu tab.
2. Click the Add Devices button
3. Click on the Discover button to discover gateways on the local LAN/Network or to manually add the gateway,enter in the MAC address and click Add. Example MAC address format:
Where XXXXXX represents the last 6 digits of your Device MAC address.
View Device Readings/data:
Login to https://digi-se.appspot.com using your Device Cloud credentials.
1. Navigate to the Network -> In-Home Display or Network-> Tree menu tab.
2. Select the desired gateway from the drop down box
Digi SureLink™ is an optional feature that monitors the integrity of an established network
connection. Several settings and tests can be configured to perform a selected test to examine the
functional integrity of the network connection, and take action to recover the connection in the
event that it is lost. Details can be found in the following knowledge base article:
Digi SureLink™ Configuration
|Color and blink pattern||Ethernet||Wi-Fi||Cellular|
|OFF||No Ethernet detected.||No Wi-Fi AP or Ad-Hoc networks detected.||No cellular network detected.|
|Blinking yellow, slow||Ethernet interface identified; waiting for link.||Wi-Fi AP or Ad-Hoc network detected. Connecting to Wi-Fi. Waiting for association.||Cellular network(s) detected. Registering on cellular network.|
|Blinking yellow, fast||Connected to Ethernet. Establishing LAN connection. Waiting for IP address.||Connected to Wi-Fi. Establishing LAN connection. Waiting for IP address.||Registered on cellular network. Establishing WAN connection. Waiting for IP address.|
|Solid yellow||An IP address has been assigned to the gateway. Connected to LAN. Waiting for Device Cloud service to take control, and for DNS resolution of server chosen by Device Cloud.||An IP address has been assigned to the gateway. Connected to LAN. Waiting for Device Cloud service to take control, and for DNS resolution of server chosen by Device Cloud.||An IP address has been assigned to the gateway. Connected to WAN. Waiting for Device Cloud service to take control, and for DNS resolution of server chosen by Device Cloud.|
|Alternating between yellow and green||
The gateway cannot connect to Device Cloud. The two most common reasons for this state are:
- The gateway cannot connect to a DNS server to resolve the Device Cloud server address. See below for instructions.
- The gateway cannot connect to an NTP time server to get the correct time. See below for instructions.
|Blinking green, slow||Verifying Internet connection. Waiting for network connection to the chosen server.|
|Blinking green, fast||Connected to Internet. Establishing Device Cloud connection. Waiting for protocol level “connection” with Device Cloud server, which might include authentication.|
|Solid green||Gateway is connected to Device Cloud server.|
Following are some key provisioning-related fields on the Mobile Status page.
|Mobile Status field||Description|
|SIM PIN status||
GSM Indicates whether a PIN needs to be entered to unlock the SIM card. There area many possible status values; some common ones are:
- READY: SIM is ready. PIN has been entered or no PIN is needed.
- SIM PIN: PIN is required to unlock the SIM. It can be entered on the Mobile Configuration page.
- SIM PUK, SIM PIN2, SIM PUK2, and similar codes: SIM is locked and cannot be unlocked by the ConnectPort X2e SE Cellular device. It must be placed in another device or phone to be unlocked.
- Error: SIM not inserted or other SIM problem.
|SIM slot index||
Displayed for products that support multiple SIMs only. Indicates which SIM slot is currently in use by the device. 0 means the first slot, 1 means the second slot.
Received cellular signal strength indicator (RSSI). A measure of the signal level of the network.
For GSM, a signal strength of -108 or more is equivalent to 1 bar, -93 to 2 bars, and -77 to 3 bars.
An indicator of the received cellular signal, in bars.
0: No signal
1: Poor signal
2: Adequate signal
3: Good signal
|Signal quality||An indicator of the quality of the received cellular signal, measured in dB.This value is also known as Ec/Io.|
|Registration status||The status of the cellular modem’s connection to a cellular network. |
- Not registered
- Registered (Home network)
- Searching for Network
- Not Registered (Access Denied)
- Not Available (Reason not Known)
- Registered (Roaming)
|Mobile country code /|
Mobile network code
|These codes are used to uniquely identify a mobile phone operator/carrier with which the cellular modem is registered. For example, for AT&T, these codes would be 310 and 410.|
|Connection state||The operating state of the cellular modem:|
- Initializing: Modem is being reset and configured
- Registering: Modem is searching for a network
- Delay before connecting: Modem is delaying after an unsuccessful connection (Verizon only)
- Connecting: Mobile data connection is being established
- Connected: Mobile data connection is active
- Disconnecting: Mobile data connection is ending
- Disconnected: Mobile data connection has ended. See Disconnect reason for the cause.
- Disabled: Mobile data connection is not enabled by configuration settings.
- No device found: Modem is not available or is malfunctioning.
Displayed after a connection error occurs only. Indicates the reason the previous connection attempt failed:
- SIM PIN required: The SIM PIN must be entered on the Mobile Configuration page.
- SIM PIN incorrect: The SIM PIN entered does not match the actual one for the SIM.
- SIM not ready: No SIM inserted or other SIM problem.
- Not registered: Modem did not register with a cellular network.
- Dial failed: Error starting data connection.
- Authentication failed: Incorrect login or password entered on the Mobile Configuration page.
- Connection timeout: Connection did not complete.
- Device reset error: Modem could not be reset.
- Device open error: Modem is malfunctioning.
- Device config error: Modem could not be configured.
- PPP error: Internal system error
|Disconnect reason||Displayed after a previous connection was ended. Indicates the reason the previous connection was ended:|
- User requested: Initiated by user action.
- Network disconnect: Initiated by cellular network or carrier.
- Carrier loss: Poor signal or disconnected by network.
- Connection timer: Connection did not complete.
- Receive idle timer: No data received for configured receive idle time.
- Device monitoring error: Error while monitoring the modem status. May indicate a malfunctioning modem.
|IP address||Internet protocol address of the mobile data interface. The device may be contacted at this IP address if permitted by the carrier.|
|DNS primary address|
IP address of the primary Domain Name System (DNS) server assigned by the mobile carrier. This server resolves domain names to IP addresses. For more information on how the ConnectPort X2e ZB device uses this value and DNS secondary address, go here.
|DNS secondary address||IP address of the backup DNS server assigned by the mobile carrier.|