dm648_hal.h File Reference

---

Detailed Description

Hardware Abstraction Layer for DM648. Define the Platform specific HAL (Hardware Abstraction Layer) object.

============================================================================

Path:

/gpp/inc/sys/arch/DM648/

Version:

1.65.02.09 ============================================================================

Copyright:

Copyright (C) 2002-2012, Texas Instruments Incorporated - https://www.ti.com/

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

* Neither the name of Texas Instruments Incorporated nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ============================================================================

#include <dsplink.h>
#include <hal.h>
#include <dm648_hal_pci.h>

Include dependency graph for dm648_hal.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	DM648_HalObj_tag
struct	DM648_InitParams_tag
Typedefs
DM648_HalPciPhyObj
Forward declaration of PCI Physical Interface object. ============================================================================ ============================================================================
typedef struct DM648_HalPciPhyObj_tag	DM648_HalPciPhyObj
DM648_HalObj
Hardware Abstraction object. ============================================================================ Parameters: dspId Processor Identifier. phyType Physical Interface type. interface Function table for hal functions. isMapActive tells whether user has mapped some area. mapSize Size of the mapped area. lock Lock for using DMA resource. pci Structure containging members related to PCI Phy. Only on PCI platforms ============================================================================
typedef struct DM648_HalObj_tag	DM648_HalObj
DM648_InitParams
Initialize parameters for HAL init call. ============================================================================ Parameters: dspId Processor Identifier. phyType Physical Interface type. shMemEntry Shared memory entry ID, this is mapped after initialzing the physical interface. arg1 Argument 1. arg2 Argument 2. arg3 Argument 3. arg4 Argument 4. arg5 Argument 5. arg6 Argument 6. ============================================================================
typedef struct DM648_InitParams_tag	DM648_InitParams
NORMAL_API DSP_STATUS	DM648_halInit (IN Pvoid *halObject, IN Pvoid initParams)
	Initializes the HAL object and physical interface.
NORMAL_API DSP_STATUS	DM648_halExit (IN Pvoid *halObject)
	Finializes the HAL object and physical interface.

---

Typedef Documentation

typedef struct DM648_HalPciPhyObj_tag DM648_HalPciPhyObj

typedef struct DM648_HalObj_tag DM648_HalObj

typedef struct DM648_InitParams_tag DM648_InitParams

---

Function Documentation

NORMAL_API DSP_STATUS DM648_halInit	(	IN Pvoid *	halObject,
		IN Pvoid	initParams
	)

Initializes the HAL object and physical interface.

============================================================================

Function:

DM648_halInit

Parameters:

halObject.	HAL Object
initParams.	Parameters for initialization.

Returns:

DSP_SOK Operation successfully completed. DSP_EFAIL All other error conditions.

Precondition:

None.

Postcondition:

None.

See also:

None ============================================================================

NORMAL_API DSP_STATUS DM648_halExit

(

IN Pvoid *

halObject )

Finializes the HAL object and physical interface.

============================================================================

Function:

DM648_halExit

Parameters:

halObject.

HAL Object

Returns:

DSP_SOK Operation successfully completed. DSP_EFAIL All other error conditions.

Precondition:

None.

Postcondition:

None.

See also:

None ============================================================================