Fix makefile conditions

[maemo-rb.git] / apps / codecs / libgme / ay_emu.c

// Game_Music_Emu 0.6-pre. http://www.slack.net/~ant/

#include "ay_emu.h"

#include "blargg_endian.h"

/* Copyright (C) 2006-2009 Shay Green. This module is free software; you
can redistribute it and/or modify it under the terms of the GNU Lesser
General Public License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version. This
module is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
details. You should have received a copy of the GNU Lesser General Public
License along with this module; if not, write to the Free Software Foundation,
Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */

#include "blargg_source.h"

const char* const gme_wrong_file_type = "Wrong file type for this emulator";

// TODO: probably don't need detailed errors as to why file is corrupt

int const spectrum_clock = 3546900; // 128K Spectrum
int const spectrum_period = 70908;

//int const spectrum_clock = 3500000; // 48K Spectrum
//int const spectrum_period = 69888;

int const cpc_clock = 2000000;

static void clear_track_vars( struct Ay_Emu *this )
{
        this->current_track    = -1;
        track_stop( &this->track_filter );
}

void Ay_init( struct Ay_Emu *this )
{
        this->sample_rate  = 0;
        this->mute_mask_   = 0;
        this->tempo        = (int)FP_ONE_TEMPO;
        this->gain         = (int)FP_ONE_GAIN;
        this->track_count  = 0;
        
        // defaults
        this->tfilter = *track_get_setup( &this->track_filter );
        this->tfilter.max_initial = 2;
        this->tfilter.lookahead   = 6;
        this->track_filter.silence_ignored_ = false;
        
        this->beeper_output = NULL;
        disable_beeper( this );
        
        Ay_apu_init( &this->apu );
        Z80_init( &this->cpu );
        
        // clears fields
        this->voice_count = 0;
        this->voice_types = 0;
        clear_track_vars( this );
}

// Track info

// Given pointer to 2-byte offset of data, returns pointer to data, or NULL if
// offset is 0 or there is less than min_size bytes of data available.
static byte const* get_data( struct file_t const* file, byte const ptr [], int min_size )
{
        int offset = (int16_t) get_be16( ptr );
        int pos  = ptr - (byte const*) file->header;
        int size = file->end - (byte const*) file->header;
        assert( (unsigned) pos <= (unsigned) size - 2 );
        int limit = size - min_size;
        if ( limit < 0 || !offset || (unsigned) (pos + offset) > (unsigned) limit )
                return NULL;
        return ptr + offset;
}

static blargg_err_t parse_header( byte const in [], int size, struct file_t* out )
{
        if ( size < header_size )
                return gme_wrong_file_type;
        
        out->header = (struct header_t const*) in;
        out->end    = in + size;
        struct header_t const* h = (struct header_t const*) in;
        if ( memcmp( h->tag, "ZXAYEMUL", 8 ) )
                return gme_wrong_file_type;
        
        out->tracks = get_data( out, h->track_info, (h->max_track + 1) * 4 );
        if ( !out->tracks )
                return "missing track data";

        return 0;
}

// Setup

static void change_clock_rate( struct Ay_Emu *this, int rate )
{
        this->clock_rate_ = rate;
        Buffer_clock_rate( &this->stereo_buf, rate );
}

blargg_err_t Ay_load_mem( struct Ay_Emu *this, byte const in [], long size )
{
        // Unload
        this->voice_count = 0;
        this->track_count = 0;
        this->m3u.size = 0;
        clear_track_vars( this );

        assert( offsetof (struct header_t,track_info [2]) == header_size );
        
        RETURN_ERR( parse_header( in, size, &this->file ) );
        
        /* if ( file.header->vers > 2 )
                warning( "Unknown file version" ); */
        
        this->voice_count = ay_osc_count + 1; // +1 for beeper
        static int const types [ay_osc_count + 1] = {
                wave_type+0, wave_type+1, wave_type+2, mixed_type+1
        };
        this->voice_types = types;
        
        Ay_apu_volume( &this->apu, this->gain);
        
        // Setup buffer
        change_clock_rate( this, spectrum_clock );
        RETURN_ERR( Buffer_set_channel_count( &this->stereo_buf, this->voice_count, this->voice_types ) );
        this->buf_changed_count = Buffer_channels_changed_count( &this->stereo_buf );
        
        Sound_set_tempo( this, this->tempo );
        Sound_mute_voices( this, this->mute_mask_ );
        
        this->track_count = this->file.header->max_track + 1;
        return 0;
}

static void set_beeper_output( struct Ay_Emu *this, struct Blip_Buffer* b )
{
        this->beeper_output = b;
        if ( b && !this->cpc_mode )
                this->beeper_mask = 0x10;
        else
                disable_beeper( this );
}

static void set_voice( struct Ay_Emu *this, int i, struct Blip_Buffer* center )
{
        if ( i >= ay_osc_count )
                set_beeper_output( this, center );
        else
                Ay_apu_set_output( &this->apu, i, center );
}

static blargg_err_t run_clocks( struct Ay_Emu *this, blip_time_t* duration, int msec )
{
#if defined(ROCKBOX)
        (void) msec;
#endif

        cpu_time_t *end = duration;     
        struct Z80_Cpu* cpu = &this->cpu;
        Z80_set_time( cpu, 0 );
        
        // Since detection of CPC mode will halve clock rate during the frame
        // and thus generate up to twice as much sound, we must generate half
        // as much until mode is known.
        if ( !(this->spectrum_mode | this->cpc_mode) )
                *end /= 2;
        
        while ( Z80_time( cpu ) < *end )
        {
                run_cpu( this, min( *end, this->next_play ) );
                
                if ( Z80_time( cpu ) >= this->next_play )
                {
                        // next frame
                        this->next_play += this->play_period;
                        
                        if ( cpu->r.iff1 )
                        {
                                // interrupt enabled
                                
                                if ( this->mem.ram [cpu->r.pc] == 0x76 )
                                        cpu->r.pc++; // advance past HALT instruction
                                
                                cpu->r.iff1 = 0;
                                cpu->r.iff2 = 0;
                                
                                this->mem.ram [--cpu->r.sp] = (byte) (cpu->r.pc >> 8);
                                this->mem.ram [--cpu->r.sp] = (byte) (cpu->r.pc);
                                
                                // fixed interrupt
                                cpu->r.pc = 0x38;
                                Z80_adjust_time( cpu, 12 );
                                
                                if ( cpu->r.im == 2 )
                                {
                                        // vectored interrupt
                                        addr_t addr = cpu->r.i * 0x100 + 0xFF;
                                        cpu->r.pc = this->mem.ram [(addr + 1) & 0xFFFF] * 0x100 + this->mem.ram [addr];
                                        Z80_adjust_time( cpu, 6 );
                                }
                        }
                }
        }
        
        // End time frame
        *end = Z80_time( cpu );
        this->next_play -= *end;
        check( this->next_play >= 0 );
        Z80_adjust_time( cpu, -*end );
        Ay_apu_end_frame( &this->apu, *end );
        return 0;
}

// Emulation

void cpu_out_( struct Ay_Emu *this, cpu_time_t time, addr_t addr, int data )
{
        // Spectrum
        if ( !this->cpc_mode )
        {
                switch ( addr & 0xFEFF )
                {
                case 0xFEFD:
                        this->spectrum_mode = true;
                        Ay_apu_write_addr( &this->apu, data );
                        return;
                
                case 0xBEFD:
                        this->spectrum_mode = true;
                        Ay_apu_write_data( &this->apu, time, data );
                        return;
                }
        }
        
        // CPC
        if ( !this->spectrum_mode )
        {
                switch ( addr >> 8 )
                {
                case 0xF6:
                        switch ( data & 0xC0 )
                        {
                        case 0xC0:
                                Ay_apu_write_addr( &this->apu, this->cpc_latch );
                                goto enable_cpc;
                        
                        case 0x80:
                                Ay_apu_write_data( &this->apu, time, this->cpc_latch );
                                goto enable_cpc;
                        }
                        break;
                
                case 0xF4:
                        this->cpc_latch = data;
                        goto enable_cpc;
                }
        }
        
        /* dprintf( "Unmapped OUT: $%04X <- $%02X\n", addr, data ); */
        return;
        
enable_cpc:
        if ( !this->cpc_mode )
        {
                this->cpc_mode = true;
                disable_beeper( this );
        
                change_clock_rate( this, cpc_clock );
                Sound_set_tempo( this, this->tempo );
        }
}

blargg_err_t Ay_set_sample_rate( struct Ay_Emu *this, int rate )
{
        require( !this->sample_rate ); // sample rate can't be changed once set
        Buffer_init( &this->stereo_buf );
        RETURN_ERR( Buffer_set_sample_rate( &this->stereo_buf, rate, 1000 / 20 ) );
        
        // Set buffer bass
        Buffer_bass_freq( &this->stereo_buf, 160 );
        
        this->sample_rate = rate;
        RETURN_ERR( track_init( &this->track_filter, this ) );
        this->tfilter.max_silence = 6 * stereo * this->sample_rate;
        return 0;
}

void Sound_mute_voice( struct Ay_Emu *this, int index, bool mute )
{
        require( (unsigned) index < (unsigned) this->voice_count );
        int bit = 1 << index;
        int mask = this->mute_mask_ | bit;
        if ( !mute )
                mask ^= bit;
        Sound_mute_voices( this, mask );
}

void Sound_mute_voices( struct Ay_Emu *this, int mask )
{
        require( this->sample_rate ); // sample rate must be set first
        this->mute_mask_ = mask;
        
        int i;
        for ( i = this->voice_count; i--; )
        {
                if ( mask & (1 << i) )
                {
                        set_voice( this, i, 0 );
                }
                else
                {
                        struct channel_t ch = Buffer_channel( &this->stereo_buf, i );
                        assert( (ch.center && ch.left && ch.right) ||
                                        (!ch.center && !ch.left && !ch.right) ); // all or nothing
                        set_voice( this, i, ch.center );
                }
        }
}

void Sound_set_tempo( struct Ay_Emu *this, int t )
{
        require( this->sample_rate ); // sample rate must be set first
        int const min = (int)(FP_ONE_TEMPO*0.02);
        int const max = (int)(FP_ONE_TEMPO*4.00);
        if ( t < min ) t = min;
        if ( t > max ) t = max;
        this->tempo = t;
        
        int p = spectrum_period;
        if ( this->clock_rate_ != spectrum_clock )
                p = this->clock_rate_ / 50;
        
        this->play_period = (blip_time_t) ((p * FP_ONE_TEMPO) / t);
}

blargg_err_t Ay_start_track( struct Ay_Emu *this, int track )
{
        clear_track_vars( this );
        
        // Remap track if playlist available
        if ( this->m3u.size > 0 ) {
                struct entry_t* e = &this->m3u.entries[track];
                track = e->track;
        }
        
        this->current_track = track;
        Buffer_clear( &this->stereo_buf );
        
        byte* const mem = this->mem.ram;
        
        memset( mem + 0x0000, 0xC9, 0x100 ); // fill RST vectors with RET
        memset( mem + 0x0100, 0xFF, 0x4000 - 0x100 );
        memset( mem + ram_addr, 0x00, mem_size - ram_addr );

        // locate data blocks
        byte const* const data = get_data( &this->file, this->file.tracks + track * 4 + 2, 14 );
        if ( !data )
                return "file data missing";
        
        byte const* const more_data = get_data( &this->file, data + 10, 6 );
        if ( !more_data )
                return "file data missing";
        
        byte const* blocks = get_data( &this->file, data + 12, 8 );
        if ( !blocks )
                return "file data missing";
        
        // initial addresses
        unsigned addr = get_be16( blocks );
        if ( !addr )
                return "file data missing";
        
        unsigned init = get_be16( more_data + 2 );
        if ( !init )
                init = addr;
        
        // copy blocks into memory
        do
        {
                blocks += 2;
                unsigned len = get_be16( blocks ); blocks += 2;
                if ( addr + len > mem_size )
                {
                        /* warning( "Bad data block size" ); */
                        len = mem_size - addr;
                }
                check( len );
                byte const* in = get_data( &this->file, blocks, 0 ); blocks += 2;
                if ( len > (unsigned) (this->file.end - in) )
                {
                        /* warning( "File data missing" ); */
                        len = this->file.end - in;
                }

                memcpy( mem + addr, in, len );
                
                if ( this->file.end - blocks < 8 )
                {
                        /* warning( "File data missing" ); */
                        break;
                }
        }
        while ( (addr = get_be16( blocks )) != 0 );
        
        // copy and configure driver
        static byte const passive [] = {
                0xF3,       // DI
                0xCD, 0, 0, // CALL init
                0xED, 0x5E, // LOOP: IM 2
                0xFB,       // EI
                0x76,       // HALT
                0x18, 0xFA  // JR LOOP
        };
        static byte const active [] = {
                0xF3,       // DI
                0xCD, 0, 0, // CALL init
                0xED, 0x56, // LOOP: IM 1
                0xFB,       // EI
                0x76,       // HALT
                0xCD, 0, 0, // CALL play
                0x18, 0xF7  // JR LOOP
        };
        memcpy( mem, passive, sizeof passive );
        int const play_addr = get_be16( more_data + 4 );
        if ( play_addr )
        {
                memcpy( mem, active, sizeof active );
                mem [ 9] = play_addr;
                mem [10] = play_addr >> 8;
        }
        mem [2] = init;
        mem [3] = init >> 8;
        
        mem [0x38] = 0xFB; // Put EI at interrupt vector (followed by RET)
        
        // start at spectrum speed
        change_clock_rate( this, spectrum_clock );
        Sound_set_tempo( this, this->tempo );
        
        struct registers_t r;
        memset( &r, 0, sizeof(struct registers_t) );
        
        r.sp = get_be16( more_data );
        r.b.a     = r.b.b = r.b.d = r.b.h = data [8];
        r.b.flags = r.b.c = r.b.e = r.b.l = data [9];
        r.alt.w = r.w;
        r.ix = r.iy = r.w.hl;
        
        memset( this->mem.padding1, 0xFF, sizeof this->mem.padding1 );
        
        int const mirrored = 0x80; // this much is mirrored after end of memory
        memset( this->mem.ram + mem_size + mirrored, 0xFF, sizeof this->mem.ram - mem_size - mirrored );
        memcpy( this->mem.ram + mem_size, this->mem.ram, mirrored ); // some code wraps around (ugh)
        
        Z80_reset( &this->cpu, this->mem.padding1, this->mem.padding1 );
        Z80_map_mem( &this->cpu, 0, mem_size, this->mem.ram, this->mem.ram );
        this->cpu.r = r;
        
        this->beeper_delta   = (int) ((ay_amp_range*4)/5);
        this->last_beeper    = 0;
        this->next_play      = this->play_period;
        this->spectrum_mode  = false;
        this->cpc_mode       = false;
        this->cpc_latch      = 0;
        set_beeper_output( this, this->beeper_output );
        Ay_apu_reset( &this->apu );
        
        // a few tunes rely on channels having tone enabled at the beginning
        Ay_apu_write_addr( &this->apu, 7 );
        Ay_apu_write_data( &this->apu, 0, 0x38 );
        
        // convert filter times to samples
        struct setup_t s = this->tfilter;
        s.max_initial *= this->sample_rate * stereo;
        #ifdef GME_DISABLE_SILENCE_LOOKAHEAD
                s.lookahead = 1;
        #endif
        track_setup( &this->track_filter, &s );
        
        return track_start( &this->track_filter );
}

// Tell/Seek

static int msec_to_samples( int msec, int sample_rate )
{
        int sec = msec / 1000;
        msec -= sec * 1000;
        return (sec * sample_rate + msec * sample_rate / 1000) * stereo;
}

int Track_tell( struct Ay_Emu *this )
{
        int rate = this->sample_rate * stereo;
        int sec = track_sample_count( &this->track_filter ) / rate;
        return sec * 1000 + (track_sample_count( &this->track_filter ) - sec * rate) * 1000 / rate;
}

blargg_err_t Track_seek( struct Ay_Emu *this, int msec )
{
        int time = msec_to_samples( msec, this->sample_rate );
        if ( time < track_sample_count( &this->track_filter ) )
        RETURN_ERR( Ay_start_track( this, this->current_track ) );
        return Track_skip( this, time - track_sample_count( &this->track_filter ) );
}

blargg_err_t skip_( void *emu, int count )
{
        struct Ay_Emu* this = (struct Ay_Emu*) emu;
        
        // for long skip, mute sound
        const int threshold = 32768;
        if ( count > threshold )
        {
                int saved_mute = this->mute_mask_;
                Sound_mute_voices( this, ~0 );

                int n = count - threshold/2;
                n &= ~(2048-1); // round to multiple of 2048
                count -= n;
                RETURN_ERR( skippy_( &this->track_filter, n ) );

                Sound_mute_voices( this, saved_mute );
        }

        return skippy_( &this->track_filter, count );
}

blargg_err_t Track_skip( struct Ay_Emu *this, int count )
{
        require( this->current_track >= 0 ); // start_track() must have been called already
        return track_skip( &this->track_filter, count );
}

int Track_get_length( struct Ay_Emu* this, int n )
{
        int length = 0;

        byte const* track_info = get_data( &this->file, this->file.tracks + n * 4 + 2, 6 );
        if ( track_info )
                length = get_be16( track_info + 4 ) * (1000 / 50); // frames to msec 

        if ( (this->m3u.size > 0) && (n < this->m3u.size) ) {
                struct entry_t* entry = &this->m3u.entries [n];
                length = entry->length;
        } 
        
        if ( length <= 0 )
                length = 120 * 1000;  /* 2 minutes */ 

        return length;
}

void Track_set_fade( struct Ay_Emu *this, int start_msec, int length_msec )
{
        track_set_fade( &this->track_filter, msec_to_samples( start_msec, this->sample_rate ),
                length_msec * this->sample_rate / (1000 / stereo) );
}

blargg_err_t Ay_play( struct Ay_Emu *this, int out_count, sample_t* out )
{
        require( this->current_track >= 0 );
        require( out_count % stereo == 0 );
        return track_play( &this->track_filter, out_count, out );
}

blargg_err_t play_( void *emu, int count, sample_t* out )
{
        struct Ay_Emu* this = (struct Ay_Emu*) emu;
        
        int remain = count;
        while ( remain )
        {
                Buffer_disable_immediate_removal( &this->stereo_buf );
                remain -= Buffer_read_samples( &this->stereo_buf, &out [count - remain], remain );
                if ( remain )
                {
                        if ( this->buf_changed_count != Buffer_channels_changed_count( &this->stereo_buf ) )
                        {
                                this->buf_changed_count = Buffer_channels_changed_count( &this->stereo_buf );
                                
                                // Remute voices
                                Sound_mute_voices( this, this->mute_mask_ );
                        }
                        int msec = Buffer_length( &this->stereo_buf );
                        blip_time_t clocks_emulated = msec * this->clock_rate_ / 1000 - 100;
                        RETURN_ERR( run_clocks( this, &clocks_emulated, msec ) );
                        assert( clocks_emulated );
                        Buffer_end_frame( &this->stereo_buf, clocks_emulated );
                }
        }
        return 0;
}