From 921d2b2253e9f1fc2451f529f05eff5afbbbaf70 Mon Sep 17 00:00:00 2001 From: Steven Hugg Date: Thu, 2 Jul 2020 12:33:22 -0500 Subject: [PATCH] added ZX Spectrum 48k --- README.md | 2 +- index.html | 3 +- presets/zx/bios.c | 68 ++++ presets/zx/bios.h | 10 + presets/zx/cosmic.c | 627 +++++++++++++++++++++++++++++++++++++ presets/zx/hello.asm | 20 ++ res/zx.bios | Bin 0 -> 16384 bytes res/zx.wasm | Bin 0 -> 72098 bytes src/common/baseplatform.ts | 2 + src/ide/ui.ts | 4 +- src/machine/zx.ts | 121 +++++++ src/platform/zx.ts | 40 +++ src/worker/workermain.ts | 10 +- 13 files changed, 899 insertions(+), 8 deletions(-) create mode 100644 presets/zx/bios.c create mode 100644 presets/zx/bios.h create mode 100644 presets/zx/cosmic.c create mode 100644 presets/zx/hello.asm create mode 100755 res/zx.bios create mode 100755 res/zx.wasm create mode 100644 src/machine/zx.ts create mode 100644 src/platform/zx.ts diff --git a/README.md b/README.md index ef693b59..60b2f0da 100644 --- a/README.md +++ b/README.md @@ -41,7 +41,7 @@ unless otherwise licensed. ## Dependencies -Many of these use custom forks found at https://github.com/sehugg?tab=repositories +The IDE uses custom forks for many of these, found at https://github.com/sehugg?tab=repositories ### Emulators diff --git a/index.html b/index.html index 4f909519..401e3652 100644 --- a/index.html +++ b/index.html @@ -184,10 +184,11 @@ if (window.location.host.endsWith('8bitworkshop.com')) {
  • Computers
  • diff --git a/presets/zx/bios.c b/presets/zx/bios.c new file mode 100644 index 00000000..3bf39af5 --- /dev/null +++ b/presets/zx/bios.c @@ -0,0 +1,68 @@ + +#include + +#ifdef __MAIN__ + +void main(void); + +void startup(void) __naked { + __asm + jp _main + __endasm; +} + +#endif + +// http://www.users.globalnet.co.uk/~jg27paw4/pourri/rom-routines.txt + +void init_stdio(void) { + __asm + ld a,#2 + call 0x1601 + __endasm; +} + +int putchar(int ch) { + if (ch == 10) ch = 13; // newline -> CR + __asm + ld a,4 (ix) + rst 0x10 + __endasm; +} + +void beep(int divisor, int duration) { + divisor; + duration; + __asm + ld l,4 (ix) + ld h,5 (ix) + ld e,6 (ix) + ld d,7 (ix) + call 0x3b5 + __endasm; +} + +int keyscan(void) { + __asm + call 0x028e + ld l,e + ld h,d + __endasm; +} + +#ifdef __MAIN__ + +void main() { + init_stdio(); + printf("HELLO WORLD!\r"); + beep(1000,20); + beep(750,20); + beep(500,20); + while (1) { + int key = keyscan(); + if (key != -1) printf("%04x", key); + } + while (1); +} + +#endif diff --git a/presets/zx/bios.h b/presets/zx/bios.h new file mode 100644 index 00000000..0fec53d0 --- /dev/null +++ b/presets/zx/bios.h @@ -0,0 +1,10 @@ + +// FONT FUNCTIONS +#define LOCHAR 0x20 // lowest character value in font +#define HICHAR 0x7f // highest character value in font +unsigned char __at(0x3d00) font8x8[HICHAR-LOCHAR+1][8]; + +void init_stdio(void); +int putchar(int ch); +void beep(int divisor, int duration); +int keyscan(void); diff --git a/presets/zx/cosmic.c b/presets/zx/cosmic.c new file mode 100644 index 00000000..6a1d5c7a --- /dev/null +++ b/presets/zx/cosmic.c @@ -0,0 +1,627 @@ + +/* + * A ZX Spectrum port of the Cosmic Impalas game + * described in the book + * "Making 8-bit Arcade Games in C" + */ + +#include +#include "bios.h" +//#link "bios.c" + +void main(void); + +void startup(void) __naked { + __asm +; copy initialized data + LD BC, #l__INITIALIZER + LD A, B + LD DE, #s__INITIALIZED + LD HL, #s__INITIALIZER + LDIR +; disable interrupts + DI +; start main routine + jp _main + __endasm; +} + +// type aliases for byte/signed byte/unsigned 16-bit +typedef unsigned char byte; +typedef signed char sbyte; +typedef unsigned short word; + +// speaker click +__sfr __at (0xfe) portfe; +static byte spkr; +#define CLICK portfe = spkr ^= 0x10; + +#define VHEIGHT 192 // number of scanlines +#define VBWIDTH 32 // number of bytes per scanline +#define PIXWIDTH 256 // 8 pixels per byte + +// swap bits of address for ZX screen layout +// http://www.breakintoprogram.co.uk/computers/zx-spectrum/screen-memory-layout +// lookup table, starting address of each scanline (0 .. 191) +static byte* const vidmem[VHEIGHT] = { + 0x4000, 0x4100, 0x4200, 0x4300 + , 0x4400, 0x4500, 0x4600, 0x4700 + , 0x4020, 0x4120, 0x4220, 0x4320 + , 0x4420, 0x4520, 0x4620, 0x4720 + , 0x4040, 0x4140, 0x4240, 0x4340 + , 0x4440, 0x4540, 0x4640, 0x4740 + , 0x4060, 0x4160, 0x4260, 0x4360 + , 0x4460, 0x4560, 0x4660, 0x4760 + , 0x4080, 0x4180, 0x4280, 0x4380 + , 0x4480, 0x4580, 0x4680, 0x4780 + , 0x40A0, 0x41A0, 0x42A0, 0x43A0 + , 0x44A0, 0x45A0, 0x46A0, 0x47A0 + , 0x40C0, 0x41C0, 0x42C0, 0x43C0 + , 0x44C0, 0x45C0, 0x46C0, 0x47C0 + , 0x40E0, 0x41E0, 0x42E0, 0x43E0 + , 0x44E0, 0x45E0, 0x46E0, 0x47E0 + , 0x4800, 0x4900, 0x4A00, 0x4B00 + , 0x4C00, 0x4D00, 0x4E00, 0x4F00 + , 0x4820, 0x4920, 0x4A20, 0x4B20 + , 0x4C20, 0x4D20, 0x4E20, 0x4F20 + , 0x4840, 0x4940, 0x4A40, 0x4B40 + , 0x4C40, 0x4D40, 0x4E40, 0x4F40 + , 0x4860, 0x4960, 0x4A60, 0x4B60 + , 0x4C60, 0x4D60, 0x4E60, 0x4F60 + , 0x4880, 0x4980, 0x4A80, 0x4B80 + , 0x4C80, 0x4D80, 0x4E80, 0x4F80 + , 0x48A0, 0x49A0, 0x4AA0, 0x4BA0 + , 0x4CA0, 0x4DA0, 0x4EA0, 0x4FA0 + , 0x48C0, 0x49C0, 0x4AC0, 0x4BC0 + , 0x4CC0, 0x4DC0, 0x4EC0, 0x4FC0 + , 0x48E0, 0x49E0, 0x4AE0, 0x4BE0 + , 0x4CE0, 0x4DE0, 0x4EE0, 0x4FE0 + , 0x5000, 0x5100, 0x5200, 0x5300 + , 0x5400, 0x5500, 0x5600, 0x5700 + , 0x5020, 0x5120, 0x5220, 0x5320 + , 0x5420, 0x5520, 0x5620, 0x5720 + , 0x5040, 0x5140, 0x5240, 0x5340 + , 0x5440, 0x5540, 0x5640, 0x5740 + , 0x5060, 0x5160, 0x5260, 0x5360 + , 0x5460, 0x5560, 0x5660, 0x5760 + , 0x5080, 0x5180, 0x5280, 0x5380 + , 0x5480, 0x5580, 0x5680, 0x5780 + , 0x50A0, 0x51A0, 0x52A0, 0x53A0 + , 0x54A0, 0x55A0, 0x56A0, 0x57A0 + , 0x50C0, 0x51C0, 0x52C0, 0x53C0 + , 0x54C0, 0x55C0, 0x56C0, 0x57C0 + , 0x50E0, 0x51E0, 0x52E0, 0x53E0 + , 0x54E0, 0x55E0, 0x56E0, 0x57E0 +}; + +// attribute table +byte __at(0x5800) vidattrs[24][32]; + +// bitmask table +const byte BIT8[8] = { 0x80, 0x40, 0x20, 0x10, 0x08, 0x04, 0x02, 0x01 }; + +/// SOUND FUNCTIONS + +void tone(byte period, byte dur, sbyte mod) { + word i; + while (dur--) { + for (i=0; i>3; // divide x by 8 + byte mask = BIT8[x&7]; // lookup bitmask for remainder + byte y; + for (y=y1; y<=y2; y++) { + byte* dest = &vidmem[y][xb]; // lookup dest. address + *dest ^= mask; // XOR mask with destination + } +} + +// clear screen and set graphics mode +void clrscr() { + memset(vidmem[0], 0, 0x1800); // clear page 1 + memset(vidattrs, 0x4, 0x300); // set attributes +} + +// draw (xor) a pixel +void xor_pixel(byte x, byte y) { + xor_vline(x, y, y); // draw line with 1-pixel height +} + +typedef enum { + OP_DRAW, OP_XOR, OP_ERASE +} GraphicsOperation; + +// render a sprite with the given graphics operation +byte render_sprite(const byte* src, byte x, byte y, byte op) { + byte i,j; + byte w = *src++; // get width from 1st byte of sprite + byte h = *src++; // get height from 2nd byte of sprite + byte xb = x>>3; // xb = x DIV 8 + byte xs = x&7; // xs = x MOD 8 + byte result = 0; // result (used only with XOR) + for (j=0; j> xs) | rest; // shift and OR with leftover + // compute graphics operation, write to dest + switch (op) { + case OP_DRAW: *dest++ = next; break; + case OP_XOR: result |= (*dest++ ^= next); break; + case OP_ERASE: *dest++ &= ~next; break; + } + rest = data << (7-xs); // save leftover bits + } + // compute final byte operation + switch (op) { + case OP_DRAW: *dest = rest; break; + case OP_XOR: result |= (*dest ^= rest); break; + case OP_ERASE: *dest &= ~rest; break; + } + } + return result; +} + +void draw_sprite(const byte* src, byte x, byte y) { + render_sprite(src, x, y, OP_DRAW); +} + +// XOR returns non-zero if any pixels were overlapped +byte xor_sprite(const byte* src, byte x, byte y) { + return render_sprite(src, x, y, OP_XOR); +} + +void erase_sprite(const byte* src, byte x, byte y) { + render_sprite(src, x, y, OP_ERASE); +} + +// clear just sets all bytes to 0, and is fast +void clear_sprite(const byte* src, byte x, byte y) { + byte i,j; + byte w = *src++; + byte h = *src++; + byte xb = x>>3; + for (j=0; j>= 4; + } +} + +// add two 16-bit BCD values +word bcd_add(word a, word b) __naked { + a; b; // to avoid warning +__asm + push ix + ld ix,#0 + add ix,sp + ld a,4 (ix) + add a, 6 (ix) + daa + ld c,a + ld a,5 (ix) + adc a, 7 (ix) + daa + ld b,a + ld l, c + ld h, b + pop ix + ret +__endasm; +} + +// +// GAME GRAPHICS +// + +const byte player_bitmap[] = +{3,16,/*{w:24,h:16,bpp:1,brev:1}*/0x00,0x00,0x00,0x00,0x18,0x00,0x00,0x3C,0x00,0x04,0x18,0x20,0x04,0x18,0x20,0x0E,0x3C,0x70,0x1D,0x3C,0xB8,0x2C,0xE7,0x34,0x2E,0x66,0x74,0x25,0xE7,0xA4,0x34,0xDB,0x2C,0x2E,0x5A,0x74,0x2D,0xE7,0xB4,0x1C,0x3C,0x38,0x0D,0xDB,0xB0,0x07,0x18,0xE0}; +const byte bomb_bitmap[] = +{1,5,/*{w:8,h:5,bpp:1,brev:1}*/0x88,0x55,0x77,0x55,0x88}; +const byte bullet_bitmap[] = +{1,5,/*{w:8,h:5,bpp:1,brev:1}*/0x14,0x28,0x14,0x14,0x28}; +const byte enemy1_bitmap[] = +{2,16,/*{w:16,h:16,bpp:1,brev:1}*/0x00,0x00,0x7F,0xF8,0xF8,0x7C,0x8C,0xC4,0xAC,0xD4,0x8C,0xC4,0xFC,0xFC,0xF8,0x7C,0xF0,0x3C,0x8B,0x44,0xF3,0x3C,0xF3,0x3C,0xD3,0x2C,0x8C,0xC4,0x48,0x48,0x80,0x04}; +const byte enemy2_bitmap[] = +{2,16,/*{w:16,h:16,bpp:1,brev:1}*/0x00,0x00,0x30,0x0C,0x14,0x28,0x2F,0xF4,0x08,0x10,0x22,0x44,0xE0,0x07,0xD0,0x0B,0xB0,0x0D,0xB2,0x4D,0x19,0x98,0x8E,0x71,0x82,0x41,0xB1,0x8D,0x59,0x9A,0x4A,0x52}; +const byte enemy3_bitmap[] = +{2,16,/*{w:16,h:16,bpp:1,brev:1}*/0x00,0x00,0x00,0x00,0x04,0x20,0x05,0xA0,0x05,0xA0,0x25,0xA4,0xA7,0xE5,0xF7,0xEF,0xF7,0xEF,0xFE,0x7F,0xFC,0x3F,0xBC,0x3D,0x64,0x26,0x20,0x04,0x00,0x00,0x00,0x00}; +const byte enemy4_bitmap[] = +{2,16,/*{w:16,h:16,bpp:1,brev:1}*/0x00,0x00,0x00,0x00,0x37,0xEC,0x78,0x1E,0x5A,0x5A,0xFA,0x5F,0xF8,0x1F,0xF8,0x1F,0xF1,0x8F,0xA8,0x15,0xCC,0x33,0xE8,0x17,0x66,0x66,0x33,0xCC,0x0D,0xB0,0x00,0x00}; + +const byte* const enemy_bitmaps[4] = { + enemy1_bitmap, + enemy2_bitmap, + enemy3_bitmap, + enemy4_bitmap +}; + +// +// GAME CODE +// + +byte attract; +word score; +byte lives; + +#define MAXLIVES 5 + +byte player_x; +byte bullet_x; +byte bullet_y; +byte bomb_x; +byte bomb_y; + +typedef struct { + byte x,y; + const byte* shape; // need const here +} Enemy; + +#define MAX_ENEMIES 28 + +Enemy enemies[MAX_ENEMIES]; +byte enemy_index; +byte num_enemies; + +typedef struct { + int right:1; + int down:1; +} MarchMode; + +MarchMode this_mode, next_mode; + +void draw_lives() { + byte i; + byte n = lives; + byte y = 18; + byte x = VBWIDTH-1; + for (i=0; i j) { CLICK; } + } + } +} + +void destroy_player() { + xor_player_derez(); // xor derez pattern + xor_sprite(player_bitmap, player_x, VHEIGHT-17); // erase ship via xor + xor_player_derez(); // xor 2x to erase derez pattern + player_x = 0xff; + lives--; +} + +void init_enemies() { + byte i,x,y,bm; + x=0; + y=10; + bm=0; + for (i=0; ix = x; + e->y = y; + e->shape = enemy_bitmaps[bm]; + x += 29; + if (x >= 200) { + x = 0; + y += 20; + bm++; + } + } + enemy_index = 0; + num_enemies = MAX_ENEMIES; + this_mode.right = 1; + this_mode.down = 0; + next_mode.right = 1; + next_mode.down = 0; +} + +void delete_enemy(Enemy* e) { + clear_sprite(e->shape, e->x, e->y); + memmove(e, e+1, sizeof(Enemy)*(enemies-e+MAX_ENEMIES-1)); + num_enemies--; // update_next_enemy() will check enemy_index + tone(1,10,10); +} + +void update_next_enemy() { + Enemy* e; + if (enemy_index >= num_enemies) { + enemy_index = 0; + memcpy(&this_mode, &next_mode, sizeof(this_mode)); + tone(220+num_enemies,3,1); + } + e = &enemies[enemy_index]; + clear_sprite(e->shape, e->x, e->y); + if (this_mode.down) { + e->y += 4; + // if too close to ground, end game + if (e->y > 170) { + destroy_player(); + lives = 0; + } + next_mode.down = 0; + } else { + if (this_mode.right) { + e->x += 2; + if (e->x >= 255-32) { + next_mode.down = 1; + next_mode.right = 0; + } + } else { + e->x -= 2; + if (e->x == 0) { + next_mode.down = 1; + next_mode.right = 1; + } + } + } + draw_sprite(e->shape, e->x, e->y); + enemy_index++; +} + +char in_rect(Enemy* e, byte x, byte y, byte w, byte h) { + byte ew = e->shape[0]*8; + byte eh = e->shape[1]; + return (x >= e->x-w && x <= e->x+ew+w && y >= e->y-h && y <= e->y+eh+h); +} + +Enemy* find_enemy_at(byte x, byte y) { + byte i; + for (i=0; ix + 7; + bomb_y = e->y + 16; + xor_sprite(bomb_bitmap, bomb_x, bomb_y); +} + +void move_bomb() { + byte leftover = xor_sprite(bomb_bitmap, bomb_x, bomb_y); // erase + if (bomb_y > VHEIGHT-12) { + bomb_y = 0; + } else if (leftover & 0x7f) { // don't count hi bit + erase_sprite(bomb_bitmap, bomb_x, bomb_y); // erase bunker + if (bomb_y > VHEIGHT-23) { + // player was hit (probably) + destroy_player(); + } + bomb_y = 0; + } else { + bomb_y += 3; + xor_sprite(bomb_bitmap, bomb_x, bomb_y); + } +} + +byte frame; +signed char player_dir = 0; + +void move_player() { + if (attract) { + if (bullet_y == 0) fire_bullet(); + player_dir = 0; + } else { + char key = keyscan(); + // handle keyboard + if (key != 0xff) { + switch (key) { + case 0x04: // left arrow + player_dir = -2; + break; + case 0x13: // right arrow + player_dir = 2; + break; + case ' ': // space + if (bullet_y == 0) { + fire_bullet(); + } + break; + } + } else { + player_dir = 0; + } + } + // move player + if (player_dir < 0 && player_x > 0) + player_x += player_dir; + else if (player_dir > 0 && player_x < 255-40) + player_x += player_dir; + draw_sprite(player_bitmap, player_x, VHEIGHT-17); +} + +void play_round() { + draw_playfield(); + player_x = VHEIGHT/2-8; + bullet_y = 0; + bomb_y = 0; + frame = 0; + while (player_x != 0xff && num_enemies) { + move_player(); + if (bullet_y) { + move_bullet(); + } + update_next_enemy(); + if (frame & 1) { + if (bomb_y == 0) { + drop_bomb(); + } else { + move_bomb(); + } + } + frame++; + } +} + +void init_game() { + score = 0; + lives = 5; +} + +void game_over_msg() { + byte i; + byte x=8; + byte y=10; + for (i=0; i<50; i++) { + draw_string(" *************** ", x, y+0, 0); + draw_string("*** ***", x, y+1, 0); + draw_string("** GAME OVER **", x, y+2, 0); + draw_string("*** ***", x, y+3, 0); + draw_string(" *************** ", x, y+4, 0); + } +} + +void play_game() { + attract = 0; + init_game(); + init_enemies(); + while (lives) { + play_round(); + if (num_enemies == 0) { + init_enemies(); + } + } + game_over_msg(); +} + +void attract_mode() { + attract = 1; + while (1) { + init_enemies(); + play_round(); + } +} + +void main() { + // NOTE: initializers don't get run, so we init here + while (1) { + //attract_mode(); + play_game(); + } +} diff --git a/presets/zx/hello.asm b/presets/zx/hello.asm new file mode 100644 index 00000000..f22524cb --- /dev/null +++ b/presets/zx/hello.asm @@ -0,0 +1,20 @@ + +CHAN_OPEN equ 5633 +PRINT equ 8252 + + org 0x5ccb +loop + ld a, 2 ; 3E 02 + call CHAN_OPEN ; CD 01 16 + ld de, text ; 11 0E 7F + ld bc, textend-text ; 01 0E 00 + call PRINT ; C3 3C 20 + jmp loop + +text defb 'Hello, World!' ; 48 65 6C 6C 6F 2C 20 57 + ; 6F 72 6C 64 21 + defb 13 ; 0D +textend + + org 0xff57 + defb 00h diff --git a/res/zx.bios b/res/zx.bios new file mode 100755 index 0000000000000000000000000000000000000000..d7738dea027ce561b8f77c9fa7371f49e66b1ee2 GIT binary patch literal 16384 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 literal 0 HcmV?d00001 diff --git a/src/common/baseplatform.ts b/src/common/baseplatform.ts index 9617159a..46aca836 100644 --- a/src/common/baseplatform.ts +++ b/src/common/baseplatform.ts @@ -899,6 +899,7 @@ export abstract class BaseMAMEPlatform { */ } +//TODO: how to get stack_end? export function dumpStackToString(platform:Platform, mem:Uint8Array|number[], start:number, end:number, sp:number, jsrop:number) : string { var s = ""; var nraw = 0; @@ -1288,6 +1289,7 @@ export abstract class BaseWASMMachine { } } } + // TODO: tick might advance 1 instruction advanceFrameClock(trap, cpf:number) : number { var i : number; if (trap) { diff --git a/src/ide/ui.ts b/src/ide/ui.ts index 4305e149..62de8b3f 100644 --- a/src/ide/ui.ts +++ b/src/ide/ui.ts @@ -1620,6 +1620,7 @@ function setupReplaySlider() { if (stateRecorder.loadFrame(frame)) { updateFrameNo(frame); projectWindows.tick(); + showDebugInfo(platform.saveState()); } }; var setFrameTo = (frame:number) => { @@ -1628,7 +1629,7 @@ function setupReplaySlider() { replayslider.val(frame); updateFrameNo(frame); projectWindows.tick(); - console.log('seek to frame',frame); + showDebugInfo(platform.saveState()); } }; stateRecorder.callbackStateChanged = () => { @@ -1636,6 +1637,7 @@ function setupReplaySlider() { replayslider.attr('max', stateRecorder.numFrames()); replayslider.val(stateRecorder.currentFrame()); updateFrameNo(stateRecorder.currentFrame()); + showDebugInfo(platform.saveState()); }; replayslider.on('input', sliderChanged); replayslider.on('change', sliderChanged); diff --git a/src/machine/zx.ts b/src/machine/zx.ts new file mode 100644 index 00000000..ddce22c7 --- /dev/null +++ b/src/machine/zx.ts @@ -0,0 +1,121 @@ + +import { MOS6502, MOS6502State } from "../common/cpu/MOS6502"; +import { BasicMachine, RasterFrameBased, Bus, ProbeAll } from "../common/devices"; +import { KeyFlags, newAddressDecoder, padBytes, Keys, makeKeycodeMap, newKeyboardHandler, EmuHalt, dumpRAM } from "../common/emu"; +import { lzgmini, stringToByteArray, hex, rgb2bgr } from "../common/util"; + +//// WASM Machine + +import { Machine, BaseWASMMachine } from "../common/baseplatform"; +import { TrapCondition } from "../common/devices"; + +export class ZX_WASMMachine extends BaseWASMMachine implements Machine { + + joymask0 = 0; + + reset() { + super.reset(); + // advance bios + this.exports.machine_exec(this.sys, 500000); // TODO? + // load rom (Z80 header: https://worldofspectrum.org/faq/reference/z80format.htm) + if (this.romptr && this.romlen) { + // TODO + this.exports.machine_load_rom(this.sys, this.romptr, this.romlen); + /* + var romstart = 0x5ccb; + for (var i=0; i implements Platform { + + newMachine() { return new ZX_WASMMachine('zx'); } + + async start() { + // TODO: start() needs to block + await this.machine.loadWASM(); + super.start(); + } + getPresets() { return ZX_PRESETS; } + getDefaultExtension() { return ".asm"; }; + readAddress(a) { return this.machine.readConst(a); } + getMemoryMap() { return ZX_MEMORY_MAP; } + showHelp() { + window.open("https://worldofspectrum.org/faq/reference/reference.htm", "_help"); + } +} + +PLATFORMS['zx'] = ZXWASMPlatform; diff --git a/src/worker/workermain.ts b/src/worker/workermain.ts index 26d04d9d..d54c08f2 100644 --- a/src/worker/workermain.ts +++ b/src/worker/workermain.ts @@ -262,11 +262,11 @@ var PLATFORM_PARAMS = { 'x86': { }, 'zx': { - code_start: 0x8000, - rom_size: 0xff58-0x8000, - data_start: 0x5d00, - data_size: 0x8000-0x5d00, - stack_end: 0x8000, + code_start: 0x5ccb, + rom_size: 0xff58-0x5ccb, + data_start: 0xf000, + data_size: 0xfe00-0xf000, + stack_end: 0xff58, }, };