This is a list of Dusk OS configurations for specific machines. Dusk OS doesn't do any kind of auto-probing, so you have to know your hardware and adjust configuration appropriately. You can use this repository as an inspiration for your own deployments.
This code is available from Dusk OS' files folder or as a Git repository (without SSL) at:
If you have a deployment that isn't an exact copycat of something that is already in there, please send it to me, I'll merge it in. The more the merrier.
The idea behind this separate repository is to avoid polluting Dusk OS's code with the myriad of possible configurations for a given system and have a "bazaar" of configurations here. Configurations are something that you'll want to maintain personally, but it's much easier to build a configuration if you have a wide selection of examples to choose from.
What we do want in Dusk OS directly are tools to work with specific machines.
A machine running Dusk OS and having its whole
fs directory should have all
as many tools as possible to work with specific machines.
In short, configurations come in here, tools stay in Dusk OS.
Raspberry Pi need opaque firmware on their boot partitions. Generally, if you
have a Raspberry Pi, you have those
start.elf file, but
it's possible that you don't. So if you don't have them handy, it's nice that
Dusk comes with it. But where should it go, Dusk OS or Dusk Deployments?
On the one hand, if you're stuck with only a machine running Dusk OS and a Raspberry Pi with no firmware file, you need those files to deploy Dusk OS. So on the first look, they should go in Dusk OS.
But on the other hand, these files are deeply tied to the machine. If you have one without the other, you have a broken machine. Should Dusk OS also carry backup dumps of PC BIOS ROM in case you have a machine with a corrupted BIOS? I don't think so.
Therefore, these files live in Dusk Deployments.
Each deployment has its own directory along with its own submodule linking to Dusk OS (so that we know what version of Dusk OS this deployment is last known to run on).
To build it, you need:
Dusk OS has the ability to copy itself into a FAT without external tooling, but the makefiles in this repo don't bother using this capability and use mtools instead as its an easier fit with POSIX makefiles.
cd into the directory and run
make. This should yield an image which
you can deploy on your target media.
Each subdirectory has a README with hardware and deployment details.
Some targets can readily emulated via QEMU. Such target indicate
to their name in the list below. In such target, you can run
make emul to
launch QEMU with the right parameters to run it.
pc-bios: Barebone PC and BIOS diagnostic tools (QEMU)
pc-piix: PC of the "PIIX" architecture (QEMU)
pc-p2l97: PC w/ P2L97 motherboard
hp-mini-2103070: HP Mini 210-3070
pcengine-alix: PC Engine's Alix board
rpi1: Raspberry Pi Model 1 (QEMU)
rpi2: Raspberry Pi Model 2 (QEMU)