collapseos/README.md

76 lines
2.8 KiB
Markdown
Raw Normal View History

2019-03-06 14:28:56 -05:00
# Collapse OS
*Bootstrap post-collapse technology*
2019-05-20 12:11:45 -04:00
Collapse OS is a z80 kernel and a collection of programs, tools and
2019-06-07 20:08:41 -04:00
documentation that allows you to assemble an OS that, when completed, will be
able to:
2019-03-06 14:28:56 -05:00
1. Run on minimal and improvised machines.
2. Interface through improvised means (serial, keyboard, display).
2019-03-06 14:28:56 -05:00
3. Edit text files.
4. Compile assembler source files for a wide range of MCUs and CPUs.
5. Read and write from a wide range of storage devices.
6. Replicate itself.
2019-03-06 14:28:56 -05:00
Additionally, the goal of this project is to be as self-contained as possible.
With a copy of this project, a capable and creative person should be able to
manage to build and install Collapse OS without external resources (i.e.
internet) on a machine of her design, built from scavenged parts with low-tech
tools.
## Forth reboot in process
You are currently looking at the `forth` branch of the project, which is a
Forth reboot of Collapse OS. You can see why I'm doing this in the [related
github issue][forth-issue].
Documentation is lacking, it's not ready yet, this is a WIP branch.
## See it in action
Michael Schierl has put together [a set of emulators running in the browser that
run Collapse OS in different contexts][jsemul].
Using those while following along with the [User Guide](doc/) is your quickest
path to giving Collapse OS a try.
## Documentation
Usage documentation is in-system. Run `0 LIST` for an introduction. You can
also open `blk/000` in a modern text editor.
See `/emul/README.md` for getting an emulated system running.
2019-06-19 19:10:58 -04:00
## Organisation of this repository
* `forth`: Forth is slowly taking over this project (see issue #4). It comes
from this folder.
2019-06-19 19:10:58 -04:00
* `recipes`: collection of recipes that assemble parts together on a specific
machine.
2020-04-13 22:05:03 -04:00
* `blk`: Collapse OS filesystem's content. See `000` for intro.
2019-06-19 19:10:58 -04:00
* `doc`: User guide for when you've successfully installed Collapse OS.
2019-12-31 13:32:09 -05:00
* `tools`: Tools for working with Collapse OS from "modern" environments. For
example, tools for facilitating data upload to a Collapse OS machine
through a serial port.
2020-04-13 22:05:03 -04:00
* `emul`: Emulated applications.
2019-12-31 13:07:05 -05:00
* `tests`: Automated test suite for the whole project.
2019-06-19 19:10:58 -04:00
## Status
2019-03-06 14:28:56 -05:00
The project unfinished but is progressing well! See [Collapse OS' website][web]
for more information.
2019-03-06 14:28:56 -05:00
2019-11-11 06:28:41 -05:00
## Discussion
For a general discussion of Collapse OS and the ecosystem of technologies and ideas that may develop around it refer to [r/collapseos][discussion]
2019-11-13 20:27:09 -05:00
A more traditional [mailing list][listserv] and IRC (#collapseos on freenode) channels are also maintained.
2019-05-20 12:11:45 -04:00
[libz80]: https://github.com/ggambetta/libz80
[web]: https://collapseos.org
[jsemul]: https://schierlm.github.io/CollapseOS-Web-Emulator/
2019-11-11 06:28:41 -05:00
[discussion]: https://www.reddit.com/r/collapseos
[listserv]: http://lists.sonic.net/mailman/listinfo/collapseos
[forth-issue]: https://github.com/hsoft/collapseos/issues/4