@nordicsemiconductor/pc-nrfconnect-shared 187.0.0 → 189.0.0

package/Changelog.md

@@ -7,6 +7,31 @@ This project does _not_ adhere to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html) but contrary to it
 every new version is a new major version.
 
+## 189.0.0 - 2024-10-18
+
+### Added
+
+-   Dropdown helper functions which are used in `pc-nrfconnect-serial-terminal`
+    and `pc-nrfconnect-programmer`.
+-   Add nrfutil mcu-state-options for multi target support.
+
+### Steps to upgrade when using this package
+
+-   Minimum support version of nrfutil device is now 2.5.0
+
+## 188.0.0 - 2024-10-15
+
+### Changed
+
+-   Update JLink macOS install link pointing from `V794e` to `V794i`.
+-   Update `@xterm/headless`, `electron`, `serialport`, `applicationinsights`
+    dependencies.
+
+### Steps to upgrade when using this package
+
+-   Update imports of the `Terminal` from `xterm-headless` to `@xterm/headless`
+    if applicable.
+
 ## 187.0.0 - 2024-10-04
 
 ### Fixed

package/nrfutil/device/deviceInfo.ts

@@ -41,11 +41,23 @@ export interface DfuTriggerVersion {
     semVer: string;
 }
 
+export interface McuStateOption {
+    arguments?: {
+        target: string;
+    };
+    description: string;
+    name: string;
+    type: 'Programming' | 'Application';
+    value: 'NRFDL_MCU_STATE_PROGRAMMING';
+}
+
 export interface DeviceInfo {
     hwInfo?: HwInfo;
     jlink?: JLinkDeviceInfo;
     dfuTriggerVersion?: DfuTriggerVersion;
     dfuTriggerInfo?: DfuTriggerInfo;
+    mcuStateOptions?: McuStateOption[];
+    supportedOptions?: string[];
 }
 
 export interface DeviceInfoRaw {
@@ -60,7 +72,9 @@ export default async (
     controller?: AbortController
 ) => {
     try {
-        return device.traits.jlink || device.traits.nordicDfu
+        return device.traits.jlink ||
+            device.traits.nordicDfu ||
+            device.traits.mcuBoot
             ? (
                   await deviceSingleTaskEndOperation<DeviceInfoRaw>(
                       device,

package/nrfutil/device/logLibVersions.ts

@@ -108,7 +108,7 @@ export default async (moduleVersion: ModuleVersion) => {
                     `It looks like you have installed JLink using ${JLinkInstallerVersion}, but currently we only support their Universal Installer for your system.`
                 );
                 logger?.warn(
-                    `Please install JLink: https://www.segger.com/downloads/jlink/JLink_MacOSX_V794e_universal.pkg`
+                    `Please install JLink: https://www.segger.com/downloads/jlink/JLink_MacOSX_V794i_universal.pkg`
                 );
             }
         }

package/nrfutil/device/program.ts

@@ -35,6 +35,7 @@ export interface JLinkProgrammingOptions {
 export interface McuBootProgrammingOptions {
     mcuEndState?: 'NRFDL_MCU_STATE_APPLICATION' | 'NRFDL_MCU_STATE_PROGRAMMING';
     netCoreUploadDelay?: number;
+    target?: string;
 }
 
 export interface NordicDfuProgrammingOptions {
@@ -91,6 +92,7 @@ export const programmingOptionsToArgs = (options?: ProgrammingOptions) => {
                     options.netCoreUploadDelay
                 )}`
             );
+        if (options.target) args.push(`target=${options.target}`);
     } else if (isNordicDfuProgrammingOptions(options)) {
         if (options.mcuEndState)
             args.push(`mcu_end_state=${options.mcuEndState}`);

package/nrfutil/device/setMcuState.ts

@@ -13,12 +13,13 @@ export default (
     device: NrfutilDevice,
     state: McuState,
     onProgress?: (progress: Progress) => void,
-    controller?: AbortController
+    controller?: AbortController,
+    target?: string
 ) =>
     deviceSingleTaskEndOperationVoid(
         device,
         'mcu-state-set',
         onProgress,
         controller,
-        [state]
+        [state, target ? `--target=${target}` : '']
     );

package/nrfutil/moduleVersion.ts

@@ -92,7 +92,7 @@ const versionFromPackageJson = (module: string) =>
     packageJsonApp().nrfConnectForDesktop.nrfutil?.[module][0];
 
 const failToDetermineVersion = (module: string) => {
-    throw new Error(`No version specified for nrfutil-${module}`);
+    throw new Error(`No version specified for the bundled nrfutil ${module}`);
 };
 
 export const versionToInstall = (module: string, version?: string) =>

package/nrfutil/modules.ts

@@ -21,7 +21,7 @@ const logModuleVersions = (module: string, moduleSandbox: NrfutilSandbox) => {
     } else {
         moduleSandbox.getModuleVersion().then(moduleVersion => {
             getNrfutilLogger()?.info(
-                `Using ${module} version: ${describeVersion(
+                `Using the bundled nrfutil ${module} version: ${describeVersion(
                     moduleVersion.version
                 )}`
             );
@@ -30,7 +30,7 @@ const logModuleVersions = (module: string, moduleSandbox: NrfutilSandbox) => {
 
     moduleSandbox.getCoreVersion().then(moduleVersion => {
         getNrfutilLogger()?.info(
-            `Using nrfutil-${module} core version: ${describeVersion(
+            `Using the bundled core version for nrfutil ${module}: ${describeVersion(
                 moduleVersion.version
             )}`
         );
@@ -78,7 +78,7 @@ const getModuleSandbox = (module: string) => {
     let promiseModuleSandbox: Promise<NrfutilSandbox> | undefined;
 
     const createModuleSandbox = async () => {
-        getNrfutilLogger()?.info(`Initialising nrfutil module: ${module}`);
+        getNrfutilLogger()?.info(`Initialising the bundled nrfutil ${module}`);
         promiseModuleSandbox = sandbox(
             getUserDataDir(),
             module,

package/nrfutil/sandbox.ts

@@ -207,7 +207,7 @@ export class NrfutilSandbox {
                 onProgress
             );
             getNrfutilLogger()?.info(
-                `Successfully installed nrfutil-${this.module} version ${this.version}`
+                `Successfully installed nrfutil ${this.module} version: ${this.version}`
             );
         } catch (error) {
             if (this.env.NRFUTIL_HOME && fs.existsSync(this.env.NRFUTIL_HOME)) {
@@ -218,7 +218,7 @@ export class NrfutilSandbox {
             }
 
             getNrfutilLogger()?.error(
-                `Error while installing nrfutil-${this.module} version: ${
+                `Error while installing nrfutil ${this.module} version: ${
                     this.version
                 }. describeError: ${describeError(error)}`
             );
@@ -233,7 +233,9 @@ export class NrfutilSandbox {
             await this.spawnNrfutil('self-upgrade', [], onProgress);
         } catch (error) {
             // User might not have internet hance fail silently
-            getNrfutilLogger()?.error(`Error while updated nrfutil core`);
+            getNrfutilLogger()?.error(
+                `Error while updating the bundled core for nrfutil ${this.module}.`
+            );
         }
     };
 
@@ -574,7 +576,7 @@ export class NrfutilSandbox {
 
             const listener = () => {
                 getNrfutilLogger()?.info(
-                    `Aborting ongoing nrfutil ${
+                    `Aborting the ongoing command nrfutil ${
                         this.module
                     } ${command} ${JSON.stringify(args)}`
                 );

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nordicsemiconductor/pc-nrfconnect-shared",
-    "version": "187.0.0",
+    "version": "189.0.0",
     "description": "Shared commodities for developing pc-nrfconnect-* packages",
     "repository": {
         "type": "git",
@@ -33,7 +33,7 @@
         "@mdi/font": "7.2.96",
         "@mdi/js": "^7.2.96",
         "@mdi/react": "^1.6.1",
-        "@microsoft/applicationinsights-web": "^3.0.4",
+        "@microsoft/applicationinsights-web": "^3.0.9",
         "@reduxjs/toolkit": "1.9.3",
         "@svgr/core": "^7.0.0",
         "@svgr/plugin-jsx": "7.0.0",
@@ -56,13 +56,14 @@
         "@types/uuid": "8.3.4",
         "@typescript-eslint/eslint-plugin": "5.57.1",
         "@typescript-eslint/parser": "5.57.1",
+        "@xterm/headless": "^5.5.0",
         "adm-zip": "^0.5.5",
-        "applicationinsights": "^2.9.0",
+        "applicationinsights": "^2.9.6",
         "autoprefixer": "10.4.14",
         "bootstrap": "4.6.2",
         "commander": "10.0.0",
         "date-fns": "2.29.3",
-        "electron": "^30.1.2",
+        "electron": "^32.1.2",
         "electron-store": "8.1.0",
         "esbuild": "0.19.2",
         "esbuild-sass-plugin": "2.13.0",
@@ -111,7 +112,7 @@
         "rimraf": "3.0.2",
         "roboto-fontface": "0.10.0",
         "semver": "7.3.8",
-        "serialport": "^10.5.0",
+        "serialport": "^12.0.0",
         "shasum": "1.0.2",
         "systeminformation": "5.17.12",
         "tailwindcss": "3.3.2",
@@ -121,7 +122,6 @@
         "util": "0.12.5",
         "uuid": "8.3.2",
         "winston": "3.8.2",
-        "xterm-headless": "^5.3.0",
         "zod": "^3.22.2",
         "zod-validation-error": "^1.5.0"
     },