Kona Gateways
      Back to home
      1. Knowledge Hub
      2. Kona Gateways

      Cellular Backhaul Commands (Sierra Wireless)

      Please note that the commands listed below are intended for debugging purposes. We do not recommend using below commands in conjunction with scripts to query or configure the modem as this has been known to cause issues with the gateway's connection manager.

      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