.. _ppp:

Point-to-Point Protocol (PPP) Support
#####################################

.. contents::
    :local:
    :depth: 2

Overview
********

`Point-to-Point Protocol
<https://en.wikipedia.org/wiki/Point-to-Point_Protocol>`_ (PPP) is a data link
layer (layer 2) communications protocol used to establish a direct connection
between two nodes. PPP is used over many types of serial links since IP packets
cannot be transmitted over a modem line on their own, without some data link
protocol.

In Zephyr, each individual PPP link is modelled as a network interface. This
is similar to how Linux implements PPP.

PPP support must be enabled at compile time by setting option
:option:`CONFIG_NET_PPP` and :option:`CONFIG_NET_L2_PPP`.
The PPP support in Zephyr 2.0 is still experimental and the implementation
supports only these protocols:

* LCP (Link Control Protocol,
  `RFC1661 <https://tools.ietf.org/html/rfc1661>`__)
* HDLC (High-level data link control,
  `RFC1662 <https://tools.ietf.org/html/rfc1662>`__)
* IPCP (IP Control Protocol,
  `RFC1332 <https://tools.ietf.org/html/rfc1332>`__)
* IPV6CP (IPv6 Control Protocol,
  `RFC5072 <https://tools.ietf.org/html/rfc5072>`__)

See also the :zephyr_file:`samples/net/sockets/echo_server/overlay-ppp.conf`
file for configuration option examples.
For using PPP with GSM modem, see :ref:`gsm_modem` for additional information.

Testing
*******

See the `net-tools README`_ file for more details on how to test the Zephyr PPP
against pppd running in Linux.

.. _net-tools README:
   https://github.com/zephyrproject-rtos/net-tools/blob/master/README.md#ppp-connectivity