作者: zchou (Nelson Chou) 看板: Emulator
標題: 認識MAME DRIVER VOL.1(翻譯版-2)
時間: Tue Sep 8 18:27:56 1998
2.5 MemoryWriteAddress Structure
MemoryWriteAddress結構很簡單的像MemoryReadAddress結構一樣的設定,
但是就像代替從記憶體讀取的處理一樣,這個結構處理記憶體的寫入.
1 static struct MemoryWriteAddress satansat_writemem =
2 {
3 { 0x0000, 0x03ff, MWA_RAM },
4 { 0x0400, 0x07ff, MWA_RAM, &rockola_videoram2 },
5 { 0x0800, 0x0bff, videoram_w, &videoram, &videoram_size },
6 { 0x0c00, 0x0fff, colorram_w, &colorram },
7 { 0x1000, 0x1fff, rockola_characterram_w, &rockola_characterram },
8 { 0x4000, 0x97ff, MWA_ROM },
9 // { 0xb000, 0xb000, satansat_sound0_w },
10 // { 0xb001, 0xb001, satansat_sound1_w },
11 { 0xb002, 0xb002, satansat_b002_w }, /* flip screen & irq enable */
12 { 0xb003, 0xb003, satansat_backcolor_w },
13 { -1 } /* 表格結尾 */
14 };
第3行定義了從0x0000到0x03FF的記憶體區段.並且如同RAM一般的定義.
第4行像第3行一樣同樣定義一個像RAM一樣的區段,但是比第3行多了一個
參數.這個"&rockola_videoram2"是一個指標變數,就像這樣的宣告:
unsigned char *rockola_videoram2;
當MAME為這個機器設置記憶體時,會把記憶體區段0x400-0x7ff的位址交給
指標rockola_videoram2.這會允許這個記憶體區段更容易為DRIVER的其他
部份所存取.記住這點很重要,這一個段落仍在整個ROM載入的記憶體區段
內,rockola_videoram2只是一個指標指到這個區域的一部份而已.
第5行有點小小的複雜.像平常一樣,我們定義記憶體區段,這裡是0x800到
0xbff.接下來我們有videoram_w,當一個寫入動作到在這個段落時呼叫的
常式.videoram_w是MAME中一個預先定義的常式.接下來我們有&videoram
,像第4行一樣的指標變數.當記憶體被設置時,&videoram會指到這個記憶
體區段.最後我們有&videoram_size.當記憶體被設置時,MAME會把這個記
憶體區域的大小放到變數videoram_size內.
第6行就像第5行一樣,但是這裡我們不需要這個區段在記憶體中的大小,所
以沒有包含尺寸變數.colorram_w and &colorram也同時定義於MAME核心
中.
第7行也與第6行一樣,不同的是,特定變數用來代替標準內建的變數.
第8行定義像ROM一樣的記憶體區段.
9-12行與在MemoryReadAddress結構中的5-8行類似.當這些位址被寫入時,
這個相對應的常式會被呼叫去處理寫入動作.
第13行是我們以"-1"結束這個結構.
2.6 Input Ports
DRIVER的下一個我們要觀察的段落定義了這個機器輸入埠的運作.這個結
構用來定義這些,像搖桿輸入,錢幣投入,指撥開關(dipswitch),和其他等
.我已經拆開這個段落成為兩個較小的段落:
1 INPUT_PORTS_START( satansat_input_ports )
2 PORT_START /* IN0 */
3 PORT_BIT( 0x01, IP_ACTIVE_HIGH, IPT_JOYSTICK_LEFT | IPF_2WAY )
4 PORT_BIT( 0x02, IP_ACTIVE_HIGH, IPT_JOYSTICK_RIGHT | IPF_2WAY )
5 PORT_BIT( 0x04, IP_ACTIVE_HIGH, IPT_BUTTON1 )
6 PORT_BIT( 0x08, IP_ACTIVE_HIGH, IPT_JOYSTICK_LEFT | IPF_2WAY | IPF_COCKTAIL )
7 PORT_BIT( 0x10, IP_ACTIVE_HIGH, IPT_JOYSTICK_RIGHT | IPF_2WAY | IPF_COCKTAIL )
8 PORT_BIT( 0x20, IP_ACTIVE_HIGH, IPT_BUTTON1 | IPF_COCKTAIL )
9 PORT_BIT( 0x40, IP_ACTIVE_HIGH, IPT_BUTTON2 )
10 PORT_BIT( 0x80, IP_ACTIVE_HIGH, IPT_BUTTON2 | IPF_COCKTAIL )
第1行開始這個遊戲的輸入埠的定義.名稱,satansat_input_port指到
GameDriver結構.
第2行開始第一個埠的定義(輸出埠0).
3到10行定義這個埠中每個bit做些什麼.每一行的第一個參數是遮罩(mask
).每一個BIT,也就是遮罩中的那個"1",將會使這一行的功能有作用.所以
在第3行中,遮罩是0x01,這表示使這行有作用的是BIT 0.下一個參數設定
這個功能是在高電位(HIGH)時作用還是低電位時作用(LOW).最後一個參數
設定這個BIT的功能並且它還有任何特殊的屬性.第3行中,功能是
IPT_JOYSTICK_LEFT ,表示這個BIT被搖桿推向左所控制.這行中的
IP_ACTIVE_HIGH參數表示當搖桿推向左時,這個BIT將會是一個"1",所有其
餘時間都應該是一個"0".IPF_2WAY屬性表示這是一個兩方向搖桿,它只能
被推向左或向右.
第4行與第3行相同,只是這行是JOYSTICK_RIGHT.
第5行定義一個按鍵(button).BUTTON1在這個遊戲中通常是"發射(FIRE)"
鍵.
6,7,8行定義了第二組兩方向搖桿及按鍵,但是這一組有個屬性IPF_COCKTAIL
.這表示這個搖桿使用在機器的雞尾酒桌版.
9,10行定義了一個第二組的按鍵為了正常機器及雞尾酒版兩種.
這裡是輸入埠第二個段落,定義在PORT 1的BIT:
1 PORT_START /* IN1 */
2 PORT_BIT( 0x01, IP_ACTIVE_HIGH, IPT_START1 )
3 PORT_BIT( 0x02, IP_ACTIVE_HIGH, IPT_START2 )
4 PORT_BIT( 0x7C, IP_ACTIVE_HIGH, IPT_UNKNOWN )
5 PORT_BIT( 0x80, IP_ACTIVE_LOW, IPT_UNKNOWN )
第2行開始第二組埠(PORT1).
2,3行類似於第一輸入埠的幾行.第2行定義了START1,通常是1P開始按鍵,
第3行定義了START2,通常是1P開始按鍵.
如果你觀察第4行,你會注意到,有超過1bit設定在這個遮罩中.你可以使遮
罩中有許多你想要的BIT設定為1在每個空位.每一個設定為1的BIT會使該
行的功能有作用.第4行的功能是IPT_UNKNOWN,意指這些BITS的功能現在還
不知道.因為這行以IP_ACTIVE_HIGH來定義,並且任何未知的輸入永遠不能
變成ACTIVE,所以這些BITS將總是為0.
第5行類似於第4行,因為這是IP_ACTIVE_LOW,所以這個BIT將總是為高電位
(HIGH).
下一個段落有點不同,因為它定義了指撥開關(dipswitch)代替輸入端.不
過即使它是一個指撥開關,它仍然如一個輸入埠一樣的被參考,本例中是輸
入埠2:
1 PORT_START /* DSW */
2 PORT_DIPNAME( 0x01, 0x01, "Cabinet", IP_KEY_NONE )
3 PORT_DIPSETTING( 0x01, "Upright"<img src="images/smilies/face-wink.png" align="absmiddle" border="0">
4 PORT_DIPSETTING( 0x00, "Cocktail" )
5 PORT_DIPNAME (0x0a, 0x00, "Coinage", IP_KEY_NONE )
6 PORT_DIPSETTING ( 0x08, "2 Coins/1 Credit" )
7 PORT_DIPSETTING ( 0x00, "1 Coin/1 Credit" )
8 PORT_DIPSETTING ( 0x02, "1 Coin/2 Credits" )
9 /* 0x0a gives 2/1 again */
10 PORT_DIPNAME (0x04, 0x00, "Bonus Life", IP_KEY_NONE )
11 PORT_DIPSETTING ( 0x00, "5000" )
12 PORT_DIPSETTING ( 0x04, "10000" )
13 PORT_DIPNAME (0x30, 0x00, "Lives", IP_KEY_NONE )
14 PORT_DIPSETTING ( 0x00, "3" )
15 PORT_DIPSETTING ( 0x10, "4" )
16 PORT_DIPSETTING ( 0x20, "5" )
17 /* 0x30 gives 3 again */
18 PORT_DIPNAME (0x40, 0x00, "Unknown", IP_KEY_NONE )
19 PORT_DIPSETTING ( 0x00, "Off" )
20 PORT_DIPSETTING ( 0x40, "On" )
21 PORT_DIPNAME (0x80, 0x00, "Unknown", IP_KEY_NONE )
22 PORT_DIPSETTING ( 0x00, "Off" )
23 PORT_DIPSETTING ( 0x80, "On" )
第1行像,平常一樣,定義這個輸入埠的開頭.
第2行定義指撥開關的第一段的開頭.第一個參數是像在正常的輸入埠一樣
的遮罩.每一個是"1"的BIT會使這個指撥開關有作用.下一個參數是指撥開
關的內定值,本例中是0x01.下一個參數是這個指撥開關的名稱,會顯示在
MAME中的指撥開關目錄中.最後一個參數允許你設定一個按鍵去控制這個
指撥開關.因為這是IP_KEY_NONE意指沒有任何按鍵能控制它,並且它必須
被設置在指撥開關目錄上.
3,4行是PORT_DIPSETTING.這些定義了不同的設定為了我們定義的指撥開
關區段.第一個參數在PORT_DIPSETTING中是對應到設定的數值,第二個參
數是設定的名稱.例如,如果指撥開關"Cabinet"設定給"Upright",然後這
個埠的BIT 0將會設成0x01.如果是設定給"Cocktail",這個埠的BIT 0將會
設成0x00.
第5行開始指撥開關下一個區段的定義,這次叫"Coinage".注意這裡,有兩
個BIT設定在遮罩裡,意指這個指撥開關有兩種以上組合.
第6-8行定義了"Coinage"指撥開關的設定.有四種可能的組合在這個DIP區
段,但是只定義了其中三種.像第9行所表示的,第四種設定,0x0A,與0x08的
設定相同.
13-23行定義了指撥開關區段及設定的剩餘部份.
這裡是輸入埠最後區段:
1 PORT_START /* IN2 */
2 PORT_BITX(0x01, IP_ACTIVE_HIGH, IPT_COIN1 | IPF_IMPULSE,
3 IP_NAME_DEFAULT, IP_KEY_DEFAULT, IP_JOY_DEFAULT, 1 )
4 PORT_BIT( 0x0e, IP_ACTIVE_LOW, IPT_UNUSED )
5 PORT_BIT( 0xf0, IP_ACTIVE_LOW, IPT_UNKNOWN ) /* 連接到一個計數器 - 亂數產生器? */
6 INPUT_PORTS_END
第1行是開始最後的輸入埠,PORT 3,的定義.
第2行是POST BIT定義的另外一種類型.PORT_BITX允許我們去指定這個
PORT的某些額外參數.這個BIT的功能是IPT_COIN1,第一個錢幣投入口.屬
性IPF_IMPULSE表示這是一個脈衝輸入,意指這個BIT會引發(active)多玩
一次遊戲,然後又回到自己之前的(inactive)狀態.這一行唯一額外的參數
是在最後的1,這是脈衝時間的長度.所有其他的額外參數都設定DEFUALT,
因為我們不需要他們.
第4行顯示更多不同的功能,IPT_UNUSED.這表示這些BITS在這個遊戲是不
被使用的,通常意指在硬體中它們是沒有連接的.就像UNKNOWN,這些是永不
變成ACTIVE的.因為這BITS被定義為IP_ACTIVE_LOW,這些BITS總是處於高
電位.
第6行是這個機器的輸入埠的結尾.
2.7 GfxDecodeInfo Structure
GfxDecodeInfo是用來決定這個遊戲的繪圖資料如何被解碼的兩個結構的
第一個結構.繪圖資料通常儲存在遊戲基版上的ROM中,並且這些ROM被組織
以使電路繪製顯示影像時能更簡單的方式.不幸的,資料被儲存在ROM中的
方式通常不容易使用在模擬器中.GfxDecode結構告訴MAME如何轉換原始繪
圖ROM到更有用的格式.
1 static struct GfxDecodeInfo satansat_gfxdecodeinfo =
2 {
3 { 0, 0x1000, &charlayout256, 0, 4 }, /* 遊戲會動態的改變這裡 */
4 { 1, 0x0000, &charlayout256, 4*4, 4 },
5 { -1 }
6 };
第1行開始了GfxDecodeInfo結構的定義.它的名稱,本例是
satansat_gfxdecodeinfo,指到MachineDriver結構.
這個機器有兩種不同的對圖形解碼的方案,第3,4行各定義這些方案之一.
這幾行的第一個參數告訴MAME,在哪個記憶體區域可以找到圖形資料.第4
行最明顯.它顯示了圖形資料可以在區域1找到,如果觀察ROM載入結構,可
以看到圖形ROM被載入在這個區域.第3行顯示資料來自區域0,處理機記憶
體區域.這樣做的理由是,ZARZON儲存一些圖形資料在RAM中.下一個參數說
明這些資料來自哪裡.第三個參數是一個指標指到GfxLayout結構,定義了
這些圖形資料是怎樣的格式.
每行中的最後兩個參數是用來決定畫這些圖形的顏色.這組的第一個數字
是到顏色的位移,查看表格到這些圖形顏色的起點.這組中的第二個參數是
這個圖形所使用的顏色總數.
2.8 GfxLayout structure
GfxLayout結構是定義圖形ROM是怎樣格式的第二部份.這個結構定義了資
料的實際格式.
1 static struct GfxLayout charlayout256 =
2 {
3 8,8, /* 8*8 圖樣 */
4 256, /* 256 圖樣 */
5 2, /* 每個像點2 bits */
6 { 0, 256*8*8 }, /* 兩個位元平面(bitplane)是分開的 */
7 { 0, 1, 2, 3, 4, 5, 6, 7 },
8 { 0*8, 1*8, 2*8, 3*8, 4*8, 5*8, 6*8, 7*8 },
9 8*8 /* 每個圖樣要8個連續的BYTE */
10 };
這可能有點困擾,所以看的時候要小心一點.
第1開始這個結構.它的名稱,本例是charlayout256,指到GfxDecodeInfo結構.
第3行定義了每個圖樣的長寬是幾個像點.所以圖樣在ZARZON中是8點長8點
寬.
第4行定義圖形ROM中有幾個圖樣,本例中有256個圖樣.
第5行定義了圖樣中每個像點用了幾個BITS表示.ZARZON是每個像點2BITS.
因為2BITS有4種不同的組合(00,01,10,11),所以每個圖樣最多有4種顏色.
第6行包含每個位元平面中資料起點的位移以BIT表示.因為ZARZON是每個
像點使用2BITS(定義在第五行),所以它也有兩個位元平面.在ZARZON硬體
中,造成每個像點的2BITS中的每一個位元都被儲存在分別的ROM CHIP中.
我們所載入的第一個圖形ROM包含第一位元平面,所以第一位元平面位移為
0.我們所載入的第二個圖形ROM包含第二位元平面,所以為了得到它,我們
必須保留在第一位元平面的所有資料.到第二位元平面的位移是256*8*8,
這個數字從何得來?256是每個ROM中有256個圖樣,第一個"*8"是因為每個
圖樣有8條線高,所以每個圖樣有8BYTE.256*8=2048是圖形ROM的長度以
BYTE表示,位元平面的位移是以BIT作單位,因為每個圖樣的每條線是8BITS
,所以我們要乘以8,2048 X 8得到總位移是256*8*8 = 16384.
7,8行說明了圖樣中在每個座標的每個像點的資料在哪裡得到.ZARZON中的
圖樣是8X8像點.第7行給的是直切過圖樣的像點的位移.第8行給的是圖樣
由上而下每行的位移.聽起來有點混亂,不過當看到例子時就會很清楚.
第9行給的是兩個連續圖樣之間的距離以位元表示.在ZARZON中,每個圖樣
需要8BYTE,並且每個BYTE有8個BIT,所有總數是8*8=64.
OK!現在我們來看這些加在一起如何運作.當MAME對這些圖形ROM解碼時,它
是一個圖樣接著一個的步驟.所以譬如它想對編號10的圖樣解碼.ZARZON使
用兩個位元平面(第五行),所以MAME首先必須找到每個位元平面資料的起
點.從GfxDecodeInfo結構中,我們知道這些圖型ROM在記憶體區域1開始在
位移0的位置.從第六行得知,位元平面1開始在位移0及位元平面2開始在位
移16384.從第9行得知,每個圖樣需要64BITS,所以我們可以計算每個圖樣
的每個位元平面的資料開始在哪裡:
位元平面1,第10個圖樣 * 每個圖樣64BITS + 平面位移0 = 640
位元平面2,第10個圖樣 * 每個圖樣64BITS + 平面位移16384 = 17024
現在我們知道資料中每個位元平面的開始在哪裡,我們能開始對這個圖樣
解碼.我們從圖樣的左上角的像點開始.這就是第一行的第一個像點.為了
從資料中找出這個位元的位移,觀察第8行的第一個數值,0*8,這是圖樣上
第一行資料的位移.接下來觀察第七行的第一個數值,0,這是每一行中第
一個像點資料的位移.所以這個像點資料的位移將是 (0*8) + 0.第一行的
第二個像點,我們還是用0*8,因為還是在第一行,但是如果現在我們使用第
7行中的第二個像點,第七行是1.這行第二個像點的位移就會是(0*8)+1.我
們以這種方式繼續處理第一行八個像點中的每一個.為了得到圖樣的第二
行中的第一個像點,我們從第八行中的第二個數值開始,1*8.第二行的第一
個像點將是(1*8)+0 = 8,第二點將是(1*8)+1 = 9, etc.
3.0 Linking In The Driver.
我在本篇寫的最後一件事是如何連結你的DRIVER到MAME原始碼中.第一件
事是你必須把所有你的原始碼檔案的檔名放到MAKEFILE檔案中.因為ZARZON
是在rockola driver原始檔中,在MAKEFILE中它將看起來長成這樣:
obj/vidhrdw/rockola.o obj/sndhrdw/rockola.o obj/drivers/rockola.o \
這將編譯rockola driver並連結它到MAME中,但是MAME仍然不知道有這個
遊戲存在,這需要更多步驟.在檔案driver.c中,有個指標陣列指到MAME中
每個GameDriver結構.ZARZON那行看起來像這樣:
&zarzon_driver, /* (c) 1981 Taito, gameplay says SNK */
你也需要在driver.c中宣告這個,以使編譯器可以找到它:
extern struct GameDriver zarzon_driver;
這就是連結DRIVER到程式碼中的全部步驟.
