mirror of
https://github.com/hsoft/collapseos.git
synced 2024-11-08 15:58:05 +11:00
7001446212
Recipes contain bits and pieces of hardware-related knowledge, but these bits feel sparse. I've been wanting to consolidate hardware- related documentation for a while, but always fell at odds with the recipes organisation. We don't have recipes anymore, just a /doc/hw section that contains hardware-related documentation which often translate to precise instructions to run Collapse OS on a specific machine. With this new organisation, I hope to end up with a better, more solid documentation.
29 lines
979 B
Plaintext
29 lines
979 B
Plaintext
# Frequently asked questions
|
|
|
|
# What is the easiest way to run Collapse OS on a modern
|
|
computer?
|
|
|
|
Run the C VM in folder "/cvm". Run "make", then "./forth".
|
|
See doc/usage.txt for the rest.
|
|
|
|
# How do I use the different emulators?
|
|
|
|
Ah, you've noticed that /emul contains quite a few emulators.
|
|
Code in this folder only build emulators, not the binary to run
|
|
under it. It's the /arch folder that contains the makefiles to
|
|
build Collapse OS binaries to run under those.
|
|
|
|
When a binary built in /arch has a corresponding emulator, the
|
|
makefile has a "emul" target that you can use.
|
|
|
|
For example, "cd arch/z80/rc2014 && make emul" builds RC2014's
|
|
Collapse OS, the RC2014 emulator and then invokes the emulator.
|
|
|
|
# How do I fill my SD card with Collapse OS' FS?
|
|
|
|
Very easy. You see that "/cvm/blkfs" file? You dump it to your
|
|
raw device. For example, if the device you get when you insert
|
|
your SD card is "/dev/sdb", then you type "cat emul/blkfs | sudo
|
|
tee /dev/sdb > /dev/null".
|
|
|