Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Device Driver BSP Functions

NetDev_

...

WiFi_Start()

This function is called by a device driver’s NetDev_InitStart() to configure a specific network device’s clocks on a specific interfacestart and power up the wireless hardware.

Files

net_bsp.c

Prototype

 

 

Note: since NetDev_WiFi_CfgClkStart() is accessed only by function pointer via a BSP interface structure, it doesn’t need to be globally available and should therefore be declared as ‘static’.

Arguments

pifp_if

Pointer to specific interface to configure start device’s clockshardware.

perrp_err

Pointer to variable that will receive the return error code from this function:

NET_DEV_ERR_NONE

NET_DEV_ERR_FAULT

 

This is not an exclusive list of return errors and specific network device’s or device BSP functions may return any other specific errors as required.

...

Required Configuration

None.

Notes / Warnings

...

Since each network device requires a unique NetDev_WiFi_CfgClkStart(), it is recommended that each device’s NetDev_CfgClkWiFi_Start() function be named using the following convention:

NetDev_WiFi_[Device]CfgClk_Start[Number]()

 

[Device]

Network device name or type, e.g. MACB RS9110 (optional if the development board does not support multiple devices)

...

Network device number for each specific instance of device (optional if the development board does not support multiple instances of the specific device)

For example, the NetDev_CfgClkWiFi_Start() function for the #2 MACB Ethernet controller on an Atmel AT91SAM9263-EK RS9110 wireless devie should be named NetDev_WiFi_MACBRS9110_CfgClk2Start2(), or NetDev_WiFI_MACBRS9110_CfgClkStart_2() with additional underscore optional.

See also Chapter 6, “Network Board Support Package”.