VulCode

chip8-sharp

Kompletny, przetestowany emulator CHIP-8 w C#. Pe艂ny zestaw instrukcji sprawdzany headless na spo艂eczno艣ciowych ROM-ach testowych - czysta biblioteka bez zale偶no艣ci od renderowania.

chip8-sharp

Wprowadzenie

chip8-sharp to kompletny emulator CHIP-8 napisany w C#. CHIP-8 jest ma艂y - kilkadziesi膮t instrukcji, prosta pami臋膰, ekran 64 na 32 piksele - i w艂a艣nie dlatego jest klasycznym "pierwszym emulatorem". Ale r贸偶nica mi臋dzy zabawk膮 a projektem le偶y w tym s艂owie "kompletny": pe艂ny zestaw instrukcji, timery i wej艣cie, a nie po艂owa "wystarczaj膮ca do jednej gry".

Rdze艅 jest czyst膮 bibliotek膮 bez zale偶no艣ci od rysowania, dok艂adnie jak przy Game Boyu. Dzi臋ki temu ca艂膮 maszyn臋 da si臋 odpali膰 headless i przepu艣ci膰 przez testowe ROM-y bez 偶adnego okna, co zamienia "chyba dzia艂a" w "sprawdzone".

CHIP-8 to rytua艂 przej艣cia dla ka偶dego, kto chce zrozumie膰, jak dzia艂a emulacja. Jest na tyle ma艂y, 偶e da si臋 go ogarn膮膰 w ca艂o艣ci w g艂owie, i na tyle prawdziwy, 偶e uczy wszystkiego, co wi臋ksze emulatory robi膮 na wi臋ksz膮 skal臋: cyklu pobierz-zdekoduj-wykonaj, pami臋ci, timer贸w, obs艂ugi wej艣cia.

Jego rozmiar to zaleta, nie ograniczenie. W艂a艣nie dlatego, 偶e jest ma艂y, da si臋 go zrobi膰 naprawd臋 poprawnie, a nie tylko "prawie". Ka偶dy opcode mo偶na sprawdzi膰 osobno, a spo艂eczno艣膰 ma gotowe ROM-y, kt贸re wypisuj膮 "OK" albo "FAIL" dla ka偶dej instrukcji.

Jedna p臋tla: pobierz, zdekoduj, wykonaj

Ca艂a maszyna kr臋ci si臋 wok贸艂 jednej p臋tli. Opcode to dwa bajty, a poszczeg贸lne bity m贸wi膮, kt贸ra to instrukcja i na jakich rejestrach ma dzia艂a膰. Dekodowanie polega na wyci臋ciu odpowiednich fragment贸w z tych dw贸ch bajt贸w i skierowaniu ich do w艂a艣ciwej ga艂臋zi.

Interpreter.cs 路 csharp
ushort opcode = (ushort)(memory[PC] << 8 | memory[PC + 1]);
PC += 2;

ushort nnn = (ushort)(opcode & 0x0FFF);
byte x = (byte)((opcode & 0x0F00) >> 8);
byte kk = (byte)(opcode & 0x00FF);

switch (opcode & 0xF000) {
    case 0x1000: PC = nnn; break;
    case 0x6000: V[x] = kk; break;
    case 0x7000: V[x] += kk; break;
}

Anatomia opkodu

Ca艂y urok CHIP-8 polega na tym, 偶e dekodowanie da si臋 roz艂o偶y膰 na czynniki pierwsze. Szesnastobitowy opcode dzieli si臋 na fragmenty o ustalonym znaczeniu, a raz zrozumiana ta anatomia zamienia ca艂膮 list臋 instrukcji w kilka prostych regu艂.

Fragmenty szesnastobitowego opkodu

FragmentBityZnaczenie
nnndolne 12adres w pami臋ci
xbity 8-11numer rejestru
kkdolne 8sta艂a o艣miobitowa

Efekt: pe艂ny zestaw, nie po艂owa

Na wyj艣ciu jest ma艂y, ale dopracowany emulator - pe艂ny zestaw instrukcji, timery i wej艣cie, sprawdzone headless na spo艂eczno艣ciowych ROM-ach. Ten sam trik co przy Game Boyu, oddzielenie logiki od wy艣wietlania, sprawia, 偶e poprawno艣膰 jest dowiedziona, a nie deklarowana. To projekt ma艂y z za艂o偶enia, ale sko艅czony naprawd臋, a nie porzucony na "wystarczy do jednej gry".

Pytania o chip8-sharp

Wi臋cej projekt贸w

Inne realizacje z tej samej kategorii - zobacz, jak podchodzimy do podobnych wyzwa艅.

Masz podobny projekt?

Napisz do nas - wycena jest bezp艂atna i wraca w godzin臋.