nRF93M1 DK: PPP shell

This sample establishes a PPP connection between the nRF54L15 host core and the nRF93M1 modem over a CMUX-multiplexed UART link, giving shell-driven access to IP networking and performance testing tools.

Requirements

The sample supports the following development kit:

Hardware platforms

PCA

Board name

Board target

nRF93M1 DK

nrf93m1dk

nrf93m1dk/nrf54l15/cpuapp

Overview

The sample uses the Zephyr modem cellular driver with CMUX to multiplex the single physical UART between the PPP data channel and an AT command channel. The AT command channel is made available through the AT command shell (CONFIG_MODEM_AT_SHELL) backend so that AT commands can be issued from the shell.

IPv4, IPv6, DNS, TCP, UDP, and POSIX sockets are all enabled. The zperf networking performance tool is included for throughput testing.

The nRF93M1 side requires no additional firmware preparation, as the nRF54L15 host completely controls the modem.

The UART baud rate is 115200.

Building and running

This sample can be found under samples/nrf93m1dk/ppp_shell in the nRF Connect SDK folder structure.

To build the sample, follow the instructions in Building an application for your preferred building environment. See also Programming an application for programming steps and Testing and optimization for general information about testing and debugging in the nRF Connect SDK.

Note

When building repository applications in the SDK repositories, building with sysbuild is enabled by default. If you work with out-of-tree freestanding applications, you need to manually pass the --sysbuild parameter to every build command or configure west to always use it.

Testing

After programming the sample to the development kit, complete the following steps to establish the PPP connection:

  1. Connect the kit to the host PC using a USB cable and open a serial terminal at 115200 baud.

  2. Initialize the PPP interface:

    uart:~$ net iface up 1

    The shell prints network management events as the connection is established. When connectivity is available, you will see output similar to:

    EVENT: L4 [1] IPv4 connectivity available

  3. Verify the IP configuration:

    uart:~$ net iface

  4. Close the PPP connection when you are done:

    uart:~$ net iface down 1