dsp.h

Go to the documentation of this file.

/*
** Jo Sega Saturn Engine
** Copyright (c) 2012-2026, Johannes Fetz (johannesfetz@gmail.com)
** All rights reserved.
**
** Redistribution and use in source and binary forms, with or without
** modification, are permitted provided that the following conditions are met:
**     * Redistributions of source code must retain the above copyright
**       notice, this list of conditions and the following disclaimer.
**     * Redistributions in binary form must reproduce the above copyright
**       notice, this list of conditions and the following disclaimer in the
**       documentation and/or other materials provided with the distribution.
**     * Neither the name of the Johannes Fetz nor the
**       names of its contributors may be used to endorse or promote products
**       derived from this software without specific prior written permission.
**
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
** ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
** WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
** DISCLAIMED. IN NO EVENT SHALL Johannes Fetz BE LIABLE FOR ANY
** DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
** (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
** LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
** ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
** SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
 
#ifndef __JO_DSP_H__
# define __JO_DSP_H__

# define JO_DSP_BANK_SIZE           (64)
# define JO_DSP_PROGRAM_SIZE        (256)

# define JO_DSP_PPAF                (*(volatile unsigned int *)0x25FE0080)
# define JO_DSP_PPD                 (*(volatile unsigned int *)0x25FE0084)
# define JO_DSP_PDA                 (*(volatile unsigned int *)0x25FE0088)
# define JO_DSP_PDD                 (*(volatile unsigned int *)0x25FE008C)
# define JO_DSP_PPAF_EXECUTE        (1 << 16)
# define JO_DSP_PPAF_LOAD           (1 << 15)
# define JO_DSP_PPAF_DMA            (1 << 23)

void                                jo_dsp_load_program(const unsigned int * const program, const unsigned int count);

void                                jo_dsp_write_data(const unsigned int bank, const unsigned int address, const unsigned int * const data, const unsigned int count);

void                                jo_dsp_read_data(const unsigned int bank, const unsigned int address, unsigned int * const data, const unsigned int count);

static  __jo_force_inline void      jo_dsp_start(const unsigned int pc)
{
    JO_DSP_PPAF = JO_DSP_PPAF_EXECUTE | JO_DSP_PPAF_LOAD | (pc & 0xFF);
}

static  __jo_force_inline bool      jo_dsp_is_running(void)
{
    return ((JO_DSP_PPAF & (JO_DSP_PPAF_EXECUTE | JO_DSP_PPAF_DMA)) != 0);
}

static  __jo_force_inline void      jo_dsp_wait(void)
{
    while (jo_dsp_is_running())
        ;
}
 
#endif /* !__JO_DSP_H__ */
 
/*
** END OF FILE
*/