System Prerequisites and Dependencies
Establishing a stable build environment for Nordic Connect SDK (NCS) version 3.1.0 requires several core utilities. Ensure your workstation runs Windows 10 or later before acquiring the following software packages:
- Editor: Visual Studio Code (latest stable build)
- Device Management: nRF Connect for Desktop application
- Command-Line Interface: nRFutil.exe, nrf Command-Line Tools, Git
- Runtime: Python 3.x distribution
- Version Control: West module installed via pip
- Hardware Debugger: J-Link adapter drivers
Refer to the official Nordic documentation repository for the most recent installer binaries.
Manual Environment Setup via CLI
The preferred method for managing SDK versions involves the nrfutil command-line interface. This approach offers granular control over component versions and installation paths.
Phase 1: Utility Initialization
Begin by verifying the integrity of the package manager.
# Update the nrfutil manager to the latest revision
nrfutil self-upgrade
Phase 2: Module Deployment
Install the critical handler modules required for SDK lifecycle management and device interaction.
# Deploy the toolchain and SDK managers
nrfutil install toolchain-manager
nrfutil install sdk-manager
nrfutil upgrade sdk-manager
# Enable device programming capabilities
nrfutil install device
nrfutil upgrade device
Phase 3: Path Configuration
Define custom storage locations to avoid conflicts with default directories. Utilizing variables simplifies future path adjustments.
# Define target installation root
$WorkDir = "E:\Firmware\NCS\v3.1.0"
# Bind the toolchain to the defined directory
nrfutil toolchain-manager config --set install-dir="$WorkDir"
# Confirm active toolchain settings
nrfutil toolchain-manager config --show
# Assign the SDK root path
nrfutil sdk-manager config install-dir set "$WorkDir"
Phase 4: Asset Retrieval
Pull the specific binary artifacts corresponding to the v3.1.0 release.
# Fetch the compiler chain
nrfutil toolchain-manager install --ncs-version v3.1.0
# Download the SDK framework
nrfutil sdk-manager install v3.1.0
Visual Studio Code Integration
To leverage Nordics' development tools within the IDE, perform the following setup:
- Initialize Visual Studio Code with administrator privileges.
- Select the Extensions view and locate the official Nordic plugin suite.
- Trigger the installation sequence for the Nordic SDK support bundle.
- Observe the Output window; a completion notification indicates successful binding.
Configuration Troubleshooting
Activating Internal Low-Frequency Clock
When external 32.768kHz crystals are absent, modify the kernel configuration to utilize the internal RC oscillator.
/* Application Kconfig Overrides */
CONFIG_CLOCK_CONTROL_NRF_K32SRC_RC=y
CONFIG_CLOCK_CONTROL_NRF_K32SRC_XTAL=n
CONFIG_CLOCK_CONTROL_NRF_K32SRC_250PPM=y
An alternative method involves disabling the hardware node in the overlay file:
/* Device Tree Overlay */
&lfxo {
status = "disabled";
};
Flashing nRF54 Series Products
Newer 54-series microcontrollers utilize nrfutil for firmware deployment instead of traditional serial programmers.
- Include the
nrfutil.exebinary in your system PATH. - Validate the connected debug probe via terminal:
nrfutil --device
Consult the nRFutil documentation for advanced payload formatting options specific to the second-generation architecture.