Add basic docs
This commit is contained in:
parent
1bc0910b37
commit
c2a268a4a0
65
README.md
65
README.md
|
@ -1,3 +1,68 @@
|
||||||
# zephyr-nix
|
# zephyr-nix
|
||||||
|
|
||||||
Develop Zephyr projects using Nix
|
Develop Zephyr projects using Nix
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- SDK packaging
|
||||||
|
- Host tools packaging
|
||||||
|
|
||||||
|
## Basic usage
|
||||||
|
|
||||||
|
- `shell.nix`
|
||||||
|
|
||||||
|
``` nix
|
||||||
|
{ mkShell
|
||||||
|
, zephyr
|
||||||
|
, callPackage
|
||||||
|
, cmake
|
||||||
|
, ninja
|
||||||
|
, lib
|
||||||
|
}:
|
||||||
|
|
||||||
|
mkShell {
|
||||||
|
packages = [
|
||||||
|
zephyr.pythonEnv
|
||||||
|
# Use zephyr.hosttools-nix to use nixpkgs built tooling instead of official Zephyr binaries
|
||||||
|
zephyr.hosttools
|
||||||
|
cmake
|
||||||
|
ninja
|
||||||
|
];
|
||||||
|
|
||||||
|
env.ZEPHYR_SDK_INSTALL_DIR = zephyr.sdk.overrideAttrs(old: {
|
||||||
|
targets = old.targets ++ [
|
||||||
|
"arm-zephyr-eabi"
|
||||||
|
];
|
||||||
|
});
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Flakes usage
|
||||||
|
|
||||||
|
- `flake.nix`
|
||||||
|
``` nix
|
||||||
|
{
|
||||||
|
description = "A very basic Zephyr flake";
|
||||||
|
|
||||||
|
inputs = {
|
||||||
|
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
|
||||||
|
|
||||||
|
# Customize the version of Zephyr used by the flake here
|
||||||
|
zephyr.url = "github:zephyrproject-rtos/zephyr/v3.5.0";
|
||||||
|
zephyr.flake = false;
|
||||||
|
|
||||||
|
zephyr-nix.url = "github:adisbladis/zephyr-nix";
|
||||||
|
zephyr-nix.inputs.nixpkgs.follows = "nixpkgs";
|
||||||
|
zephyr-nix.inputs.zephyr.follows = "zephyr";
|
||||||
|
};
|
||||||
|
|
||||||
|
outputs = { self, nixpkgs, zephyr-nix, ... }: let
|
||||||
|
pkgs = nixpkgs.legacyPackages.x86_64-linux;
|
||||||
|
zephyr = zephyr-nix.packages.x86_64-linux;
|
||||||
|
in {
|
||||||
|
devShell.x86_64-linux.default = pkgs.mkShell {
|
||||||
|
# Use the same mkShell as documented above
|
||||||
|
};
|
||||||
|
};
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
Loading…
Reference in New Issue