Mistake on this page?
Report an issue in GitHub or email us
Public Types | Public Member Functions | Static Public Member Functions
L3IP Class Referenceabstract

This interface should be used to abstract low level access to networking hardware All operations receive a void * hardware pointer which an l3ip device provides when it is registered with a stack. More...

#include <L3IP.h>

Inheritance diagram for L3IP:
Cellular_driver_L3IP

Public Types

typedef mbed::Callback< void(net_stack_mem_buf_t *buf)> l3ip_link_input_cb_t
 Callback to be registered with L3IP interface and to be called for received packets. More...
 
typedef mbed::Callback< void(bool up)> l3ip_link_state_change_cb_t
 Callback to be registered with L3IP interface and to be called for link status changes. More...
 

Public Member Functions

virtual uint32_t get_mtu_size () const =0
 Return maximum transmission unit. More...
 
virtual uint32_t get_align_preference () const =0
 Gets memory buffer alignment preference. More...
 
virtual void get_ifname (char *name, uint8_t size) const =0
 Return interface name. More...
 
virtual bool link_out (net_stack_mem_buf_t *buf)=0
 Sends the packet over the link. More...
 
virtual bool power_up ()=0
 Initializes the hardware. More...
 
virtual void power_down ()=0
 Deinitializes the hardware. More...
 
virtual void set_link_input_cb (l3ip_link_input_cb_t input_cb)=0
 Sets a callback that needs to be called for packets received for that interface. More...
 
virtual void set_link_state_cb (l3ip_link_state_change_cb_t state_cb)=0
 Sets a callback that needs to be called on link status changes for given interface. More...
 
virtual void add_ipv4_multicast_group (const SocketAddress &address)=0
 Add device to an IP4 multicast group. More...
 
virtual void add_ipv6_multicast_group (const SocketAddress &address)=0
 Add device to an IP6 multicast group. More...
 
virtual void remove_ipv4_multicast_group (const SocketAddress &address)=0
 Remove device from an IPV4 multicast group. More...
 
virtual void remove_ipv6_multicast_group (const SocketAddress &address)=0
 Remove device from an IPV6 multicast group. More...
 
virtual void set_all_multicast (bool all)=0
 Request reception of all multicast packets. More...
 
virtual void set_memory_manager (NetStackMemoryManager &mem_mngr)=0
 Sets memory manager that is used to handle memory buffers. More...
 

Static Public Member Functions

static L3IPget_default_instance ()
 Return the default on-board L3IP. More...
 

Detailed Description

This interface should be used to abstract low level access to networking hardware All operations receive a void * hardware pointer which an l3ip device provides when it is registered with a stack.

Definition at line 31 of file L3IP.h.

Member Typedef Documentation

typedef mbed::Callback<void (net_stack_mem_buf_t *buf)> l3ip_link_input_cb_t

Callback to be registered with L3IP interface and to be called for received packets.

Parameters
bufReceived data

Definition at line 47 of file L3IP.h.

Callback to be registered with L3IP interface and to be called for link status changes.

Parameters
upLink status

Definition at line 55 of file L3IP.h.

Member Function Documentation

virtual void add_ipv4_multicast_group ( const SocketAddress address)
pure virtual

Add device to an IP4 multicast group.

Parameters
addressAn IP4 multicast group address

Implemented in Cellular_driver_L3IP.

virtual void add_ipv6_multicast_group ( const SocketAddress address)
pure virtual

Add device to an IP6 multicast group.

Parameters
addressAn IP6 multicast group address

Implemented in Cellular_driver_L3IP.

virtual uint32_t get_align_preference ( ) const
pure virtual

Gets memory buffer alignment preference.

Gets preferred memory buffer alignment of the l3ip device.

Returns
Memory alignment requirement in bytes

Implemented in Cellular_driver_L3IP.

static L3IP& get_default_instance ( )
static

Return the default on-board L3IP.

Returns the default on-board L3IP - this will be target-specific, and may not be available on all targets.

virtual void get_ifname ( char *  name,
uint8_t  size 
) const
pure virtual

Return interface name.

Parameters
namePointer to where the name should be written
sizeMaximum number of characters to copy

Implemented in Cellular_driver_L3IP.

virtual uint32_t get_mtu_size ( ) const
pure virtual

Return maximum transmission unit.

Returns
MTU in bytes

Implemented in Cellular_driver_L3IP.

virtual bool link_out ( net_stack_mem_buf_t *  buf)
pure virtual

Sends the packet over the link.

That cannot be called from an interrupt context.

Parameters
bufPacket to be send
Returns
True if the packet was send successfully, false otherwise

Implemented in Cellular_driver_L3IP.

virtual void power_down ( )
pure virtual

Deinitializes the hardware.

Implemented in Cellular_driver_L3IP.

virtual bool power_up ( )
pure virtual

Initializes the hardware.

Returns
True on success, False in case of an error.

Implemented in Cellular_driver_L3IP.

virtual void remove_ipv4_multicast_group ( const SocketAddress address)
pure virtual

Remove device from an IPV4 multicast group.

Parameters
addressAn IPV4 multicast group address

Implemented in Cellular_driver_L3IP.

virtual void remove_ipv6_multicast_group ( const SocketAddress address)
pure virtual

Remove device from an IPV6 multicast group.

Parameters
addressAn IPV6 multicast group address

Implemented in Cellular_driver_L3IP.

virtual void set_all_multicast ( bool  all)
pure virtual

Request reception of all multicast packets.

Parameters
allTrue to receive all multicasts False to receive only multicasts addressed to specified groups

Implemented in Cellular_driver_L3IP.

virtual void set_link_input_cb ( l3ip_link_input_cb_t  input_cb)
pure virtual

Sets a callback that needs to be called for packets received for that interface.

Parameters
input_cbFunction to be register as a callback

Implemented in Cellular_driver_L3IP.

virtual void set_link_state_cb ( l3ip_link_state_change_cb_t  state_cb)
pure virtual

Sets a callback that needs to be called on link status changes for given interface.

Parameters
state_cbFunction to be register as a callback

Implemented in Cellular_driver_L3IP.

virtual void set_memory_manager ( NetStackMemoryManager mem_mngr)
pure virtual

Sets memory manager that is used to handle memory buffers.

Parameters
mem_mngrPointer to memory manager

Implemented in Cellular_driver_L3IP.

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.