Add Thinkpad NXP1001 NFC support using libnfc-nci and PC/SC (#379118)

nixos/doc/manual/release-notes/rl-2505.section.md

···
 
 - [waagent](https://github.com/Azure/WALinuxAgent), the Microsoft Azure Linux Agent (waagent) manages Linux provisioning and VM interaction with the Azure Fabric Controller. Available with [services.waagent](options.html#opt-services.waagent.enable).
 
+- [nfc-nci](https://github.com/StarGate01/ifdnfc-nci), an alternative NFC stack and PC/SC driver for the NXP PN54x chipset, commonly found in Lenovo systems as NXP1001 (NPC300). Available as [hardware.nfc-nci](#opt-hardware.nfc-nci.enable).
+
 - [duckdns](https://www.duckdns.org), free dynamic DNS. Available with [services.duckdns](options.html#opt-services.duckdns.enable)
 
 - [nostr-rs-relay](https://git.sr.ht/~gheartsfield/nostr-rs-relay/), This is a nostr relay, written in Rust. Available as [services.nostr-rs-relay](options.html#opt-services.nostr-rs-relay.enable).

nixos/modules/hardware/nfc-nci.nix

···
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+
+let
+  cfg = config.hardware.nfc-nci;
+
+  # To understand these settings in more detail, refer to the upstream configuration templates
+  # available at https://github.com/NXPNFCLinux/linux_libnfc-nci/tree/master/conf .
+  # Settings in curly braces are NCI commands, the "NFC Controller Interface Specification"
+  # as well as the "NFC Digital Protocol Technical Specification" can be found online.
+  # These default settings have been specifically engineered for the Lenovo NXP1001 (NPC300) chipset.
+  defaultSettings = {
+    # This block will be emitted into /etc/libnfc-nci.conf
+    nci = {
+      # Set up general logging
+      APPL_TRACE_LEVEL = "0x01";
+      PROTOCOL_TRACE_LEVEL = "0x01";
+      # Set up which NFC technologies are enabled (due to e.g. local regulation or patent law)
+      HOST_LISTEN_TECH_MASK = "0x07";
+      POLLING_TECH_MASK = "0xEF";
+      P2P_LISTEN_TECH_MASK = "0xC5";
+    };
+    # This block will be emitted into /etc/libnfc-nxp-init.conf
+    init = {
+      # Setup logging of the individual userland library components
+      NXPLOG_GLOBAL_LOGLEVEL = "0x01";
+      NXPLOG_EXTNS_LOGLEVEL = "0x01";
+      NXPLOG_NCIHAL_LOGLEVEL = "0x01";
+      NXPLOG_NCIX_LOGLEVEL = "0x01";
+      NXPLOG_NCIR_LOGLEVEL = "0x01";
+      NXPLOG_FWDNLD_LOGLEVEL = "0x00";
+      NXPLOG_TML_LOGLEVEL = "0x01";
+      # Where to find the kernel device node
+      NXP_NFC_DEV_NODE = ''"/dev/pn544"'';
+      # Enable the NXP proprietary features of the chip
+      NXP_ACT_PROP_EXTN = "{2F, 02, 00}";
+      # Configure the NFC Forum profile:
+      # 0xA0 0x44: POLL_PROFILE_SEL_CFG = 0x00 (Use NFC Forum profile default configuration values. Specifically, not EMVCo.)
+      NXP_NFC_PROFILE_EXTN = ''
+        {20, 02, 05, 01,
+          A0, 44, 01, 00
+        }
+      '';
+      # Enable chip standby mode
+      NXP_CORE_STANDBY = "{2F, 00, 01, 01}";
+      # Enable NCI packet fragmentation on the I2C bus
+      NXP_I2C_FRAGMENTATION_ENABLED = "0x01";
+    };
+    # This block will be emitted into /etc/libnfc-nxp-pn547.conf as well as /etc/libnfc-nxp-pn548.conf
+    # Which file is actually used is decided by the library at runtime depending on chip variant, both files are required.
+    pn54x = {
+      # Enable Mifare Classic reader functionality
+      MIFARE_READER_ENABLE = "0x01";
+      # Configure clock source - use XTAL (hardware crystal) instead of PLL (synthetic clock)
+      NXP_SYS_CLK_SRC_SEL = "0x01";
+      NXP_SYS_CLK_FREQ_SEL = "0x00";
+      NXP_SYS_CLOCK_TO_CFG = "0x01";
+      # Configure the non-propriety NCI settings in EEPROM:
+      # 0x28: PN_NFC_DEP_SPEED = 0x00 (Data exchange: Highest Available Bit Rates)
+      # 0x21: PI_BIT_RATE = 0x00 (Maximum allowed bit rate: 106 Kbit/s)
+      # 0x30: LA_BIT_FRAME_SDD = 0x08 (Bit Frame SDD value to be sent in Byte 1 of SENS_RES)
+      # 0x31: LA_PLATFORM_CONFIG = 0x03 (Platform Configuration value to be sent in Byte 2 of SENS_RES)
+      # 0x33: LA_NFCID1 = [ 0x04 0x03 0x02 0x01 ] ("Unique" NFCID1 ID in SENS_RES)
+      # 0x54: LF_CON_BITR_F = 0x06 (Bit rates to listen for: Both)
+      # 0x50: LF_PROTOCOL_TYPE = 0x02 (Protocols supported in Listen Mode for NFC-F: NFC-DEP)
+      # 0x5B: LI_BIT_RATE = 0x00 (Maximum supported bit rate: 106 Kbit/s)
+      # 0x60: LN_WT = 0x0E (Waiting Time NFC-DEP WT_MAX default for Initiator)
+      # 0x80: RF_FIELD_INFO = 0x01 (Chip is allowed to emit RF Field Information Notifications)
+      # 0x81: RF_NFCEE_ACTION = 0x01 (Chip should send trigger notification for the default set of NFCEE actions)
+      # 0x82: NFCDEP_OP = 0x0E (NFC-DEP protocol behavior: Default flags, but also enable RTOX requests)
+      # 0x18: PF_BIT_RATE = 0x01 (NFC-F discovery polling initial bit rate: 106 Kbit/s)
+      NXP_CORE_CONF = ''
+        {20, 02, 2B, 0D,
+          28, 01, 00,
+          21, 01, 00,
+          30, 01, 08,
+          31, 01, 03,
+          33, 04, 04, 03, 02, 01,
+          54, 01, 06,
+          50, 01, 02,
+          5B, 01, 00,
+          60, 01, 0E,
+          80, 01, 01,
+          81, 01, 01,
+          82, 01, 0E,
+          18, 01, 01
+        }
+      '';
+      # Configure the proprietary NXP extension to the NCI standard in EEPROM:
+      # 0xA0 0x5E: JEWEL_RID_CFG = 0x01 (Enable sending RID to T1T on RF)
+      # 0xA0 0x40: TAG_DETECTOR_CFG = 0x00 (Tag detector: Disable both AGC based detection and trace mode)
+      # 0xA0 0x43: TAG_DETECTOR_FALLBACK_CNT_CFG = 0x00 (Tag detector: Disable hybrid mode, only use LPCD to initiate polling)
+      # 0xA0 0x0F: DH_EEPROM_AREA_1 = [ 32 bytes of opaque Lenovo data ] (Custom configuration for the Lenovo customized chip firmware)
+      # See also https://github.com/nfc-tools/libnfc/issues/455#issuecomment-2221979571
+      NXP_CORE_CONF_EXTN = ''
+        {20, 02, 30, 04,
+          A0, 5E, 01, 01,
+          A0, 40, 01, 00,
+          A0, 43, 01, 00,
+          A0, 0F, 20,
+          00, 03, 1D, 01, 03, 00, 02, 00,
+          01, 00, 01, 00, 00, 00, 00, 00,
+          00, 00, 00, 00, 00, 00, 00, 00,
+          00, 00, 00, 00, 00, 00, 00, 00
+        }
+      '';
+      # Firmware-specific protocol configuration parameters (one byte per protocol)
+      NXP_NFC_PROPRIETARY_CFG = "{05:FF:FF:06:81:80:70:FF:FF}";
+      # Configure power supply of chip, use Lenovo driver configuration, which deviates a bit from the spec:
+      # 0xA0 0x0E: PMU_CFG = [ 0x16, 0x09, 0x00 ] (VBAT1 connected to 5V, TVDD monitoring: 3.6V, TxLDO Voltage in reader and card mode: 3.3V)
+      NXP_EXT_TVDD_CFG = "0x01";
+      NXP_EXT_TVDD_CFG_1 = ''
+        {20, 02, 07, 01,
+          A0, 0E, 03, 16, 09, 00
+        }
+      '';
+      # Use the default for NFA_EE_MAX_EE_SUPPORTED stack size (concerns HCI)
+      NXP_NFC_MAX_EE_SUPPORTED = "0x00";
+    };
+  };
+
+  generateSettings =
+    cfgName:
+    let
+      toKeyValueLines =
+        obj: builtins.concatStringsSep "\n" (map (key: "${key}=${obj.${key}}") (builtins.attrNames obj));
+    in
+    toKeyValueLines (defaultSettings.${cfgName} // (cfg.settings.${cfgName} or { }));
+in
+{
+  options.hardware.nfc-nci = {
+    enable = lib.mkEnableOption "PN5xx kernel module with udev rules, libnfc-nci userland, and optional ifdnfc-nci PC/SC driver";
+
+    settings = lib.mkOption {
+      default = defaultSettings;
+      description = ''
+        Configuration to be written to the libncf-nci configuration files.
+        To understand the configuration format, refer to https://github.com/NXPNFCLinux/linux_libnfc-nci/tree/master/conf.
+      '';
+      type = lib.types.attrs;
+    };
+
+    enableIFD = lib.mkOption {
+      type = lib.types.bool;
+      default = true;
+      description = ''
+        Register ifdnfc-nci as a serial reader with pcscd.
+      '';
+    };
+  };
+
+  config = lib.mkIf cfg.enable {
+    environment.systemPackages =
+      [
+        pkgs.libnfc-nci
+      ]
+      ++ lib.optionals cfg.enableIFD [
+        pkgs.ifdnfc-nci
+      ];
+
+    environment.etc = {
+      "libnfc-nci.conf".text = generateSettings "nci";
+      "libnfc-nxp-init.conf".text = generateSettings "init";
+      "libnfc-nxp-pn547.conf".text = generateSettings "pn54x";
+      "libnfc-nxp-pn548.conf".text = generateSettings "pn54x";
+    };
+
+    services.udev.packages = [
+      config.boot.kernelPackages.nxp-pn5xx
+    ];
+
+    boot.blacklistedKernelModules = [
+      "nxp_nci_i2c"
+      "nxp_nci"
+    ];
+
+    boot.extraModulePackages = [
+      config.boot.kernelPackages.nxp-pn5xx
+    ];
+
+    boot.kernelModules = [
+      "nxp-pn5xx"
+    ];
+
+    services.pcscd.readerConfigs = lib.mkIf cfg.enableIFD [
+      ''
+        FRIENDLYNAME "NFC NCI"
+        LIBPATH      ${pkgs.ifdnfc-nci}/lib/libifdnfc-nci.so
+        CHANNELID    0
+      ''
+    ];
+
+    # NFC chip looses power when system goes to sleep / hibernate,
+    # and needs to be re-initialized upon wakeup
+    powerManagement.resumeCommands = lib.mkIf cfg.enableIFD ''
+      systemctl restart pcscd.service
+    '';
+  };
+
+  meta.maintainers = with lib.maintainers; [ stargate01 ];
+}

nixos/modules/module-list.nix

···
   ./hardware/network/eg25-manager.nix
   ./hardware/network/intel-2200bg.nix
   ./hardware/new-lg4ff.nix
+  ./hardware/nfc-nci.nix
   ./hardware/nitrokey.nix
   ./hardware/onlykey/default.nix
   ./hardware/openrazer.nix

nixos/modules/services/hardware/pcscd.nix

···
-{ config, lib, pkgs, ... }:
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
 let
   cfg = config.services.pcscd;
-  cfgFile = pkgs.writeText "reader.conf" config.services.pcscd.readerConfig;
+  cfgFile = pkgs.writeText "reader.conf" (
+    builtins.concatStringsSep "\n\n" config.services.pcscd.readerConfigs
+  );
 
-  package = if config.security.polkit.enable
-              then pkgs.pcscliteWithPolkit
-              else pkgs.pcsclite;
+  package = if config.security.polkit.enable then pkgs.pcscliteWithPolkit else pkgs.pcsclite;
 
   pluginEnv = pkgs.buildEnv {
     name = "pcscd-plugins";
···
 
 in
 {
+  imports = [
+    (lib.mkChangedOptionModule
+      [ "services" "pcscd" "readerConfig" ]
+      [ "services" "pcscd" "readerConfigs" ]
+      (
+        config:
+        let
+          readerConfig = lib.getAttrFromPath [ "services" "pcscd" "readerConfig" ] config;
+        in
+        [ readerConfig ]
+      )
+    )
+  ];
+
   options.services.pcscd = {
     enable = lib.mkEnableOption "PCSC-Lite daemon, to access smart cards using SCard API (PC/SC)";
 
···
       description = "Plugin packages to be used for PCSC-Lite.";
     };
 
-    readerConfig = lib.mkOption {
-      type = lib.types.lines;
-      default = "";
-      example = ''
-        FRIENDLYNAME      "Some serial reader"
-        DEVICENAME        /dev/ttyS0
-        LIBPATH           /path/to/serial_reader.so
-        CHANNELID         1
-      '';
+    readerConfigs = lib.mkOption {
+      type = lib.types.listOf lib.types.lines;
+      default = [ ];
+      example = [
+        ''
+          FRIENDLYNAME      "Some serial reader"
+          DEVICENAME        /dev/ttyS0
+          LIBPATH           /path/to/serial_reader.so
+          CHANNELID         1
+        ''
+      ];
       description = ''
         Configuration for devices that aren't hotpluggable.
 
···
       # around it, we force the path to the cfgFile.
       #
       # https://github.com/NixOS/nixpkgs/issues/121088
-      serviceConfig.ExecStart = [ "" "${lib.getExe package} -f -x -c ${cfgFile} ${lib.escapeShellArgs cfg.extraArgs}" ];
+      serviceConfig.ExecStart = [
+        ""
+        "${lib.getExe package} -f -x -c ${cfgFile} ${lib.escapeShellArgs cfg.extraArgs}"
+      ];
     };
   };
 }

pkgs/by-name/if/ifdnfc-nci/package.nix

···
+{
+  lib,
+  stdenv,
+  fetchFromGitHub,
+  pkg-config,
+  cmake,
+  pcsclite,
+  libnfc-nci,
+}:
+
+stdenv.mkDerivation (finalAttrs: {
+  pname = "ifdnfc-nci";
+  version = "0.2.1";
+
+  src = fetchFromGitHub {
+    owner = "StarGate01";
+    repo = "ifdnfc-nci";
+    tag = "v${finalAttrs.version}";
+    sha256 = "sha256-I2MNzmaxQUh4bN3Uytf2bQRthByEaFWM7c79CKZJQZA=";
+  };
+
+  nativeBuildInputs = [
+    cmake
+    pkg-config
+  ];
+
+  buildInputs = [
+    pcsclite
+    libnfc-nci
+  ];
+
+  meta = {
+    description = "PC/SC IFD Handler based on linux_libnfc-nci";
+    homepage = "https://github.com/StarGate01/ifdnfc-nci";
+    license = lib.licenses.gpl3Only;
+    platforms = lib.platforms.linux;
+    maintainers = with lib.maintainers; [ stargate01 ];
+  };
+})

pkgs/by-name/li/libnfc-nci/package.nix

···
+{
+  lib,
+  stdenv,
+  fetchFromGitHub,
+  autoreconfHook,
+  pkg-config,
+  config,
+  debug ? config.libnfc-nci.debug or false,
+}:
+
+stdenv.mkDerivation (finalAttrs: {
+  pname = "libnfc-nci";
+  version = "2.4.1-unstable-2024-08-05";
+
+  src = fetchFromGitHub {
+    owner = "StarGate01";
+    repo = "linux_libnfc-nci";
+    rev = "7ce9c8aad0e37850a49b6d8dcc22ae5c783268e7";
+    sha256 = "sha256-iSvDiae+A2hUok426Lj5TMn3Q9G+vH1G0jajP48PehQ=";
+  };
+
+  buildInputs = [
+    pkg-config
+    autoreconfHook
+  ];
+
+  configureFlags =
+    [
+      "--enable-i2c"
+    ]
+    ++ lib.optionals debug [
+      "--enable-debug"
+    ];
+  dontStrip = debug;
+
+  postInstall = ''
+    rm -rf $out/etc
+  '';
+
+  meta = {
+    description = "Linux NFC stack for NCI based NXP NFC Controllers";
+    homepage = "https://github.com/NXPNFCLinux/linux_libnfc-nci";
+    license = lib.licenses.asl20;
+    maintainers = with lib.maintainers; [ stargate01 ];
+    platforms = lib.platforms.linux;
+  };
+})

pkgs/os-specific/linux/nxp-pn5xx/default.nix

···
+{
+  lib,
+  stdenv,
+  fetchFromGitHub,
+  kernel,
+  kernelModuleMakeFlags,
+}:
+
+stdenv.mkDerivation (finalAttrs: {
+  pname = "nxp-pn5xx";
+  version = "0.4-unstable-2025-02-08-${kernel.version}";
+
+  src = fetchFromGitHub {
+    owner = "jr64";
+    repo = "nxp-pn5xx";
+    rev = "07411e0ce3445e7dcb970df1837f0ad74b7b0a7a";
+    hash = "sha256-jVkcvURFlihKW2vFvAaqzKdtexPXywRa2LkPkIhmdeU=";
+  };
+
+  nativeBuildInputs = kernel.moduleBuildDependencies;
+
+  makeFlags = kernelModuleMakeFlags ++ [
+    "KERNELRELEASE=${kernel.modDirVersion}"
+    "BUILD_KERNEL_PATH=${kernel.dev}/lib/modules/${kernel.modDirVersion}/build"
+    "INSTALL_MOD_PATH=$(out)/lib/modules/${kernel.modDirVersion}"
+  ];
+
+  postInstall = ''
+    mkdir -p $out/etc/udev/rules.d
+    echo 'SUBSYSTEM=="misc", KERNEL=="pn544", MODE="0666", GROUP="dialout"' > $out/etc/udev/rules.d/99-nxp-pn5xx.rules
+  '';
+
+  meta = {
+    description = "NXP's NFC Open Source Kernel mode driver with ACPI configuration support";
+    homepage = "https://github.com/jr64/nxp-pn5xx";
+    license = lib.licenses.gpl2Only;
+    maintainers = with lib.maintainers; [ stargate01 ];
+    platforms = lib.platforms.linux;
+  };
+})

pkgs/top-level/linux-kernels.nix

···
     nvidia_x11_stable_open       = nvidiaPackages.stable.open;
     nvidia_x11_vulkan_beta_open  = nvidiaPackages.vulkan_beta.open;
 
+    nxp-pn5xx = callPackage ../os-specific/linux/nxp-pn5xx { };
+
     openrazer = callPackage ../os-specific/linux/openrazer/driver.nix { };
 
     ply = callPackage ../os-specific/linux/ply { };