P4080 PCIe Adapter SDK User Guide Production Release

Freescale Semiconductor
/**
* API: unregister_hardware_function :
* Each upper-level Hardware Function driver calls this function to
* unregister itself from Host Packet Driver. This function is
* invoked at the time of Driver unload. It sends an unload command to P4080
* to notify that hardware function Driver is unloaded. The Host
* Packet Driver cleans all the data structures of the Hardware Function that
* requested the de-registration.
*
* @func_id – Identifier of a Hardware Function.
*/
The prototype of this API is as follows.
void unregister_hardware_function(P4080_HW_FUNCTIONS func_id);
func_id – Hardware function identifier based on “enum P4080_HW_FUNCTIONS”
/**
* API: get_p4080_address : It converts an address that belongs to Host domain
* into P4080 PCIE domain address. The converted address will be the
* pcie address * in P4080 domain. When accessed by P4080 software or
hardware,
* in the P4080->Host direction, the address gets translated into
* Host domain address
* using outbound ATMU. The Host address 0x0 is mapped into 0xC_0000_0000 PCIe
* address on P4080.
*
* @host_address – Address belongs to Host domain.
*
* @return – Address belongs to P4080 PCIE domain.
*/
unsigned long long get_p4080_address(unsigned long long host_address);
host_address – Address in Host domain that needs to be converted into P4080 domain
address.
/**
* API: convert_p4080_add_to_host_virt : It converts an address belonging
© Freescale Semiconductor, Inc., 2011. All rights reserved.
Freescale Confidential Proprietary Page 72