gigatron/rom/Utils

Utilities for Gigatron development

Files

BabelFish/BabelFish.ino         Sketch to install on Arduino for Gigatron hookup
gcl.vim                         VIM syntax highlighting file
raw24toraw6.py                  Raw 24bpp to GCL-format packed 6bpp converter
sendFile.py                     Send a GT1 or BASIC file from laptop/PC to Gigatron
SerialTest.gt1                  Test file for verifying serial transmission
gt1dump.py                      Dump GT1 file to show internal structure

Installing VIM syntax highlighting

Place gcl.vim in $HOME/.vim/after/syntax/ and create a file, $HOME/.vim/ftdetect/gcl.vim with the contents:

au BufRead,BufNewFile *.gcl set filetype=gcl

Installing Gedit/Pluma/Xed syntax highlighting

Place gcl.lang in $HOME/.local/share/gtksourceview-3.0/language-specs.

Using raw24toraw6.py

Running the file will output usage instructions. When executed successfully, two files will be produced, a .raw file and a .gcl file. Both files contain packed 6bpp image data. The .gcl file is formatted as valid GCL code and can be copy-pasted to use directly in GCL code. The data can then be drawn to the screen with \SYS_Unpack_56 and \SYS_Draw4_30.

Using sendFile.py

usage: sendFile.py [-h] [-v] [-p PORT] [filename]

Send a file into the Gigatron

positional arguments:
  filename              GT1 or GTB file

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         be verbose
  -p PORT, --port PORT  USB port to Arduino (default is auto-detect)

Using gt1file.py

usage: gt1dump.py [-h] [-d] [-f] [filename]

Dump GT1 file

positional arguments:
  filename           GT1 file

optional arguments:
  -h, --help         show this help message and exit
  -d, --disassemble  disassmble as vCPU code
  -f, --force        accept any filename extension