Annotation of hatari/src/falcon/dsp_core.h, revision 1.1.1.2

1.1       root        1: /*
                      2:        DSP M56001 emulation
                      3:        Core of DSP emulation
                      4: 
                      5:        (C) 2003-2008 ARAnyM developer team
                      6: 
                      7:        This program is free software; you can redistribute it and/or modify
                      8:        it under the terms of the GNU General Public License as published by
                      9:        the Free Software Foundation; either version 2 of the License, or
                     10:        (at your option) any later version.
                     11: 
                     12:        This program is distributed in the hope that it will be useful,
                     13:        but WITHOUT ANY WARRANTY; without even the implied warranty of
                     14:        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     15:        GNU General Public License for more details.
                     16: 
                     17:        You should have received a copy of the GNU General Public License
                     18:        along with this program; if not, write to the Free Software
                     19:        Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     20: */
                     21: 
                     22: #ifndef DSP_CORE_H
                     23: #define DSP_CORE_H
                     24: 
                     25: #include <SDL.h>
                     26: 
                     27: #ifdef __cplusplus
                     28: extern "C" {
                     29: #endif
                     30: 
                     31: #define DSP_RAMSIZE 32768
                     32: 
                     33: /* Host port, CPU side */
                     34: #define CPU_HOST_ICR   0x00
                     35: #define CPU_HOST_CVR   0x01
                     36: #define CPU_HOST_ISR   0x02
                     37: #define CPU_HOST_IVR   0x03
1.1.1.2 ! root       38: #define CPU_HOST_TRX0  0x04
        !            39: #define CPU_HOST_TRXH  0x05
        !            40: #define CPU_HOST_TRXM  0x06
        !            41: #define CPU_HOST_TRXL  0x07
1.1       root       42: #define CPU_HOST_RX0   0x04
                     43: #define CPU_HOST_RXH   0x05
                     44: #define CPU_HOST_RXM   0x06
                     45: #define CPU_HOST_RXL   0x07
1.1.1.2 ! root       46: #define CPU_HOST_TXH   0x09
        !            47: #define CPU_HOST_TXM   0x0a
        !            48: #define CPU_HOST_TXL   0x0b
1.1       root       49: 
                     50: #define CPU_HOST_ICR_RREQ      0x00
                     51: #define CPU_HOST_ICR_TREQ      0x01
                     52: #define CPU_HOST_ICR_HF0       0x03
                     53: #define CPU_HOST_ICR_HF1       0x04
                     54: #define CPU_HOST_ICR_HM0       0x05
                     55: #define CPU_HOST_ICR_HM1       0x06
                     56: #define CPU_HOST_ICR_INIT      0x07
                     57: 
                     58: #define CPU_HOST_CVR_HC                0x07
                     59: 
                     60: #define CPU_HOST_ISR_RXDF      0x00
                     61: #define CPU_HOST_ISR_TXDE      0x01
                     62: #define CPU_HOST_ISR_TRDY      0x02
                     63: #define CPU_HOST_ISR_HF2       0x03
                     64: #define CPU_HOST_ISR_HF3       0x04
                     65: #define CPU_HOST_ISR_DMA       0x06
                     66: #define CPU_HOST_ISR_HREQ      0x07
                     67: 
                     68: /* Host port, DSP side, DSP addresses are 0xffc0+value */
                     69: #define DSP_PBC                        0x20    /* Port B control register */
                     70: #define DSP_PCC                        0x21    /* Port C control register */
                     71: #define DSP_PBDDR              0x22    /* Port B data direction register */
                     72: #define DSP_PCDDR              0x23    /* Port C data direction register */
                     73: #define DSP_PBD                        0x24    /* Port B data register */
                     74: #define DSP_PCD                        0x25    /* Port C data register */
1.1.1.2 ! root       75: #define DSP_HOST_HCR           0x28    /* Host control register */
        !            76: #define DSP_HOST_HSR           0x29    /* Host status register */
        !            77: #define DSP_HOST_HRX           0x2b    /* Host receive register */
        !            78: #define DSP_HOST_HTX           0x2b    /* Host transmit register */
1.1       root       79: #define DSP_SSI_CRA            0x2c    /* Ssi control register A */
                     80: #define DSP_SSI_CRB            0x2d    /* Ssi control register B */
                     81: #define DSP_SSI_SR             0x2e    /* Ssi status register */
                     82: #define DSP_SSI_TSR            0x2e    /* Ssi time slot register */
                     83: #define DSP_SSI_RX             0x2f    /* Ssi receive register */
                     84: #define DSP_SSI_TX             0x2f    /* Ssi transmit register */
                     85: #define DSP_BCR                        0x3e    /* Port A bus control register */
                     86: #define DSP_IPR                        0x3f    /* Interrupt priority register */
                     87: 
                     88: #define DSP_HOST_HCR_HRIE      0x00
                     89: #define DSP_HOST_HCR_HTIE      0x01
                     90: #define DSP_HOST_HCR_HCIE      0x02
                     91: #define DSP_HOST_HCR_HF2       0x03
                     92: #define DSP_HOST_HCR_HF3       0x04
                     93: 
                     94: #define DSP_HOST_HSR_HRDF      0x00
                     95: #define DSP_HOST_HSR_HTDE      0x01
                     96: #define DSP_HOST_HSR_HCP       0x02
                     97: #define DSP_HOST_HSR_HF0       0x03
                     98: #define DSP_HOST_HSR_HF1       0x04
                     99: #define DSP_HOST_HSR_DMA       0x07
                    100: 
1.1.1.2 ! root      101: #define DSP_SSI_CRA_DC0                0x8
        !           102: #define DSP_SSI_CRA_DC1                0x9
        !           103: #define DSP_SSI_CRA_DC2                0xa
        !           104: #define DSP_SSI_CRA_DC3                0xb
        !           105: #define DSP_SSI_CRA_DC4                0xc
        !           106: #define DSP_SSI_CRA_WL0                0xd
        !           107: #define DSP_SSI_CRA_WL1                0xe
        !           108: 
        !           109: #define DSP_SSI_CRB_OF0                0x0
        !           110: #define DSP_SSI_CRB_OF1                0x1
        !           111: #define DSP_SSI_CRB_SCD0       0x2
        !           112: #define DSP_SSI_CRB_SCD1       0x3
        !           113: #define DSP_SSI_CRB_SCD2       0x4
        !           114: #define DSP_SSI_CRB_SCKD       0x5
        !           115: #define DSP_SSI_CRB_SHFD       0x6
        !           116: #define DSP_SSI_CRB_FSL0       0x7
        !           117: #define DSP_SSI_CRB_FSL1       0x8
        !           118: #define DSP_SSI_CRB_SYN                0x9
        !           119: #define DSP_SSI_CRB_GCK                0xa
        !           120: #define DSP_SSI_CRB_MOD                0xb
        !           121: #define DSP_SSI_CRB_TE         0xc
        !           122: #define DSP_SSI_CRB_RE         0xd
        !           123: #define DSP_SSI_CRB_TIE                0xe
        !           124: #define DSP_SSI_CRB_RIE                0xf
        !           125: 
        !           126: #define DSP_SSI_SR_IF0         0x0
        !           127: #define DSP_SSI_SR_IF1         0x1
        !           128: #define DSP_SSI_SR_TFS         0x2
        !           129: #define DSP_SSI_SR_RFS         0x3
        !           130: #define DSP_SSI_SR_TUE         0x4
        !           131: #define DSP_SSI_SR_ROE         0x5
        !           132: #define DSP_SSI_SR_TDE         0x6
        !           133: #define DSP_SSI_SR_RDF         0x7
        !           134: 
        !           135: #define DSP_INTERRUPT_NONE      0x0
        !           136: #define DSP_INTERRUPT_FAST      0x1
        !           137: #define DSP_INTERRUPT_LONG      0x2
        !           138: 
        !           139: #define DSP_INTER_RESET                        0x0
        !           140: #define DSP_INTER_ILLEGAL              0x1
        !           141: #define DSP_INTER_STACK_ERROR          0x2
        !           142: #define DSP_INTER_TRACE                        0x3
        !           143: #define DSP_INTER_SWI                  0x4
        !           144: #define DSP_INTER_HOST_COMMAND         0x5
        !           145: #define DSP_INTER_HOST_RCV_DATA                0x6
        !           146: #define DSP_INTER_HOST_TRX_DATA                0x7
        !           147: #define DSP_INTER_SSI_RCV_DATA_E       0x9
        !           148: #define DSP_INTER_SSI_RCV_DATA         0xa
        !           149: #define DSP_INTER_SSI_TRX_DATA_E       0xb
        !           150: #define DSP_INTER_SSI_TRX_DATA         0xc
        !           151: 
        !           152: 
        !           153: typedef struct dsp_core_ssi_s dsp_core_ssi_t;
        !           154: 
        !           155: struct dsp_core_ssi_s {
        !           156:        Uint16  cra_word_length;
        !           157:        Uint32  cra_word_mask;
        !           158:        Uint16  cra_frame_rate_divider;
        !           159: 
        !           160:        Uint16  crb_src_clock;
        !           161:        Uint16  crb_shifter;
        !           162:        Uint16  crb_synchro;
        !           163:        Uint16  crb_mode;
        !           164:        Uint16  crb_te;
        !           165:        Uint16  crb_re;
        !           166:        Uint16  crb_tie;
        !           167:        Uint16  crb_rie;
        !           168: 
        !           169:        Uint32  TX;
        !           170:        Uint32  RX;
        !           171:        Uint32  transmit_value;         /* DSP Transmit --> SSI */
        !           172:        Uint32  received_value;         /* DSP Receive  --> SSI */
        !           173:        Uint16  waitFrame;
        !           174:        Uint16  slot_in_frame;
        !           175: };
        !           176: 
        !           177: 
        !           178: typedef struct dsp_core_s dsp_core_t;
        !           179: 
        !           180: struct dsp_core_s {
1.1       root      181: 
                    182:        /* DSP executing instructions ? */
                    183:        volatile int running;
1.1.1.2 ! root      184:        
        !           185:        /* DSP instruction Cycle counter */
        !           186:        Uint16  instr_cycle;
1.1       root      187: 
                    188:        /* Registers */
                    189:        Uint16  pc;
                    190:        Uint32  registers[64];
                    191: 
                    192:        /* stack[0=ssh], stack[1=ssl] */
1.1.1.2 ! root      193:        Uint16  stack[2][16];
1.1       root      194: 
                    195:        /* External ram[0] is x:, ram[1] is y:, ram[2] is p: */
1.1.1.2 ! root      196:        Uint32  ramext[DSP_RAMSIZE];
1.1       root      197: 
                    198:        /* rom[0] is x:, rom[1] is y: */
                    199:        Uint32  rom[2][512];
                    200: 
                    201:        /* Internal ram[0] is x:, ram[1] is y:, ram[2] is p: */
                    202:        Uint32  ramint[3][512];
                    203: 
                    204:        /* peripheral space, [x|y]:0xffc0-0xffff */
                    205:        volatile Uint32 periph[2][64];
1.1.1.2 ! root      206:        volatile Uint32 dsp_host_htx;
        !           207:        volatile Uint32 dsp_host_rtx;
        !           208: 
1.1       root      209: 
                    210:        /* host port, CPU side */
1.1.1.2 ! root      211:        volatile Uint8 hostport[12];
        !           212: 
        !           213:        /* SSI */
        !           214:        dsp_core_ssi_t ssi;
1.1       root      215: 
                    216:        /* Misc */
                    217:        Uint32 loop_rep;                /* executing rep ? */
1.1.1.2 ! root      218:        Uint32 pc_on_rep;               /* True if PC is on REP instruction */
1.1       root      219: 
                    220:        /* For bootstrap routine */
                    221:        Uint16  bootstrap_pos;
1.1.1.2 ! root      222: 
        !           223:        /* Interruptions */
        !           224:        Uint16  interrupt_state;
        !           225:        Uint32  interrupt_instr_fetch;
        !           226:        Uint32  interrupt_save_pc;
        !           227:        Uint16  interrupt_table[13];
        !           228:        Uint16  interrupt_counter;
        !           229: };
        !           230: 
1.1       root      231: 
                    232: /* Emulator call these to init/stop/reset DSP emulation */
1.1.1.2 ! root      233: extern void dsp_core_init(dsp_core_t *dsp_core);
        !           234: extern void dsp_core_shutdown(dsp_core_t *dsp_core);
        !           235: extern void dsp_core_reset(dsp_core_t *dsp_core);
1.1       root      236: 
1.1.1.2 ! root      237: /* Post a new interrupt to the interrupt table */
        !           238: extern void dsp_core_add_interrupt(dsp_core_t *dsp_core, Uint32 inter);
1.1       root      239: 
1.1.1.2 ! root      240: /* host port read/write by emulator, addr is 0-7, not 0xffa200-0xffa207 */
        !           241: extern Uint8 dsp_core_read_host(dsp_core_t *dsp_core, int addr);
        !           242: extern void dsp_core_write_host(dsp_core_t *dsp_core, int addr, Uint8 value);
1.1       root      243: 
                    244: /* dsp_cpu call these to read/write host port */
1.1.1.2 ! root      245: extern void dsp_core_hostport_dspread(dsp_core_t *dsp_core);
        !           246: extern void dsp_core_hostport_dspwrite(dsp_core_t *dsp_core);
        !           247: 
        !           248: /* dsp_cpu call these to read/write/configure SSI port */
        !           249: extern void dsp_core_ssi_configure(dsp_core_t *dsp_core, Uint32 adress, Uint32 value);
        !           250: extern void dsp_core_ssi_receive_serial_clock(dsp_core_t *dsp_core);
        !           251: extern void dsp_core_ssi_receive_SC2(dsp_core_t *dsp_core, Uint32 value);
        !           252: extern void dsp_core_ssi_writeTX(dsp_core_t *dsp_core, Uint32 value);
        !           253: extern void dsp_core_ssi_writeTSR(dsp_core_t *dsp_core);
        !           254: extern Uint32 dsp_core_ssi_readRX(dsp_core_t *dsp_core);
        !           255: extern void dsp_core_ssi_generate_internal_clock(dsp_core_t *dsp_core);
        !           256: 
        !           257: 
        !           258: 
        !           259: /* Process peripheral code */
        !           260: extern void dsp_core_process_host_interface(dsp_core_t *dsp_core);     /* HI */
        !           261: extern void dsp_core_process_ssi_interface(dsp_core_t *dsp_core);      /* SSI */
1.1       root      262: 
                    263: #ifdef __cplusplus
                    264: }
                    265: #endif
                    266: 
                    267: #endif /* DSP_CORE_H */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.