WAN interface protocols

:!: The package ppp must be installed to use PPP.

Name Type Required Default Description
device file path yes (none) Modem device node
username string no(?) (none) Username for PAP/CHAP authentication
password string no(?) (none) Password for PAP/CHAP authentication
connect file path no (none) Path to custom PPP connect script
disconnect file path no (none) Path to custom PPP disconnect script
keepalive number no (none) Number of unanswered echo requests before considering the peer dead. The interval between echo requests is 5 seconds.
demand number no (none) Number of seconds to wait before closing the connection due to inactivity
defaultroute boolean no 1 Replace existing default route on PPP connect
peerdns boolean no 1 Use peer-assigned DNS server(s)
dns list of ip addresses no (none) Override peer-assigned DNS server(s)
ipv6 [0,1,auto] no auto Enable IPv6 on the PPP link
0: IPv6 disabled
1: IPv6 enabled
auto: IPv6 enabled. DHCPv6 client enabled.
pppd_options string no (none) Additional command line arguments to pass to the pppd daemon

PPP-based protocols negotiate IPv4 and IPv6 support when the link is established. These protocols require option ipv6 to be specified in the parent config interface wan section if IPv6 support is required. Further configuration can be given in the alias config interface wan6 section – see ipv6.

:!: The packages ppp, kmod-pppoe and ppp-mod-pppoe must be installed to use PPPoE.

opkg update
opkg install ppp kmod-pppoe ppp-mod-pppoe
Name Type Required Default
username string no (none) Username for PAP/CHAP authentication
password string no (none) Password for PAP/CHAP authentication
ac string no (none) Specifies the Access Concentrator to connect to. If unset, pppd uses the first discovered one
service string no (none) Specifies the Service Name to connect to, If unset, pppd uses the first discovered one
host_uniq string no (none) Specifies the PPPoE Host-Uniq tag (hexstring) to connect with. If unset, it uses the pppd process ID
connect file path no (none) Path to custom PPP connect script
disconnect file path no (none) Path to custom PPP disconnect script
keepalive 2 numbers no 5 1 The numbers must be separated by a space. First number is “we assume the connection is down after this number of pings failed” (ppp's lcp-echo-failure option). Second number is for “seconds between each ping” (ppp's lcp-echo-interval option).
keepalive_adaptive boolean no 1 Suppress LCP echo requests if traffic was received more info
demand number no (none) Number of seconds to wait before closing the connection due to inactivity
defaultroute boolean no 1 Replace existing default route on PPP connect
peerdns boolean no 1 Use peer-assigned DNS server(s)
dns list of ip addresses no (none) Override peer-assigned DNS server(s)
ipv6 [0,1,auto] no auto Enable IPv6 on the PPP link. See Protocol “ppp” above
pppd_options string no (none) Additional command line arguments to pass to the pppd daemon e.g debug noipv6

:!: The package ppp-mod-pppoa must be installed to use PPPoA.

Name Type Required Default Description
vci number no 35 PPPoA VCI
vpi number no 8 PPPoA VPI
atmdev number no 0 Specifies the ATM adapter number starting with 0. Most systems only have one ATM device and do not need this option
encaps string no llc PPPoA encapsulation mode: 'llc' (LLC) or 'vc' (VC)
username string no(?) (none) Username for PAP/CHAP authentication
password string no(?) (none) Password for PAP/CHAP authentication
connect file path no (none) Path to custom PPP connect script
disconnect file path no (none) Path to custom PPP disconnect script
keepalive number no (none) Number of connection failures before reconnect
demand number no (none) Number of seconds to wait before closing the connection due to inactivity
defaultroute boolean no 1 Replace existing default route on PPP connect
peerdns boolean no 1 Use peer-assigned DNS server(s)
dns list of ip addresses no (none) Override peer-assigned DNS server(s)
ipv6 [0,1,auto] no auto Enable IPv6 on the PPP link. See Protocol “ppp” above.
pppd_options string no (none) Additional command line arguments to pass to the pppd daemon

:!: The package comgt must be installed to use 3G.

Name Type Required Default Description
device file path yes (none) Modem device node
service string yes umts 3G service type: cdma/evdo, umts/umts_only/gprs_only (...._only options limited to Novatel & Option cards and dongles)
apn string yes (none) Used APN
pincode number no (none) PIN code to unlock SIM card
dialnumber string no *99***1# Modem dial string e.g. *99#
maxwait number no 0 Number of seconds to wait for modem to become ready
username string no(?) (none) Username for PAP/CHAP authentication
password string no(?) (none) Password for PAP/CHAP authentication
keepalive number no (none) Number of connection failures before reconnect
demand number no (none) Number of seconds to wait before closing the connection due to inactivity
defaultroute boolean no 1 Replace existing default route on PPP connect
peerdns boolean no 1 Use peer-assigned DNS server(s)
dns list of ip addresses no (none) Override peer-assigned DNS server(s)
ipv6 [0,1,auto] no auto Enable IPv6 on the PPP link. See Protocol “ppp” above.
delay number no 0 Seconds to wait before trying to interact with the modem (some ZTE modems require up to 30 s.)

:!: The package uqmi must be installed to use QMI.

Name Type Required Default Description
device file path yes (none) QMI device node, typically /dev/cdc-wdm0
apn string yes (none) Used APN
pincode number no (none) PIN code to unlock SIM card
username string no (none) Username for PAP/CHAP authentication
password string no (none) Password for PAP/CHAP authentication
auth string no (none) Authentication type: pap, chap, both, none
modes string no (modem default) Allowed network modes, comma separated list of: all, lte, umts, gsm, cdma, td-scdma
delay number no 0 Seconds to wait before trying to interact with the modem (some ZTE modems require up to 30 s.)

:!: The package comgt-ncm + modem specific driver must be installed to use NCM.

Name Type Required Default Description
device file path yes (none) NCM device node, typically /dev/cdc-wdm0 or /dev/ttyUSB#
apn string yes (none) Used APN
pincode number no (none) PIN code to unlock SIM card
username string no (none) Username for PAP/CHAP authentication
password string no (none) Password for PAP/CHAP authentication
auth string no (none) Authentication type: pap, chap, both, none
mode string no (modem default) Used network mode, not every device support every mode: preferlte, preferumts, lte, umts, gsm, auto
pdptype string no IPV4V6 Used IP-stack mode, IP (for IPv4), IPV6 (for IPv6) or IPV4V6 (for dual-stack) (Designated Driver #46844 and later)
delay number no 0 Seconds to wait before trying to interact with the modem (some modems require up to 30 s.)

:!: The package wwan must be installed to use this feature. The “wwan” protocol detects the right protocol (3G/QMI/NCM/MBIM) for the USB Modem model and passes the configuration to the protocol.

Name Type Required Default Description
apn string yes (none) Used APN
auth string no (none) Authentication type: pap, chap, both, none
username string no (none) Username for PAP/CHAP authentication
password string no (none) Password for PAP/CHAP authentication
pincode number no (none) PIN code to unlock SIM card
modes string no (modem default) Allowed network modes, comma separated list of: all, lte, umts, gsm, cdma, td-scdma
delay number no 0 Seconds to wait before trying to interact with the modem (some ZTE modems require up to 30 s.)

Below are a few examples for special, non-standard interface configurations.

config interface 'wan'
        option proto     'pppoe'
        option device    'eth0'
        option username  'user'
        option password  'pass'
        option keepalive '4 5'
config adsl-device 'adsl'
        option fwannex 'a'
        option annex 'a'
 
config interface 'wan'
        option proto 'pppoa'
        option username 'jbloggs@plusdsl.net'
        option password 'XXXXXXXXX'
        option vpi '0'
        option vci '38'
        option encaps 'vc'
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
  • Last modified: 2024/01/18 14:00
  • by charles_harris