Mistake on this page?
Report an issue in GitHub or email us

IP networking

IP Networking in Mbed OS is layered in three clearly defined API levels. The diagram below shows the layers next to the closest matching OSI model layers.

IP networking

The following sections introduce the APIs and technologies implemented in each level.

Socket API

The Socket API is the common API among all IP connectivity methods. All network stacks in Mbed OS provide the same Socket API, making applications portable among different connectivity methods or even stacks.

In the OSI model, the Socket API relates to layer 4, the Transport layer. In Mbed OS, the Socket API supports both TCP and UDP protocols.

Refer to Socket API reference for usage instructions.

IP stacks

Mbed OS has three options to select for the IP stack. The connectivity modules provides two built-in IP stacks or an external IP stack.

Network stack

As the diagram above shows, all stacks implement the same Socket API. Therefore, the application developer rarely needs to know which stack is going to be used. Mbed OS chooses one at the build time, and usually it is LwIP.

Some external Wi-Fi modules and most cellular modules are in fact external IP stacks from the application point of view. In that case, the network driver implements the full Network stack API. These drivers usually drive the module through an AT-command type of interface. Using an external IP module saves RAM and Flash, but depending on the driver and AT-command interface, it might not properly match the full Socket API.

The following table summarizes different stacks, use cases and their limitations.

Stack Network protocols supported Use cases Limitations
LwIP IPv4, IPv6, PPP Ethernet, Wi-Fi, 2G/3G/4G Cellular 4 sockets, 1 interface, no routing
Nanostack IPv6, 6LoWPAN Mesh networking, Border Router Only IPv6
External IP module Depends on the module (Save RAM/Flash) Depends on the module. Usually poor match to Socket API

Configuring the IP stack interface

Depending on the Layer 3, Network layer, protocol used, there are different ways to configure the interface. It also depends on the stack used, which configurations are supported on each link layer.

Stack Data link layer Network layer Configurations supported
LwIP Ethernet, WiFi IPv4 DHCP, static
LwIP Ethernet, WiFi IPv6 RFC 4862 IPv6 Stateless Address Autoconfiguration. No DHCPv6 support
LwIP PPP IPv4,IPv6 automatic
Nanostack Ethernet IPv6 static or RFC 4862 IPv6 Stateless Address Autoconfiguration. No DHCPv6 support
Nanostack IEEE 802.15.4 6LoWPAN 6LoWPAN-ND+RPL

Network interfaces

Network interfaces are the application level APIs where users choose the driver, connectivity method and IP stack. Each connectivity methods requires different configuration, so these APIs are not interchangeable. The application developer must choose one. Choosing the interface also automatically pulls in the network stack as a dependency.

Please note that the interface API is not the same as the network driver. The interface API is the control interface for the application. The network driver implements the controlling API only if it requires configuration from application. From the application point of view, there is no difference, but the network driver developer needs to be aware of that.

Mbed OS implements the following network interface APIs:

  • Ethernet.
  • Wi-Fi.
  • Cellular (PPP).
  • 6LoWPAN-ND mesh networking.
  • Wi-SUN mesh networking.

Refer to Network Interface API reference for usage instructions.

Network drivers

"Network driver" describes different APIs that connect a networking device to the IP stack or Socket API. Below is a description of each driver API.

Ethernet driver

Emac API

Ethernet drivers are implemented using the stack-independent EMAC API. Because the Ethernet driver requires no configuration, it does not implement any controlling interface for the application.

Wi-Fi driver

Wi-Fi driver

There are two types of Wi-Fi drivers in Mbed OS, depending on which protocol layer it implements. Wi-Fi drivers are either a special case of Ethernet driver or external IP stacks. Wi-Fi drivers require configuration from an application and, therefore, implement both the low level EMAC API or Network stack API and the high level controlling interface API called WiFiInterface.

Cellular modem driver

Cellular driver

Cellular drivers have the same two separate cases as Wi-Fi. If they use an external IP stack, the driver implements the Network stack API. If they use the internal IP stack, LwIP, then they implement the Serial PPP driver.

Mesh (Wi-SUN, 6LoWPAN-NDead) RF driver

RF driver

On Mesh networks, Nanostack uses IEEE 802.15.4 radios for transmitting and receiving packets. The RF driver implements the NanostackRfPhy API.

This driver type has no other use cases, so it is implemented in C using a Nanostack-specific API.

Please see Porting a new RF driver for the 6LoWPAN stack for more information.

Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.