dsp.h

Go to the documentation of this file.

/*-------------------------------------------------------------

dsp.h -- DSP subsystem

Copyright (C) 2004
Michael Wiedenbauer (shagkur)
Dave Murphy (WinterMute)

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any
damages arising from the use of this software.

Permission is granted to anyone to use this software for any
purpose, including commercial applications, and to alter it and
redistribute it freely, subject to the following restrictions:

1.  The origin of this software must not be misrepresented; you
must not claim that you wrote the original software. If you use
this software in a product, an acknowledgment in the product
documentation would be appreciated but is not required.

2.  Altered source versions must be plainly marked as such, and
must not be misrepresented as being the original software.

3.  This notice may not be removed or altered from any source
distribution.

-------------------------------------------------------------*/


#ifndef __DSP_H__
#define __DSP_H__

#include <gctypes.h>

#define DSPTASK_INIT        0               
#define DSPTASK_RUN         1               
#define DSPTASK_YIELD       2               
#define DSPTASK_DONE        3               
#define DSPTASK_CLEARALL    0x00000000      
#define DSPTASK_ATTACH      0x00000001      
#define DSPTASK_CANCEL      0x00000002      
#ifdef __cplusplus
   extern "C" {
#endif /* __cplusplus */


typedef struct _dsp_task dsptask_t;


typedef void (*DSPTaskCallback)(dsptask_t *task);


typedef void (*DSPCallback)(void);


struct _dsp_task {
    vu32 state;
    vu32 prio;
    vu32 flags;

    void *iram_maddr;
    u32 iram_len;
    u32 iram_addr;

    void *dram_maddr;
    u32 dram_len;
    u32 dram_addr;

    u16 init_vec;
    u16 resume_vec;

    DSPTaskCallback init_cb;
    DSPTaskCallback res_cb;
    DSPTaskCallback done_cb;
    DSPTaskCallback req_cb;

    struct _dsp_task *next;
    struct _dsp_task *prev;
};


void DSP_Init();


u32 DSP_CheckMailTo();


u32 DSP_CheckMailFrom();


u32 DSP_ReadMailFrom();


void DSP_AssertInt();


void DSP_SendMailTo(u32 mail);


u32 DSP_ReadCPUtoDSP();


dsptask_t* DSP_AddTask(dsptask_t *task);

dsptask_t* DSP_AssertTask(dsptask_t *task);

void DSP_CancelTask(dsptask_t *task);

void DSP_Reset();

void DSP_Halt();

void DSP_Unhalt();

DSPCallback DSP_RegisterCallback(DSPCallback usr_cb);

#ifdef __cplusplus
   }
#endif /* __cplusplus */

#endif