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