aboutsummaryrefslogtreecommitdiff
path: root/infra/corenix/README.md
diff options
context:
space:
mode:
authorMx Kookie <kookie@spacekookie.de>2021-01-01 00:55:51 +0100
committerMx Kookie <kookie@spacekookie.de>2021-01-01 00:55:51 +0100
commitaf8b681b5ef80871e6586061568b8ab8af2d85e3 (patch)
tree4f3d66f0afbea6c947cc4dff32fa4c25e70329d4 /infra/corenix/README.md
parent51970440a767f3906bcb69cc3d00185391c5d595 (diff)
parent53a9f091f8cf9362a95c12130daa1f69ddff036c (diff)
Add 'infra/corenix/' from commit '53a9f091f8cf9362a95c12130daa1f69ddff036c'
git-subtree-dir: infra/corenix git-subtree-mainline: 51970440a767f3906bcb69cc3d00185391c5d595 git-subtree-split: 53a9f091f8cf9362a95c12130daa1f69ddff036c
Diffstat (limited to 'infra/corenix/README.md')
-rw-r--r--infra/corenix/README.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/infra/corenix/README.md b/infra/corenix/README.md
new file mode 100644
index 000000000000..5a70e2b7ce9b
--- /dev/null
+++ b/infra/corenix/README.md
@@ -0,0 +1,20 @@
+## corenix
+
+#### *Configure and build coreboot using the Nix package manager*
+
+*How to use:*
+
+1. Create a configuration file for your device in `configs/`
+2. Add an entry to flake.nix, i.e. `my-device = makeDevice ./configs/my-device.nix;`
+3. Build the coreboot rom: `nix build -A pkgs.my-device`
+
+*Features*
+
+- Specify the build parameters with NixOS-style modules
+- Share declarative configuration across devices
+- Use cached coreboot and payload builds for different device/payload combinations
+- Use GRUB2, TianoCore or SeaBIOS as primary payload
+
+*Limitations*
+
+- currently only `x86_64-linux` host and target systems are supported