Joakim Repomaa
4a7aabb0f3
- Add complete config.txt settings with u-boot boot lines + spi=on - Override sdImage.populateFirmwareCommands to use configtxt module output - Mount firmware partition and add activation script to sync config.txt - Load spi_bcm2835 and bcm2835_gpiomem kernel modules - Add udev rule for gpiomem subsystem (not just gpio) - Relax ProtectKernelTunables so service can access GPIO - Update turny flake input to rppal-based CS pin fix
24 lines
1.3 KiB
Markdown
24 lines
1.3 KiB
Markdown
# Agent Guidelines for NixOS Configuration
|
|
|
|
## Build & Deploy Commands
|
|
- `nix flake check` - Validate flake configuration
|
|
- `build <host>` - Build configuration for specific host (e.g., `build radish`)
|
|
- `apply <host>` - Deploy to remote host via colmena
|
|
- `apply-local` - Apply configuration locally using nh
|
|
- `nix build .#nixosConfigurations.<host>.config.system.build.toplevel` - Build specific host
|
|
|
|
## Code Style
|
|
- **Format**: Use `nixfmt` for all .nix files
|
|
- **Imports**: List imports first, group by: local modules, external inputs (inputs.*)
|
|
- **Function args**: Multi-line with trailing comma when >3 args: `{ config, lib, pkgs, ... }:`
|
|
- **Options**: Define in `options.<service>` block, implement in `config = lib.mkIf cfg.enable { ... }`
|
|
- **Types**: Use `lib.types.*` for option types (str, bool, int, etc.)
|
|
- **String interpolation**: Use `"${}"` for Nix expressions, prefer lib.getExe for binaries
|
|
- **Conditionals**: Use `lib.mkIf`, `lib.mkDefault`, `lib.mkMerge` for NixOS options
|
|
|
|
## Structure
|
|
- Host configs in `hosts/<name>/` with configuration.nix, default.nix, hardware-configuration.nix
|
|
- Reusable modules in `modules/` and `modules/services/`
|
|
- Custom packages in `custom-pkgs/` using util.package pattern
|
|
- Secrets managed via agenix in `secrets/` directory
|