Cellular Backhaul Commands (Sierra Wireless)

Cellular Backhaul Commands (Sierra Wireless)

Introduction

Requirements:
  1. Kona Gateway with Cellular Backhaul. If you are unsure if your gateway features cellular backhaul, please consult the user guide for your gateway and cross-reference it with the T-code (i.e. T000XXYY) BEFORE proceeding with this article.
  2. SSH access to the gateway.
This article will contain commands to configure the cellular backhaul of your Kona Gateway. These commands ONLY apply to gateways with Sierra Wireless modems.
To determine if your gateway has the correct modem model, please follow the below steps:
1. SSH into your gateway.
2. Run the following command: konaLTEmodem.py -c 'ati'

Command Usage

There are two ways to execute a command - in one line or within the script.
  1. One line: konaLTEmodem.py -c '<insert command here>'
  2. Within the script: First enter "konaLTEmodem.py" by itself, then enter your command.

Set APN

There are two ways to set an APN - through KonaFT or through command-line.
  1. In the command-line, enter the following command: at+cgdcont=1,"IP","<APN_OF_SIM_U_R_USING>","0.0.0.0",0,0
  2. The "1" in the command indicates the profile index. To set the 2nd profile, replace it with a 2.

Check APN profiles

There are two ways to check APN profiles - through KonaFT or through command-line.
  1. In the command-line, enter the following command: at+cgdcont?
  2. Example: konaLTEmodem.py -c 'at+cgdcont?';

Check Modem Statistics

Command: at!gstatus?
Example output:
  1. root@kona-micro:~# konaLTEmodem.py -c 'at!gstatus?';
at!gstatus?
!GSTATUS: 
Current Time:  2240             Temperature: 45
Reset Counter: 31               Mode:        ONLINE         
System mode:   LTE              PS state:    Attached     
LTE band:      B7               LTE bw:      10 MHz  
LTE Rx chan:   2800             LTE Tx chan: 20800
LTE CA state:  NOT ASSIGNED
EMM state:     Registered       Normal Service 
RRC state:     RRC Connected  
IMS reg state: No Srv  

PCC RxM RSSI:  -84              RSRP (dBm):  -109
PCC RxD RSSI:  -82              RSRP (dBm):  -105
Tx Power:      --               TAC:         DACF (56015)
RSRQ (dB):     -7.0             Cell ID:     087A035D (142213981)
SINR (dB):     13.6


OK

Check Modem status

Command: ati
Example output:
  1. root@kona-micro:~# konaLTEmodem.py -c 'ati';
ati
Manufacturer: Sierra Wireless, Incorporated
Model: EM7455
Revision: SWI9X30C_02.30.01.01 r7792 CARMD-EV-FRMWR2 2018/07/13 02:24:52
MEID: 35907306215981
ESN: 12805526736, 805454D0
IMEI: 359073062159813
IMEI SV: 16
FSN: LF852183970110
+GCAP: +CGSM


OK

Check Modem firmware

Command: at!gobiimpref?
Example output:
  1. root@kona-micro:~# konaLTEmodem.py -c 'at!gobiimpref?';
at!gobiimpref?
!GOBIIMPREF: 
 preferred fw version:    02.30.01.01
 preferred carrier name:  GENERIC
 preferred config name:   GENERIC_002.045_001
 current fw version:      02.30.01.01
 current carrier name:    GENERIC
 current config name:     GENERIC_002.045_001

OK

Check ICCID

Command: at+ccid
Command: at+iccid
Example output:
  1. root@kona-micro:~# konaLTEmodem.py -c 'at+iccid'
    at+iccid
    ICCID: [string of numbers]
    OK

Check SIM Status

Command: at+cpin?
Example output:
  1. :at+cpin?
    at+cpin?
    +CPIN: READY
    OK

Check Active SIM slot

Command: at!uims?
Example output:
  1. :at!uims?
    at!uims?
    !UIMS: 0
    OK

Change active SIM slot

Command: at!uims=[0/1]
Example output:
  1. :at!uims=1
    at!uims=1
    OK

Checking if SIM is locked with PIN

Command: at+clck="sc",2
Check output.
  1. +CLCK: 0 means that the SIM is NOT LOCKED.
  2. +CLCK: 1 means that the SIM is LOCKED.
Example output:
  1. :at+clck="sc",2
    at+clck="sc",2
    +CLCK: [0 or 1]

Lock/Unlock SIM with PIN

To remove/disable/unlock the PIN for SIM:

Command: at+clck="sc",0,"<PIN>"
Example output:
  1. :at+clck="sc",0,"<PIN>"
    at+clck="sc",0,"<PIN>"
    OK

To Lock/Enable the SIM with PIN:

Command: at+clck="sc",1,"<PIN>"
Example output:
  1. :at+clck="sc",1,"<PIN>"
    at+clck="sc",1,"<PIN>"
    OK

Enter SIM PIN:

Command: at+cpin=<SIM PIN>

Change SIM PIN:

Command: at+cpwd="SC","<current PIN>","<New PIN>"
Example: Changing SIM PIN to "1234"
  1. :at+cpwd="SC","0000","1234"
    at+cpwd="SC","0000","1234"
    OK

Note:

If the user enters wrong PIN, after 3 tries (3 bootup), the SIM will be locked. To unlock the SIM, user has to obtain "PUK" code from the cellular provider.

Once they get the "PUK" then they have to use this PUK and set the new SIMPIN. Then they can start using this new SIMPIN. This can be done using "AT" commands.

Example locked output:
  1. :at+cpin?
    at+cpin?
    +CPIN: SIM PUK
    OK
Changing PIN with PUK:
  1. :at+cpin="77700212","1234"
    at+cpin="77700212","1234"
    OK
Verify that SIM is not locked:
  1. :at+cpin?
    at+cpin?
    +CPIN: READY
    OK

    • Related Articles

    • Kona Gateway Cellular Backhaul FAQ

      This article applies to Kona Gateways with cellular backhaul featured. You can find gateway specific FAQs here: Kona Micro / Micro PoE Kona Enterprise Kona Macro Kona Mega General FAQ Cellular Backhaul FAQ (you are here) Network Monitoring FAQ ...

    • Cellular Interface Configuration on Kona Micro Gateway

      To access the document outlining the procedure to configure cellular interface on Kona Micro Gateway, you can go to attachment section of this article.

    • Cellular Interface Configuration on Kona Macro Gateway

      To access the document outlining the procedure to configure cellular interface on Kona Macro Gateway, you can go to attachment section of this article.

    • Kona Gateway Network Monitoring FAQ

      This article applies to Kona Gateways with cellular backhaul featured. You can find gateway specific FAQs here: Kona Micro / Micro PoE Kona Enterprise Kona Macro Kona Mega General FAQ Cellular Backhaul FAQ Network Monitoring FAQ (you are here) ...

    • Kona Enterprise Gateway Quick Start Guide

      See attachment for current Kona Enterprise Quick Start Guide