Mistake on this page?
Report an issue in GitHub or email us
Public Member Functions
Nanostack::EthernetInterface Class Referencefinal
Inheritance diagram for Nanostack::EthernetInterface:
Nanostack::Interface OnboardNetworkStack::Interface NonCopyable< Nanostack::Interface >

Public Member Functions

nsapi_error_t bringup (bool dhcp, const char *ip, const char *netmask, const char *gw, nsapi_ip_stack_t stack=DEFAULT_STACK, bool blocking=true) override
 Connect the interface to the network. More...
 
nsapi_error_t bringdown () override
 Disconnect interface from the network. More...
 
char * get_mac_address (char *buf, nsapi_size_t buflen) override
 Return MAC address of the network interface. More...
 
char * get_interface_name (char *buf) override
 Returns interface name. More...
 
nsapi_error_t get_ip_address (SocketAddress *address) final
 Get the local IP address. More...
 
nsapi_error_t get_netmask (SocketAddress *address) final
 
nsapi_error_t get_gateway (SocketAddress *address) override
 
void attach (mbed::Callback< void(nsapi_event_t, intptr_t)> status_cb) final
 Register callback for status reporting. More...
 
nsapi_connection_status_t get_connection_status () const final
 Get the connection status. More...
 
void network_handler (mesh_connection_status_t status)
 Callback from C-layer. More...
 
virtual nsapi_error_t set_ip_address (const char *ip, const char *netmask, const char *gw, uint8_t ipv6_flag)
 Set IP address. More...
 
virtual nsapi_error_t get_ipv6_link_local_address (SocketAddress *address)
 Get the IPv6 link local address. More...
 

Detailed Description

Definition at line 24 of file NanostackEthernetInterface.h.

Member Function Documentation

void attach ( mbed::Callback< void(nsapi_event_t, intptr_t)>  status_cb)
finalvirtualinherited

Register callback for status reporting.

The specified status callback function will be called on status changes on the network. The parameters on the callback are the event type and event-type dependent reason parameter.

Parameters
status_cbThe callback for status changes

Implements OnboardNetworkStack::Interface.

nsapi_error_t bringdown ( )
overridevirtual

Disconnect interface from the network.

After this call the network interface is inactive, to use it again user needs to call
bringup again.

Returns
NSAPI_ERROR_OK on success, or error code

Implements OnboardNetworkStack::Interface.

nsapi_error_t bringup ( bool  dhcp,
const char *  ip,
const char *  netmask,
const char *  gw,
nsapi_ip_stack_t  stack = DEFAULT_STACK,
bool  blocking = true 
)
overridevirtual

Connect the interface to the network.

Sets up a connection on specified network interface, using DHCP or provided network details. If the dhcp is set to true all the remaining parameters are ignored.

Parameters
dhcptrue if the network details should be acquired using DHCP
ipIP address to be used for the interface as "W:X:Y:Z" or NULL
netmaskNet mask to be used for the interface as "W:X:Y:Z" or NULL
gwGateway address to be used for the interface as "W:X:Y:Z" or NULL
stackAllow manual selection of IPv4 and/or IPv6.
blockingSpecify whether bringup blocks for connection completion.
Returns
NSAPI_ERROR_OK on success, or error code

Implements OnboardNetworkStack::Interface.

nsapi_connection_status_t get_connection_status ( ) const
finalvirtualinherited

Get the connection status.

Returns
The connection status according to ConnectionStatusType

Implements OnboardNetworkStack::Interface.

nsapi_error_t get_gateway ( SocketAddress address)
overridevirtualinherited
char* get_interface_name ( char *  buf)
overridevirtual

Returns interface name.

Returns
string containing name of network interface for example "en0"

Reimplemented from OnboardNetworkStack::Interface.

nsapi_error_t get_ip_address ( SocketAddress address)
finalvirtualinherited

Get the local IP address.

Parameters
addressSocketAddress representation of the local IP address
Return values
NSAPI_ERROR_OKon success
NSAPI_ERROR_UNSUPPORTEDif this feature is not supported
NSAPI_ERROR_PARAMETERif the provided pointer is invalid
NSAPI_ERROR_NO_ADDRESSif the address cannot be obtained from stack

Implements OnboardNetworkStack::Interface.

virtual nsapi_error_t get_ipv6_link_local_address ( SocketAddress address)
virtualinherited

Get the IPv6 link local address.

Parameters
addressSocketAddress representation of the link local IPv6 address
Return values
NSAPI_ERROR_OKon success
NSAPI_ERROR_UNSUPPORTEDif this feature is not supported
NSAPI_ERROR_PARAMETERif the provided pointer is invalid

Reimplemented in LWIP::Interface.

Definition at line 140 of file OnboardNetworkStack.h.

char* get_mac_address ( char *  buf,
nsapi_size_t  buflen 
)
overridevirtual

Return MAC address of the network interface.

Returns
MAC address as "V:W:X:Y:Z"

Reimplemented from Nanostack::Interface.

nsapi_error_t get_netmask ( SocketAddress address)
finalvirtualinherited
void network_handler ( mesh_connection_status_t  status)
inherited

Callback from C-layer.

Parameters
statusstate of the network
virtual nsapi_error_t set_ip_address ( const char *  ip,
const char *  netmask,
const char *  gw,
uint8_t  ipv6_flag 
)
virtualinherited

Set IP address.

bringup() can only take one IP address and in dual stack case another IP address can be set using this function.

Must be called before bringup().

Parameters
ipIP address to be used for the interface as "W:X:Y:Z" or NULL
netmaskNet mask to be used for the interface as "W:X:Y:Z" or NULL
gwGateway address to be used for the interface as "W:X:Y:Z" or NULL
ipv6_flagProvide this flag for IPv6 state flag override. For example, you can set IP6_ADDR_PREFERRED. For IPv4, this value will be ignored.
Returns
NSAPI_ERROR_OK on success, or error code

Reimplemented in LWIP::Interface.

Definition at line 69 of file OnboardNetworkStack.h.

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.