...
Starting Network Interfaces
Anchor
NetIF_Start()
marks the end of the initialization sequence of µC/TCP-IP for a specific network interface. Recall that the first interface added and started will be the default interface.NetIF_Start()
API function with the necessary parameters. A call to NetIF_Start()
is shown below. Anchor
...
Listing 5-12 Calling NetIF_Start(
...
)
L5-12(1)
...
NetIF_Start()
...
requires two arguments. The first function argument is the interface number that the application wants to start, and the second argument is a pointer to a NET_ERR
to contain the return error code. The interface number is acquired upon successful addition of the interface and upon the successful start of the interface; the return error variable will contain the value NET_IF_ERR_NONE
.
...
Anchor
There are very few things that could cause a network interface to not start properly. The application developer should always inspect the return error code and take the appropriate action if an error occurs. Once the error is resolved, the application may again attempt to call NetIF_Start()
.