Populate repository from old progress; massive cleanup and fixes

README.md

@@ -1,3 +1,41 @@
-# chibi-firmware
+# CHIBI PC-09 BIOS
 
-CHIBI PC-09 BIOS and BUZBEE monitor
+This is the firmware for the CHIBI PC-09. In the future it will provide the
+CHIBI with initialization code, a UART driver, some self test features, as well
+as the "BUZBEE" machine language monitor.
+
+## Building the Firmware
+
+Building the firmware from source requires [LWTOOLS](http://www.lwtools.ca/) for
+building S-Records of the ROM. GNU Binutils' `objcopy` is used to translate
+S-Records into ROM images. A GNU Make makefile is provided.
+
+### Using the Makefile
+
+To generate an S-Record run:
+
+```sh
+make generate
+make boot.s19
+```
+
+To generate a binary run:
+
+```sh
+make generate
+make
+```
+
+The makefile also can clean up after itself (this will remove generated files as
+well):
+
+```sh
+make clean
+```
+
+## Firmware Licensing
+
+This firmware like the rest of the CHIBI PC-09 is licensed under the MIT
+license.
+
+CHIBI PC-09 BIOS (c) Amber Zeller, Gale Faraday