@zwave-js/nvmedit 10.6.0 → 10.10.0

package/build/convert.js

@@ -3,10 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.migrateNVM = exports.json700To500 = exports.json500To700 = exports.jsonToNVM500 = exports.jsonToNVM = exports.nvm500ToJSON = exports.nvmToJSON = exports.jsonToNVMObjects_v1_to_v4 = exports.jsonToNVMObjects_v0 = exports.nvmObjectsToJSON = exports.nodeHasInfo = void 0;
+exports.migrateNVM = exports.json700To500 = exports.json500To700 = exports.jsonToNVM500 = exports.jsonToNVM = exports.nvm500ToJSON = exports.nvmToJSON = exports.jsonToNVMObjects_v7_11_0 = exports.jsonToNVMObjects_v7_0_0 = exports.nvmObjectsToJSON = exports.nodeHasInfo = void 0;
 const safe_1 = require("@zwave-js/core/safe");
 const safe_2 = require("@zwave-js/shared/safe");
+const typeguards_1 = require("alcalzone-shared/typeguards");
 const semver_1 = __importDefault(require("semver"));
+const consts_1 = require("./consts");
 const files_1 = require("./files");
 const nvm_1 = require("./nvm3/nvm");
 const utils_1 = require("./nvm3/utils");
@@ -68,28 +70,34 @@ function nvmObjectsToJSON(applicationObjects, protocolObjects) {
             return ret;
         throw new safe_1.ZWaveError(`Object${typeof id === "number" ? ` ${id}` : ""} not found!`, safe_1.ZWaveErrorCodes.NVM_ObjectNotFound);
     };
-    const getFileOrThrow = (id) => {
+    const getFileOrThrow = (id, fileVersion) => {
         const obj = getObjectOrThrow(id);
-        return files_1.NVMFile.from(obj);
+        return files_1.NVMFile.from(obj, fileVersion);
     };
-    const getFile = (id) => {
+    const getFile = (id, fileVersion) => {
         const obj = getObject(id);
         if (!obj)
             return undefined;
-        return files_1.NVMFile.from(obj);
+        return files_1.NVMFile.from(obj, fileVersion);
     };
+    // === Protocol NVM files ===
     // Figure out how to parse the individual files
-    const protocolVersionFile = getFileOrThrow(files_1.ProtocolVersionFileID);
+    const protocolVersionFile = getFileOrThrow(files_1.ProtocolVersionFileID, "7.0.0");
     const protocolFileFormat = protocolVersionFile.format;
+    const protocolVersion = `${protocolVersionFile.major}.${protocolVersionFile.minor}.${protocolVersionFile.patch}`;
+    // Bail early if the NVM uses a protocol file format that's newer than we support
+    if (protocolFileFormat > consts_1.MAX_PROTOCOL_FILE_FORMAT) {
+        throw new safe_1.ZWaveError(`Unsupported protocol file format: ${protocolFileFormat}`, safe_1.ZWaveErrorCodes.NVM_NotSupported, { protocolFileFormat });
+    }
     // Figure out which nodes exist
-    const nodeIds = getFileOrThrow(files_1.ProtocolNodeListFileID).nodeIds;
+    const nodeIds = getFileOrThrow(files_1.ProtocolNodeListFileID, protocolVersion).nodeIds;
     // Read all flags for all nodes
-    const appRouteLock = new Set(getFileOrThrow(files_1.ProtocolAppRouteLockNodeMaskFileID).nodeIds);
-    const routeSlaveSUC = new Set(getFileOrThrow(files_1.ProtocolRouteSlaveSUCNodeMaskFileID).nodeIds);
-    const sucPendingUpdate = new Set(getFileOrThrow(files_1.ProtocolSUCPendingUpdateNodeMaskFileID).nodeIds);
-    const isVirtual = new Set(getFileOrThrow(files_1.ProtocolVirtualNodeMaskFileID).nodeIds);
-    const pendingDiscovery = new Set(getFileOrThrow(files_1.ProtocolPendingDiscoveryNodeMaskFileID).nodeIds);
-    const routeCacheExists = new Set(getFileOrThrow(files_1.ProtocolRouteCacheExistsNodeMaskFileID).nodeIds);
+    const appRouteLock = new Set(getFileOrThrow(files_1.ProtocolAppRouteLockNodeMaskFileID, protocolVersion).nodeIds);
+    const routeSlaveSUC = new Set(getFileOrThrow(files_1.ProtocolRouteSlaveSUCNodeMaskFileID, protocolVersion).nodeIds);
+    const sucPendingUpdate = new Set(getFileOrThrow(files_1.ProtocolSUCPendingUpdateNodeMaskFileID, protocolVersion).nodeIds);
+    const isVirtual = new Set(getFileOrThrow(files_1.ProtocolVirtualNodeMaskFileID, protocolVersion).nodeIds);
+    const pendingDiscovery = new Set(getFileOrThrow(files_1.ProtocolPendingDiscoveryNodeMaskFileID, protocolVersion).nodeIds);
+    const routeCacheExists = new Set(getFileOrThrow(files_1.ProtocolRouteCacheExistsNodeMaskFileID, protocolVersion).nodeIds);
     // And create each node entry, including virtual ones
     for (const id of nodeIds) {
         const node = getNode(id);
@@ -103,17 +111,14 @@ function nvmObjectsToJSON(applicationObjects, protocolObjects) {
         try {
             if (protocolFileFormat === 0) {
                 const fileId = (0, files_1.nodeIdToNodeInfoFileIDV0)(id);
-                const file = getFileOrThrow(fileId);
+                const file = getFileOrThrow(fileId, protocolVersion);
                 nodeInfo = file.nodeInfo;
             }
-            else if (protocolFileFormat <= 4) {
+            else {
                 const fileId = (0, files_1.nodeIdToNodeInfoFileIDV1)(id);
-                const file = getFileOrThrow(fileId);
+                const file = getFileOrThrow(fileId, protocolVersion);
                 nodeInfo = file.nodeInfos.find((i) => i.nodeId === id);
             }
-            else {
-                throw new safe_1.ZWaveError(`Unsupported protocol file format: ${protocolFileFormat}`, safe_1.ZWaveErrorCodes.NVM_NotSupported);
-            }
         }
         catch (e) {
             if (e.message.includes("Object not found")) {
@@ -133,17 +138,14 @@ function nvmObjectsToJSON(applicationObjects, protocolObjects) {
             let routeCache;
             if (protocolFileFormat === 0) {
                 const fileId = (0, files_1.nodeIdToRouteCacheFileIDV0)(id);
-                const file = getFile(fileId);
+                const file = getFile(fileId, protocolVersion);
                 routeCache = file?.routeCache;
             }
-            else if (protocolFileFormat <= 4) {
+            else {
                 const fileId = (0, files_1.nodeIdToRouteCacheFileIDV1)(id);
-                const file = getFile(fileId);
+                const file = getFile(fileId, protocolVersion);
                 routeCache = file?.routeCaches.find((i) => i.nodeId === id);
             }
-            else {
-                throw new safe_1.ZWaveError(`Unsupported protocol file format: ${protocolFileFormat}`, safe_1.ZWaveErrorCodes.NVM_NotSupported);
-            }
             if (routeCache) {
                 node.lwr = routeCache.lwr;
                 node.nlwr = routeCache.nlwr;
@@ -153,14 +155,29 @@ function nvmObjectsToJSON(applicationObjects, protocolObjects) {
         delete node.nodeId;
     }
     // Now read info about the controller
-    const controllerInfoFile = getFileOrThrow(files_1.ControllerInfoFileID);
-    const sucUpdateEntries = getFileOrThrow(files_1.SUCUpdateEntriesFileID).updateEntries;
-    const rfConfigFile = getFile(files_1.ApplicationRFConfigFileID);
-    const applicationVersionFile = getFileOrThrow(files_1.ApplicationVersionFileID);
-    const applicationCCsFile = getFileOrThrow(files_1.ApplicationCCsFileID);
-    const applicationDataFile = getFile(files_1.ApplicationDataFileID);
-    const applicationTypeFile = getFileOrThrow(files_1.ApplicationTypeFileID);
-    const preferredRepeaters = getFile(files_1.ProtocolPreferredRepeatersFileID)?.nodeIds;
+    const controllerInfoFile = getFileOrThrow(files_1.ControllerInfoFileID, protocolVersion);
+    let sucUpdateEntries;
+    if (protocolFileFormat < 5) {
+        sucUpdateEntries = getFileOrThrow(files_1.SUCUpdateEntriesFileIDV0, protocolVersion).updateEntries;
+    }
+    else {
+        // V5 has split the entries into multiple files
+        sucUpdateEntries = [];
+        for (let index = 0; index < consts_1.SUC_MAX_UPDATES; index += files_1.SUC_UPDATES_PER_FILE_V5) {
+            const file = getFile((0, files_1.sucUpdateIndexToSUCUpdateEntriesFileIDV5)(index), protocolVersion);
+            if (!file)
+                break;
+            sucUpdateEntries.push(...file.updateEntries);
+        }
+    }
+    // === Application NVM files ===
+    const applicationVersionFile = getFileOrThrow(files_1.ApplicationVersionFileID, "7.0.0");
+    const applicationVersion = `${applicationVersionFile.major}.${applicationVersionFile.minor}.${applicationVersionFile.patch}`;
+    const rfConfigFile = getFile(files_1.ApplicationRFConfigFileID, applicationVersion);
+    const applicationCCsFile = getFileOrThrow(files_1.ApplicationCCsFileID, applicationVersion);
+    const applicationDataFile = getFile(files_1.ApplicationDataFileID, applicationVersion);
+    const applicationTypeFile = getFileOrThrow(files_1.ApplicationTypeFileID, applicationVersion);
+    const preferredRepeaters = getFile(files_1.ProtocolPreferredRepeatersFileID, applicationVersion)?.nodeIds;
     const controllerProps = [
         "nodeId",
         "lastNodeId",
@@ -283,18 +300,24 @@ function nvmJSONControllerToFileOptions(ctrlr) {
 }
 function serializeCommonApplicationObjects(nvm) {
     const ret = [];
-    const applTypeFile = new files_1.ApplicationTypeFile((0, safe_2.pick)(nvm.controller, [
-        "isListening",
-        "optionalFunctionality",
-        "genericDeviceClass",
-        "specificDeviceClass",
-    ]));
+    const applTypeFile = new files_1.ApplicationTypeFile({
+        ...(0, safe_2.pick)(nvm.controller, [
+            "isListening",
+            "optionalFunctionality",
+            "genericDeviceClass",
+            "specificDeviceClass",
+        ]),
+        fileVersion: nvm.controller.applicationVersion,
+    });
     ret.push(applTypeFile.serialize());
-    const applCCsFile = new files_1.ApplicationCCsFile((0, safe_2.pick)(nvm.controller.commandClasses, [
-        "includedInsecurely",
-        "includedSecurelyInsecureCCs",
-        "includedSecurelySecureCCs",
-    ]));
+    const applCCsFile = new files_1.ApplicationCCsFile({
+        ...(0, safe_2.pick)(nvm.controller.commandClasses, [
+            "includedInsecurely",
+            "includedSecurelyInsecureCCs",
+            "includedSecurelySecureCCs",
+        ]),
+        fileVersion: nvm.controller.applicationVersion,
+    });
     ret.push(applCCsFile.serialize());
     if (nvm.controller.rfConfig) {
         const applRFConfigFile = new files_1.ApplicationRFConfigFile({
@@ -305,6 +328,7 @@ function serializeCommonApplicationObjects(nvm) {
             ]),
             enablePTI: nvm.controller.rfConfig.enablePTI ?? undefined,
             maxTXPower: nvm.controller.rfConfig.maxTXPower ?? undefined,
+            fileVersion: nvm.controller.applicationVersion,
         });
         ret.push(applRFConfigFile.serialize());
     }
@@ -312,6 +336,7 @@ function serializeCommonApplicationObjects(nvm) {
         // TODO: ensure this is 512 bytes long
         const applDataFile = new files_1.ApplicationDataFile({
             data: Buffer.from(nvm.controller.applicationData, "hex"),
+            fileVersion: nvm.controller.applicationVersion,
         });
         ret.push(applDataFile.serialize());
     }
@@ -346,33 +371,58 @@ function serializeCommonProtocolObjects(nvm) {
     ret.push(new files_1.ControllerInfoFile(nvmJSONControllerToFileOptions(nvm.controller)).serialize());
     ret.push(new files_1.ProtocolAppRouteLockNodeMaskFile({
         nodeIds: [...appRouteLock],
+        fileVersion: nvm.controller.protocolVersion,
     }).serialize());
     ret.push(new files_1.ProtocolRouteSlaveSUCNodeMaskFile({
         nodeIds: [...routeSlaveSUC],
+        fileVersion: nvm.controller.protocolVersion,
     }).serialize());
     ret.push(new files_1.ProtocolSUCPendingUpdateNodeMaskFile({
         nodeIds: [...sucPendingUpdate],
+        fileVersion: nvm.controller.protocolVersion,
     }).serialize());
     ret.push(new files_1.ProtocolVirtualNodeMaskFile({
         nodeIds: [...isVirtual],
+        fileVersion: nvm.controller.protocolVersion,
     }).serialize());
     ret.push(new files_1.ProtocolPendingDiscoveryNodeMaskFile({
         nodeIds: [...pendingDiscovery],
+        fileVersion: nvm.controller.protocolVersion,
     }).serialize());
     // TODO: format >= 2: { .key = FILE_ID_LRANGE_NODE_EXIST, .size = FILE_SIZE_LRANGE_NODE_EXIST, .name = "LRANGE_NODE_EXIST"},
     if (nvm.controller.preferredRepeaters?.length) {
         ret.push(new files_1.ProtocolPreferredRepeatersFile({
             nodeIds: nvm.controller.preferredRepeaters,
+            fileVersion: nvm.controller.protocolVersion,
         }).serialize());
     }
-    ret.push(new files_1.SUCUpdateEntriesFile({
-        updateEntries: nvm.controller.sucUpdateEntries,
-    }).serialize());
+    if (nvm.format < 5) {
+        ret.push(new files_1.SUCUpdateEntriesFileV0({
+            updateEntries: nvm.controller.sucUpdateEntries,
+            fileVersion: nvm.controller.protocolVersion,
+        }).serialize());
+    }
+    else {
+        // V5 has split the SUC update entries into multiple files
+        for (let index = 0; index < consts_1.SUC_MAX_UPDATES; index += files_1.SUC_UPDATES_PER_FILE_V5) {
+            const slice = nvm.controller.sucUpdateEntries.slice(index, index + files_1.SUC_UPDATES_PER_FILE_V5);
+            if (slice.length === 0)
+                break;
+            const file = new files_1.SUCUpdateEntriesFileV5({
+                updateEntries: slice,
+                fileVersion: nvm.controller.protocolVersion,
+            });
+            file.fileId = (0, files_1.sucUpdateIndexToSUCUpdateEntriesFileIDV5)(index);
+            ret.push(file.serialize());
+        }
+    }
     return ret;
 }
-function jsonToNVMObjects_v0(json, major, minor, patch) {
+function jsonToNVMObjects_v7_0_0(json, targetSDKVersion) {
     const target = (0, safe_2.cloneDeep)(json);
+    target.controller.protocolVersion = "7.0.0";
     target.format = 0;
+    target.controller.applicationVersion = targetSDKVersion.format();
     const applicationObjects = new Map();
     const protocolObjects = new Map();
     const addApplicationObjects = (...objects) => {
@@ -386,21 +436,23 @@ function jsonToNVMObjects_v0(json, major, minor, patch) {
         }
     };
     // Application files
-    const [applMajor, applMinor, applPatch] = target.controller.applicationVersion.split(".").map((i) => parseInt(i));
     const applVersionFile = new files_1.ApplicationVersionFile({
-        format: target.format,
-        major: applMajor,
-        minor: applMinor,
-        patch: applPatch,
+        // The SDK compares 4-byte values where the format is set to 0 to determine whether a migration is needed
+        format: 0,
+        major: targetSDKVersion.major,
+        minor: targetSDKVersion.minor,
+        patch: targetSDKVersion.patch,
+        fileVersion: target.controller.applicationVersion, // does not matter for this file
     });
     addApplicationObjects(applVersionFile.serialize());
     addApplicationObjects(...serializeCommonApplicationObjects(target));
     // Protocol files
     const protocolVersionFile = new files_1.ProtocolVersionFile({
         format: target.format,
-        major,
-        minor,
-        patch,
+        major: 7,
+        minor: 0,
+        patch: 0,
+        fileVersion: target.controller.protocolVersion, // does not matter for this file
     });
     addProtocolObjects(protocolVersionFile.serialize());
     const nodeInfoFiles = new Map();
@@ -416,6 +468,7 @@ function jsonToNVMObjects_v0(json, major, minor, patch) {
         const nodeInfoFileIndex = (0, files_1.nodeIdToNodeInfoFileIDV0)(nodeId);
         nodeInfoFiles.set(nodeInfoFileIndex, new files_1.NodeInfoFileV0({
             nodeInfo: nvmJSONNodeToNodeInfo(nodeId, node),
+            fileVersion: target.controller.protocolVersion,
         }));
         // Create/update route cache file (if there is a route)
         if (node.lwr || node.nlwr) {
@@ -427,13 +480,18 @@ function jsonToNVMObjects_v0(json, major, minor, patch) {
                     lwr: node.lwr ?? (0, files_1.getEmptyRoute)(),
                     nlwr: node.nlwr ?? (0, files_1.getEmptyRoute)(),
                 },
+                fileVersion: target.controller.protocolVersion,
             }));
         }
     }
     addProtocolObjects(...serializeCommonProtocolObjects(target));
-    addProtocolObjects(new files_1.ProtocolNodeListFile({ nodeIds: [...nodeInfoExists] }).serialize());
+    addProtocolObjects(new files_1.ProtocolNodeListFile({
+        nodeIds: [...nodeInfoExists],
+        fileVersion: target.controller.protocolVersion,
+    }).serialize());
     addProtocolObjects(new files_1.ProtocolRouteCacheExistsNodeMaskFile({
         nodeIds: [...routeCacheExists],
+        fileVersion: target.controller.protocolVersion,
     }).serialize());
     if (nodeInfoFiles.size > 0) {
         addProtocolObjects(...[...nodeInfoFiles.values()].map((f) => f.serialize()));
@@ -446,11 +504,47 @@ function jsonToNVMObjects_v0(json, major, minor, patch) {
         protocolObjects,
     };
 }
-exports.jsonToNVMObjects_v0 = jsonToNVMObjects_v0;
-function jsonToNVMObjects_v1_to_v4(format, json, major, minor, patch) {
+exports.jsonToNVMObjects_v7_0_0 = jsonToNVMObjects_v7_0_0;
+function jsonToNVMObjects_v7_11_0(json, targetSDKVersion) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
     const target = (0, safe_2.cloneDeep)(json);
-    target.format = format;
+    let targetApplicationVersion;
+    let targetProtocolVersion;
+    let targetProtocolFormat;
+    // We currently support application version migrations up to 7.19.1
+    // For all higher ones, set the highest version we support and let the controller handle the migration itself
+    if (semver_1.default.lte(targetSDKVersion, "7.19.1")) {
+        targetApplicationVersion = semver_1.default.parse(targetSDKVersion);
+    }
+    else {
+        targetApplicationVersion = semver_1.default.parse("7.19.1");
+    }
+    // The protocol version file only seems to be updated when the format of the protocol file system changes
+    // Once again, we simply set the highest version we support here and let the controller handle any potential migration
+    if (semver_1.default.gte(targetSDKVersion, "7.19.0")) {
+        targetProtocolVersion = semver_1.default.parse("7.19.0");
+        targetProtocolFormat = 5;
+    }
+    else if (semver_1.default.gte(targetSDKVersion, "7.17.0")) {
+        targetProtocolVersion = semver_1.default.parse("7.17.0");
+        targetProtocolFormat = 4;
+    }
+    else if (semver_1.default.gte(targetSDKVersion, "7.15.3")) {
+        targetProtocolVersion = semver_1.default.parse("7.15.3");
+        targetProtocolFormat = 3;
+    }
+    else if (semver_1.default.gte(targetSDKVersion, "7.12.0")) {
+        targetProtocolVersion = semver_1.default.parse("7.12.0");
+        targetProtocolFormat = 2;
+    }
+    else {
+        // All versions below 7.11.0 are handled in the _v7_0_0 method
+        targetProtocolVersion = semver_1.default.parse("7.11.0");
+        targetProtocolFormat = 1;
+    }
+    target.format = targetProtocolFormat;
+    target.controller.applicationVersion = targetApplicationVersion.format();
+    target.controller.protocolVersion = targetProtocolVersion.format();
     const applicationObjects = new Map();
     const protocolObjects = new Map();
     const addApplicationObjects = (...objects) => {
@@ -464,12 +558,13 @@ function jsonToNVMObjects_v1_to_v4(format, json, major, minor, patch) {
         }
     };
     // Application files
-    const [applMajor, applMinor, applPatch] = target.controller.applicationVersion.split(".").map((i) => parseInt(i));
     const applVersionFile = new files_1.ApplicationVersionFile({
-        format: target.format,
-        major: applMajor,
-        minor: applMinor,
-        patch: applPatch,
+        // The SDK compares 4-byte values where the format is set to 0 to determine whether a migration is needed
+        format: 0,
+        major: targetApplicationVersion.major,
+        minor: targetApplicationVersion.minor,
+        patch: targetApplicationVersion.patch,
+        fileVersion: target.controller.applicationVersion, // does not matter for this file
     });
     addApplicationObjects(applVersionFile.serialize());
     // When converting it can be that the rfConfig doesn't exist. Make sure
@@ -481,19 +576,20 @@ function jsonToNVMObjects_v1_to_v4(format, json, major, minor, patch) {
         enablePTI: null,
         maxTXPower: null,
     });
-    // For v3+ targets, the enablePTI and maxTxPower must be set in the rfConfig
-    // or the controller will ignore the file and not accept any changes to the RF config
-    if (format >= 3) {
+    // Make sure the RF config format matches the application version.
+    // Otherwise, the controller will ignore the file and not accept any changes to the RF config
+    if (semver_1.default.gte(targetSDKVersion, "7.15.3")) {
         (_b = target.controller.rfConfig).enablePTI ?? (_b.enablePTI = 0);
         (_c = target.controller.rfConfig).maxTXPower ?? (_c.maxTXPower = 14.0);
     }
     addApplicationObjects(...serializeCommonApplicationObjects(target));
     // Protocol files
     const protocolVersionFile = new files_1.ProtocolVersionFile({
-        format: target.format,
-        major,
-        minor,
-        patch,
+        format: targetProtocolFormat,
+        major: targetProtocolVersion.major,
+        minor: targetProtocolVersion.minor,
+        patch: targetProtocolVersion.patch,
+        fileVersion: target.controller.protocolVersion, // does not matter for this file
     });
     addProtocolObjects(protocolVersionFile.serialize());
     const nodeInfoFiles = new Map();
@@ -510,6 +606,7 @@ function jsonToNVMObjects_v1_to_v4(format, json, major, minor, patch) {
         if (!nodeInfoFiles.has(nodeInfoFileIndex)) {
             nodeInfoFiles.set(nodeInfoFileIndex, new files_1.NodeInfoFileV1({
                 nodeInfos: [],
+                fileVersion: target.controller.protocolVersion,
             }));
         }
         const nodeInfoFile = nodeInfoFiles.get(nodeInfoFileIndex);
@@ -521,6 +618,7 @@ function jsonToNVMObjects_v1_to_v4(format, json, major, minor, patch) {
             if (!routeCacheFiles.has(routeCacheFileIndex)) {
                 routeCacheFiles.set(routeCacheFileIndex, new files_1.RouteCacheFileV1({
                     routeCaches: [],
+                    fileVersion: target.controller.protocolVersion,
                 }));
             }
             const routeCacheFile = routeCacheFiles.get(routeCacheFileIndex);
@@ -533,7 +631,7 @@ function jsonToNVMObjects_v1_to_v4(format, json, major, minor, patch) {
     }
     // For v3+ targets, the ControllerInfoFile must contain the LongRange properties
     // or the controller will ignore the file and not have a home ID
-    if (format >= 3) {
+    if (targetProtocolFormat >= 3) {
         (_d = target.controller).lastNodeIdLR ?? (_d.lastNodeIdLR = 255);
         (_e = target.controller).maxNodeIdLR ?? (_e.maxNodeIdLR = 0);
         (_f = target.controller).reservedIdLR ?? (_f.reservedIdLR = 0);
@@ -541,9 +639,13 @@ function jsonToNVMObjects_v1_to_v4(format, json, major, minor, patch) {
         (_h = target.controller).dcdcConfig ?? (_h.dcdcConfig = 255);
     }
     addProtocolObjects(...serializeCommonProtocolObjects(target));
-    addProtocolObjects(new files_1.ProtocolNodeListFile({ nodeIds: [...nodeInfoExists] }).serialize());
+    addProtocolObjects(new files_1.ProtocolNodeListFile({
+        nodeIds: [...nodeInfoExists],
+        fileVersion: target.controller.protocolVersion,
+    }).serialize());
     addProtocolObjects(new files_1.ProtocolRouteCacheExistsNodeMaskFile({
         nodeIds: [...routeCacheExists],
+        fileVersion: target.controller.protocolVersion,
     }).serialize());
     if (nodeInfoFiles.size > 0) {
         addProtocolObjects(...[...nodeInfoFiles.values()].map((f) => f.serialize()));
@@ -556,7 +658,7 @@ function jsonToNVMObjects_v1_to_v4(format, json, major, minor, patch) {
         protocolObjects,
     };
 }
-exports.jsonToNVMObjects_v1_to_v4 = jsonToNVMObjects_v1_to_v4;
+exports.jsonToNVMObjects_v7_11_0 = jsonToNVMObjects_v7_11_0;
 /** Reads an NVM buffer and returns its JSON representation */
 function nvmToJSON(buffer, debugLogs = false) {
     const nvm = (0, nvm_1.parseNVM)(buffer, debugLogs);
@@ -574,26 +676,17 @@ function nvm500ToJSON(buffer) {
 }
 exports.nvm500ToJSON = nvm500ToJSON;
 /** Takes a JSON represented NVM and converts it to binary */
-function jsonToNVM(json, protocolVersion) {
-    const parsedVersion = semver_1.default.parse(protocolVersion);
+function jsonToNVM(json, targetSDKVersion) {
+    const parsedVersion = semver_1.default.parse(targetSDKVersion);
     if (!parsedVersion) {
-        throw new safe_1.ZWaveError(`Invalid protocol version: ${protocolVersion}`, safe_1.ZWaveErrorCodes.Argument_Invalid);
+        throw new safe_1.ZWaveError(`Invalid SDK version: ${targetSDKVersion}`, safe_1.ZWaveErrorCodes.Argument_Invalid);
     }
     let objects;
-    if (semver_1.default.gte(parsedVersion, "7.17.0")) {
-        objects = jsonToNVMObjects_v1_to_v4(4, json, parsedVersion.major, parsedVersion.minor, parsedVersion.patch);
-    }
-    else if (semver_1.default.gte(parsedVersion, "7.15.3")) {
-        objects = jsonToNVMObjects_v1_to_v4(3, json, parsedVersion.major, parsedVersion.minor, parsedVersion.patch);
-    }
-    else if (semver_1.default.gte(parsedVersion, "7.12.0")) {
-        objects = jsonToNVMObjects_v1_to_v4(2, json, parsedVersion.major, parsedVersion.minor, parsedVersion.patch);
-    }
-    else if (semver_1.default.gte(parsedVersion, "7.11.0")) {
-        objects = jsonToNVMObjects_v1_to_v4(1, json, parsedVersion.major, parsedVersion.minor, parsedVersion.patch);
+    if (semver_1.default.gte(parsedVersion, "7.11.0")) {
+        objects = jsonToNVMObjects_v7_11_0(json, parsedVersion);
     }
     else if (semver_1.default.gte(parsedVersion, "7.0.0")) {
-        objects = jsonToNVMObjects_v0(json, parsedVersion.major, parsedVersion.minor, parsedVersion.patch);
+        objects = jsonToNVMObjects_v7_0_0(json, parsedVersion);
     }
     else {
         throw new safe_1.ZWaveError("jsonToNVM cannot convert to a pre-7.0 NVM version. Use jsonToNVM500 instead.", safe_1.ZWaveErrorCodes.Argument_Invalid);
@@ -766,11 +859,14 @@ exports.json700To500 = json700To500;
 function migrateNVM(sourceNVM, targetNVM) {
     let source;
     let target;
+    let sourceProtocolFileFormat;
+    let targetProtocolFileFormat;
     try {
         source = {
             type: 700,
             json: nvmToJSON(sourceNVM),
         };
+        sourceProtocolFileFormat = source.json.format;
     }
     catch (e) {
         if ((0, safe_1.isZWaveError)(e) && e.code === safe_1.ZWaveErrorCodes.NVM_InvalidFormat) {
@@ -780,6 +876,14 @@ function migrateNVM(sourceNVM, targetNVM) {
                 json: nvm500ToJSON(sourceNVM),
             };
         }
+        else if ((0, safe_1.isZWaveError)(e) &&
+            e.code === safe_1.ZWaveErrorCodes.NVM_NotSupported &&
+            (0, typeguards_1.isObject)(e.context) &&
+            typeof e.context.protocolFileFormat === "number") {
+            // This is a 700 series NVM, but the protocol version is not (yet) supported
+            source = { type: "unknown" };
+            sourceProtocolFileFormat = e.context.protocolFileFormat;
+        }
         else {
             source = { type: "unknown" };
         }
@@ -789,6 +893,7 @@ function migrateNVM(sourceNVM, targetNVM) {
             type: 700,
             json: nvmToJSON(targetNVM),
         };
+        targetProtocolFileFormat = target.json.format;
     }
     catch (e) {
         if ((0, safe_1.isZWaveError)(e) && e.code === safe_1.ZWaveErrorCodes.NVM_InvalidFormat) {
@@ -798,19 +903,48 @@ function migrateNVM(sourceNVM, targetNVM) {
                 json: nvm500ToJSON(targetNVM),
             };
         }
+        else if ((0, safe_1.isZWaveError)(e) &&
+            e.code === safe_1.ZWaveErrorCodes.NVM_NotSupported &&
+            source.type === 700 &&
+            (0, typeguards_1.isObject)(e.context) &&
+            typeof e.context.protocolFileFormat === "number") {
+            // This is a 700 series NVM, but the protocol version is not (yet) supported
+            target = { type: "unknown" };
+            targetProtocolFileFormat = e.context.protocolFileFormat;
+        }
         else {
             target = { type: "unknown" };
         }
     }
     // Short circuit if...
-    if (source.type === 700 && target.type === 700) {
+    if (target.type === "unknown" &&
+        targetProtocolFileFormat &&
+        targetProtocolFileFormat > consts_1.MAX_PROTOCOL_FILE_FORMAT &&
+        sourceProtocolFileFormat &&
+        sourceProtocolFileFormat <= targetProtocolFileFormat) {
+        // ...both the source and the target are 700 series, but at least the target uses an unsupported protocol version.
+        // We can be sure hwoever that the target can upgrade any 700 series NVM to its protocol version, as long as the
+        // source protocol version is not higher than the target's
+        return sourceNVM;
+    }
+    else if (source.type === 700 && target.type === 700) {
         //... the source and target protocol versions are compatible without conversion
         const sourceProtocolVersion = source.json.controller.protocolVersion;
         const targetProtocolVersion = target.json.controller.protocolVersion;
+        // ... and the application version on the both is compatible with the respective protocol version
+        const sourceApplicationVersion = source.json.controller.applicationVersion;
+        const targetApplicationVersion = target.json.controller.applicationVersion;
         // The 700 series firmware can automatically upgrade backups from a previous protocol version
         // Not sure when that ability was added. To be on the safe side, allow it for 7.16+ which definitely supports it.
         if (semver_1.default.gte(targetProtocolVersion, "7.16.0") &&
-            semver_1.default.gte(targetProtocolVersion, sourceProtocolVersion)) {
+            semver_1.default.gte(targetProtocolVersion, sourceProtocolVersion) &&
+            // the application version is updated on every update, protocol version only when the format changes
+            // so this is a good indicator if the NVMs are in a compatible state
+            semver_1.default.gte(targetApplicationVersion, targetProtocolVersion) &&
+            semver_1.default.gte(sourceApplicationVersion, sourceProtocolVersion) &&
+            // avoid preserving broken 255.x versions which appear on some controllers
+            semver_1.default.lt(sourceApplicationVersion, "255.0.0") &&
+            semver_1.default.lt(targetApplicationVersion, "255.0.0")) {
             return sourceNVM;
         }
     }
@@ -829,6 +963,13 @@ function migrateNVM(sourceNVM, targetNVM) {
     // TypeScript doesn't understand multi-variable narrowings (yet)
     source = source;
     target = target;
+    // Some 700 series NVMs have a strange 255.x application version - fix that first
+    if (target.type === 700 &&
+        semver_1.default.gte(target.json.controller.applicationVersion, "255.0.0")) {
+        // replace both with the protocol version
+        target.json.controller.applicationVersion =
+            target.json.controller.protocolVersion;
+    }
     // In any case, preserve the application version of the target stick
     source.json.controller.applicationVersion =
         target.json.controller.applicationVersion;
@@ -850,7 +991,8 @@ function migrateNVM(sourceNVM, targetNVM) {
         };
         // The target is a different series, try to preserve the RF config of the target stick
         json.controller.rfConfig = target.json.controller.rfConfig;
-        return jsonToNVM(json, target.json.controller.protocolVersion);
+        // 700 series distinguishes the NVM format by the application version
+        return jsonToNVM(json, target.json.controller.applicationVersion);
     }
     else if (source.type === 700 && target.type === 500) {
         // We need to downgrade the source to 500 series
@@ -868,7 +1010,8 @@ function migrateNVM(sourceNVM, targetNVM) {
             ...source.json,
             meta: target.json.meta,
         };
-        return jsonToNVM(json, target.json.controller.protocolVersion);
+        // 700 series distinguishes the NVM format by the application version
+        return jsonToNVM(json, target.json.controller.applicationVersion);
     }
 }
 exports.migrateNVM = migrateNVM;