feat(ui, zwaveclient): learn/secondary controller mode

api/lib/ZwaveClient.ts

@@ -108,6 +108,9 @@
 	ProvisioningEntryStatus,
 	AssociationCheckResult,
 	LinkReliabilityCheckResult,
+	JoinNetworkOptions,
+	JoinNetworkStrategy,
+	JoinNetworkResult,
 } from 'zwave-js'
 import { getEnumMemberName, parseQRCodeString } from 'zwave-js/Utils'
 import { configDbDir, logsDir, nvmBackupsDir, storeDir } from '../config/app'
@@ -217,6 +220,8 @@
 	'checkForConfigUpdates',
 	'installConfigUpdate',
 	'shutdownZwaveAPI',
+	'startLearnMode',
+	'stopLearnMode',
 	'pingNode',
 	'restart',
 	'grantSecurityClasses',
@@ -2891,6 +2896,48 @@
 		}
 	}
 
+	/**
+	 * Stops learn mode
+	 */
+	stopLearnMode(): Promise<boolean> {
+		if (this.driverReady) {
+			if (this.commandsTimeout) {
+				clearTimeout(this.commandsTimeout)
+				this.commandsTimeout = null
+			}
+			return this._driver.controller.stopJoiningNetwork()
+		}
+
+		throw new DriverNotReadyError()
+	}
+
+	/**
+	 * Starts learn mode
+	 */
+	async startLearnMode(): Promise<JoinNetworkResult> {
+		if (this.driverReady) {
+			if (this.commandsTimeout) {
+				clearTimeout(this.commandsTimeout)
+				this.commandsTimeout = null
+			}
+
+			this.commandsTimeout = setTimeout(
+				() => {
+					this.stopLearnMode().catch(logger.error)
+				},
+				(this.cfg.commandsTimeout || 0) * 1000 || 30000,
+			)
+
+			const joinNetworkOptions: JoinNetworkOptions = {
+				strategy: JoinNetworkStrategy.Default,
+			}
+
+			return this._driver.controller.beginJoiningNetwork(joinNetworkOptions)
+		}
+
+		throw new DriverNotReadyError()
+	}
+
 	/**
 	 * Request an update of this value
 	 *

src/views/ControlPanel.vue

@@ -321,6 +321,25 @@ export default {
 					color: 'warning',
 					desc: 'Allows to shutdown the Zwave API to safely unplug the Zwave stick.',
 				},
+				{
+					text: 'Learn mode',
+					options: [
+						{
+							name: 'Start',
+							action: 'startLearnMode',
+							args: {
+								confirm:
+									'Initiate learn mode on primary controller first and then click OK here.',
+							},
+						},
+						{
+							name: 'Stop',
+							action: 'stopLearnMode',
+						},
+					],
+					icon: 'join_inner',
+					desc: 'Instruct controller to run learning mode (can join pre-existing network)',
+				},
 			],
 			rules: {
 				required: (value) => {