Show pagesourceOld revisionsBacklinksBack to top × Table of Contents WAN interface protocols Protocol "ppp" (PPP over Modem) Protocol "pppoe" (PPP over Ethernet) Protocol "pppoa" (PPP over ATM AAL5) Protocol "3g" (PPP over EV-DO, CDMA, UMTS or GPRS) Protocol "qmi" (USB modems using QMI protocol) Protocol "ncm" (USB modems using NCM protocol) Protocol "wwan" (USB modems autodetecting above protocols) Examples PPPoE internet connection PPPoA ADSL internet connection WAN interface protocols Protocol "ppp" (PPP over Modem) 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. Protocol "pppoe" (PPP over Ethernet) 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 Description Example 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 (hex) to connect with. If unset, it uses the pppd process ID option host_uniq 'b33f0000' 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 (none) 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). option keepalive '5 5' 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 option pppd_options 'debug noipv6' Protocol "pppoa" (PPP over ATM AAL5) 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 Protocol "3g" (PPP over EV-DO, CDMA, UMTS or GPRS) 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.) Protocol "qmi" (USB modems using QMI protocol) 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.) Protocol "ncm" (USB modems using NCM protocol) 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.) Protocol "wwan" (USB modems autodetecting above protocols) 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.) Examples Below are a few examples for special, non-standard interface configurations. PPPoE internet connection config 'interface' 'wan' option 'proto' 'pppoe' option 'ifname' 'eth1' option 'username' 'user' option 'password' 'pass' option 'timeout' '10' PPPoA ADSL internet connection 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.OKMore information about cookies Last modified: 2022/12/27 06:02by charles_harris