2021-11-16 06:09:27 +00:00
|
|
|
# ableOS
|
|
|
|
|
 
|
|
|
|
|
## Set up
|
|
|
|
|
Install [Qemu](https://www.qemu.org/)
|
|
|
|
|
|
|
|
|
|
> On Windows be sure to add `C:\Program Files\qemu` to your `PATH` variable
|
|
|
|
|
|
|
|
|
|
`rustup component add rust-src`
|
|
|
|
|
|
|
|
|
|
`rustup component add llvm-tools-preview`
|
|
|
|
|
|
|
|
|
|
`cargo install bootimage`
|
|
|
|
|
|
2022-01-18 12:15:51 +00:00
|
|
|
|
|
|
|
|
## Running
|
|
|
|
|
repbuild can be used to run and build docs for able os
|
|
|
|
|
|
|
|
|
|
`cargo repbuild doc`
|
|
|
|
|
`cargo repbuild run`
|
|
|
|
|
|
2021-11-16 06:09:27 +00:00
|
|
|
## Testing on real hardware
|
|
|
|
|
I recommend using an old x86_64 computer
|
|
|
|
|
* `cargo run --release` to generate a binary image that is bootable
|
2022-01-26 15:22:39 +00:00
|
|
|
* flash it to a USB device via `dd` or balenaEtcher
|
2021-11-16 06:09:27 +00:00
|
|
|
* Remove said USB device and plug into test machine
|
|
|
|
|
* assure test machine boots from USB devices
|
