Device Driver BSP Functions
NetDev_
...
CfgClk()
This function is called by a device driver’s NetDev_StartInit()
to start and power up the wireless hardwareconfigure a specific network device’s clocks on a specific interface.
Files
net_bsp.c
Prototype
Note: since NetDev_WiFi_StartCfgClk()
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
p_if
pif
Pointer to specific interface to start configure device’s hardwareclocks.
p_err
perr
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
Each network device’s NetDev_CfgClk()
should configure and enable all required clocks for the network device. For example, on some devices it may be necessary to enable clock gating for an embedded Ethernet MAC as well as various GPIO modules in order to configure Ethernet Phy pins for (R)MII mode and interrupts.
Since each network device requires a unique NetDev_WiFi_StartCfgClk()
, it is recommended that each device’s NetDev_WiFi_StartCfgClk()
function be named using the following convention:
NetDev_WiFi_[Device]
_Start
CfgClk[Number]()
[Device]
Network device name or type, e.g. RS9110 MACB (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_WiFi_StartCfgClk()
function for the #2 RS9110 wireless devie MACB Ethernet controller on an Atmel AT91SAM9263-EK should be named NetDev_WiFiMACB_RS9110_Start2CfgClk2()
, or NetDev_WiFIMACB_RS9110CfgClk_Start_2()
with additional underscore optional.
See also Chapter 6, “Network Board Support Package”.