zephyr/doc/reference/networking/ppp.rst

48 lines
1.5 KiB
ReStructuredText

.. _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.
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