cl-hackasm is an assembler for the Hack platform, written in Common Lisp. It was designed as the exercise for Chapter 6 of the book The Elements of Computing Systems, by Nisan and Schocken.
More information on my progress on the book can be seen at my study repository.
One should be able to use this assembler by using either Quicklisp directly or Roswell.
Either add this repository to your local-projects folder or install it using
Quicklisp (this project should be available from Ultralisp. If you don’t know
how to add a new dist, I recommend taking a look at the Quicksys tool).
Then, to assemble a file, one might just want to use:
(ql:quickload :cl-hackasm)
(cl-hackasm:assemble-file "/path/to/file.asm")This will create a file "/path/to/file.hack", which should load without problems
on the tools provided as resources for the book.
One can simply install this tool using Roswell with the following command:
ros install luksamuk/cl-hackasmFrom there on, a script called hackasm should be available to invoke directly
from command line. Simply pass as argument all the .asm files which are supposed
to be assembled, and hackasm will attempt to assemble each one of them.
This project is distributed under the MIT License. See LICENSE for details.
Copyright (c) 2019 Lucas Vieira