本当に悩んで考えて、どうしてもわからなかったから、出てくるわけないだろと思って、テストコードそのままぐぐったら出てきた。  

[gb-test-rom-emulation-issues](https://stackoverflow.com/questions/23037456/gb-test-rom-emulation-issues)

  

つまりFの下位4ビットは何か値が書き込まれても無視するということ。



```asm
     set_test 5,"POP AF"
     ld   bc,$1200
-    push bc
     pop  af
     push af
     pop  de
     ld   a,c
     and  $F0
     cp   e
     jp   nz,test_failed
     inc  b
     inc  c
     jr   nz,-

```



以下、自分の実装。どうやってもこれで正解だろうと思ってた。命令に間違えがあるのかと必死で見直してたのに、レジスタが突っぱねてるなんて、まったく考えもしなかった。どうせどっかに書いてあって見落としていたのだろうけど。無念。非常に悔しい。



- BC = $1200
- loop 1回目


  - BC == $1200
  - AF = $1200
  - DE = $1200
  - A = C
  - A = A & $F0; 上位4ビットだけ取り出す
  - A - E; $0 - $0; Zero = 1
  - jp test_failed if Zero == 0; Zero = 1なのでジャンプしない。
  - B++; $13
  - C++; $01
  - jp loop


- loop 2回目


  - BC == $1301
  - AF = $1301
  - DE = $1301
  - A = C; A = $01
  - A = A & $F0; A = $01 & $F0. A = 0
  - A - E; $0 - $1 = $FF. Zero = 0
  - jp test_failed if Zero == 0; Zero = 0なのでジャンプでテスト失敗







set Test &quot;POP AF&quot;

HALTはInterruptで復帰するんだから、DIしたら帰ってこれない。  
IME=0のTimerはIF立てるだけでIEは立てないんだからInterruptしない。  
そういう理解。どないやねん。  
TimerはIEかIMEをオンにするの？  
すごい振出しに戻る感あってつらい。



GBのHALTつらい

正直なところエミュレータを完成させていないし、完成しない気もしているので理解がいろいろとおかしいところもあるかと思うので基本的には元資料見ていただくのが正解かと。


![](https://cdn-ak.f.st-hatena.com/images/fotolife/b/bercriber/20210105/20210105195138.png "undefined")


(ターミナルでもグラフィックのデバッグできたりします)


# 資料


- [Gameboy Development Manual V1.1](https://archive.org/details/GameBoyProgManVer1.1)




  - コンフィデンシャルな公式マニュアル


- [gbdev.io](https://gbdev.io/pandocs/)




  - 包括的なメイン資料
  - その[github](https://github.com/gbdev/pandocs)


  - 現在でも結構コミットされてる
  - 英語圏だが[Discordなど](https://gbdev.io/chat.html)

のチャットコミュニティも活発


- [GBCPUman.pdf](http://marc.rawer.de/Gameboy/Docs/GBCPUman.pdf)




  - CPUの命令はこれを主に参考にした


- [z80のマニュアル](/http://www.zilog.com/docs/z80/um0080.pdf)




  - ゲームボーイのCPUはz80をだいぶ簡素化した感じらしい
  - 困ったときはこっちと見比べた


- [テストROM](https://github.com/retrio/gb-test-roms/tree/master)


- [GameBoy-Emulation-in-JavaScript:-GPU-Timings](http://imrannazar.com/GameBoy-Emulation-in-JavaScript:-GPU-Timings)




  - PPUの実装の参考にした


- [Game Boy: Complete Technical Reference](https://gekkio.fi/files/gb-docs/gbctr.pdf)




  - MBCについてわかりやすい
  - こちらもメンテされてる





# ざっくり

上記の[gbdev.io](https://gbdev.io/pandocs/)

を見てもらえば特に説明することないんだけど、簡単に。
ゲームボーイエミュレータは主に以下で考えればよい。



- Memory
- CPU


  - 8-bit Sharp LR35902


- PPU (Picture Processing Unit)


  - グラフィックスはGPUとは言わずPPUと言うらしい
  - ファミコンなんかではPPUやAPUがCPUとは別々のプロセッサだった
  - ゲームボーイではCPUもPPUもAPUもワンチップらしい。


- APU (Audio Processing Unit)


  - 音楽


- MBC (Memory Bank Controller)


  - メインメモリが0xFFFFまでしかアドレス空間がないのを拡張的に扱う物


- ROM (ポケモンなどのゲームカセット)
- Log


  - ログはないとまったくデバッグできないので最初から実装すべし


- Display


  - ディスプレイはお好みのGUIライブラリで描写
  - 最初はターミナルでアスキーアート的にやってもいいと思う





## CPU

8ビットのレジスタがA,F,B,C,D,E,H,L  

16ビットのレジスタがAF,BC,DE,HL,SP(Stack Pointer),PC(Program Counter)  

AF,BC,DE,HLは8ビットのレジスタ二つを並べて疑似的に16ビットレジスタとして扱っている。  

BCはBとCで、BC=0xABCDとすれば、B=0xAB、C=0xCDとなる。  

AとFは特殊でAはアキュムレーターとして、Fはフラグとしても扱われる。  

フラグはZero,Negative,Half Carry,Carryの4つ



```
F:11110000
  |||+-> Carry
  ||+-> Half Carry
  |+-> Negative
  +-> Zero
```




- Zeroは演算結果が0だった場合に1になる。
- Negativeは引き算を使ったときなどに1になる。
- Half Carryは4ビット目が繰り上がったときなどに1になる。
- Carryは8ビット目が繰り上がったときなどに１になる。



命令のクロック数は全体を同期するときに重要。


#### 割り込み、Interrupts

割り込みは主にV-Blank、LCD STAT、Timer、Serial、Joypadの5種類。



- V-BlankはPPUが画面の書き込み操作が一定以上完了した時にオンになる。
- LCD STATはPPUによって４種類ほど割り込みのタイミングが設定でき、それによってオンになる。
- TimerはTACで設定したクロックのタイミングによってオンになる。
- Serialはケーブル接続時のゲームボーイtoゲームボーイのシリアル通信に完了時にオンになる。
- Joypadはプレイヤーによるコントローラーの操作時にオンになる。



IME,IE(0xFFFF),IF(0xFF0F)の三つのレジスタで操作される。



- IMEはInterrupt Master Enable Flagであり、すべての割り込みのオン、オフを決める。
- IEはInterrupt Enableで、個別の割り込みのオン、オフを操作できる。
- IFはInterrupt Flagで、個別に割り込みをリクエストすることができる。
三つのフラグがあり、ややこしい。



#### タイマー、Timer

DIV(0xFF04),TIMA(0xFF05),TMA(0xFF06),TAC(0xFF07)のレジスタによって操作される。



- TACはタイマーコントロール。タイマーのオン、オフとタイマーの周期を4種類設定できる。
- DIVはタイマーのオンオフ関係なく16384hz周期でインクリメントされる。8ビットなので0xff超えると0になる。


  - DIVの16384hzというのはゲームボーイのクロックが4194304hzで、4194304/16384=256(0xFF)からなんじゃないかと。


- TIMAはタイマーカウンター。TACで設定した周期でインクリメントされる。


  - オーバーフローすると割り込みのフラグを立てる。


- TMAはTIMAはオーバーフローしたときにTIMAにセットする値。



## PPU

下から順にBackground、Window、Spritesとレイヤーになっている。  

スプライトないしタイルという単位でキャラクターや背景や文字などが管理されている。  

スプライトはOAM(Object Attribute Tabe)で位置や向きなどが設定される。


![LCD Display Timing](https://gbdev.io/pandocs/imgs/game-boy-lcd-refresh-diagram-2.svg "undefined")


ディスプレイはlineごとに描写される。  

lineごとにOAMからスプライト検索し、書き込み、H-Blankに入る。  

144lineでV-Blankに入る。  

STAT(0xFF41)で設定されていれば、OAM検索時、H-Blank時、V-Blank時に割り込みフラグが立つ。


ラインごとに描写するのは実装が難しいので、CPUと同期をとってフラグ管理だけ進めていき、  

最後にまとめて描写するのが簡単な実装になるのではないかと思う。


## APU

手付かずにつき、省略。


## MBC

[Game Boy: Complete Technical Reference](https://gekkio.fi/files/gb-docs/gbctr.pdf)

が分かりやすい。


ゲームボーイのメインメモリは1Byteが0xFFFF個しか乗らないし、PCも16ビットで0xffffまでしか数えられない。  

ROMによっては1.5MBまであり、バンクと言う概念を使い、これらにアクセスしていく。  

MBCにもいくつか種類がある。ROMによってMBCが変わってくる。  

たとえば、ゼルダの伝説 夢を見る島であればMBC1。ポケットモンスター 赤であればMBC3。


MBC1であれば、メインメモリの0x0000-0x3fffがROM Bank1、0x4000-0x7fffがROM Bank2、  

0xa000-0xbfffにRAM Bankのコントロールレジスタがある。  

やたら範囲が広いがたいてい一か所に書き込まれるだけのような気がするがわからん。  

アドレス0x0000-0x3fffにBank 0、0x4000-0x7fffにBank Nが配置される。  

こんな感じでアドレスを組み立てていく。



```js
// Read Bank N
let i = (bank2 << 19) | (bank1 << 14) | (index - 0x4000);
cartridge.rom[i];
```



個人的つまづきポイントとして、0x0000-0xbfffにMBCの設定レジスタが配置されることになっているのに、  

0x0000-0x7fffのアドレスからどのようにROMの内容を読みだすのか混乱した。  

これは、MBCを通した0x0000-0x7fffの読み込みの時はROMから読んで、0x0000-0xbfffに書き込むときはメモリに書き込む。  

つまり、ReadとWriteは別の場所にそれぞれ行われている。  

メインメモリに両方とも展開されていると思い込んでいたのが混乱した要因だった。




自作ゲームボーイエミュレータメモ


![f:id:bercriber:20210105195138p:plain](https://cdn-ak.f.st-hatena.com/images/fotolife/b/bercriber/20210105/20210105195138.png "")



  
10月くらいからちょこちょこ作り始めてやっと入口に立てたような気がする。  
とりあえずバグだらけではあるがゼルダの夢見る島のオープニングくらいは動くようになったので記念カキコ（死語）  
CPUだいたい実装してからPPUがどうしていいかまったくわからんかったから挫折しそうだった。  
割り込みとかタイマーとか同期とかIntとかまぁー苦労したよね。  
英語読めないくせに意地で英語資料しか見ずにやっていったのが時間かかった要因。  
でも日本語資料あんまりないっぽいんだよな。  
いまだになんでここまで動いてるのかよくわからない。  
年末はぴくりともせんかったのに不思議。  
もうちょっと動くようになったらまとめるかな。  
いや、すでにうろ覚えだけど覚えている所だけまとめよ。  
完成させられる自信全くないんだけど。



Bercriber's Blog

set Test "POP AF"

GBのHALTつらい

自作ゲームボーイエミュレータメモ

自作ゲームボーイエミュレータ少し動いた

最初

前

最後

Bercriber's Blog

set Test &quot;POP AF&quot;

GBのHALTつらい

自作ゲームボーイエミュレータメモ

自作ゲームボーイエミュレータ少し動いた

最初

前

最後

set Test "POP AF"