.. _wwan-interface: #################### WirelessModem (WWAN) #################### Configuration ############# The wirelessmodem interface provides access (through a wireless modem/wwan) to wireless networks provided by various cellular providers. VyOS uses the interfaces wirelessmodem subsystem for configuration. Address ------- .. cfgcmd:: set interfaces wirelessmodem apn Every WWAN connection requires an :abbr:`APN (Access Point Name)` which is used by the client to dial into the ISPs network. This is a mandatory parameter. See the following list of well-known APNs: - AT&T (isp.cingular) - Deutsche Telekom (internet.t-d1.de or internet.telekom) .. cfgcmd:: set interfaces wirelessmodem backup distance Configure metric of the default route added via the Wireless Modem interface. The default metric if not specified is 10. .. cfgcmd:: set interfaces wirelessmodem device Device identifier of the underlaying physical interface. This is usually a ttyUSB device, if not configured this defaults to ttyUSB2. .. cfgcmd:: set interfaces wirelessmodem no-peer-dns Do not install DNS nameservers received from ISP into system wide nameserver list. .. cfgcmd:: set interfaces wirelessmodem ondemand Enables or disables on-demand WWAN connection. Use this command to instruct the system to establish a PPP connection automatically once traffic passes through the interface. A disabled on-demand connection is established at boot time and remains up. If the link fails for any reason, the link is brought back up immediately. Link Administration ------------------- .. cfgcmd:: set interfaces wirelessmodem description Assign given `` to interface. Description will also be passed to SNMP monitoring systems. .. cfgcmd:: set interfaces wirelessmodem disable Disable given ``. It will be placed in administratively down state. .. cfgcmd:: set interfaces wirelessmodem mtu Configure :abbr:`MTU (Maximum Transmission Unit)` on given ``. It is the size (in bytes) of the largest ethernet frame sent on this link. Example ======= The following example is based on a Sierra Wireless MC7710 miniPCIe card (only the form factor in reality it runs UBS) and Deutsche Telekom as ISP. The card is assembled into a :ref:`pc-engines-apu4`. .. code-block:: none set interfaces wirelessmodem wlm0 apn 'internet.telekom' set interfaces wirelessmodem wlm0 backup distance '100' set interfaces wirelessmodem wlm0 device 'ttyUSB2' set interfaces wirelessmodem wlm0 disable set interfaces wirelessmodem wlm0 no-peer-dns Operation ========= .. opcmd:: show interfaces wirelessmodem Retrive interface information from given WWAN interface. .. code-block:: none vyos@vyos:~$ show interfaces wirelessmodem wlm0 wlm0: mtu 1500 qdisc pfifo_fast master black state UNKNOWN group default qlen 3 link/ppp inet 10.26.238.93 peer 10.64.64.64/32 scope global wlm0 valid_lft forever preferred_lft forever Description: baaar RX: bytes packets errors dropped overrun mcast 38 5 0 0 0 0 TX: bytes packets errors dropped carrier collisions 217 8 0 0 0 0 .. opcmd:: show interfaces wirelessmodem statistics Retrive interface statistics from given WWAN interface. .. code-block:: none vyos@vyos:~$ show interfaces wirelessmodem wlm0 statistics IN PACK VJCOMP VJUNC VJERR | OUT PACK VJCOMP VJUNC NON-VJ 38 5 0 0 0 | 217 8 0 0 8 .. opcmd:: show interfaces wirelessmodem log Displays log information for a WWAN interface. Supported Modules ################# The following hardware modules have been tested successfully in an :ref:`pc-engines-apu4` board: * Sierra Wireless AirPrime MC7304 miniPCIe card (LTE) * Sierra Wireless AirPrime MC7430 miniPCIe card (LTE) * Sierra Wireless AirPrime MC7455 miniPCIe card (LTE) * Sierra Wireless AirPrime MC7710 miniPCIe card (LTE) * Huawei ME909u-521 miniPCIe card (LTE)