VSC extension: nrf-connect.nrfutil.home how should be used?

Hi,

i am under Windows 11 using the latest VS code extension (2025.4.106).

How should i use https://docs.nordicsemi.com/bundle/nrf-connect-vscode/page/reference/settings.html#nrf-connectnrfutilhome ?

Suppose that i have a folder "tools/nrfutil" where i locally installed nrfutil.exe and .nrfuitl folder (as described here https://docs.nordicsemi.com/bundle/nrfutil/page/guides/installing.html#installation-locations).  I don'T want to add nrfutil folder in system path. I would have for each project-repo  its own nrfutil instance and subcommands.

I am expeting if i set in the .workspace file the path to my tools/nrfutil/.nrfutil folder (e.g."nrf-connect.nrfutil.home": "tools/nrfutil/.nrfutil") the Extension  uses it for searching the nrfutil device command.

Insetad when fleshing using Extension GUI BUTTON  it says that nrfutil is not found: "FATAL ERROR: required program nrfutil not found; install it or add its location to PATH"

Am i missing something?

Thank you,

Alessandro

Below the report genereted by vs code extension:

// IMPORTANT: The following data can contain sensitive or confidential information about your environment.
// If you do not want others to see this information, make sure to remove it before sharing the data.

// For help and support, visit Nordic Semiconductor's DevZone at devzone.nordicsemi.com/.

{
  "platform": {
    "os": "win32",
    "osVersion": "Windows 11 Pro",
    "osKernel": "10.0.26100",
    "vscode": "1.100.2",
    "electron": "34.5.1",
    "node": "v20.19.0"
  },
  "system": {
    "date": "2025-05-21T15:41:17.177Z",
    "vscodeRoot": "c:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Microsoft VS Code\\resources\\app",
    "nrfConnectForDesktopInstalled": true,
    "vscodeUptime": "00:01:30",
    "osUptime": "00:02:17",
    "cpu": "Intel(R) Core(TM) Ultra 9 285K"
  },
  "workspace": {
    "name": "fw-rain-nrf-connect-sdk (Workspace)",
    "workspaceFile": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\fw-rain-nrf-connect-sdk.code-workspace",
    "folders": [
      "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk"
    ]
  },
  "sdks": [
    {
      "version": "v3.0.1",
      "path": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk"
    },
    {
      "version": "v2.8.0",
      "path": "d:\\DriveDrop\\fw-drivedrop-drop-nrfc-sdk"
    }
  ],
  "activeBuild": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\apps\\console_app\\build_nrf21540dk\\console_app",
  "apps": [
    {
      "workspace": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk",
      "uri": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\apps\\console_app",
      "buildConfigurations": [
        {
          "id": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\apps\\console_app\\build_nrf21540dk",
          "name": "build_nrf21540dk",
          "boardId": "nrf21540dk/nrf52840",
          "type": "Sysbuild",
          "isChild": false,
          "isStale": false,
          "taskBindings": {
            "build": [],
            "pristineBuild": [],
            "flash": [],
            "eraseAndFlash": []
          },
          "sdk": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk",
          "toolchain": "nRF Connect SDK Toolchain v3.0.1"
        }
      ]
    }
  ],
  "toolchains": [
    {
      "version": "3.0.1",
      "path": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b"
    },
    {
      "version": "3.0.0",
      "path": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b"
    }
  ],
  "connectedDevices": [
    {
      "serialNumber": "000683885350",
      "boardVersion": "PCA10056",
      "deviceFamily": "NRF52_FAMILY",
      "deviceVersion": "NRF52840_xxAA_REV3",
      "jlinkObFirmwareVersion": "J-Link OB-SAM3U128-V2-NordicSemi compiled Oct  9 2024 11:00:56",
      "protectionStatus": "NRFDL_PROTECTION_STATUS_NONE",
      "protectionStatusCore": "NRFDL_DEVICE_CORE_APPLICATION"
    }
  ],
  "tools": {
    "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\zephyr-sdk\\arm-zephyr-eabi\\bin\\arm-zephyr-eabi-gcc.exe": "0.17.0",
    "C:\\Program Files\\SEGGER\\JLink_V818\\JLink.exe": "8.18",
    "C:\\Program Files\\Nordic Semiconductor\\nrf-command-line-tools\\bin\\nrfjprog.exe": "10.24.2",
    "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\cmake": "3.21.0",
    "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin\\Scripts\\west.exe": "1.2.0",
    "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin\\python.exe": "3.12.4",
    "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin\\ninja.exe": "1.10.2",
    "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin\\gperf.exe": "3.1",
    "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin\\dtc.exe": "1.4.7",
    "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin\\gn.exe": "2223",
    "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\mingw64\\bin\\git.exe": "2.37.3.windows.1",
    "arm-gdbPath": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\zephyr-sdk\\arm-zephyr-eabi\\bin\\arm-zephyr-eabi-gdb.exe",
    "riscv-gdbPath": "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\zephyr-sdk\\riscv64-zephyr-elf\\bin\\riscv64-zephyr-elf-gdb.exe"
  },
  "nrfutil": {
    "nrfutil-device": {
      "version": "2.11.0",
      "binPath": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\tools\\nrfutil\\.nrfutil\\bin\\nrfutil-device",
      "jlinkInfo": {
        "name": "JlinkARM",
        "version": "JLink_V8.18",
        "versionFormat": "string"
      }
    },
    "nrfutil-sdk-manager": {
      "version": "1.3.0",
      "binPath": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\tools\\nrfutil\\.nrfutil\\bin\\nrfutil-sdk-manager"
    }
  },
  "environment": {
    "westEnv": {
      "HOME": "C:\\Users\\AlessandroLongobardi",
      "HOMEDRIVE": "C:",
      "HOMEPATH": "\\Users\\AlessandroLongobardi",
      "PATH": "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b;D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\mingw64\\bin;D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\bin;D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin;D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin\\Scripts;D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\nanopb\\generator-bin;D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\zephyr-sdk\\arm-zephyr-eabi\\bin;D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\zephyr-sdk\\riscv64-zephyr-elf\\bin;d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\tools\\nrfutil\\.nrfutil\\lib\\nrfutil-sdk-manager;C:\\Windows\\system32;C:\\Windows;C:\\Windows\\System32\\Wbem;C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\;C:\\Windows\\System32\\OpenSSH\\;C:\\Program Files (x86)\\NVIDIA Corporation\\PhysX\\Common;C:\\Program Files\\dotnet\\;C:\\Program Files\\Git\\cmd;C:\\Program Files\\TortoiseGit\\bin;C:\\Program Files\\Nordic Semiconductor\\nrf-command-line-tools\\bin\\;C:\\Program Files\\NVIDIA Corporation\\NVIDIA App\\NvDLISR;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Python\\Python313\\Scripts\\;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Python\\Python313\\;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Python\\Launcher\\;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Microsoft\\WindowsApps;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Microsoft VS Code\\bin;C:\\Program Files\\Git\\usr\\bin;",
      "ZEPHYR_BASE": "d:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\deps\\zephyr",
      "ZEPHYR_TOOLCHAIN_VARIANT": "zephyr",
      "ZEPHYR_SDK_INSTALL_DIR": "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\zephyr-sdk",
      "PYTHONPATH": "D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin;D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin\\Lib;D:\\RAIN\\fw-rain-gamma_ld-nrfc-sdk\\toolchain\\toolchains\\0b393f9e1b\\opt\\bin\\Lib\\site-packages"
    },
    "inherited": {
      "HOME": "C:\\Users\\AlessandroLongobardi",
      "HOMEDRIVE": "C:",
      "HOMEPATH": "\\Users\\AlessandroLongobardi",
      "Path": "C:\\Windows\\system32;C:\\Windows;C:\\Windows\\System32\\Wbem;C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\;C:\\Windows\\System32\\OpenSSH\\;C:\\Program Files (x86)\\NVIDIA Corporation\\PhysX\\Common;C:\\Program Files\\dotnet\\;C:\\Program Files\\Git\\cmd;C:\\Program Files\\TortoiseGit\\bin;C:\\Program Files\\Nordic Semiconductor\\nrf-command-line-tools\\bin\\;C:\\Program Files\\NVIDIA Corporation\\NVIDIA App\\NvDLISR;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Python\\Python313\\Scripts\\;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Python\\Python313\\;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Python\\Launcher\\;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Microsoft\\WindowsApps;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Microsoft VS Code\\bin;C:\\Program Files\\Git\\usr\\bin;",
      "PATH": "C:\\Windows\\system32;C:\\Windows;C:\\Windows\\System32\\Wbem;C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\;C:\\Windows\\System32\\OpenSSH\\;C:\\Program Files (x86)\\NVIDIA Corporation\\PhysX\\Common;C:\\Program Files\\dotnet\\;C:\\Program Files\\Git\\cmd;C:\\Program Files\\TortoiseGit\\bin;C:\\Program Files\\Nordic Semiconductor\\nrf-command-line-tools\\bin\\;C:\\Program Files\\NVIDIA Corporation\\NVIDIA App\\NvDLISR;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Python\\Python313\\Scripts\\;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Python\\Python313\\;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Python\\Launcher\\;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Microsoft\\WindowsApps;C:\\Users\\AlessandroLongobardi\\AppData\\Local\\Programs\\Microsoft VS Code\\bin;C:\\Program Files\\Git\\usr\\bin;"
    }
  },
  "terminal": {
    "defaultProfile": null
  },
  "config": {
    "nordic-semiconductor.nrf-connect": {
      "topdir": "",
      "toolchain": {
        "path": ""
      },
      "ozonePath": "",
      "applications": [
        "${workspaceFolder}\\apps\\console_app",
        "${workspaceFolder}\\apps\\slave_app",
        "${workspaceFolder}\\apps\\master_app"
      ],
      "applicationOptions": {},
      "kconfig": {
        "interface": "kconfig"
      },
      "west": {
        "env": {
          "$base": "terminal"
        }
      },
      "boardRoots": [],
      "taskBindings": {},
      "buildTerminal": {
        "condensedProgress": true
      },
      "debugging": {
        "flash": true,
        "bindings": {},
        "justMyCode": false
      },
      "activeAppFollowActiveEditor": true,
      "flash": {
        "softreset": false,
        "erase": false,
        "recover": false
      },
      "enableTelemetry": true,
      "thirdpartyIntegration": {},
      "toolchainManager": {
        "indexURL": null,
        "installDirectory": "toolchain/"
      },
      "nrfutil": {
        "home": "tools/nrfutil/.nrfutil"
      },
      "defaultOpenAction": "ask",
      "terminalProfile": {
        "shell": null
      }
    },
    "nordic-semiconductor.nrf-terminal": {
      "terminalMode": "character"
    }
  },
  "extensions": {
    "internal": {
      "nordic-semiconductor.nrf-connect": {
        "version": "2025.5.92",
        "path": "c:\\Users\\AlessandroLongobardi\\.vscode\\extensions\\nordic-semiconductor.nrf-connect-2025.5.92-win32-x64",
        "isActive": true
      },
      "nordic-semiconductor.nrf-terminal": {
        "version": "2024.9.14",
        "path": "c:\\Users\\AlessandroLongobardi\\.vscode\\extensions\\nordic-semiconductor.nrf-terminal-2024.9.14",
        "isActive": true
      },
      "nordic-semiconductor.nrf-devicetree": {
        "version": "2025.4.22",
        "path": "c:\\Users\\AlessandroLongobardi\\.vscode\\extensions\\nordic-semiconductor.nrf-devicetree-2025.4.22",
        "isActive": true
      },
      "nordic-semiconductor.nrf-kconfig": {
        "version": "2025.4.26",
        "path": "c:\\Users\\AlessandroLongobardi\\.vscode\\extensions\\nordic-semiconductor.nrf-kconfig-2025.4.26",
        "isActive": true
      }
    },
    "external": {
      "marus25.cortex-debug": null,
      "ms-vscode.cpptools": "1.25.3",
      "ms-vscode.js-debug": "1.100.1",
      "ms-vscode.js-debug-companion": "1.1.3",
      "ms-vscode.vscode-js-profile-table": "1.0.10",
      "espressif.esp-idf-extension": "1.9.1",
      "GitHub.copilot": "1.322.0",
      "GitHub.copilot-chat": "0.27.1",
      "Gruntfuggly.todo-tree": "0.0.226",
      "josetr.cmake-language-support-vscode": "0.0.9",
      "mechatroner.rainbow-csv": "3.19.0",
      "ms-dotnettools.vscode-dotnet-runtime": "2.3.3",
      "ms-python.debugpy": "2025.8.0",
      "ms-python.python": "2025.6.1",
      "ms-python.vscode-pylance": "2025.5.1",
      "ms-vscode.cpptools-extension-pack": "1.3.1",
      "ms-vscode.cpptools-themes": "2.0.0",
      "ms-vscode.powershell": "2025.0.0",
      "trond-snekvik.gnu-mapfiles": "1.1.0",
      "twxs.cmake": "0.0.17"
    }
  }
}


Parents
  • Hi Alessandro,

    Please note that you can upload files to the ticket using Insert->Image->Video->File.

    I am expeting if i set in the .workspace file the path to my tools/nrfutil/.nrfutil folder (e.g."nrf-connect.nrfutil.home": "tools/nrfutil/.nrfutil") the Extension  uses it for searching the nrfutil device command.

    Can you show how you created workspace file? Can you show how you set mentioned path in the workspace file?

    Insetad when fleshing using Extension GUI BUTTON  it says that nrfutil is not found: "FATAL ERROR: required program nrfutil not found; install it or add its location to PATH"

    Can you show this error?

    Best regards,
    Dejan

  • I attahced the entire folder used as workspace.

    1.  double click on .code-workspace files. This will open VS code with settings set in .code-workspace. You can find that file the mentioned  nrf-connect.nrfutil.home setting
    2.  Create  a new power shell terminal(Terminal->New Terminal) (NOT in nrf connect Shell Terminal)
    3.  launch ./setup_nrf_connect.ps1: this will install both toolchain and sdk locally, using nrfutil in tools/nrfutil/nrfutil.exe
    4.  close vs code
    5.  re-open code-workspace 
    6. Open nrf connect extenion: build and run hello word application bundeld in subfolder apps/. Then click on flash button and error will happen. The Build configuration should find the sdk and the toochain locally installed.

    Remember to remove from the environment variables the path to system nrfutil. I want to use the one in tools/nrfutil.

    Thanks,

    Alessandro

    tfw-rain-gamma_ld-nrfc-sdk.zip

  • Hi Alessandro,

    I have reproduced described behavior.
    Currently, nRFUtil must be in the user path to be found by the SDK's build system. You can always use full path to your locally installed nrfutil when flashing from VS Code terminal. Alternatively, you can look at binding custom tasks to actions.

    Best regards,
    Dejan

Reply Children
No Data
Related