mirror of
https://github.com/zeldaret/oot.git
synced 2024-11-14 13:30:47 +00:00
efe485f017
* Real rcp.h * Correction to comment in initialize.c * Try fix R4300.h * Adjust rcp.h formatting, remove defines in other headers that are now in rcp.h * Suggested changes, document a bug in the modified osAiSetNextBuffer * More rcp.h formatting changes
811 lines
28 KiB
C
811 lines
28 KiB
C
#ifndef ULTRA64_RCP_H
|
|
#define ULTRA64_RCP_H
|
|
|
|
#include "R4300.h"
|
|
#include "ultratypes.h"
|
|
|
|
/**
|
|
* RCP memory map overview:
|
|
*
|
|
* 0x0000_0000 .. 0x03EF_FFFF RDRAM memory
|
|
* 0x03F0_0000 .. 0x03FF_FFFF RDRAM registers
|
|
*
|
|
* 0x0400_0000 .. 0x0400_2000 SP memory
|
|
* 0x0404_0000 .. 0x040F_FFFF SP registers
|
|
* 0x0410_0000 .. 0x041F_FFFF DP command registers
|
|
* 0x0420_0000 .. 0x042F_FFFF DP span registers
|
|
* 0x0430_0000 .. 0x043F_FFFF MI registers
|
|
* 0x0440_0000 .. 0x044F_FFFF VI registers
|
|
* 0x0450_0000 .. 0x045F_FFFF AI registers
|
|
* 0x0460_0000 .. 0x046F_FFFF PI registers
|
|
* 0x0470_0000 .. 0x047F_FFFF RI registers
|
|
* 0x0480_0000 .. 0x048F_FFFF SI registers
|
|
* 0x0490_0000 .. 0x04FF_FFFF unused
|
|
*
|
|
* 0x0500_0000 .. 0x05FF_FFFF cartridge domain 2
|
|
* 0x0600_0000 .. 0x07FF_FFFF cartridge domain 1
|
|
* 0x0800_0000 .. 0x0FFF_FFFF cartridge domain 2
|
|
* 0x1000_0000 .. 0x1FBF_FFFF cartridge domain 1
|
|
*
|
|
* 0x1FC0_0000 .. 0x1FC0_07BF PIF Boot Rom (1984 bytes)
|
|
* 0x1FC0_07C0 .. 0x1FC0_07FF PIF (JoyChannel) RAM (64 bytes)
|
|
* 0x1FC0_0800 .. 0x1FCF_FFFF Reserved
|
|
* 0x1FD0_0000 .. 0x7FFF_FFFF cartridge domain 1
|
|
* 0x8000_0000 .. 0xFFFF_FFFF external SysAD device
|
|
*/
|
|
|
|
|
|
/**
|
|
* RDRAM memory
|
|
*/
|
|
|
|
#define RDRAM_0_START 0x00000000
|
|
#define RDRAM_0_END 0x001FFFFF
|
|
#define RDRAM_1_START 0x00200000
|
|
#define RDRAM_1_END 0x003FFFFF
|
|
|
|
#define RDRAM_START RDRAM_0_START
|
|
#define RDRAM_END RDRAM_1_END
|
|
|
|
|
|
/**
|
|
* RDRAM registers
|
|
*/
|
|
#define RDRAM_BASE_REG 0x03F00000
|
|
|
|
#define RDRAM_CONFIG_REG (RDRAM_BASE_REG + 0x00)
|
|
#define RDRAM_DEVICE_TYPE_REG (RDRAM_BASE_REG + 0x00)
|
|
#define RDRAM_DEVICE_ID_REG (RDRAM_BASE_REG + 0x04)
|
|
#define RDRAM_DELAY_REG (RDRAM_BASE_REG + 0x08)
|
|
#define RDRAM_MODE_REG (RDRAM_BASE_REG + 0x0C)
|
|
#define RDRAM_REF_INTERVAL_REG (RDRAM_BASE_REG + 0x10)
|
|
#define RDRAM_REF_ROW_REG (RDRAM_BASE_REG + 0x14)
|
|
#define RDRAM_RAS_INTERVAL_REG (RDRAM_BASE_REG + 0x18)
|
|
#define RDRAM_MIN_INTERVAL_REG (RDRAM_BASE_REG + 0x1C)
|
|
#define RDRAM_ADDR_SELECT_REG (RDRAM_BASE_REG + 0x20)
|
|
#define RDRAM_DEVICE_MANUF_REG (RDRAM_BASE_REG + 0x24)
|
|
|
|
#define RDRAM_0_DEVICE_ID 0
|
|
#define RDRAM_1_DEVICE_ID 1
|
|
|
|
#define RDRAM_RESET_MODE 0
|
|
#define RDRAM_ACTIVE_MODE 1
|
|
#define RDRAM_STANDBY_MODE 2
|
|
|
|
#define RDRAM_LENGTH (2 * 512 * 2048)
|
|
#define RDRAM_0_BASE_ADDRESS (RDRAM_0_DEVICE_ID * RDRAM_LENGTH)
|
|
#define RDRAM_1_BASE_ADDRESS (RDRAM_1_DEVICE_ID * RDRAM_LENGTH)
|
|
|
|
#define RDRAM_0_CONFIG 0x00000
|
|
#define RDRAM_1_CONFIG 0x00400
|
|
#define RDRAM_GLOBAL_CONFIG 0x80000
|
|
|
|
|
|
/**
|
|
* PIF Physical memory map (total size = 2 KB)
|
|
*
|
|
* Size Description Mode
|
|
* 1FC007FF +-------+-----------------+-----+
|
|
* | 64 B | JoyChannel RAM | R/W |
|
|
* 1FC007C0 +-------+-----------------+-----+
|
|
* |1984 B | Boot ROM | * | * = Reserved
|
|
* 1FC00000 +-------+-----------------+-----+
|
|
*/
|
|
#define PIF_ROM_START 0x1FC00000
|
|
#define PIF_ROM_END 0x1FC007BF
|
|
#define PIF_RAM_START 0x1FC007C0
|
|
#define PIF_RAM_END 0x1FC007FF
|
|
|
|
|
|
/**
|
|
* Controller channel
|
|
* Each game controller channel has 4 error bits that are defined in bit 6-7 of
|
|
* the Rx and Tx data size area bytes. Programmers need to clear these bits
|
|
* when setting the Tx/Rx size area values for a channel
|
|
*/
|
|
#define CHNL_ERR_NORESP 0x80 /* Bit 7 (Rx): No response error */
|
|
#define CHNL_ERR_OVERRUN 0x40 /* Bit 6 (Rx): Overrun error */
|
|
#define CHNL_ERR_FRAME 0x80 /* Bit 7 (Tx): Frame error */
|
|
#define CHNL_ERR_COLLISION 0x40 /* Bit 6 (Tx): Collision error */
|
|
|
|
#define CHNL_ERR_MASK 0xC0 /* Bit 6-7: channel errors */
|
|
|
|
|
|
/**
|
|
* External device info
|
|
*/
|
|
#define DEVICE_TYPE_CART 0 // ROM cartridge
|
|
#define DEVICE_TYPE_BULK 1 // ROM bulk
|
|
#define DEVICE_TYPE_64DD 2 // 64 Disk Drive
|
|
#define DEVICE_TYPE_SRAM 3 // SRAM
|
|
// 4-6 are reserved
|
|
#define DEVICE_TYPE_INIT 7 // initial value
|
|
// 8-14 are reserved
|
|
|
|
|
|
/**
|
|
* Signal Processor (SP) Memory
|
|
*/
|
|
#define SP_DMEM_START 0x04000000
|
|
#define SP_DMEM_END 0x04000FFF
|
|
#define SP_IMEM_START 0x04001000
|
|
#define SP_IMEM_END 0x04001FFF
|
|
|
|
|
|
/**
|
|
* Signal Processor (SP) CP0 Registers
|
|
*/
|
|
|
|
#define SP_BASE_REG 0x04040000
|
|
|
|
// SP memory address (R/W): [12] 0=DMEM,1=IMEM, [11:0] DMEM/IMEM address
|
|
#define SP_MEM_ADDR_REG (SP_BASE_REG + 0x00)
|
|
|
|
// SP DRAM DMA address (R/W): [23:0] RDRAM address
|
|
#define SP_DRAM_ADDR_REG (SP_BASE_REG + 0x04)
|
|
|
|
// SP read DMA length (R/W): [31:20] skip, [19:12] count, [11:0] length; RDRAM -> I/DMEM
|
|
#define SP_RD_LEN_REG (SP_BASE_REG + 0x08)
|
|
|
|
// SP write DMA length (R/W): [31:20] skip, [19:12] count, [11:0] length; I/DMEM -> RDRAM
|
|
#define SP_WR_LEN_REG (SP_BASE_REG + 0x0C)
|
|
|
|
// SP status (R/W): [14:0] valid bits; see below for write/read mode
|
|
#define SP_STATUS_REG (SP_BASE_REG + 0x10)
|
|
|
|
// SP DMA full (R): [0] dma full
|
|
#define SP_DMA_FULL_REG (SP_BASE_REG + 0x14)
|
|
|
|
// SP DMA busy (R): [0] dma busy
|
|
#define SP_DMA_BUSY_REG (SP_BASE_REG + 0x18)
|
|
|
|
// SP semaphore (R/W): Read: [0] acquire semaphore; Write: [] release semaphore
|
|
#define SP_SEMAPHORE_REG (SP_BASE_REG + 0x1C)
|
|
|
|
// SP PC (R/W): [11:0] program counter
|
|
#define SP_PC_REG 0x04080000
|
|
|
|
/*
|
|
* SP_MEM_ADDR_REG: bit 12
|
|
*/
|
|
#define SP_DMA_DMEM (0 << 12)
|
|
#define SP_DMA_IMEM (1 << 12)
|
|
|
|
/*
|
|
* SP_STATUS_REG: write bits
|
|
*/
|
|
#define SP_CLR_HALT (1 << 0) // clear halt
|
|
#define SP_SET_HALT (1 << 1) // set halt
|
|
#define SP_CLR_BROKE (1 << 2) // clear broke
|
|
#define SP_CLR_INTR (1 << 3) // clear interrupt
|
|
#define SP_SET_INTR (1 << 4) // set interrupt
|
|
#define SP_CLR_SSTEP (1 << 5) // clear sstep
|
|
#define SP_SET_SSTEP (1 << 6) // set sstep
|
|
#define SP_CLR_INTR_BREAK (1 << 7) // clear interrupt on break
|
|
#define SP_SET_INTR_BREAK (1 << 8) // set interrupt on break
|
|
#define SP_CLR_SIG0 (1 << 9) // clear signal 0
|
|
#define SP_SET_SIG0 (1 << 10) // set signal 0
|
|
#define SP_CLR_SIG1 (1 << 11) // clear signal 1
|
|
#define SP_SET_SIG1 (1 << 12) // set signal 1
|
|
#define SP_CLR_SIG2 (1 << 13) // clear signal 2
|
|
#define SP_SET_SIG2 (1 << 14) // set signal 2
|
|
#define SP_CLR_SIG3 (1 << 15) // clear signal 3
|
|
#define SP_SET_SIG3 (1 << 16) // set signal 3
|
|
#define SP_CLR_SIG4 (1 << 17) // clear signal 4
|
|
#define SP_SET_SIG4 (1 << 18) // set signal 4
|
|
#define SP_CLR_SIG5 (1 << 19) // clear signal 5
|
|
#define SP_SET_SIG5 (1 << 20) // set signal 5
|
|
#define SP_CLR_SIG6 (1 << 21) // clear signal 6
|
|
#define SP_SET_SIG6 (1 << 22) // set signal 6
|
|
#define SP_CLR_SIG7 (1 << 23) // clear signal 7
|
|
#define SP_SET_SIG7 (1 << 24) // set signal 7
|
|
|
|
/*
|
|
* SP_STATUS_REG: read bits
|
|
*/
|
|
#define SP_STATUS_HALT (1 << 0)
|
|
#define SP_STATUS_BROKE (1 << 1)
|
|
#define SP_STATUS_DMA_BUSY (1 << 2)
|
|
#define SP_STATUS_DMA_FULL (1 << 3)
|
|
#define SP_STATUS_IO_FULL (1 << 4)
|
|
#define SP_STATUS_SSTEP (1 << 5)
|
|
#define SP_STATUS_INTR_BREAK (1 << 6)
|
|
#define SP_STATUS_SIG0 (1 << 7)
|
|
#define SP_STATUS_SIG1 (1 << 8)
|
|
#define SP_STATUS_SIG2 (1 << 9)
|
|
#define SP_STATUS_SIG3 (1 << 10)
|
|
#define SP_STATUS_SIG4 (1 << 11)
|
|
#define SP_STATUS_SIG5 (1 << 12)
|
|
#define SP_STATUS_SIG6 (1 << 13)
|
|
#define SP_STATUS_SIG7 (1 << 14)
|
|
|
|
/*
|
|
* SP_STATUS_REG: use of SIG bits
|
|
*/
|
|
#define SP_CLR_YIELD SP_CLR_SIG0
|
|
#define SP_SET_YIELD SP_SET_SIG0
|
|
#define SP_STATUS_YIELD SP_STATUS_SIG0
|
|
#define SP_CLR_YIELDED SP_CLR_SIG1
|
|
#define SP_SET_YIELDED SP_SET_SIG1
|
|
#define SP_STATUS_YIELDED SP_STATUS_SIG1
|
|
#define SP_CLR_TASKDONE SP_CLR_SIG2
|
|
#define SP_SET_TASKDONE SP_SET_SIG2
|
|
#define SP_STATUS_TASKDONE SP_STATUS_SIG2
|
|
#define SP_CLR_RSPSIGNAL SP_CLR_SIG3
|
|
#define SP_SET_RSPSIGNAL SP_SET_SIG3
|
|
#define SP_STATUS_RSPSIGNAL SP_STATUS_SIG3
|
|
#define SP_CLR_CPUSIGNAL SP_CLR_SIG4
|
|
#define SP_SET_CPUSIGNAL SP_SET_SIG4
|
|
#define SP_STATUS_CPUSIGNAL SP_STATUS_SIG4
|
|
|
|
// SP IMEM BIST REG (R/W): [6:0] BIST status bits; see below for detail
|
|
#define SP_IBIST_REG 0x04080004
|
|
|
|
/*
|
|
* SP_IBIST_REG: write bits
|
|
*/
|
|
#define SP_IBIST_CHECK (1 << 0) // BIST check
|
|
#define SP_IBIST_GO (1 << 1) // BIST go
|
|
#define SP_IBIST_CLEAR (1 << 2) // BIST clear
|
|
|
|
/*
|
|
* SP_BIST_REG: read bits
|
|
* First 2 bits are same as in write mode
|
|
*/
|
|
#define SP_IBIST_DONE (1 << 2)
|
|
#define SP_IBIST_FAILED 0x78 // bits [6:3], BIST fail
|
|
|
|
|
|
/**
|
|
* Display Processor Command (DPC) Registers
|
|
*/
|
|
#define DPC_BASE_REG 0x04100000
|
|
|
|
// DP CMD DMA start (R/W): [23:0] DMEM/RDRAM start address
|
|
#define DPC_START_REG (DPC_BASE_REG + 0x00)
|
|
|
|
// DP CMD DMA end (R/W): [23:0] DMEM/RDRAM end address
|
|
#define DPC_END_REG (DPC_BASE_REG + 0x04)
|
|
|
|
// DP CMD DMA end (R): [23:0] DMEM/RDRAM current address
|
|
#define DPC_CURRENT_REG (DPC_BASE_REG + 0x08)
|
|
|
|
// DP CMD status (R/W): [9:0] valid bits - see below for definitions
|
|
#define DPC_STATUS_REG (DPC_BASE_REG + 0x0C)
|
|
|
|
// DP clock counter (R): [23:0] clock counter
|
|
#define DPC_CLOCK_REG (DPC_BASE_REG + 0x10)
|
|
|
|
// DP buffer busy counter (R): [23:0] clock counter
|
|
#define DPC_BUFBUSY_REG (DPC_BASE_REG + 0x14)
|
|
|
|
// DP pipe busy counter (R): [23:0] clock counter
|
|
#define DPC_PIPEBUSY_REG (DPC_BASE_REG + 0x18)
|
|
|
|
// DP TMEM load counter (R): [23:0] clock counter
|
|
#define DPC_TMEM_REG (DPC_BASE_REG + 0x1C)
|
|
|
|
/*
|
|
* DPC_STATUS_REG: write bits
|
|
*/
|
|
#define DPC_CLR_XBUS_DMEM_DMA (1 << 0)
|
|
#define DPC_SET_XBUS_DMEM_DMA (1 << 1)
|
|
#define DPC_CLR_FREEZE (1 << 2)
|
|
#define DPC_SET_FREEZE (1 << 3)
|
|
#define DPC_CLR_FLUSH (1 << 4)
|
|
#define DPC_SET_FLUSH (1 << 5)
|
|
#define DPC_CLR_TMEM_CTR (1 << 6)
|
|
#define DPC_CLR_PIPE_CTR (1 << 7)
|
|
#define DPC_CLR_CMD_CTR (1 << 8)
|
|
#define DPC_CLR_CLOCK_CTR (1 << 9)
|
|
|
|
/*
|
|
* DPC_STATUS_REG: read bits
|
|
*/
|
|
#define DPC_STATUS_XBUS_DMEM_DMA (1 << 0)
|
|
#define DPC_STATUS_FREEZE (1 << 1)
|
|
#define DPC_STATUS_FLUSH (1 << 2)
|
|
#define DPC_STATUS_START_GCLK (1 << 3)
|
|
#define DPC_STATUS_TMEM_BUSY (1 << 4)
|
|
#define DPC_STATUS_PIPE_BUSY (1 << 5)
|
|
#define DPC_STATUS_CMD_BUSY (1 << 6)
|
|
#define DPC_STATUS_CBUF_READY (1 << 7)
|
|
#define DPC_STATUS_DMA_BUSY (1 << 8)
|
|
#define DPC_STATUS_END_VALID (1 << 9)
|
|
#define DPC_STATUS_START_VALID (1 << 10)
|
|
|
|
|
|
/**
|
|
* Display Processor Span (DPS) Registers
|
|
*/
|
|
#define DPS_BASE_REG 0x04200000
|
|
|
|
// DP tmem built-in self-test (R/W): [10:0] BIST status bits
|
|
#define DPS_TBIST_REG (DPS_BASE_REG + 0x00)
|
|
|
|
// DP span test mode (R/W): [0] Span buffer test access enable
|
|
#define DPS_TEST_MODE_REG (DPS_BASE_REG + 0x04)
|
|
|
|
// DP span buffer test address (R/W): [6:0] bits
|
|
#define DPS_BUFTEST_ADDR_REG (DPS_BASE_REG + 0x08)
|
|
|
|
// DP span buffer test data (R/W): [31:0] span buffer data
|
|
#define DPS_BUFTEST_DATA_REG (DPS_BASE_REG + 0x0C)
|
|
|
|
/*
|
|
* DPS_TMEM_BIST_REG: write bits
|
|
*/
|
|
#define DPS_TBIST_CHECK (1 << 0)
|
|
#define DPS_TBIST_GO (1 << 1)
|
|
#define DPS_TBIST_CLEAR (1 << 2)
|
|
|
|
/*
|
|
* DPS_TMEM_BIST_REG: read bits
|
|
* First 2 bits are same as in write mode
|
|
*/
|
|
#define DPS_TBIST_DONE (1 << 2)
|
|
#define DPS_TBIST_FAILED 0x7F8 // bits [10:3], BIST fail
|
|
|
|
|
|
/**
|
|
* MIPS Interface (MI) Registers
|
|
*/
|
|
#define MI_BASE_REG 0x04300000
|
|
|
|
// MI init mode (W): [11] clear DP interrupt, [9/10] clear/set ebus test mode
|
|
// [8] set init mode, [7] clear init mode, [6:0] init length
|
|
// (R): [8] ebus test mode, [7] init mode, [6:0] init length
|
|
#define MI_INIT_MODE_REG (MI_BASE_REG + 0x00)
|
|
#define MI_MODE_REG MI_INIT_MODE_REG
|
|
|
|
/*
|
|
* MI_MODE_REG: write bits
|
|
*/
|
|
#define MI_CLR_INIT (1 << 7) // clear init mode
|
|
#define MI_SET_INIT (1 << 8) // set init mode
|
|
#define MI_CLR_EBUS (1 << 9) // clear ebus test
|
|
#define MI_SET_EBUS (1 << 10) // set ebus test mode
|
|
#define MI_CLR_DP_INTR (1 << 11) // clear dp interrupt
|
|
#define MI_CLR_RDRAM (1 << 12) // clear RDRAM reg
|
|
#define MI_SET_RDRAM (1 << 13) // set RDRAM reg mode
|
|
|
|
/*
|
|
* MI_MODE_REG: read bits
|
|
*/
|
|
#define MI_MODE_INIT (1 << 7) /* init mode */
|
|
#define MI_MODE_EBUS (1 << 8) /* ebus test mode */
|
|
#define MI_MODE_RDRAM (1 << 9) /* RDRAM reg mode */
|
|
|
|
// MI version (R): [31:24] rsp, [23:16] rdp, [15:8] rac, [7:0] io
|
|
#define MI_VERSION_REG (MI_BASE_REG + 0x04)
|
|
#define MI_NOOP_REG MI_VERSION_REG
|
|
|
|
// MI interrupt (R): [5:0] valid bits - see below for bit patterns
|
|
#define MI_INTR_REG (MI_BASE_REG + 0x08)
|
|
|
|
// MI interrupt mask (R): [5:0] valid bits - see below for bit patterns
|
|
// (W): [11:0] valid bits - see below for bit patterns
|
|
#define MI_INTR_MASK_REG (MI_BASE_REG + 0x0C)
|
|
|
|
/*
|
|
* MI_INTR_REG: read bits
|
|
*/
|
|
#define MI_INTR_SP (1 << 0) // SP intr
|
|
#define MI_INTR_SI (1 << 1) // SI intr
|
|
#define MI_INTR_AI (1 << 2) // AI intr
|
|
#define MI_INTR_VI (1 << 3) // VI intr
|
|
#define MI_INTR_PI (1 << 4) // PI intr
|
|
#define MI_INTR_DP (1 << 5) // DP intr
|
|
|
|
/*
|
|
* MI_INTR_MASK_REG: write bits
|
|
*/
|
|
#define MI_INTR_MASK_CLR_SP (1 << 0) // clear SP mask
|
|
#define MI_INTR_MASK_SET_SP (1 << 1) // set SP mask
|
|
#define MI_INTR_MASK_CLR_SI (1 << 2) // clear SI mask
|
|
#define MI_INTR_MASK_SET_SI (1 << 3) // set SI mask
|
|
#define MI_INTR_MASK_CLR_AI (1 << 4) // clear AI mask
|
|
#define MI_INTR_MASK_SET_AI (1 << 5) // set AI mask
|
|
#define MI_INTR_MASK_CLR_VI (1 << 6) // clear VI mask
|
|
#define MI_INTR_MASK_SET_VI (1 << 7) // set VI mask
|
|
#define MI_INTR_MASK_CLR_PI (1 << 8) // clear PI mask
|
|
#define MI_INTR_MASK_SET_PI (1 << 9) // set PI mask
|
|
#define MI_INTR_MASK_CLR_DP (1 << 10) // clear DP mask
|
|
#define MI_INTR_MASK_SET_DP (1 << 11) // set DP mask
|
|
|
|
/*
|
|
* MI_INTR_MASK_REG: read bits
|
|
*/
|
|
#define MI_INTR_MASK_SP (1 << 0) // SP intr mask
|
|
#define MI_INTR_MASK_SI (1 << 1) // SI intr mask
|
|
#define MI_INTR_MASK_AI (1 << 2) // AI intr mask
|
|
#define MI_INTR_MASK_VI (1 << 3) // VI intr mask
|
|
#define MI_INTR_MASK_PI (1 << 4) // PI intr mask
|
|
#define MI_INTR_MASK_DP (1 << 5) // DP intr mask
|
|
|
|
|
|
/**
|
|
* Video Interface (VI) Registers
|
|
*/
|
|
#define VI_BASE_REG 0x04400000
|
|
|
|
/*
|
|
* VI status/control (R/W): [15-0] valid bits:
|
|
* [1:0] = type[1:0] (pixel size)
|
|
* 0: blank (no data, no sync)
|
|
* 1: reserved
|
|
* 2: 5/5/5/3 ("16" bit)
|
|
* 3: 8/8/8/8 (32 bit)
|
|
* [2] = gamma_dither_enable (normally on, unless "special effect")
|
|
* [3] = gamma_enable (normally on, unless MPEG/JPEG)
|
|
* [4] = divot_enable (normally on if antialiased, unless decal lines)
|
|
* [5] = vbus_clock_enable - always off
|
|
* [6] = serrate (always on if interlaced, off if not)
|
|
* [7] = test_mode - diagnostics only
|
|
* [9:8] = anti-alias (aa) mode[1:0]
|
|
* 0: aa & resamp (always fetch extra lines)
|
|
* 1: aa & resamp (fetch extra lines if needed)
|
|
* 2: resamp only (treat as all fully covered)
|
|
* 3: neither (replicate pixels, no interpolate)
|
|
* [11] = kill_we - diagnostics only
|
|
* [15:12] = pixel_advance
|
|
* [16] = dither_filter_enable
|
|
*/
|
|
#define VI_CONTROL_REG (VI_BASE_REG + 0x00)
|
|
#define VI_STATUS_REG VI_CONTROL_REG
|
|
|
|
// VI origin (R/W): [23:0] frame buffer origin in bytes
|
|
#define VI_ORIGIN_REG (VI_BASE_REG + 0x04)
|
|
#define VI_DRAM_ADDR_REG VI_ORIGIN_REG
|
|
|
|
// VI width (R/W): [11:0] frame buffer line width in pixels
|
|
#define VI_WIDTH_REG (VI_BASE_REG + 0x08)
|
|
#define VI_H_WIDTH_REG VI_WIDTH_REG
|
|
|
|
// VI vertical intr (R/W): [9:0] interrupt when current half-line = V_INTR
|
|
#define VI_INTR_REG (VI_BASE_REG + 0x0C)
|
|
#define VI_V_INTR_REG VI_INTR_REG
|
|
|
|
// VI current vertical line (R/W): [9:0] current half line, sampled once per
|
|
// line (the lsb of V_CURRENT is constant within a field, and in interlaced
|
|
// modes gives the field number - which is constant for non-interlaced modes)
|
|
// - Any write to this register will clear interrupt line
|
|
#define VI_CURRENT_REG (VI_BASE_REG + 0x10)
|
|
#define VI_V_CURRENT_LINE_REG VI_CURRENT_REG
|
|
|
|
// VI video timing (R/W): [29:20] start of color burst in pixels from h-sync
|
|
// [19:16] vertical sync width in half lines,
|
|
// [15: 8] color burst width in pixels,
|
|
// [ 7: 0] horizontal sync width in pixels,
|
|
#define VI_BURST_REG (VI_BASE_REG + 0x14)
|
|
#define VI_TIMING_REG VI_BURST_REG
|
|
|
|
// VI vertical sync (R/W): [9:0] number of half-lines per field
|
|
#define VI_V_SYNC_REG (VI_BASE_REG + 0x18)
|
|
|
|
// VI horizontal sync (R/W): [20:16] a 5-bit leap pattern used for PAL only (h_sync_period)
|
|
// [11: 0] total duration of a line in 1/4 pixel
|
|
#define VI_H_SYNC_REG (VI_BASE_REG + 0x1C)
|
|
|
|
// VI horizontal sync leap (R/W): [27:16] identical to h_sync_period
|
|
// [11: 0] identical to h_sync_period
|
|
#define VI_LEAP_REG (VI_BASE_REG + 0x20)
|
|
#define VI_H_SYNC_LEAP_REG VI_LEAP_REG
|
|
|
|
// VI horizontal video (R/W): [25:16] start of active video in screen pixels
|
|
// [ 9: 0] end of active video in screen pixels
|
|
#define VI_H_START_REG (VI_BASE_REG + 0x24)
|
|
#define VI_H_VIDEO_REG VI_H_START_REG
|
|
|
|
// VI vertical video (R/W): [25:16] start of active video in screen half-lines
|
|
// [ 9: 0] end of active video in screen half-lines
|
|
#define VI_V_START_REG (VI_BASE_REG + 0x28)
|
|
#define VI_V_VIDEO_REG VI_V_START_REG
|
|
|
|
// VI vertical burst (R/W): [25:16] start of color burst enable in half-lines
|
|
// [ 9: 0] end of color burst enable in half-lines
|
|
#define VI_V_BURST_REG (VI_BASE_REG + 0x2C)
|
|
|
|
// VI x-scale (R/W): [27:16] horizontal subpixel offset (2.10 format)
|
|
// [11: 0] 1/horizontal scale up factor (2.10 format)
|
|
#define VI_X_SCALE_REG (VI_BASE_REG + 0x30)
|
|
|
|
// VI y-scale (R/W): [27:16] vertical subpixel offset (2.10 format)
|
|
// [11: 0] 1/vertical scale up factor (2.10 format)
|
|
#define VI_Y_SCALE_REG (VI_BASE_REG + 0x34)
|
|
|
|
/*
|
|
* VI_CONTROL_REG: read bits
|
|
*/
|
|
#define VI_CTRL_TYPE_16 0x00002 // [1:0] pixel size: 16 bit
|
|
#define VI_CTRL_TYPE_32 0x00003 // [1:0] pixel size: 32 bit
|
|
#define VI_CTRL_GAMMA_DITHER_ON 0x00004 // 2: default = on
|
|
#define VI_CTRL_GAMMA_ON 0x00008 // 3: default = on
|
|
#define VI_CTRL_DIVOT_ON 0x00010 // 4: default = on
|
|
#define VI_CTRL_SERRATE_ON 0x00040 // 6: on if interlaced
|
|
#define VI_CTRL_ANTIALIAS_MASK 0x00300 // [9:8] anti-alias mode
|
|
#define VI_CTRL_ANTIALIAS_MODE_0 0x00000 // Bit [9:8] anti-alias mode: AA enabled, resampling enabled, always fetch extra lines
|
|
#define VI_CTRL_ANTIALIAS_MODE_1 0x00100 // Bit [9:8] anti-alias mode: AA enabled, resampling enabled, fetch extra lines as-needed
|
|
#define VI_CTRL_ANTIALIAS_MODE_2 0x00200 // Bit [9:8] anti-alias mode: AA disabled, resampling enabled, operate as if everything is covered
|
|
#define VI_CTRL_ANTIALIAS_MODE_3 0x00300 // Bit [9:8] anti-alias mode: AA disabled, resampling disabled, replicate pixels
|
|
#define VI_CTRL_PIXEL_ADV_MASK 0x0F000 // [15:12] pixel advance mode
|
|
#define VI_CTRL_PIXEL_ADV(n) (((n) << 12) & VI_CTRL_PIXEL_ADV_MASK) // Bit [15:12] pixel advance mode: Always 3 on N64
|
|
#define VI_CTRL_DITHER_FILTER_ON 0x10000 // 16: dither-filter mode
|
|
|
|
/*
|
|
* Possible video clocks (NTSC or PAL)
|
|
*/
|
|
#define VI_NTSC_CLOCK 48681812 // Hz = 48.681812 MHz
|
|
#define VI_PAL_CLOCK 49656530 // Hz = 49.656530 MHz
|
|
#define VI_MPAL_CLOCK 48628316 // Hz = 48.628316 MHz
|
|
|
|
|
|
/**
|
|
* Audio Interface (AI) Registers
|
|
*
|
|
* The address and length registers are double buffered; that is, they
|
|
* can be written twice before becoming full.
|
|
* The address must be written before the length.
|
|
*/
|
|
#define AI_BASE_REG 0x04500000
|
|
|
|
// AI DRAM address (W): [23:0] starting RDRAM address (8B-aligned)
|
|
#define AI_DRAM_ADDR_REG (AI_BASE_REG + 0x00)
|
|
|
|
// AI length (R/W): [14:0] transfer length (v1.0) - Bottom 3 bits are ignored
|
|
// [17:0] transfer length (v2.0) - Bottom 3 bits are ignored
|
|
#define AI_LEN_REG (AI_BASE_REG + 0x04)
|
|
|
|
// AI control (W): [0] DMA enable - if LSB == 1, DMA is enabled
|
|
#define AI_CONTROL_REG (AI_BASE_REG + 0x08)
|
|
|
|
/*
|
|
* AI_CONTROL_REG: write bits
|
|
*/
|
|
#define AI_CONTROL_DMA_ON 1 // LSB = 1: DMA enable
|
|
#define AI_CONTROL_DMA_OFF 0 // LSB = 1: DMA enable
|
|
|
|
// AI status (R): [31]/[0] ai_full (addr & len buffer full), [30] ai_busy
|
|
// Note that a 1->0 transition in ai_full will set interrupt
|
|
// (W): clear audio interrupt
|
|
#define AI_STATUS_REG (AI_BASE_REG + 0x0C)
|
|
|
|
/*
|
|
* AI_STATUS_REG: read bits
|
|
*/
|
|
#define AI_STATUS_FIFO_FULL (1 << 31)
|
|
#define AI_STATUS_DMA_BUSY (1 << 30)
|
|
|
|
// AI DAC sample period register (W): [13:0] dac rate
|
|
// - vid_clock/(dperiod + 1) is the DAC sample rate
|
|
// - (dperiod + 1) >= 66 * (aclockhp + 1) must be true
|
|
#define AI_DACRATE_REG (AI_BASE_REG + 0x10)
|
|
|
|
// DAC rate = video clock / audio frequency
|
|
// - DAC rate >= (66 * Bit rate) must be true
|
|
#define AI_MAX_DAC_RATE 16384 // 14-bit+1
|
|
#define AI_MIN_DAC_RATE 132
|
|
|
|
// AI bit rate (W): [3:0] bit rate (abus clock half period register - aclockhp)
|
|
// - vid_clock/(2 * (aclockhp + 1)) is the DAC clock rate
|
|
// - The abus clock stops if aclockhp is zero
|
|
#define AI_BITRATE_REG (AI_BASE_REG + 0x14)
|
|
|
|
// Bit rate <= (DAC rate / 66)
|
|
#define AI_MAX_BIT_RATE 16 // 4-bit+1
|
|
#define AI_MIN_BIT_RATE 2
|
|
|
|
/*
|
|
* Maximum and minimum values for audio frequency based on video clocks
|
|
* max frequency = (video clock / min dac rate)
|
|
* min frequency = (video clock / max dac rate)
|
|
*/
|
|
#define AI_NTSC_MAX_FREQ 368000 // 368 KHz
|
|
#define AI_NTSC_MIN_FREQ 3000 // 3 KHz ~ 2971 Hz
|
|
|
|
#define AI_PAL_MAX_FREQ 376000 // 376 KHz
|
|
#define AI_PAL_MIN_FREQ 3050 // 3 KHz ~ 3031 Hz
|
|
|
|
#define AI_MPAL_MAX_FREQ 368000 // 368 KHz
|
|
#define AI_MPAL_MIN_FREQ 3000 // 3 KHz ~ 2968 Hz
|
|
|
|
|
|
/**
|
|
* Peripheral Interface (PI) Registers
|
|
*/
|
|
#define PI_BASE_REG 0x04600000
|
|
|
|
// PI DRAM address (R/W): [23:0] starting RDRAM address
|
|
#define PI_DRAM_ADDR_REG (PI_BASE_REG + 0x00)
|
|
|
|
// PI pbus (cartridge) address (R/W): [31:0] starting AD16 address
|
|
#define PI_CART_ADDR_REG (PI_BASE_REG + 0x04)
|
|
|
|
// PI read length (R/W): [23:0] read data length
|
|
#define PI_RD_LEN_REG (PI_BASE_REG + 0x08)
|
|
|
|
// PI write length (R/W): [23:0] write data length
|
|
#define PI_WR_LEN_REG (PI_BASE_REG + 0x0C)
|
|
|
|
// PI status (R): [3] interrupt flag, [2] error, [1] IO busy, [0] DMA busy
|
|
// (W): [1] clear intr, [0] reset controller (and abort current op)
|
|
#define PI_STATUS_REG (PI_BASE_REG + 0x10)
|
|
|
|
// PI dom1 latency (R/W): [7:0] domain 1 device latency
|
|
#define PI_BSD_DOM1_LAT_REG (PI_BASE_REG + 0x14)
|
|
|
|
// PI dom1 pulse width (R/W): [7:0] domain 1 device R/W strobe pulse width
|
|
#define PI_BSD_DOM1_PWD_REG (PI_BASE_REG + 0x18)
|
|
|
|
// PI dom1 page size (R/W): [3:0] domain 1 device page size
|
|
#define PI_BSD_DOM1_PGS_REG (PI_BASE_REG + 0x1C)
|
|
|
|
// PI dom1 release (R/W): [1:0] domain 1 device R/W release duration
|
|
#define PI_BSD_DOM1_RLS_REG (PI_BASE_REG + 0x20)
|
|
|
|
// PI dom2 latency (R/W): [7:0] domain 2 device latency
|
|
#define PI_BSD_DOM2_LAT_REG (PI_BASE_REG + 0x24)
|
|
|
|
// PI dom2 pulse width (R/W): [7:0] domain 2 device R/W strobe pulse width
|
|
#define PI_BSD_DOM2_PWD_REG (PI_BASE_REG + 0x28)
|
|
|
|
// PI dom2 page size (R/W): [3:0] domain 2 device page size
|
|
#define PI_BSD_DOM2_PGS_REG (PI_BASE_REG + 0x2C)
|
|
|
|
// PI dom2 release (R/W): [1:0] domain 2 device R/W release duration
|
|
#define PI_BSD_DOM2_RLS_REG (PI_BASE_REG + 0x30)
|
|
|
|
#define PI_DOMAIN1_REG PI_BSD_DOM1_LAT_REG
|
|
#define PI_DOMAIN2_REG PI_BSD_DOM2_LAT_REG
|
|
|
|
#define PI_DOM_LAT_OFS 0x00
|
|
#define PI_DOM_PWD_OFS 0x04
|
|
#define PI_DOM_PGS_OFS 0x08
|
|
#define PI_DOM_RLS_OFS 0x0C
|
|
|
|
/*
|
|
* PI_STATUS_REG: read bits
|
|
* Bit 0: DMA busy - set when DMA is in progress
|
|
* Bit 1: IO busy - set when IO is in progress
|
|
* Bit 2: Error - set when CPU issues IO request while DMA is busy
|
|
*/
|
|
#define PI_STATUS_DMA_BUSY (1 << 0)
|
|
#define PI_STATUS_IO_BUSY (1 << 1)
|
|
#define PI_STATUS_ERROR (1 << 2)
|
|
|
|
/*
|
|
* PI status register has 2 bits active when written to:
|
|
* Bit 0: When set, reset PIC
|
|
* Bit 1: When set, clear interrupt flag
|
|
* The values of the two bits can be ORed together to both reset PIC and
|
|
* clear interrupt at the same time.
|
|
*
|
|
* Note:
|
|
* - The PIC does generate an interrupt at the end of each DMA. CPU
|
|
* needs to clear the interrupt flag explicitly (from an interrupt
|
|
* handler) by writing into the STATUS register with bit 1 set.
|
|
*
|
|
* - When a DMA completes, the interrupt flag is set. CPU can issue
|
|
* another request even while the interrupt flag is set (as long as
|
|
* PIC is idle). However, it is the CPU's responsibility for
|
|
* maintaining accurate correspondence between DMA completions and
|
|
* interrupts.
|
|
*
|
|
* - When PIC is reset, if PIC happens to be busy, an interrupt will
|
|
* be generated as PIC returns to idle. Otherwise, no interrupt will
|
|
* be generated and PIC remains idle.
|
|
*/
|
|
|
|
/*
|
|
* PI_STATUS_REG: write bits
|
|
*/
|
|
#define PI_STATUS_RESET (1 << 0)
|
|
#define PI_SET_RESET PI_STATUS_RESET
|
|
|
|
#define PI_STATUS_CLR_INTR (1 << 1)
|
|
#define PI_CLR_INTR PI_STATUS_CLR_INTR
|
|
|
|
#define PI_DMA_BUFFER_SIZE 128
|
|
|
|
#define PI_DOM1_ADDR1 0x06000000 /* to 0x07FFFFFF */
|
|
#define PI_DOM1_ADDR2 0x10000000 /* to 0x1FBFFFFF */
|
|
#define PI_DOM1_ADDR3 0x1FD00000 /* to 0x7FFFFFFF */
|
|
#define PI_DOM2_ADDR1 0x05000000 /* to 0x05FFFFFF */
|
|
#define PI_DOM2_ADDR2 0x08000000 /* to 0x0FFFFFFF */
|
|
|
|
|
|
/**
|
|
* RDRAM Interface (RI) Registers
|
|
*/
|
|
#define RI_BASE_REG 0x04700000
|
|
|
|
// RI mode (R/W): [3] stop R active, [2] stop T active, [1:0] operating mode
|
|
#define RI_MODE_REG (RI_BASE_REG + 0x00)
|
|
|
|
// RI config (R/W): [6] current control enable, [5:0] current control input
|
|
#define RI_CONFIG_REG (RI_BASE_REG + 0x04)
|
|
|
|
// RI current load (W): [] any write updates current control register
|
|
#define RI_CURRENT_LOAD_REG (RI_BASE_REG + 0x08)
|
|
|
|
// RI select (R/W): [3:2] receive select, [1:0] transmit select
|
|
#define RI_SELECT_REG (RI_BASE_REG + 0x0C)
|
|
|
|
// RI refresh (R/W): [16] refresh bank, [17] refresh enable, [18] refresh optimize
|
|
// [7:0] clean refresh delay, [15:8] dirty refresh dela
|
|
#define RI_REFRESH_REG (RI_BASE_REG + 0x10)
|
|
#define RI_COUNT_REG RI_REFRESH_REG
|
|
|
|
// RI latency (R/W): [3:0] DMA latency/overlap
|
|
#define RI_LATENCY_REG (RI_BASE_REG + 0x14)
|
|
|
|
// RI error (R): [1] ack error, [0] nack error
|
|
#define RI_RERROR_REG (RI_BASE_REG + 0x18)
|
|
|
|
// RI error (W): [] any write clears all error bits
|
|
#define RI_WERROR_REG (RI_BASE_REG + 0x1C)
|
|
|
|
|
|
/**
|
|
* Serial Interface (SI) Registers
|
|
*/
|
|
#define SI_BASE_REG 0x04800000
|
|
|
|
// SI DRAM address (R/W): [23:0] starting RDRAM address
|
|
#define SI_DRAM_ADDR_REG (SI_BASE_REG + 0x00)
|
|
|
|
// SI address read 64B (W): [] write begins a 64B DMA write PIF RAM -> RDRAM
|
|
#define SI_PIF_ADDR_RD64B_REG (SI_BASE_REG + 0x04)
|
|
|
|
// Address SI_BASE_REG + (0x08, 0x0C, 0x14) are reserved
|
|
|
|
// SI address write 64B (W): [] write begins a 64B DMA read RDRAM -> PIF RAM */
|
|
#define SI_PIF_ADDR_WR64B_REG (SI_BASE_REG + 0x10)
|
|
|
|
// SI status (R/W): [] any write clears interrupt
|
|
#define SI_STATUS_REG (SI_BASE_REG + 0x18)
|
|
|
|
/*
|
|
* SI_STATUS_REG: read bits
|
|
*/
|
|
#define SI_STATUS_DMA_BUSY (1 << 0) // DMA in progress
|
|
#define SI_STATUS_RD_BUSY (1 << 1) // IO access in progress
|
|
#define SI_STATUS_DMA_ERROR (1 << 3) // Overlapping DMA requests
|
|
#define SI_STATUS_INTERRUPT (1 << 12) // Interrupt is set
|
|
|
|
|
|
/**
|
|
* Development Board GIO Control Registers
|
|
*/
|
|
|
|
#define GIO_BASE_REG 0x18000000
|
|
|
|
// Game to Host Interrupt
|
|
#define GIO_GIO_INTR_REG (GIO_BASE_REG+0x000)
|
|
|
|
// Game to Host SYNC
|
|
#define GIO_GIO_SYNC_REG (GIO_BASE_REG+0x400)
|
|
|
|
// Host to Game Interrupt
|
|
#define GIO_CART_INTR_REG (GIO_BASE_REG+0x800)
|
|
|
|
|
|
/**
|
|
* Common macros
|
|
*/
|
|
#if defined(_LANGUAGE_C) || defined(_LANGUAGE_C_PLUS_PLUS)
|
|
|
|
#define IO_READ(addr) (*(vu32*)PHYS_TO_K1(addr))
|
|
#define IO_WRITE(addr,data) (*(vu32*)PHYS_TO_K1(addr)=(u32)(data))
|
|
|
|
#define RCP_STAT_PRINT \
|
|
rmonPrintf("current=%x start=%x end=%x dpstat=%x spstat=%x\n", \
|
|
IO_READ(DPC_CURRENT_REG), \
|
|
IO_READ(DPC_START_REG), \
|
|
IO_READ(DPC_END_REG), \
|
|
IO_READ(DPC_STATUS_REG), \
|
|
IO_READ(SP_STATUS_REG))
|
|
|
|
#endif
|
|
|
|
#endif
|