nand2/tools/Readme.md
Michael Schröder 971b323822 added v2.0
2023-01-11 23:04:57 +01:00

1.5 KiB

tools

This folder contains the toolchain for Hack/Jack development.

vim

vim configuration file to highlight syntax of jack/hack-files, when editing with vim. Copy the content of the subfolders into the appropriate vim configuration directory situated in your home directory ~/.vim.

$ cp vim/syntax/* ~/.vim/syntax/
$ cp vim/ftdetect/* ~/.vim/ftdetect/

Assembler

Assembler translates Hack-Assembly-files to Machnine-code. Outputs the machine code to filename.hack.

usage: ./Assembler/assembler.pyc [filename.asm]

JackCompiler

Compiles Jack classes (single file or all *.jack files in directory) to virtualmachine code.

usage: ./JackCompiler/JackCompiler.pyc [filename.jack] or [dir]

VMTranslator

Translates vm code (single file or all files with ending *.vm in directory)to Assembler.

usage: ./VMTranslator/VMTranslator.pyc [filename.vm] or [dir]

AsciiToBin.py

Translates .hack files to binary files that can be uploaded with iecprogduino.

usage: ./AsciiToBin.py [filename.hack]

iceprogduino

iceprogduino is the programmer to upload bitstream files to iCE40 boards of olimex over olimexino-32u4 (arduino like board).

For this you first have to upload firmware to olimexino-32u4.

iceprogduino is supportes from apio (fpgawars)

connect:

  1. ice40-HX1/8K-EVB to olimexino-32u4 (over UEXT)
  2. olimexino-32u4 (with installed firmware) to PC over USB.

olimexino-32u4-firmware

Firmware to run olimexino-32u4 as programmer/UART bridge.