evmdsk54dll.h

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

*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_reset_board(HANDLE hDevice);

/*****************************************************************************
*  evmdsk54x_reset_dsp()
*
*	 Description: 
*		Holds the DSP device in reset.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		dspNum - specifies the DSP devioe. Up to 4 DSPs may be supported on the board.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_reset_dsp(HANDLE hDevice, ULONG dspNum);

/*****************************************************************************
*  evmdsk54x_unreset_dsp()
*
*	 Description: 
*		Removes the DSP device from reset. The DSP will begin executing code if a 
*		COFF file is loaded.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		dspNum - specifies the DSP devioe. Up to 4 DSPs may be supported on the board.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_unreset_dsp(HANDLE hDevice, ULONG dspNum);

/*****************************************************************************
*  evmdsk54x_board_info()
*
*	 Description: 
*		Retrieves the board type and revision id.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		pBoardType - The board type.
*		pRevId - The revision identifier
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_board_info(HANDLE hDevice,
                                      PEVMDSK54X_BOARD_TYPE pBoardType, 
                                      PULONG pRevId);

/*****************************************************************************
*  evmdsk54x_get_configuration()
*
*	 Description: 
*		Retrieves the PCI configuration information.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		pPciConfig - A pointer to a PPCI2040_DUMP_CONFIG_REGS object which contains
*		the PCI information.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_get_pci_configuration(HANDLE hDevice,
												 PPCI2040_DUMP_CONFIG_REGS pReg);

/*****************************************************************************
*  evmdsk54x_coff_load()
*
*	 Description: 
*		Loads a COFF file onto the board.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		lp_hpi - A pointer to the HPI map object returned from the call to 
*   evmdsk54x_hpi_open().
*		filename - The name of the COFF file.
*		verboseFlag - Display basic COFF file information via the standard output stream.
*   clear_bss_flag - Initialize all bss section variable to zero.
*   dump - Display all data via the standard output stream.
*   dspNum - Specifies the DSP to load the COFF file into.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_coff_load(HANDLE hDevice, 
                                   LPVOID lp_hpi,
                                   char *filename, 
                                   BOOL verboseFlag,
                                   BOOL clear_bss_flag, 
                                   BOOL dump_flag,
                                   ULONG dspNum);

/*****************************************************************************
*  evmdsk54x_coff_display()
*
*	 Description: 
*		Displays only the COFF information for a file
*
*  Parameters:
*		filename - The name of the COFF file.
*   clear_bss_flag - Initialize all bss section variable to zero.
*   dump - Display all data via the standard output stream.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_coff_display(char *filename,
                                      BOOL clear_bss_flag, 
                                      BOOL dump_flag);

/*****************************************************************************
*  evmdsk54x_hpi_open()
*
*	 Description: 
*		Opens the host port interface (HPI) to the DSPs and guarantees mutual 
*		exclusion to the DSPs HPI as well as memory.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY LPVOID evmdsk54x_hpi_open(HANDLE hDevice);

/*****************************************************************************
*  evmdsk54x_hpi_close()
*
*	 Description: 
*		Closes the host port interface (HPI) to the DSPs.
*
*  Parameters:
* h_hpi_map - Hpi_map handle returned from the call to
* *				evmdsk54x_hpi_open.
*
*  Return:
*		TRUE - success.
*		FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_hpi_close(LPVOID h_hpi_map);

/*****************************************************************************
*  evmdsk54x_hpi_read()
*
*	 Description: 
*		Reads data from the DSP memory.
*
*  Parameters:
*		h_hpi_map - A void pointer corresponding to the HPI map object.
*		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.
*		memSpace - Indicates whether to read from DATA memory or PROGRAM memory.
*   dspNum - Specifies the DSP.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_hpi_read(LPVOID h_hpi_map, 
                                  PULONG p_buffer,
                                  PULONG p_length, 
                                  ULONG src_addr,
                                  int memSpace,
                                  ULONG dspNum);

/*****************************************************************************
*  evmdsk54x_hpi_read_single()
*
*	 Description: 
*		Reads a single 16-bit value from the DSP memory.
*
*  Parameters:
*		h_hpi_map - A void pointer corresponding to the HPI map object.
*		p_data - Pointer to the buffer to read data into.
*		src_addr - DSP memory address to read from.
*		memSpace - Indicates whether to read from DATA memory or PROGRAM memory.
*     dspNum - Specifies the DSP.
*
*  Return:
*		TRUE - success.
*     FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_hpi_read_single(LPVOID h_hpi_map, 
                                  PULONG p_data,
                                  ULONG src_addr,
                                  int memSpace,
                                  ULONG dspNum);

/*****************************************************************************
*  evmdsk54x_hpi_write()
*
*	 Description: 
*		Writes data to the DSP memory.
*
*  Parameters:
*		h_hpi_map - A void pointer corresponding to the HPI map object.
*		p_buffer - Pointer to the buffer to read data into.
*		p_length - Number of 16 -bit words to write.
*		src_addr - DSP memory address to read from.
*		memSpace - Indicates whether to write to DATA memory or PROGRAM memory.
*   dspNum - Specifies the DSP
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_hpi_write(LPVOID h_hpi_map, 
                                   PULONG p_buffer,
                                   PULONG p_length, 
                                   ULONG dest_addr,
                                   int memSpace,
                                   ULONG dspNum);

/*****************************************************************************
*  evmdsk54x_hpi_write_single()
*
*	 Description: 
*		Writes a single 16-bit value to the DSP memory.
*
*  Parameters:
*		h_hpi_map - A void pointer corresponding to the HPI map object.
*		p_data - Pointer to the buffer to read data into.
*		dest_addr - DSP memory address to write to.
*		memSpace - Indicates whether to write to DATA memory or PROGRAM memory.
*     dspNum - Specifies the DSP.
*
*  Return:
*		TRUE - success.
*     FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_hpi_write_single(LPVOID h_hpi_map, 
                                           PULONG p_data,
                                           ULONG dest_addr,
                                           int memSpace,
                                           ULONG dspNum);
                                  
/*****************************************************************************
*  evmdsk54x_hpi_fill()
*
*	 Description: 
*		Fills DSP memory with a single value.
*
*  Parameters:
*		h_hpi_map - A void pointer corresponding to the HPI map object.
*		fill_value - 16-bit value to fill DSP memory with.
*		p_length - Number of 16 -bit words to write.
*		src_addr - DSP memory address to read from.
*		memSpace - Indicates whether to read from DATA memory or PROGRAM memory.
*           dspNum - Specifies the DSP.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_hpi_fill(LPVOID h_hpi_map, 
                                  USHORT fill_value,
                                  PULONG p_length, 
                                  ULONG dest_addr,
                                  int memSpace,
                                  ULONG dspNum);

/*****************************************************************************
*  evmdsk54x_fifo_read()
*
*	 Description: 
*		Reads data from the fifo stream.
*
*  Parameters:
*		h_hpi_map - A void pointer corresponding to the HPI map object.
*		p_buffer - Pointer to the buffer to read data into.
*		p_length - Number of 16-bit words to read.
*   dspNum - Specifies the DSP.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_fifo_read(LPVOID h_hpi_map, 
                                  PULONG p_buffer,
                                  PULONG p_length, 
                                  ULONG dspNum);