dusk os fork
git clone git://git.alexwennerberg.com/duskos
Log | Files | Refs | README | LICENSE

commit 9a43faa19c910a26c1872d0c91553caa7275f592
parent cbcc22e28c480481d28fd7633e06bd2c411122de
Author: Virgil Dupras <hsoft@hardcoded.net>
Date:   Mon,  2 Jan 2023 15:04:23 -0500

Update README to show what Dusk can do

MREADME.md | 30++++++++++++++++++++++++++++++
1 file changed, 30 insertions(+), 0 deletions(-)

diff --git a/README.md b/README.md @@ -153,9 +153,14 @@ higher cognitive space to fit BSD/Linux wider abstractions in your mind. * AHCI controllers * Floppy controllers * PC COM ports + * VESA in graphical mode + * PS/2 mouse support * Can read, write and boot from FAT12/FAT16 (no FAT32 for now) volumes. * Can create new FAT12 volumes. * It completely self-hosts on all its target (only PC for now) machines. +* Did I mention that the *whole* code for Dusk OS and its ported applications + (excluding docs and test code) is less than 11K lines of code and that DuskCC + is less than 1400 lines of code? List of ported C codebases: @@ -212,6 +217,30 @@ To run Dusk on an actual machine, what you can do is to write it directly to a USB key (`dd if=pc.img of=/dev/sdX`) and then boot from that key in "Legacy BIOS" mode. +### See what it can do + +Dusk OS on the PC has graphical capabilities as well as [varvara][varvara] +bindings for it. If you have QEMU installed, you can try a few little things on +it. First, start the QEMU VM with `make pcrun`. Then, enter this: + + f<< tests/manual/uxn/sprite.fs + +This will: + +1. Compile DuskCC (in forth) +2. Compile uxn (in C) +3. Compile uxntal (the uxn assembler) (in C) +4. Compile varvara (in forth) +5. Compile `tests/manual/uxn/sprite.tal` (a copy of the official `screen.tal`) +6. Put the system in graphical mode +7. Run the compiled `sprite.tal` + +You now have it running. There is also a mouse cursor that you can move around. +Press Escape to return to prompt. You can try the same thing with: + +* `tests/manual/uxn/mandel.fs` +* `tests/manual/uxn/ctrl.fs` + [collapseos]: http://collapseos.org [coswhy]: http://collapseos.org/why.html [creative]: http://collapseos.org/why.html#creative @@ -226,4 +255,5 @@ BIOS" mode. [duskcc]: fs/doc/cc/index.txt [fiwix]: https://www.fiwix.org [uxn]: https://wiki.xxiivv.com/site/uxn.html +[varvara]: https://wiki.xxiivv.com/site/varvara.html [zlib]: https://github.com/madler/zlib