Serial LTE Modem¶
Overview¶
The Serial LTE Modem (SLM) application can be used to emulate a stand-alone LTE modem on the nRF9151 Connect Kit. The application accepts both the modem-specific AT commands and proprietary AT commands. The AT commands are documented in the following guides:
- Modem-specific AT commands - nRF91x1 AT Commands Reference Guide
- Proprietary AT commands - SLM-specific AT commands
Requirements¶
Before you start, check that you have the required hardware and software:
- 1x nRF9151 Connect Kit
- 1x nano-SIM card with LTE-M or NB-IoT support
- 1x U.FL cabled LTE-M/NB-IoT/NR+ Flexible Antenna (included in the box)
- 1x U.FL cabled GNSS Antenna (included in the box)
- 1x USB-C Cable
- Serial Studio v3.0.6 or newer
- A computer running macOS, Ubuntu, or Windows 10 or newer
Set up your board¶
- Insert the nano-SIM card into the nano-SIM card slot.
- Attach the U.FL cabled LTE-M/NB-IoT/NR+ Flexible Antenna.
- Attach the U.FL cabled GNSS Antenna.
- Connect the nRF9151 Connect Kit to the computer with a USB-C cable.
Building the application¶
To build the application, follow the instructions in Getting Started Guide to set up your preferred building environment.
Use the following steps to build the Serial LTE Modem application on the command line.
-
Open a terminal window.
-
Go to
NCS-Project/nrf9151-connectkit
repository cloned in the Getting Started Guide. -
Build the application using the
west build
command, specifying the board (following the-b
option) asnrf9151_connectkit/nrf9151/ns
.The
-p
always option forces a pristine build, and is recommended for new users. Users may also use the-p auto
option, which will use heuristics to determine if a pristine build is required, such as when building another application.Note
This application has Cortex-M Security Extensions (CMSE) enabled and separates the firmware between Non-Secure Processing Environment (NSPE) and Secure Processing Environment (SPE). Because of this, it automatically includes the Trusted Firmware-M (TF-M).
-
After building the application successfully, the firmware with the name
merged.hex
can be found in thebuild
directory.
Flashing the firmware¶
Set up your board before flashing the firmware. You can flash the application using west flash
:
Tip
In case you wonder, the west flash
will execute the following command:
Testing¶
After programming the application, test it by performing the following steps:
-
Start Serial Studio application, and complete the following steps:
- Select DEVICE SETUP ->
Serial Port
. - Select FRAME PARSING ->
No Parsing
. - Select the correct serial port that your computer uses to communicate with the nRF9151 SiP from the COM Port drop-down list.
- Select Baud Rate ->
115200
, Data Bits ->8
, Parity ->None
, Stop Bits ->1
, Flow Control ->None
. - Select Send DTR Signal.
- Click Connect .
- Select Line Ending ->
CR+NL
.
- Select DEVICE SETUP ->
-
Press the DFU/RST button to reset the nRF9151 SiP.
-
Observe that the board sends a
Ready\r\n
message on the console. -
Send AT commands and observe the responses from the board. See Testing scenarios for typical test cases.