summaryrefslogtreecommitdiff
path: root/docs/configuration/interfaces/wwan.rst
blob: cfe074f62ede500c347667b1d1021c00bce6f9a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
.. _wwan-interface:

#################################
Wireless Wide-Area-Network (WWAN)
#################################

The Wireless Wide-Area-Network interface provides access (through a wireless
modem/wwan) to wireless networks provided by various cellular providers.

VyOS uses the `interfaces wwan` subsystem for configuration.

*************
Configuration
*************

Common interface configuration
==============================

.. cmdinclude:: /_include/interface-address-with-dhcp.txt
   :var0: wwan
   :var1: wwan0


.. cmdinclude:: /_include/interface-description.txt
   :var0: wwan
   :var1: wwan0

.. cmdinclude:: /_include/interface-disable.txt
   :var0: wwan
   :var1: wwan0

.. cmdinclude:: /_include/interface-disable-link-detect.txt
   :var0: wwan
   :var1: wwan0

.. cmdinclude:: /_include/interface-mtu.txt
   :var0: wwan
   :var1: wwan0

.. cmdinclude:: /_include/interface-ip.txt
   :var0: wwan
   :var1: wwan0

.. cmdinclude:: /_include/interface-ipv6.txt
   :var0: wwan
   :var1: wwan0

.. cmdinclude:: /_include/interface-vrf.txt
   :var0: wwan
   :var1: wwan0

**DHCP(v6)**

.. cmdinclude:: /_include/interface-dhcp-options.txt
   :var0: wwan
   :var1: wwan0

.. cmdinclude:: /_include/interface-dhcpv6-options.txt
   :var0: wwan
   :var1: wwan0

.. cmdinclude:: /_include/interface-dhcpv6-prefix-delegation.txt
   :var0: wwan
   :var1: wwan0

WirelessModem (WWAN) options
============================

.. cfgcmd:: set interfaces wwan <interface> apn <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. Contact your Service Provider for correct APN.


*********
Operation
*********

TBD

*******
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 wwan wwan0 apn 'internet.telekom'
  set interfaces wwan wwan0 address 'dhcp'

*****************
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)
* Huawei ME909s-120 miniPCIe card (LTE)