ppc54xdll.h

DSP（TI公司的5416)的实例程序

/*****************************************************************************
*  ppc54x_reset_board()
*
*	 Description: 
*		Resets the board to a known state.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_reset_board(LPVOID pDev_);

/*****************************************************************************
*  ppc54x_reset_dsp()
*
*	 Description: 
*		Holds the DSP device in reset.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_reset_dsp(LPVOID pDev_);

/*****************************************************************************
*  ppc54x_unreset_dsp()
*
*	 Description: 
*		Removes the DSP device from reset.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_unreset_dsp(LPVOID pDev_);

/*****************************************************************************
*  ppc54x_board_info()
*
*	 Description: 
*		Retrieves the board type and revision id.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*		pBoardType - The board type.
*		pRevId - The revision identifier
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_board_info(LPVOID pDev_, PUSHORT pRevId, PUSHORT pBoardType); 

/*****************************************************************************
*  ppc54x_get_configuration()
*
*	 Description: 
*		Retrieves the PPC34C60 configuration information.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*		pDskConfig - A pointer to a DskConfig object which contains
*		the PPC34C60 information.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_get_configuration(LPVOID pDev_, PDskConfig pDskConfig);

/*****************************************************************************
*  ppc54x_store_configuration()
*
*	 Description: 
*		Modifies the PPC34C60 configuration                                            .
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*		pDskConfig - A pointer to a DskConfig object which contains
*		the PPC34C60 information.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_store_configuration(LPVOID pDev_, PDskConfig pReg);

/*****************************************************************************
*  ppc54x_hpi_read()
*
*	 Description: 
*		Reads data from the DSP memory.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*		p_buffer - Pointer to the buffer to read data into.
*		p_length - Number of 16 -bit words to read.
*		src_addr - DSP memory address to read from.
*
*  Return:
*		TRUE - success.
*     FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_hpi_read(LPVOID pDev_, PULONG p_buffer, 
                                 PULONG p_len, ULONG src_addr);

/*****************************************************************************
*  ppc54x_hpi_write()
*
*	 Description: 
*		Writes data to the DSP memory.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*		p_buffer - Pointer to the buffer to read data into.
*		p_length - Number of 16 -bit words to write.
*		dest_addr - DSP memory address to read from.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_hpi_write(LPVOID pDev_, PULONG p_buffer, 
                                  PULONG p_len, ULONG dest_addr);

/*****************************************************************************
*  ppc54x_generate_int()
*
*	 Description: 
*		Interrupts the DSP device.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*     intr - The type of interrupt to generate to the DSP
* 
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_generate_int(LPVOID pDev_, PPC54X_DSP_EVENT intr);

/*****************************************************************************
*  ppc54x_dll_revision()
*
*	 Description: 
*		Sets the dll revision
*
*  Parameters:
*		pRevMajor - The revison major number.
*		pRevMinor - The revison minor number.
*		pBuildNum - The build number.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_dll_revision(PULONG pRevMajor,
                                      PULONG pRevMinor,
                                      PULONG pBuildNum);

/*****************************************************************************
*  ppc54x_read_ppc_reg()
*
*	 Description: 
*		Reads a PPC34C60device (The Parallel Port controller) register.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*		pReg - Pointer to the PPC34C60 register object containing the new 
*            register value.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_read_ppc_reg(LPVOID pDev_, PRegister pReg);

/*****************************************************************************
*  ppc54x_write_ppc_reg()
*
*	 Description: 
*		Modifies a PPC34C60device (The Parallel Port controller) register.
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*		pReg - Pointer to the PPC34C60 register object to hold the read register 
*            value.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL ppc54x_write_ppc_reg(LPVOID pDev_, PRegister pReg);

/****************************************************************************
* ppc54x_read_cpld_reg() 
*
*	 Description: 
*  The ppc54x_read_cpld_reg function reads a value from the CPLD register
*
*  Parameters:
*		pDev_ - Board handle returned from the call to ppc54x_open.
*		pReg - pointer to the CPLD regster that holds the read value.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
/****************************************************************************/
DLL32_ENTRY BOOL ppc54x_read_cpld_reg(LPVOID pDev_, PRegister pReg);

/****************************************************************************
*  ppc54x_write_cpld_reg()
*
*  The ppc54x_write_cpld_reg function writes a value to the CPLD register
*  
*		pDev_ - Board handle returned from the call to ppc54x_open.
*		pReg - pointer to a CPLD regster that holds the value to write
*
*    Returns TRUE on succes
*    FALSE on failure.
/****************************************************************************/
DLL32_ENTRY BOOL ppc54x_write_cpld_reg(LPVOID pDev_, PRegister pReg);

/****************************************************************************/
/*                                                                          
/* ppc54x_tbc_reset() - The ppc54x_tbc_reset function pulses the TBC        
/*                       reset to reset the Test Bus Controller.            
/*                                                                          
/*		pDev_ - Board handle returned from the call to ppc54x_open.
/*
/*