ae028e3a86
This huge refactoring remove the Seek and Tell routine from blockdev implementation requirements and change GetC and PutC's API so that they take an address to read and write (through HL/DE) at each call. The "PTR" approach in blockdev implementation was very redundant from device to device and it made more sense to generalize. It's possible that future device aren't "random access", but we'll be able to add more device types later. Another important change in this commit is that the "blockdev handle" is now opaque. Previously, consumers of the API would happily call routines directly from one of the 4 offsets. We can't do that any more. This makes the API more solid for future improvements. This change forced me to change a lot of things in fs, but overall, things are now simpler. No more `FS_PTR`: the "device handle" now holds the active pointer. Lots, lots of changes, but it also feels a lot cleaner and solid. |
||
|---|---|---|
| .. | ||
| cfsin | ||
| libz80@8a1f935daa | ||
| runbin | ||
| shell | ||
| zasm | ||
| .gitignore | ||
| bin2c.sh | ||
| Makefile | ||
| README.md | ||
emul
This folder contains a couple of tools running under the [libz80][libz80] emulator.
Build
First, make sure that the libz80 git submodule is checked out. If not, run
git submodule init && git submodule update.
After that, you can run make and it builds all tools.
shell
Running shell/shell runs the shell in an emulated machine. The goal of this
machine is not to simulate real hardware, but rather to serve as a development
platform. What we do here is we emulate the z80 part, the 64K memory space and
then hook some fake I/Os to stdin, stdout and a small storage device that is
suitable for Collapse OS's filesystem to run on.
Through that, it becomes easier to develop userspace applications for Collapse OS.
We don't try to emulate real hardware to ease the development of device drivers because so far, I don't see the advantage of emulation versus running code on the real thing.
zasm
zasm/zasm is apps/zasm wrapped in an emulator. It is quite central to the
Collapse OS project because it's used to assemble everything, including itself!
The program takes no parameter. It reads source code from stdin and spits
binary in stdout. It supports includes and had both apps/ and kernel folder
packed into a CFS that was statically included in the executable at compile
time.
The file zasm/zasm.bin is a compiled binary for apps/zasm/glue.asm and
zasm/kernel.bin is a compiled binary for tools/emul/zasm/glue.asm. It is
used to bootstrap the assembling process so that no assembler other than zasm
is required to build Collapse OS.
This binary is fed to libz80 to produce the zasm/zasm "modern" binary and
once you have that, you can recreate zasm/zasm.bin and zasm/kernel.bin.
This is why it's included as a binary in the repo, but yes, it's redundant with the source code.
Those binaries can be updated with the make updatebootstrap command. If they
are up-to date and that zasm isn't broken, this command should output the same
binary as before.
runbin
This is a very simple tool that reads binary z80 code from stdin, loads it in
memory starting at address 0 and then run the code until it halts. The exit
code of the program is the value of A when the program halts.
This is used for unit tests.