board.h

ti dsp 5510 的BOOT程序。利用此程序实现将代码写入到FLASH 的功能。

/*  Parameters:                                                              */
/*      - led - specific led                                                 */
/*                                                                           */ 
/*  Return:                                                                  */
/*  - OK success                                                             */
/*  - ERROR failure                                                          */
/*                                                                           */ 
/*  Notes:                                                                   */
/*                                                                           */ 
/*****************************************************************************/
s16 brd_led_disable(BrdLed led);

/*****************************************************************************/
/*  s16 brd_toggle_led(BrdLed led)                                            */
/*                                                                           */ 
/*  This routine enables the dsk led.             .                          */
/*                                                                           */
/*  Parameters:                                                              */
/*      - led - specific led                                                 */
/*                                                                           */ 
/*  Return:                                                                  */
/*  - OK success                                                             */
/*  - ERROR failure                                                          */
/*                                                                           */ 
/*  Notes:                                                                   */
/*                                                                           */ 
/*****************************************************************************/
s16 brd_led_toggle(BrdLed led);

/*****************************************************************************/
/*  s16 brd_sem_get(void)                                                    */
/*                                                                           */ 
/*  This routine tries to obtain the specified user semaphore.               */
/*                                                                           */
/*                                                                           */
/*  Parameters:                                                              */
/*      - sem - desired semaphore                                            */
/*                                                                           */ 
/*  Return:                                                                  */
/*  - OK success                                                             */
/*  - ERROR failure                                                          */
/*                                                                           */ 
/*  Notes:                                                                   */
/*                                                                           */ 
/*****************************************************************************/
s16 brd_sem_get(BrdSem sem);

/*****************************************************************************/
/*  s16 brd_sem_wait(void)                                                   */
/*                                                                           */ 
/*  This routine tries to obtain the specified user semaphore. It blocks till*/
/*  the semaphore is obtained.                                               */
/*                                                                           */
/*  Parameters:                                                              */
/*      - sem - desired semaphore                                            */
/*                                                                           */ 
/*  Return:                                                                  */
/*  - OK success                                                             */
/*  - ERROR failure                                                          */
/*                                                                           */ 
/*  Notes:                                                                   */
/*                                                                           */ 
/*****************************************************************************/
s16 brd_sem_wait(BrdSem sem);

/*****************************************************************************/
/*  s16 brd_sem_release(void)                                                */
/*                                                                           */ 
/*  This routine releases the previously obtained semaphore.                 */
/*                                                                           */
/*  Parameters:                                                              */
/*      - sem - semaphore to release                                         */
/*                                                                           */ 
/*  Return:                                                                  */
/*  - OK success                                                             */
/*  - ERROR failure                                                          */
/*                                                                           */ 
/*  Notes:                                                                   */
/*                                                                           */ 
/*****************************************************************************/
s16 brd_sem_release(BrdSem sem);

/*****************************************************************************/
/*  s16 brd_fifo_read (s8 *bufptr, u16 cnt)			            		     */
/*                                                                           */
/*  This routine begins a synchronous read from the fifo channel.            */
/*                                                                           */
/*  Parameters:                                                              */
/*  - p_buffer is the location of the data to be written to the FIFO         */
/*  - num_bytes is the number of bytes of data to be written to the FIFO,    */
/*                                                                           */
/*  Return:                                                                  */
/*  - returns OK or ERROR,												     */
/*      possible error conditions include: another send in progress,         */
/*      chan not open, no DMA chan available                                 */
/*                                                                           */
/*  Notes:                                                                   */
/*                                                                           */
/*****************************************************************************/
s16 brd_fifo_read(char *bufptr, u16 cnt);

/*****************************************************************************/
/*  s16 brd_fifo_write (s8 *bufptr, u16 cnt)   					             */
/*                                                                           */
/*  This routine begins a synchronous read from the fifo channel.            */
/*                                                                           */
/*  Parameters:                                                              */
/*  - p_buffer is the location of the data to be written to the FIFO         */
/*  - num_bytes is the number of bytes of data to be written to the FIFO,    */
/*                                                                           */
/*  Return:                                                                  */
/*  - returns OK or ERROR,													 */
/*                                                                           */
/*  Notes:                                                                   */
/*                                                                           */
/*****************************************************************************/
s16 brd_fifo_write(char *bufptr, u16 cnt);

/*****************************************************************************/
/*  s16 brd_delay_msec(u16 msec)                                             */
/*                                                                           */ 
/*  This routine delays execution by specified milliseconds.                 */
/*                                                                           */
/*  Parameters:                                                              */
/*      - msec - time delay in milliseconds.                                 */
/*                                                                           */ 
/*  Return:                                                                  */
/*  - TRUE success                                                           */
/*  - FALSE failure                                                          */
/*                                                                           */ 
/*  Notes:                                                                   */
/*                                                                           */ 
/*  The delay is implemented using timer 0 at port (0x24). Care must be      */ 
/*  taken not to interrupt timer operation by way of interrupts.             */
/*  Maximum supported delay is 6553 usec or 6.5 secs.                        */ 
/*                                                                           */ 
/*****************************************************************************/
s16 brd_delay_msec(u16 msec);

/*****************************************************************************/
/*  s16 brd_delay_usec(u16 usec)                                             */
/*                                                                           */ 
/*  This routine delays execution by specified microseconds.                 */
/*                                                                           */
/*  Parameters:                                                              */
/*      - usec - time delay in microseconds.                                 */
/*                                                                           */ 
/*  Return:                                                                  */
/*  - TRUE success                                                           */
/*  - FALSE failure                                                          */
/*                                                                           */ 
/*  Notes:                                                                   */
/*                                                                           */ 
/*  The delay is implemented using timer 0 at port (0x24). Care must be      */ 
/*  taken not to interrupt timer operation by way of interrupts.             */
/*  Maximum supported delay is 65536 usec or 65.536 msecs.                   */ 
/*                                                                           */ 
/*****************************************************************************/
s16 brd_delay_usec(u16 usec);

/*****************************************************************************/
/*  s16 brd_set_wait_states(u16 flashDbProg,                                 */
/*                          u16 data32_64,                                   */
/*                          u16 io)                                          */
/*                                                                           */ 
/*  This routine sets the wait states for program, data & I/O spaces         */
/*                                                                           */
/*  Parameters:                                                              */