evmdsk54dll.h

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

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

/*****************************************************************************
*  evmdsk54x_generate_int()
*
*	 Description: 
*		Interrupts the DSP device using either the CPLD or HPI depending on the 
*     desired interrupt..
*
*  Parameters:
*		h_hpi_map - A void pointer corresponding to the HPI map object.
*     dspNum - Specifies the DSP.
*     intr - The type of interrupt to generate to the DSP
* 
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_generate_int(LPVOID h_hpi_map, PCI2040_DSP_EVENT intr, ULONG dspNum);

/*****************************************************************************
*  evmdsk54x_enable_int()
*
*	 Description: 
*		Enables the specified interrupt to the host from the board.
*
*  Parameters:
*		intMask - Mask for the interrupt.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_enable_int(LPVOID h_hpi_map, ULONG intMask);

/*****************************************************************************
*  evmdsk54x_disable_int()
*
*	 Description: 
*		disables the specified interrupt to the host from the board.
*
*  Parameters:
*		intMask - Mask for the interrupt.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_disable_int(LPVOID h_hpi_map, ULONG intMask);

/*****************************************************************************
*  evmdsk54x_hotswap_switch()
*
*	 Description: 
*		Returns the status of the hotswap switch.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		pStat - Storage for the hotswap switch status
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_hotswap_switch(HANDLE hDevice, PULONG pStat);

/*****************************************************************************
*  evmdsk54x_hotswap_led_on()
*
*	 Description: 
*		Turns on the hotswap switch LED.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_hotswap_led_on(HANDLE hDevice);

/*****************************************************************************
*  evmdsk54x_hotswap_led_off()
*
*	 Description: 
*		Turns off the hotswap switch LED.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_hotswap_led_off(HANDLE hDevice);

/*****************************************************************************
*  evmdsk54x_printf_control()
*
*	 Description: 
*		Sets the function to be used for printf.
*
*  Parameters:
*		enable - Enables printf (1 - enable , 0 - disbale).
*		func - printf function
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_printf_control(BOOL enable,
                                        PPCI2040_PRINTF_FUNC func);

/*****************************************************************************
*  evmdsk54x_input_control()
*
*	 Description: 
*		Sets the function to be used for input.
*
*  Parameters:
*		func - input function
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_input_control(PPCI2040_INPUT_FUNC func);

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

/*****************************************************************************
*  evmdsk54x_read_reg()
*
*	 Description: 
*		Modifies a Montana device (The PCI controller) register.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		preg - Pointer to the PCI20404_REG  object containing the new register value.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_read_pci_reg(HANDLE hDevice, PRegister  pReg);

/*****************************************************************************
*  evmdsk54x_write_reg()
*
*	 Description: 
*		Reads a Montana device (The PCI controller) register.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		preg - Pointer to the PCI20404_REG object to hold the read register value.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_write_pci_reg(HANDLE hDevice, PRegister  pReg);

/*****************************************************************************
*  evmdsk54x_dsp_present()
*
*	 Description: 
*		Determines if the specified DSP is present.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		dspNum - Specifies the DSP.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_dsp_present(HANDLE hDevice, ULONG dspNum);

/*****************************************************************************
*  evmdsk54x_mem_config()
*
*	 Description: 
*		Sets the memory configuration on the specified DSP.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		pMem - Pointer to a PMemSpaceConfig object which contails the new OVLY, DROM,
*		and MP_MC flag values.
*
*  Return:
*		TRUE - success.
*   FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_mem_config(HANDLE hDevice, ULONG dspNum, PMemSpaceConfig pMem);

/*****************************************************************************
*  evmdsk54x_cpld_read_all()
*
*	 Description: 
*		Gets a dump of the CPLD registers.
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		regs - Pointer to array of shorts to hold register values.
*  Return:
*		TRUE - success.
*     FALSE - failure
*******************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_cpld_read_all(HANDLE hDevice, PUSHORT regs);


/*****************************************************************************
*  evmdsk54x_get_event_handle()
*
*	 Description: 
*		Returns the handle to the requested event
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		eventNUM - Event that monitoring is to be terminated.
*  Return:
*		event HANDLE - success.
*     NULL - failure
*******************************************************************************/
DLL32_ENTRY HANDLE evmdsk54x_get_event_handle(HANDLE hDevice, 
                                              PCI2040_HOST_EVENT eventNum);

/****************************************************************************
*evmdsk54x_read_cpld_reg()
*
*  Parameters:
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		pReg - pointer to a PCI2040_REG that holds the read value.
*  The evmdsk54x_read_cpld_reg function reads a value from the CPLD register
/****************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_read_cpld_reg(HANDLE hDevice, PRegister  pReg);

/****************************************************************************
*evmdsk54x_write_cpld_reg()
*
*  The evmdsk54x_write_cpld_reg function writes a value to the CPLD register
*  
*		hDevice - Board handle returned from the call to evmdsk54x_open.
*		pReg - pointer to a PCI2040_REG that holds the value to write
*
*    Returns TRUE on succes
*    FALSE on failure.
/****************************************************************************/
DLL32_ENTRY BOOL evmdsk54x_write_cpld_reg(HANDLE hDevice, PRegister  pReg);

/****************************************************************************/
/*                                                                          */
/* evmdsk54x_user_semaphore_get() - This function tries to acquire the        */
/*    specified user semaphore.                                             */
/*