izaya/collapseos
1
0
Fork 0
mirror of https://github.com/hsoft/collapseos.git synced 2024-11-27 12:58:09 +11:00
Code Issues Releases Wiki Activity

Update docs

Browse Source
This commit is contained in:
Virgil Dupras 2019-05-09 10:48:36 -04:00
parent d8bc9c2bdd
commit 02808572e6
2 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
README.md
View File

@ -85,14 +85,17 @@ to see what it can do) on a classic RC2014. Highlights:
* Extremely flexible: this is not an OS, but a meta OS. You build your own OS * Extremely flexible: this is not an OS, but a meta OS. You build your own OS
through glue code. through glue code.
* 2K binary (but size vary wildly depending on what parts you include. 2K is for * 2K binary (but size vary wildly depending on what parts you include. 2K is
a shell using all parts) for a shell using all parts).
* Built with minimal tooling: only [scas][scas] is needed * Built with minimal tooling: only [scas][scas] is needed
* Can read and write to memory through shell * Can read and write to memory through shell
* Can run arbitrary routine from arbitrary address with arbitrary arguments * Can run arbitrary routine from arbitrary address with arbitrary arguments
from shell. from shell.
* Can "upload" code from serial link into memory and execute it. * Can "upload" code from serial link into memory and execute it.
* Can manage multiple "block devices" * Can manage multiple "block devices"
* Can read SD cards as block devices
* A z80 assembler written in z80 that is progressing well and should soon be
able to replace `scas`.
## Organisation of this repository ## Organisation of this repository

15
doc/load-run-code.md
View File

@ -58,6 +58,21 @@ So, we'll expect this to become `62` after we run the code. Let's go:
Success! Success!
## The upload.py tool
The serial connection is not always 100% reliable and a bad byte can slip in
when you push your code and that's not fun when you try to debug your code (is
this bad behavior caused by my logic or by a bad serial upload?).
To this end, there is a `upload.py` file in `tools/` that takes care of loading
the file and verify the contents. So, instead of doing `load 8` followed by
your `cat` above, you would have done:
./upload.py /dev/ttyUSB0 tosend.bin
This emits `load` and `peek` commands and fail appropriately if the `peek`
doesn't match sent contents. Very handy.
## Labels in RAM code ## Labels in RAM code
If your code contains any label, make sure that you add a `.org` directive at If your code contains any label, make sure that you add a `.org` directive at