inventoresed/packages/config/maintenance/importConfig.ts

Z-Wave driver written entirely in JavaScript/TypeScript

/*!
 * This script is used to import the Z-Wave device database from
 * https://www.cd-jackson.com/zwave_device_database/zwave-database-json.gz.tar
 * and translate the information into a form this library expects
 */

process.on("unhandledRejection", (r) => {
	throw r;
});

import { CommandClasses, getIntegerLimits } from "@zwave-js/core";
import {
	enumFilesRecursive,
	formatId,
	getErrorMessage,
	num2hex,
	padVersion,
	stringify,
} from "@zwave-js/shared";
import { composeObject } from "alcalzone-shared/objects";
import { isArray, isObject } from "alcalzone-shared/typeguards";
import { AssertionError, ok } from "assert";
import axios from "axios";
import * as child from "child_process";
import * as JSONC from "comment-json";
import * as fs from "fs-extra";
import * as JSON5 from "json5";
import * as path from "path";
import { compare } from "semver";
import { promisify } from "util";
import xml2js from "xml2js";
import xml2js_parsers from "xml2js/lib/processors.js";
import yargs from "yargs";
import { ConfigManager, DeviceConfigIndexEntry } from "../src";

const execPromise = promisify(child.exec);

const program = yargs
	.option("source", {
		description: "source of the import",
		alias: "s",
		type: "array",
		choices: ["oh", "ozw", "zwa"], // oh: openhab, ozw: openzwave; zwa: zWave Alliance
		default: ["zwa"],
	})
	.option("ids", {
		description:
			"devices ids to download. In ozw the format is '<manufacturer>-<productId>-<productType>'. Ex: '0x0086-0x0075-0x0004'",
		type: "array",
		array: true,
	})
	.option("download", {
		alias: "D",
		description: "Download devices DB from <source>",
		type: "boolean",
		default: false,
	})
	.option("clean", {
		alias: "C",
		description: "Clean temporary directory",
		type: "boolean",
		default: false,
	})
	.option("manufacturers", {
		alias: "m",
		description: "Parse and update manufacturers.json",
		type: "boolean",
		default: false,
	})
	.option("manufacturer_folder", {
		alias: "M",
		description:
			"Download all Z-Wave alliance files for the specified manufacturer (using the zwa website manufacturer ID)",
		type: "array",
		array: true,
	})
	.option("devices", {
		alias: "d",
		description: "Parse and update devices configurations",
		type: "boolean",
		default: false,
	})
	.option("parse", {
		alias: "p",
		description: "Run custom parse routines -- maintenance",
		type: "boolean",
		default: false,
	})
	.example(
		"import -s ozw -Dmd",
		"Download and parse OpenZwave db (manufacturers, devices) and update the index",
	)
	.example(
		"import -s oh -Dmd",
		"Download and parse openhab db (manufacturers, devices) and update the index",
	)
	.example(
		"import -s oh -D --ids 1234 5678",
		"Download openhab devices with ids `1234` and `5678`",
	)
	.help()
	.version(false)
	.alias("h", "help")
	.parseSync();

// Where the files are located
const processedDir = path.join(
	__dirname,
	"../../../packages/config",
	"config/devices",
);

const configManager = new ConfigManager();

const ozwTempDir = path.join(__dirname, "../../../.tmpozw");
const ozwTarName = "openzwave.tar.gz";
const ozwTarUrl =
	"https://github.com/OpenZWave/open-zwave/archive/master.tar.gz";
const ozwConfigFolder = path.join(ozwTempDir, "./config");

const zwaTempDir = path.join(__dirname, "../../../.tmpzwa");

const ohTempDir = path.join(__dirname, "../../../.tmpoh");
const importedManufacturersPath = path.join(ohTempDir, "manufacturers.json");

// Where all the information can be found
const ohUrlManufacturers =
	"https://opensmarthouse.org/dmxConnect/api/zwavedatabase/manufacturers/list.php?sort=label&limit=99999";
const ohUrlIDs =
	"https://opensmarthouse.org/dmxConnect/api/zwavedatabase/device/list.php?filter=&manufacturer=-1&limit=100000";
const ohUrlDevice = (id: number) =>
	`https://opensmarthouse.org/dmxConnect/api/zwavedatabase/device/read.php?device_id=${id}`;
const zwaUrlDevice = (id: number) =>
	`https://products.z-wavealliance.org/Products/${id}/json`;

function isNullishOrEmptyString(
	value: number | string | null | undefined,
): value is "" | null | undefined {
	return value == undefined || value === "";
}

const xmlParserOptions_default: xml2js.ParserOptions = {
	// Don't separate xml attributes from children
	mergeAttrs: true,
	// We normalize to arrays where necessary, no need to do it globally
	explicitArray: false,
};

const xmlParserOptions_coerce: xml2js.ParserOptions = {
	// Coerce strings to numbers and booleans where it makes sense
	attrValueProcessors: [
		xml2js_parsers.parseBooleans,
		xml2js_parsers.parseNumbers,
	],
	valueProcessors: [
		xml2js_parsers.parseBooleans,
		xml2js_parsers.parseNumbers,
	],
};

/** Updates a numeric value with a new value, sanitizing the input. Falls back to the previous value (if it exists) or a default one */
function updateNumberOrDefault(
	newN: number | string,
	oldN: number | string,
	defaultN: number,
): number | undefined {
	// Try new value first
	let ret = sanitizeNumber(newN);
	if (typeof ret === "number") return ret;

	// Fallback to old value
	ret = sanitizeNumber(oldN);
	if (typeof ret === "number") return ret;

	return defaultN;
}

/** Retrieves the list of database IDs from the OpenSmartHouse DB */
async function fetchIDsOH(): Promise<number[]> {
	const data = (await axios({ url: ohUrlIDs })).data;
	return data.devices.map((d: any) => d.id);
}

/** Retrieves the definition for a specific device from the OpenSmartHouse DB */
async function fetchDeviceOH(id: number): Promise<string> {
	const source = (await axios({ url: ohUrlDevice(id) })).data;
	return stringify(source, "\t");
}

/** Retrieves the definition for a specific device from the Z-Wave Alliance DB */
async function fetchDeviceZWA(id: number): Promise<string> {
	const source = (await axios({ url: zwaUrlDevice(id) })).data;
	return stringify(source, "\t");
}

/** Downloads ozw master archive and store it on `tmpDir` */
async function downloadOZWConfig(): Promise<string> {
	console.log("downloading ozw archive...");

	// create tmp directory if missing
	await fs.ensureDir(ozwTempDir);

	// this will return a stream in `data` that we pipe into write stream
	// to store the file in `tmpDir`
	const data = (await axios({ url: ozwTarUrl, responseType: "stream" })).data;

	return new Promise((resolve, reject) => {
		const fileDest = path.join(ozwTempDir, ozwTarName);
		const stream = fs.createWriteStream(fileDest);
		data.pipe(stream);
		let hasError = false;
		stream.on("error", (err) => {
			hasError = true;
			stream.close();
			reject(err);
		});

		stream.on("close", () => {
			if (!hasError) {
				resolve(fileDest);
				console.log("ozw archive stored in temporary directory");
			}
		});
	});
}

/** Extract `config` folder from ozw archive in `tmpDir` */
async function extractConfigFromTar(): Promise<void> {
	console.log("extracting config folder from ozw archive...");
	await execPromise(
		`tar -xzf ${ozwTarName} open-zwave-master/config  --strip-components=1`,
		{ cwd: ozwTempDir },
	);
}

/** Delete all files in `tmpDir` */
async function cleanTmpDirectory(): Promise<void> {
	await fs.remove(ozwTempDir);
	await fs.remove(ohTempDir);
	await fs.remove(zwaTempDir);
	console.log("temporary directories cleaned");
}

function matchId(
	manufacturer: string,
	prodType: string,
	prodId: string,
): boolean {
	return !!program.ids?.includes(
		`${formatId(manufacturer)}-${formatId(prodType)}-${formatId(prodId)}`,
	);
}

/** Reads OZW `manufacturer_specific.xml` */
async function parseOZWConfig(): Promise<void> {
	// The manufacturer_specific.xml is OZW's index file and contains all devices, their type, ID and name (label)
	const manufacturerFile = path.join(
		ozwConfigFolder,
		"manufacturer_specific.xml",
	);
	const manufacturerJson: Record<string, any> =
		await xml2js.parseStringPromise(
			await fs.readFile(manufacturerFile, "utf8"),
			xmlParserOptions_default,
		);

	// Load our existing config files to cross-reference
	await configManager.loadManufacturers();
	if (program.devices) {
		await configManager.loadDeviceIndex();
	}

	for (const man of manufacturerJson.ManufacturerSpecificData.Manufacturer) {
		// <Manufacturer id="012A" name="ManufacturerName">... products ...</Manufacturer>
		const manufacturerId = parseInt(man.id, 16);
		let manufacturerName = configManager.lookupManufacturer(manufacturerId);

		// Add the manufacturer to our manufacturers.json if it is missing
		if (manufacturerName === undefined && man.name !== undefined) {
			console.log(`Adding missing manufacturer: ${man.name}`);
			// let this here, if program.manufacturers is false it will not
			// write the manufacturers to file
			configManager.setManufacturer(manufacturerId, man.name);
		}
		manufacturerName = man.name;

		if (program.devices) {
			// Import all device config files of this manufacturer if requested
			const products = ensureArray(man.Product);
			for (const product of products) {
				if (product.config !== undefined) {
					if (
						!program.ids ||
						matchId(man.id, product.id, product.type)
					) {
						await parseOZWProduct(
							product,
							manufacturerId,
							manufacturerName,
						);
					}
				}
			}
		}
	}

	if (program.manufacturers) {
		await configManager.saveManufacturers();
	}
}

/**
 * When using xml2json some fields expected as array are parsed as objects
 * when there is only one element. This method ensures that they are arrays
 *
 */
function ensureArray(json: any): any[] {
	json = json ?? [];
	return isArray(json) ? json : [json];
}

function normalizeUnits(unit: string) {
	if (!unit) return undefined;

	if (/minutes/i.test(unit)) {
		return "minutes";
	} else if (/seconds/i.test(unit)) {
		return "seconds";
	} else if (/fahrenheit|\bf\b/i.test(unit)) {
		return "°F";
	} else if (/degrees celsius|celsius|\bc\b/i.test(unit)) {
		return "°C";
	} else if (/\bwatt/i.test(unit)) {
		return "W";
	} else if (/\bvolt/i.test(unit)) {
		return "V";
	} else if (/percent|dimmer level|%/i.test(unit)) {
		return "%";
	} else if (/degrees/i.test(unit)) {
		return "°";
	}
	return unit;
}

/**
 * Normalize a device JSON configuration to ensure all keys have the same order
 * and fix some parameters if needed
 *
 * @param config Device JSON configuration
 */
function normalizeConfig(config: Record<string, any>): Record<string, any> {
	// Top-level key order (comments are not preserved between top-level keys)
	const topOrder = [
		"manufacturer",
		"manufacturerId",
		"label",
		"description",
		"devices",
		"firmwareVersion",
		"associations",
		"paramInformation",
		"compat",
		"metadata",
	];

	// Parameter key order (comments preserved)
	const paramOrder = [
		"$if",
		"$import",
		"label",
		"description",
		"valueSize",
		"unit",
		"minValue",
		"maxValue",
		"defaultValue",
		"unsigned",
		"readOnly",
		"writeOnly",
		"allowManualEntry",
		"options",
	];

	// Potentially empty arrays and objects to remove
	const disallowEmpty = [
		"associations",
		"paramInformation",
		"compat",
		"metadata",
	];

	/*******************
	 * Standardize things
	 ********************/

	// Enforce top-level order
	for (const l of topOrder) {
		if (typeof config[l] === "undefined") {
			continue;
		} else if (config[l] === "") {
			delete config[l];
		}

		const temp = config[l];
		delete config[l];
		config[l] = temp;
	}

	// Remove empty arrays and objects
	for (const prop of Object.keys(disallowEmpty)) {
		if (prop in config) {
			// Key exists
			if (
				isObject(config[prop]) &&
				Object.keys(config[prop]).length === 0
			) {
				delete config[prop];
			} else if (isArray(config[prop]) && config[prop].length === 0) {
				delete config[prop];
			} else if (!config[prop]) {
				delete config[prop];
			}
		}
	}

	// Sanitize labels
	config.label = sanitizeText(config.label) ?? "";
	config.description = sanitizeText(config.description) ?? "";

	// Sort devices by productType, then productId
	config.devices.sort((a: any, b: any) => {
		if (a.productType < b.productType) return -1;
		if (a.productType > b.productType) return +1;
		if (a.productId < b.productId) return -1;
		if (a.productId > b.productId) return +1;
		return 0;
	});

	// Standardize parameters
	if (config.paramInformation?.length) {
		// Filter out duplicates between partial and non-partial params
		const allowedKeys = (config.paramInformation as any[])
			.filter(
				(param, _, arr) =>
					// Allow partial params
					!/^\d+$/.test(param["#"]) ||
					// and non-partial params...
					// either with a condition
					"$if" in param ||
					// or without a corresponding partial param
					!arr.some((other) =>
						other["#"].startsWith(`${param["#"]}[`),
					),
			)
			.map((e) => e["#"]);

		config.paramInformation = config.paramInformation.filter((param: any) =>
			allowedKeys.includes(param["#"]),
		);
		for (const original of config.paramInformation) {
			original.unit = normalizeUnits(original.unit);

			if (original.readOnly) {
				original.allowManualEntry = undefined;
				original.writeOnly = undefined;
			} else if (original.writeOnly) {
				original.readOnly = undefined;
			} else {
				original.readOnly = undefined;
				original.writeOnly = undefined;
			}

			if (original.allowManualEntry === true) {
				original.allowManualEntry = undefined;
			}

			// Remove undefined keys while preserving comments
			for (const l of paramOrder) {
				if (original[l] == undefined || original[l] === "") {
					delete original[l];
					continue;
				}

				const temp = original[l];
				delete original[l];
				original[l] = temp;
			}

			// Delete empty options arrays
			if (original.options?.length === 0) {
				delete original.options;
			} else if (program.source.includes("ozw")) {
				const values = original.options.map((o: any) => o.value);
				original.minValue = Math.min(...values);
				original.maxValue = Math.max(...values);
			}
		}
	} else {
		delete config.paramInformation;
	}

	return config;
}

/**
 * Read and parse the product xml, add it to index if missing,
 * create/update device json config and validate the newly added
 * device
 *
 * @param product the parsed product json entry from manufacturer.xml
 */
async function parseOZWProduct(
	product: any,
	manufacturerId: number,
	manufacturer: string | undefined,
): Promise<void> {
	const productFile = await fs.readFile(
		path.join(ozwConfigFolder, product.config),
		"utf8",
	);

	// TODO: Parse the label from XML metadata, e.g.
	// <MetaDataItem id="0100" name="Identifier" type="2002">CT32 </MetaDataItem>
	const productLabel = path
		.basename(product.config, ".xml")
		.toLocaleUpperCase();

	// any products descriptions have productName in it, remove it
	const productName = product.name.replace(productLabel, "");

	// for some reasons some products already have the prefix `0x`, remove it
	product.id = product.id.replace(/^0x/, "");
	product.type = product.type.replace(/^0x/, "");

	// Format the device IDs like we expect them
	const productId = formatId(product.id);
	const productType = formatId(product.type);
	const manufacturerIdHex = formatId(manufacturerId);

	const deviceConfigs =
		configManager
			.getIndex()
			?.filter(
				(f: DeviceConfigIndexEntry) =>
					f.manufacturerId === manufacturerIdHex &&
					f.productType === productType &&
					f.productId === productId,
			) ?? [];
	const latestConfig = getLatestConfigVersion(deviceConfigs);

	// Determine where the config file should be
	const fileNameRelative =
		latestConfig?.filename ??
		`${manufacturerIdHex}/${labelToFilename(productLabel)}.json`;
	const fileNameAbsolute = path.join(processedDir, fileNameRelative);

	// Load the existing config so we can merge it with the updated information
	let existingDevice: Record<string, any> | undefined;

	if (await fs.pathExists(fileNameAbsolute)) {
		existingDevice = JSON5.parse(
			await fs.readFile(fileNameAbsolute, "utf8"),
		);
	}

	// Parse the OZW xml file
	const json = (
		await xml2js.parseStringPromise(productFile, {
			...xmlParserOptions_default,
			...xmlParserOptions_coerce,
		})
	).Product as Record<string, any>;

	// const metadata = ensureArray(json.MetaData?.MetaDataItem);
	// const name = metadata.find((m: any) => m.name === "Name")?.$t;
	// const description = metadata.find((m: any) => m.name === "Description")?.$t;

	const devices = existingDevice?.devices ?? [];

	if (
		!devices.some(
			(d: { productType: string; productId: string }) =>
				d.productType === productType && d.productId === productId,
		)
	) {
		devices.push({ productType, productId });
	}

	const newConfig: Record<string, any> = {
		manufacturer,
		manufacturerId: manufacturerIdHex,
		label: productLabel,
		description: existingDevice?.description ?? productName, // don't override the description
		devices: devices,
		firmwareVersion: {
			min: existingDevice?.firmwareVersion.min ?? "0.0",
			max: existingDevice?.firmwareVersion.max ?? "255.255",
		},
		associations: existingDevice?.associations ?? {},
		paramInformation: existingDevice?.paramInformation ?? [],
		compat: existingDevice?.compat,
	};

	// Merge the devices array with a potentially existing one
	if (existingDevice) {
		for (const device of existingDevice.devices) {
			if (
				!newConfig.devices.some(
					(d: any) =>
						d.productType === device.productType &&
						d.productId === device.productId,
				)
			) {
				newConfig.devices.push(device);
			}
		}
	}

	const commandClasses = ensureArray(json.CommandClass);

	// parse config params: <CommandClass id="112"> ...values... </CommandClass>
	const parameters = ensureArray(
		commandClasses.find((c: any) => c.id === CommandClasses.Configuration)
			?.Value,
	);
	for (const param of parameters) {
		if (isNaN(param.index)) continue;

		const isBitSet = param.type === "bitset";

		if (isBitSet) {
			// BitSets are split into multiple partial parameters
			const bitSetIds = ensureArray(param.BitSet);
			const defaultValue =
				typeof param.value === "number" ? param.value : 0;
			const valueSize = param.size || 1;

			// Partial params share the first part of the label
			param.label = ensureArray(param.label)[0];
			const paramLabel = param.label ? `${param.label}. ` : "";

			for (const bitSet of bitSetIds) {
				// OZW has 1-based bit indizes, we are 0-based
				const bit = (bitSet.id || 1) - 1;
				const mask = 2 ** bit;
				const id = `${param.index}[${num2hex(mask)}]`;

				// Parse the label for this bit
				const label = ensureArray(bitSet.Label)[0] ?? "";
				const desc = ensureArray(bitSet.Help)[0] ?? "";

				const found = newConfig.paramInformation.find(
					(p: any) => p["#"] === id.toString(),
				);
				const parsedParam = found ?? {};

				parsedParam.label = `${paramLabel}${label}`;
				parsedParam.description = desc;
				parsedParam.valueSize = valueSize; // The partial param must have the same value size as the original param
				// OZW only supports single-bit "partial" params, so we only have 0 and 1 as possible values
				parsedParam.minValue = 0;
				parsedParam.maxValue = 1;
				parsedParam.defaultValue = !!(defaultValue & mask) ? 1 : 0;
				parsedParam.readOnly = undefined;
				parsedParam.writeOnly = undefined;
				parsedParam.allowManualEntry = undefined;

				if (!found) newConfig.paramInformation.push(parsedParam);
			}
		} else {
			const found = newConfig.paramInformation.find(
				(p: any) => p["#"] === param.index.toString(),
			);
			const parsedParam = found ?? {};

			// By default, update existing properties with new descriptions
			// OZW's config fields could be empty strings, so we need to use || instead of ??
			parsedParam.label =
				ensureArray(param.label)[0] || parsedParam.label;
			parsedParam.description =
				ensureArray(param.Help)[0] || parsedParam.description;
			parsedParam.valueSize = updateNumberOrDefault(
				param.size,
				parsedParam.valueSize,
				1,
			);
			parsedParam.minValue = updateNumberOrDefault(
				param.min,
				parsedParam.min,
				0,
			);
			try {
				parsedParam.maxValue = updateNumberOrDefault(
					param.max,
					parsedParam.max,
					getIntegerLimits(parsedParam.valueSize, false).max, // choose the biggest possible number if no max is given
				);
			} catch {
				// some config params have absurd value sizes, ignore them
				parsedParam.maxValue = parsedParam.minValue;
			}
			if (param.read_only === true || param.read_only === "true") {
				parsedParam.readOnly = true;
			} else if (
				param.write_only === true ||
				param.write_only === "true"
			) {
				parsedParam.writeOnly = true;
			}
			parsedParam.allowManualEntry =
				!parsedParam.readOnly && param.type !== "list";

			parsedParam.defaultValue = updateNumberOrDefault(
				param.value,
				parsedParam.value,
				parsedParam.minValue, // choose the smallest possible number if no default is given
			);
			parsedParam.unsigned = true; // ozw values are all unsigned

			if (param.units) {
				parsedParam.unit = param.units;
			}

			// could have multiple translations, if so it's an array, the first is the english one
			if (isArray(parsedParam.description)) {
				parsedParam.description = parsedParam.description[0];
			}

			if (typeof parsedParam.description !== "string") {
				parsedParam.description = "";
			}

			const items = ensureArray(param.Item);

			// Parse options list
			// <Item label="Option 1" value="1"/>
			// <Item label="Option 2" value="2"/>
			if (param.type === "list" && items.length > 0) {
				parsedParam.options = [];
				for (const item of items) {
					if (
						!parsedParam.options.find(
							(v: any) => v.value === item.value,
						)
					) {
						const opt = {
							label: item.label.toString(),
							value: parseInt(item.value),
						};
						parsedParam.options.push(opt);
					}
				}
			}

			if (!found) newConfig.paramInformation.push(parsedParam);
		}
	}

	// parse associations contained in command class 133 and 142
	const associations = [
		...ensureArray(
			commandClasses.find((c: any) => c.id === CommandClasses.Association)
				?.Associations?.Group,
		),
		...ensureArray(
			commandClasses.find(
				(c: any) =>
					c.id === CommandClasses["Multi Channel Association"],
			)?.Associations?.Group,
		),
	];

	if (associations.length > 0) {
		newConfig.associations ??= {};
		for (const ass of associations) {
			const parsedAssociation = newConfig.associations[ass.index] ?? {};

			parsedAssociation.label = ass.label;
			parsedAssociation.maxNodes = ass.max_associations;
			// Only set the isLifeline key if its true
			const isLifeline =
				/lifeline/i.test(ass.label) ||
				ass.auto === "true" ||
				ass.auto === true;
			if (isLifeline) parsedAssociation.isLifeline = true;

			newConfig.associations[ass.index] = parsedAssociation;
		}
	}

	// Some devices report other CCs than they support, add this information to the compat field
	const toAdd = commandClasses
		.filter((c) => c.action === "add")
		.map((c) => c.id);
	const toRemove = commandClasses
		.filter((c) => c.action === "remove")
		.map((c) => c.id);

	if (toAdd.length > 0 || toRemove.length > 0) {
		newConfig.compat ??= {};
		newConfig.compat.cc ??= {};

		if (toAdd.length > 0) {
			newConfig.compat.cc.add = toAdd;
		}
		if (toRemove.length > 0) {
			newConfig.compat.cc.remove = toRemove;
		}
	}
	// create the target dir for this config file if doesn't exists
	const manufacturerDir = path.join(processedDir, manufacturerIdHex);
	await fs.ensureDir(manufacturerDir);

	// write the updated configuration file
	const output = stringify(normalizeConfig(newConfig), "\t") + "\n";
	await fs.writeFile(fileNameAbsolute, output, "utf8");
}

/*********************************************************
 *														 *
 *          zWave Alliance Processing Section            *
 * 														 *
 * *******************************************************/

/**
 * Parse a directory of zWave Alliance device xmls
 * */
async function parseZWAFiles(): Promise<void> {
	// Parse json files in the zwaTempDir
	let jsonData = [];

	const configFiles = await enumFilesRecursive(zwaTempDir, (file) =>
		file.endsWith(".json"),
	);

	for (const file of configFiles) {
		const j = await fs.readFile(file, "utf8");

		/**
		 * zWave Alliance numbering isn't always continuous and an html page is 
		returned when a device number doesn't. Test for and delete such files.
		 */
		if (j.charAt(0) === "{") {
			jsonData.push(JSON.parse(j));
		} else {
			void fs.unlink(file);
		}
	}

	// Combine provided files within models
	jsonData = combineDeviceFiles(jsonData);

	// Sanitize text fields for all files we'll use
	jsonData = sanitizeFields(jsonData);

	// Load our existing config files to cross-reference
	await configManager.loadManufacturers();
	if (program.devices) {
		await configManager.loadDeviceIndex();
	}

	for (const file of jsonData) {
		// Lookup the manufacturer
		const manufacturerId = parseInt(file.ManufacturerId, 16);
		const manufacturerName =
			configManager.lookupManufacturer(manufacturerId);

		// Add the manufacturer to our manufacturers.json if it is missing
		if (Number.isNaN(manufacturerId)) {
		} else if (manufacturerName === undefined && file.Brand !== undefined) {
			console.log(`Adding missing manufacturer: ${file.Brand}`);
			configManager.setManufacturer(manufacturerId, file.Brand);
		}

		/**
		 *  Process and write the device files, if called with program.devices
		 */

		if (program.devices && file.ProductId) {
			await parseZWAProduct(file, manufacturerId, manufacturerName);
		}
	}

	/**
	 *  Write the manufacturer.json file, if called with program.manufacturers
	 */
	if (program.manufacturers) {
		await configManager.saveManufacturers();
	}
}

/***
 * Combine zWave Alliance Device Files
 */
function combineDeviceFiles(json: Record<string, any>[]) {
	for (const file of json) {
		const identifier = file.Identifier ? file.Identifier : "Unknown";
		const normalizedIdentifier = normalizeIdentifier(identifier);
		file.Identifier = normalizedIdentifier[0];
		file.OriginalIdentifier = normalizedIdentifier[1];
	}

	for (const file of json) {
		const testManufactuer: number = file.ManufacturerId;
		const testCertification: string = file.CertificationNumber;
		const testParameters = file.ConfigurationParameters;
		const testIdentifier = file.Identifier;

		// Don't process if we've already seen this file
		if (!file.ProductId) {
			continue;
		}

		// Only deal with formatted IDs
		file.ProductId = file.ProductId.replace(/^0x/, "");
		file.ProductId = formatId(file.ProductId);
		file.ProductTypeId = file.ProductTypeId.replace(/^0x/, "");
		file.ProductTypeId = formatId(file.ProductTypeId);

		for (const test_file of json) {
			// Don't reprocess test files we've already seen
			if (!test_file.ProductId) {
				continue;
			}

			// Only deal with formatted IDs, but have to test as these will be undefined on subsequent visits
			test_file.ProductId = test_file.ProductId.replace(/^0x/, "");
			test_file.ProductId = formatId(test_file.ProductId);
			test_file.ProductTypeId = test_file.ProductTypeId.replace(
				/^0x/,
				"",
			);
			test_file.ProductTypeId = formatId(test_file.ProductTypeId);

			if (
				test_file.ManufacturerId === testManufactuer &&
				test_file.ProductId
			) {
				// Add the current file being tested
				if (
					test_file.Identifier === testIdentifier &&
					test_file.CertificationNumber === testCertification
				) {
					file.combinedDevices = createOrUpdateArray(
						file.combinedDevices,
						{
							ProductId: test_file.ProductId,
							ProductTypeId: test_file.ProductTypeId,
							Id: test_file.Id,
							Brand: test_file.Brand,
							Identifier: test_file.Identifier,
						},
					);
				}
				// Duplicate of file tested, so add the ID and remove the duplicate
				else if (
					test_file.ProductId === file.ProductId &&
					test_file.ProductTypeId === file.ProductTypeId &&
					isEquivalentParameters(
						testParameters,
						test_file?.ConfigurationParameters,
						"ParameterNumber",
					)
				) {
					// Add the device
					file.combinedDevices = createOrUpdateArray(
						file.combinedDevices,
						{
							ProductId: test_file.ProductId,
							ProductTypeId: test_file.ProductTypeId,
							Id: test_file.Id,
							Brand: test_file.Brand,
							Identifier: test_file.Identifier,
						},
					);
					delete test_file.Identifier;
					delete test_file.ProductId;

					// Merge the files themselves
					file.SupportedCommandClasses = keepLongest(
						file.SupportedCommandClasses,
						test_file.SupportedCommandClasses,
					);
					file.AssociationGroups = keepLongest(
						file.AssociationGroups,
						test_file.AssociationGroups,
					);
					file.Documents = keepLongest(
						file.Documents,
						test_file.Documents,
					);
					file.Texts = keepLongest(file.Texts, test_file.Texts);
					file.Features = keepLongest(
						file.Features,
						test_file.Features,
					);
				}
				// Combine devices with similar identifiers AND equivalent parameters
				else if (
					test_file.Identifier === testIdentifier &&
					testIdentifier !== "Unknown" &&
					testIdentifier.length > 3 &&
					isEquivalentParameters(
						testParameters,
						test_file?.ConfigurationParameters,
						"ParameterNumber",
					)
				) {
					file.combinedDevices = createOrUpdateArray(
						file.combinedDevices,
						{
							ProductId: test_file.ProductId,
							ProductTypeId: test_file.ProductTypeId,
							Id: test_file.Id,
							Brand: test_file.Brand,
							Identifier: test_file.Identifier,
						},
					);
					delete test_file.Identifier;
					delete test_file.ProductId;

					// Merge the files themselves
					// If they aren't both zwave plus, we need to strike the command classes
					if (
						bothZwavePlus(
							file.SupportedCommandClasses,
							test_file.SupportedCommandClasses,
						)
					) {
						file.SupportedCommandClasses = keepLongest(
							file.SupportedCommandClasses,
							test_file.SupportedCommandClasses,
						);
					} else {
						file.SupportedCommandClasses = [];
					}
					file.AssociationGroups = keepLongest(
						file.AssociationGroups,
						test_file.AssociationGroups,
					);
					file.Documents = keepLongest(
						file.Documents,
						test_file.Documents,
					);
					file.Texts = keepLongest(file.Texts, test_file.Texts);
					file.Features = keepLongest(
						file.Features,
						test_file.Features,
					);
				}
				// Show an error if the device parameters should match, but they don't
				// TODO add error handling if a FW changes parameters
				else if (
					test_file.ProductId === file.ProductId &&
					test_file.ProductTypeId === file.ProductTypeId &&
					isEquivalentParameters(
						testParameters,
						test_file?.ConfigurationParameters,
						"ParameterNumber",
					) == false
				) {
					console.log(
						`WARNING - Detected possible firmware parameter change ${file.Identifier} -- ${file.Id} and ${test_file.Id}`,
					);
				}
				// We were wrong to change the identifier because the params don't match, restore the tested file as it is different
				else if (
					test_file.Identifier === testIdentifier &&
					isEquivalentParameters(
						testParameters,
						test_file?.ConfigurationParameters,
						"ParameterNumber",
					) === false
				) {
					test_file.Identifier = test_file.OriginalIdentifier;
				}
			}
		}
	}
	function keepLongest(current_group: any, test_group: any) {
		if (current_group.length >= test_group.length) {
			return current_group;
		} else {
			return test_group;
		}
	}

	function bothZwavePlus(current_group: any, test_group: any) {
		for (const z of current_group) {
			for (const class2 of test_group) {
				if (
					(z.Identifier.includes("ZWAVEPLUS") ||
						z.Identifier.includes("ASSOCIATION_GRP_INFO")) &&
					(class2.Identifier.includes("ZWAVEPLUS") ||
						class2.Identifier.includes("ASSOCIATION_GRP_INFO"))
				) {
					return true;
				}
			}
		}
		return false;
	}
	return json;
}

/***
 * Combine zWave Alliance Device Files
 */
function sanitizeFields(json: Record<string, any>[]) {
	for (const file of json) {
		if (file.ProductId) {
			file.Identifier = file.Identifier
				? sanitizeString(file.Identifier)
				: "";
			file.Brand = file.Brand ? sanitizeString(file.Brand) : "";
		}
		if (file.AssociationGroups) {
			for (const assoc of file.AssociationGroups) {
				assoc.Description = assoc.Description
					? sanitizeString(assoc.Description)
					: "";
				assoc.group_name = assoc.group_name
					? sanitizeString(assoc.group_name)
					: "";
			}
		}
		if (file.ConfigurationParameters) {
			for (const param of file.ConfigurationParameters) {
				param.Name = param.Name ? sanitizeString(param.Name) : "";
				param.Name = param.Name ? param.Name.replace(/\.\"/g, '"') : "";
				param.Name = param.Name
					? param.Name.replace(/[\,\.\:]$/, '"')
					: "";
				param.Name = param.Name ? param.Name.replace(/\:\"/g, '"') : "";
				param.Description = param.Description
					? sanitizeString(param.Description)
					: "";
				if (param.ConfigurationParameterValues) {
					for (const value of param.ConfigurationParameterValues) {
						value.Description = value.Description
							? sanitizeString(value.Description)
							: "";
						value.Description = value.Description
							? value.Description.replace(/[\,\.\:]$/, '"')
							: "";
					}
				}
			}
		}
		if (file.Texts) {
			for (const text of file.Texts) {
				text.description = text.description
					? sanitizeString(text.description)
					: "";
				text.value = text.value ? sanitizeString(text.value) : "";
			}
		}
	}
	return json;
}

/**
 * Read and parse the product xml, add it to index if missing,
 * create/update device json config and validate the newly added
 * device
 *
 * @param product the parsed product json entry from manufacturer.xml
 */
async function parseZWAProduct(
	product: any,
	manufacturerId: number,
	manufacturer: string | undefined,
): Promise<void> {
	const productLabel = product.Identifier;

	// any products descriptions have productName in it, remove it
	const productName = product.Name.replace(productLabel, "");

	// Format the device IDs like we expect them

	let manufacturerIdHex = product.ManufacturerId.replace(/^0x/, "");
	manufacturerIdHex = formatId(manufacturerIdHex);

	/*************************************
	 *	Load the device configurations   *
	 *************************************/
	let deviceConfigs: any;
	for (const device of product.combinedDevices) {
		deviceConfigs =
			configManager
				.getIndex()
				?.filter(
					(f: DeviceConfigIndexEntry) =>
						f.manufacturerId === manufacturerIdHex &&
						f.productType === device.ProductTypeId &&
						f.productId === device.ProductId,
				) ?? [];
		if (deviceConfigs) {
			break;
		}
	}

	// Determine where the config file should be
	const latestConfig = getLatestConfigVersion(deviceConfigs);
	let fileNameRelative: string;
	if (latestConfig?.filename) {
		fileNameRelative = latestConfig?.filename;
	} else {
		fileNameRelative =
			latestConfig?.filename ??
			`${manufacturerIdHex}/${labelToFilename(productLabel)}.json`;
	}
	const fileNameAbsolute = path.join(processedDir, fileNameRelative);

	// Load the existing config so we can merge it with the updated information
	let existingDevice: Record<string, any> | undefined;

	try {
		if (await fs.pathExists(fileNameAbsolute)) {
			existingDevice = JSONC.parse(
				await fs.readFile(fileNameAbsolute, "utf8"),
			);
		}
	} catch (e) {
		console.log(
			`Error processing: ${fileNameAbsolute} - ${getErrorMessage(
				e,
				true,
			)}`,
		);
	}

	/********************************
	 *    Build the device lists    *
	 ********************************/
	const devices = existingDevice?.devices ?? [];

	for (const dev of product.combinedDevices) {
		// Append the zwa device ID to existing devices
		for (const eDevice of devices) {
			if (
				eDevice.productType == dev.ProductTypeId &&
				eDevice.productId == dev.ProductId
			) {
				eDevice.zwaveAllianceId = dev.Id;
			}
		}

		// Add new devices
		if (
			!devices.some(
				(d: { productType: string; productId: string }) =>
					d.productType === dev.ProductTypeId &&
					d.productId === dev.ProductId,
			)
		) {
			devices.push({
				productType: dev.ProductTypeId,
				productId: dev.ProductId,
				zwaveAllianceId: dev.Id,
			});
		}
	}

	/***************************************
	 *   Setup the initial configuration   *
	 ***************************************/

	const inclusion = product?.Texts?.find(
		(document: any) => document.Type === 1,
	)?.value;
	const exclusion = product?.Texts?.find(
		(document: any) => document.Type === 2,
	)?.value;
	const reset = product?.Texts?.find(
		(document: any) => document.Type === 5,
	)?.value;
	let manual = product?.Documents?.find(
		(document: any) => document.Type === 1,
	)?.value;
	const website_root =
		"https://products.z-wavealliance.org/ProductManual/File?folder=&filename=";
	if (manual) {
		manual = manual.replace(/ /g, "%20");
		manual = website_root.concat(manual);
	}

	const newConfig: Record<string, any> = {
		manufacturer,
		manufacturerId: manufacturerIdHex,
		label: productLabel,
		description: existingDevice?.description ?? productName, // don't override the description
		devices: devices,
		firmwareVersion: {
			min: existingDevice?.firmwareVersion.min ?? "0.0",
			max: existingDevice?.firmwareVersion.max ?? "255.255",
		},
		associations: existingDevice?.associations ?? {},
		paramInformation: existingDevice?.paramInformation ?? [],
		compat: existingDevice?.compat,
	};
	if (inclusion || exclusion || reset || manual) {
		newConfig.metadata = {
			inclusion: inclusion,
			exclusion: exclusion,
			reset: reset,
			manual: manual,
		};
	}

	/***************************
	 *     Clean up values     *
	 ***************************/

	newConfig.description = sanitizeString(newConfig.description);

	/**********************
	 *     Parameters     *
	 **********************/
	const parameters = product.ConfigurationParameters;

	for (const param of parameters) {
		const found = newConfig.paramInformation.find(
			(p: any) => p["#"] === param.ParameterNumber.toString(),
		);

		const parsedParam = found ?? {};

		// Skip parameter if already a template import
		if (parsedParam.$import) {
			continue;
		}

		// Skip parameter if a bitmask has already been defined
		if (
			newConfig.paramInformation.some((p: any) =>
				p["#"]?.startsWith(`${param.ParameterNumber}[`),
			)
		) {
			continue;
		}

		// By default, update existing properties with new descriptions
		parsedParam["#"] = param.ParameterNumber.toString();
		parsedParam.label = param.Name || parsedParam.label;
		parsedParam.label = normalizeLabel(parsedParam.label);
		parsedParam.description =
			param.ConfigurationParameterValues.length > 1 // Sometimes values options are described and not presented as options
				? param.Description
				: param.ConfigurationParameterValues[0].Description;
		parsedParam.description = normalizeDescription(parsedParam.description);
		parsedParam.valueSize = updateNumberOrDefault(
			param.Size,
			parsedParam.valueSize,
			1,
		);
		parsedParam.minValue = param.minValue;
		parsedParam.maxValue = param.maxValue;
		if (param.flagReadOnly === true) {
			parsedParam.readOnly = true;
		} else if (param.Description.toLowerCase().includes("write")) {
			// zWave Alliance typically puts (write only) in the description
			parsedParam.writeOnly = true;
		}
		parsedParam.allowManualEntry =
			!parsedParam.readOnly &&
			param.ConfigurationParameterValues.length <= 1;
		parsedParam.defaultValue = updateNumberOrDefault(
			param.DefaultValue,
			parsedParam.value,
			parsedParam.minValue, // choose the smallest possible number if no default is given
		);

		// Setup the unit
		if (/hours?/i.test(parsedParam.description)) {
			parsedParam.unit = "hours";
		} else if (/minutes?/i.test(parsedParam.description)) {
			parsedParam.unit = "minutes";
		} else if (/seconds?/i.test(parsedParam.description)) {
			parsedParam.unit = "seconds";
		} else if (/percent(age)?/i.test(parsedParam.description)) {
			parsedParam.unit = "%";
		} else if (/centigrade|celsius/i.test(parsedParam.description)) {
			parsedParam.unit = "°C";
		} else if (/fahrenheit/i.test(parsedParam.description)) {
			parsedParam.unit = "°F";
		}

		// Sanity check some values
		parsedParam.minValue =
			parsedParam.minValue <= parsedParam.defaultValue
				? parsedParam.minValue
				: parsedParam.defaultValue;
		parsedParam.maxValue =
			parsedParam.maxValue >= parsedParam.defaultValue
				? parsedParam.maxValue
				: parsedParam.defaultValue;

		// Setup unsigned
		if (parsedParam.minValue >= 0) {
			parsedParam.unsigned = true;
		} else {
			delete parsedParam.unsigned;
		}

		if (typeof parsedParam.description !== "string") {
			parsedParam.description = "";
		}

		// Parse options list if manual entry is disallowed (i.e. options picker)
		if (
			parsedParam.allowManualEntry !== true ||
			(parsedParam.minValue === 0 && parsedParam.maxValue === 0)
		) {
			parsedParam.options = [];
			for (const item of param.ConfigurationParameterValues) {
				// Values are given as options
				if (item.From === item.To) {
					const opt = {
						label: normalizeDescription(item.Description),
						value: item.To,
					};
					parsedParam.options.push(opt);
					parsedParam.minValue = Math.min(
						parsedParam.minValue,
						item.From,
					);
					parsedParam.maxValue = Math.max(
						parsedParam.maxValue,
						item.To,
					);
				} else {
					parsedParam.allowManualEntry = true;
					parsedParam.minValue = Math.min(
						parsedParam.minValue,
						item.From,
					);
					parsedParam.maxValue = Math.max(
						parsedParam.maxValue,
						item.To,
					);
				}
			}
		}
		if (!found) newConfig.paramInformation.push(parsedParam);
	}

	/********************************
	 *        Associations		    *
	 ********************************/

	// If Z-Wave+ is supported, we don't usually need the association information to determine the lifeline, but we still set it up in case we do

	let zwavePlus = false;
	zwavePlus = product?.SupportedCommandClasses?.find((document: any) =>
		document.Identifier.includes("ZWAVEPLUS"),
	)
		? true
		: zwavePlus;
	zwavePlus = product?.SupportedCommandClasses?.find((document: any) =>
		document.Identifier.includes("ASSOCIATION_GRP_INFO"),
	)
		? true
		: zwavePlus;
	zwavePlus = product?.AssociationGroups?.find((document: any) =>
		document.Description.includes("Z-Wave Plus"),
	)
		? true
		: zwavePlus;
	zwavePlus = existingDevice?.supportsZWavePlus ? true : zwavePlus;

	const newAssociations: Record<string, any> = newConfig.associations || {};
	let addCompat = false;
	for (const ass of product.AssociationGroups) {
		let label: string =
			ass.group_name.length > 0
				? ass.group_name
				: `Group ${ass.GroupNumber}`;
		const maxNodes = ass.MaximumNodes;
		const groupName = ass.group_name.toLowerCase();
		const description = ass.Description.toLowerCase();
		let lifeline = false;
		if (
			groupName.includes("lifeline") ||
			description.includes("lifeline")
		) {
			lifeline = true;

			// Lifeline reporting on other than #1, so we need associations even if zWave Plus
			if (ass.GroupNumber !== 1) {
				zwavePlus = false;
			}
		}

		// Add double tap support if supported by the device
		if (groupName.includes("double") || description.includes("double")) {
			label = "Double Tap";
			lifeline = true; // Required to receive Basic Set notifications
			zwavePlus = false; // Required
			addCompat = true;

			newConfig.compat ??= {};
			newConfig.compat.treatBasicSetAsEvent = true;
		}

		newAssociations[ass.GroupNumber] = {
			label: label,
			maxNodes: maxNodes,
		};
		if (lifeline) {
			newAssociations[ass.GroupNumber].isLifeline = true;
		}
	}

	// Overwrite the existing associations if we need to add the compat flag
	if (Object.keys(newConfig.associations).length !== 0 && addCompat) {
		newConfig.associations = newAssociations;
	}
	// Add the associations if the originals are blank AND the device is not zWavePlus.
	else if (
		Object.keys(newConfig.associations).length === 0 &&
		zwavePlus === false
	) {
		newConfig.associations = newAssociations;
	}

	/*************************************
	 *   Write the configuration file    *
	 *************************************/

	// Create the dir if necessary
	const manufacturerDir = path.join(processedDir, manufacturerIdHex);
	await fs.ensureDir(manufacturerDir);

	// Write the file
	const output =
		JSONC.stringify(normalizeConfig(newConfig), null, "\t") + "\n";
	await fs.writeFile(fileNameAbsolute, output, "utf8");
}

async function maintenanceParse(): Promise<void> {
	// Parse json files in the zwaTempDir
	const zwaData = [];

	// Load the zwa files
	await fs.ensureDir(zwaTempDir);
	const zwaFiles = await enumFilesRecursive(zwaTempDir, (file) =>
		file.endsWith(".json"),
	);
	for (const file of zwaFiles) {
		// zWave Alliance numbering isn't always continuous and an html page is
		// returned when a device number doesn't. Test for and delete such files.
		try {
			zwaData.push(await fs.readJSON(file, { encoding: "utf8" }));
		} catch {
			await fs.unlink(file);
		}
	}

	// Build the list of device files
	const configFiles = await enumFilesRecursive(processedDir, (file) =>
		file.endsWith(".json"),
	);
	for (const file of configFiles) {
		const j = await fs.readFile(file, "utf8");

		let jsonData;
		try {
			jsonData = JSONC.parse(j);
		} catch (e) {
			console.log(
				`Error processing: ${file} - ${getErrorMessage(e, true)}`,
			);
		}

		const includedZwaFiles: number[] = [];

		try {
			for (const device of jsonData.devices) {
				if (isArray(device.zwaveAllianceId)) {
					includedZwaFiles.push(...device.zwaveAllianceId);
				} else if (device.zwaveAllianceId) {
					includedZwaFiles.push(device.zwaveAllianceId);
				}
			}
		} catch (e) {
			console.log(
				`Error iterating: ${file} - ${getErrorMessage(e, true)}`,
			);
		}

		includedZwaFiles.sort(function (a, b) {
			return a - b;
		});

		for (const referenceDevice of includedZwaFiles) {
			for (const zwafile of zwaData) {
				if (zwafile.Id === referenceDevice) {
					let manual = zwafile?.Documents?.find(
						(document: any) => document.Type === 1,
					)?.value;

					const website_root =
						"https://products.z-wavealliance.org/ProductManual/File?folder=&filename=";

					if (manual) {
						manual = manual.replace(/ /g, "%20");
						manual = website_root.concat(manual);

						if (jsonData.metadata) {
							jsonData.metadata.manual = manual;
							break;
						} else {
							jsonData.metadata = {};
							jsonData.metadata.manual = manual;
							break;
						}
					}
				}
			}
		}

		if (jsonData.metadata) {
			/*************************************
			 *   Write the configuration file    *
			 *************************************/
			const output =
				JSONC.stringify(normalizeConfig(jsonData), null, "\t") + "\n";
			await fs.writeFile(file, output, "utf8");
		}
	}
}

/**
 * Retrieve ZWA device IDs, either the highest (most recent) device ID or all device IDs for the specified manufacturer
 * Note: ZWA's search uses different manufacturer IDs than devices
 */

async function retrieveZWADeviceIds(
	highestDeviceOnly: boolean = true,
	manufacturer: number[] = [-1],
): Promise<number[]> {
	const deviceIdsSet = new Set<number>();

	for (const manu of manufacturer) {
		let page = 1;
		// Page 1
		let currentUrl = `https://products.z-wavealliance.org/search/DoAdvancedSearch?productName=&productIdentifier=&productDescription=&category=-1&brand=${manu}&regionId=-1&order=&page=${page}`;
		const firstPage = (await axios({ url: currentUrl })).data;
		for (const i of firstPage.match(/(?<=productId=).*?(?=[\&\"])/g)) {
			deviceIdsSet.add(i);
		}
		const pageNumbers = firstPage.match(/(?<=page=\d+">).*?(?=\<)/g)
			? firstPage.match(/(?<=page=\d+">).*?(?=\<)/g)
			: [1];
		const lastPage = Math.max(...pageNumbers);

		process.stdout.write(`Processing Page 1 of ${lastPage}...`);
		// Delete the last line
		process.stdout.write("\r\x1b[K");

		if (!highestDeviceOnly) {
			page++;
			while (page <= lastPage) {
				process.stdout.write(
					`Processing Page ${page} of ${lastPage}...`,
				);
				currentUrl = `https://products.z-wavealliance.org/search/DoAdvancedSearch?productName=&productIdentifier=&productDescription=&category=-1&brand=${manu}&regionId=-1&order=&page=${page}`;
				const nextPage = (await axios({ url: currentUrl })).data;
				const nextPageIds = nextPage.match(
					/(?<=productId=).*?(?=[\&\"])/g,
				);

				for (const i of nextPageIds) {
					deviceIdsSet.add(i);
				}
				page++;
				// Delete the last line
				process.stdout.write("\r\x1b[K");
			}
		}
	}

	if (highestDeviceOnly) {
		const deviceIds: number[] = [...deviceIdsSet];
		deviceIds.sort(function (a, b) {
			return b - a;
		});
		console.log(`Highest Device Found: ${deviceIds[0]}`);
		return [deviceIds[0]];
	} else {
		const deviceIds: number[] = [...deviceIdsSet];
		console.log(`Identified ${deviceIds.length} device files`);
		return deviceIds;
	}
}

/**
 * Downloads the given device configurations from ZWA
 * @param IDs If given, only these IDs are downloaded
 */
async function downloadDevicesZWA(IDs: number[]): Promise<void> {
	await fs.ensureDir(zwaTempDir);
	for (let i = 0; i < IDs.length; i++) {
		process.stdout.write(
			`Fetching device config ${i + 1} of ${IDs.length}...`,
		);
		const content = await fetchDeviceZWA(IDs[i]);
		await fs.writeFile(
			path.join(zwaTempDir, `${IDs[i]}.json`),
			content,
			"utf8",
		);
		// Delete the last line
		process.stdout.write("\r\x1b[K");
	}
	console.log("done!");
}

/**
 * Downloads all device information from the OpenSmartHouse DB
 * @param IDs If given, only these IDs are downloaded
 */
async function downloadDevicesOH(IDs?: number[]): Promise<void> {
	if (!isArray(IDs) || !IDs.length) {
		process.stdout.write("Fetching database IDs...");
		IDs = await fetchIDsOH();
		// Delete the last line
		process.stdout.write("\r\x1b[K");
	}

	await fs.ensureDir(ohTempDir);
	for (let i = 0; i < IDs.length; i++) {
		p