Skip to content
This repository has been archived by the owner on Oct 8, 2019. It is now read-only.

samsaga2/js80

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

     __         ______ _______
    |__| ______/  __  \\   _  \
    |  |/  ___/>      </  /_\  \
    |  |\___ \/   --   \  \_/   \
/\__|  /____  >______  /\_____  /
\______|    \/       \/       \/

js80 is a library and an assembler for z80 cpu.

Installation

Using NPM:

npm install js80 -g

Binaries for Windows:

  1. Download [https://github.com/samsaga2/js80/releases]
  2. Add the directory bin to your PATH.

Command line

js80asm help:

  Usage: js80asm [options] <file ...>

  Options:

    -h, --help                     output usage information
    -V, --version                  output the version number
    -o, --output <file>            create binary compiled file (default a.out)
    -I, --include <dir1:dir2:...>  add directories into the search list
    -s, --sym <file>               create sym file

Examples:

js80asm test.asm

js80asm test2.asm -o test2.rom -s test2.sym

js80asm test3.asm -I include:../include2

JS80 API

New instance

var JS80 = require('js80');
var js80 = new JS80();

methods

  • asm js80.asm(code) ··Compile assembler code.
  • defineLabel js80.defineLabel(label, value) ·· Defines a new label.
  • secondPass js80.secondPass() ··Execute the second pass. The compiler evaluates the expressions because labels can be declared later.
  • buildImage js80.buildImage() ··Returns an array of bytes with the compiled code.
  • saveImage js80.saveImage(fileName) ··Save compiled code to a file.
  • saveSymbols js80.saveSymbols(fileName) ··Save symbols to a file (useful for debugging).

Example:

var JS80 = require('js80');
var js80 = new JS80();
js80.asm('xor a');
js80.secondPass();
js80.saveImage('a.out');

Assembler

Inst Desc
label: Declares a variable
.label: Declares a local label
// comment // Comment code
/* comment */ Comment code
; comment Comment code
inst1\inst2\···\inst-n Multipe instructions per line
module Declares a module
endmodule Ends module declaration
macro Declares a macro
endmacro Ends macro declaration
ifdef Branch if label is defined
ifndef Branch if label is not defined
if Branch if cond is not zero
else Else branch
endif Ends branching
repeat Repeat block of code times
endrepeat End repeats code block
include "filename" Include another source file
incbin "filename", ?skip, ?length Include a binary file
rotate Rotate macro variable arguments
map TODO
# TODO
org * TODO
defpage , , TODO
page TODO
echo e1, e2, ... TODO
error "msg" TODO
db e1, e2, ... TODO
dw e1, e2, ... TODO
dw TODO
equ TODO
struct Declares a struct
endstruct Ends struct declaration

Expressions

Expr Desc
11001100b, 0b11001100b binary number
0x1a, 01ah, $1a hexadecimal number
$ current address
-n negate a number
i-j substract two numbers
i+j sum two numbers
i*j mult two numbers
i/j div two numbers
i%j division module
(i) group expression
i<<j shift left
i>>j shift right
i^j xor
i|j or
i&j and
"str" string
'i' char
# nbytes get map and move it nbytes
@0 macro arguments length
@number get macro argument (start from 1)
str() convert identifier to string
i==j compare two expressions
i!=j compare two expressions
i<=j compare two expressions
i>=j compare two expressions
i<j compare two expressions
i>j compare two expressions

Examples

run: ld b,100
.1:  ld a,(hl)
     inc a
     ld (hl),a
     inc hl
     djnz .1
     ret
unuseful:
     jr run.1
      module mod1
util: xor a
      ret
      endmodule

      // no module
main: call mod1.util ; calling a module label
      ret
macro noargs
    xor a
endmacro
macro withargs i, j
    ld a,i+j
endmacro
macro withdefaults i, j:1, k:2
    ld a,i+j+k
endmacro
macro varargs i, 1..*
    repeat @0
        ld a,i+@1
        rotate 1
    endrepeat
endmacro
struct spr
    y   # 1
    x   # 1
    col # 1
    pat # 1
endstruct

ld ix,sprite_data
ld a,(ix+spr.y)
ld b,(ix+spr.x)
ld hl,spr.size

Assembler modules

  • bios.asm: MSX 2 Bios functions and variables (bios.WRTVRM, bios.H_KEYI, ...)
  • rom16k.asm: MSX 16kb rom setup (start label is the entry point)
  • rom32k.asm: MSX 32kb rom setup (start label is the entry point)
  • megarom.asm: MSX megarom setup (start label is the entry point)
  • extensions.asm: Misc utility macros
  • math.asm: Misc math funcs
  • debug.asm: OpenMSX debug output

About

z80 assembler for node

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages