Go to file
adisbladis 2f1680b11b Add MacOS to github testing matrix 2024-02-09 12:40:53 +13:00
.github/workflows Add MacOS to github testing matrix 2024-02-09 12:40:53 +13:00
README.md Add setup hook to setup ZEPHYR_SDK_INSTALL_DIR 2024-02-07 14:45:39 +13:00
default.nix Add setup hook to setup ZEPHYR_SDK_INSTALL_DIR 2024-02-07 14:45:39 +13:00
flake.lock Initial 2024-02-06 16:48:31 +13:00
flake.nix Add packages to flake checks 2024-02-09 12:38:40 +13:00
python.nix Add compat hacks, make python version constraints a warning 2024-02-06 19:42:29 +13:00
sdk.json Initial 2024-02-06 16:48:31 +13:00
update-sdk Initial 2024-02-06 16:48:31 +13:00

README.md

zephyr-nix

Develop Zephyr projects using Nix

Features

  • SDK packaging

    • sdk

    The minimal SDK. Can be overriden with additional targets.

    sdk.override {
      targets = [
        "arm-zephyr-eabi"
      ];
    }
    
    • sdkFull

    SDK with all targets enabled.

  • Host tools packaging

    • hosttools

    Binary hosttools from the Zephyr SDK. Because of libc incompatibilities not all binaries in this derivation actually works.

    • hosttools-nix

    A re-packaging of the Zephyr SDK hosttools using nixpkgs packages.

Basic usage

  • shell.nix
{ mkShell
, zephyr
, callPackage
, cmake
, ninja
, lib
}:

mkShell {
  packages = [
    (zephyr.sdk.override {
      targets = [
        "arm-zephyr-eabi"
      ];
    })
    zephyr.pythonEnv
    # Use zephyr.hosttools-nix to use nixpkgs built tooling instead of official Zephyr binaries
    zephyr.hosttools
    cmake
    ninja
  ];

}

Flakes usage

  • flake.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
    };
  };
}