From d481781147cffb1bcd23b55d74e8f7a5bedd81b7 Mon Sep 17 00:00:00 2001 From: Federico Capoano Date: Thu, 6 Apr 2017 17:49:46 +0200 Subject: [PATCH] [docs] Added OpenWRT PPPoE example --- docs/source/backends/openwrt.rst | 41 ++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/docs/source/backends/openwrt.rst b/docs/source/backends/openwrt.rst index 4b90c0222..69e4cac85 100644 --- a/docs/source/backends/openwrt.rst +++ b/docs/source/backends/openwrt.rst @@ -472,6 +472,47 @@ Will be rendered as follows:: option ifname 'eth0' option proto 'dchpv6' +Using different protocols +~~~~~~~~~~~~~~~~~~~~~~~~~ + +OpenWRT and LEDE support many protocols (pppoe, pppoa, pptp, l2tp, ecc) and +the list of supported protocols evolves over time. + +OpenWISP and netjsonconfig try to stay out of your way by leaving you maximum +flexibility to use any protocol and any configuration option you may need, +just set ``type`` to ``other``, then proceed by setting `proto` and any other +configuration option according to your needs, see the example below. + +PPPoE proto example +^^^^^^^^^^^^^^^^^^^ + +The following configuration dictionary: + +.. code-block:: python + + { + "interfaces": [ + { + "type": "other", + "name": "eth0", + "network": "wan", + "proto": "pppoe", + "username": "", + "password": "" + } + ] + } + +Will be rendered as follows:: + + package network + + config interface 'wan' + option ifname 'eth0' + option password '' + option proto 'ppoe' + option username '' + Bridge settings ---------------