@camstack/addon-provider-reolink 1.2.138 → 1.2.139

package/dist/addon.js

@@ -5386,7 +5386,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BDR76Ykr.mjs
+//#region ../types/dist/sleep-B1y0Fo1U.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -31657,14 +31657,81 @@ function summarisePrivacyAudio(profiles) {
 	if (profiles.length === 0) return null;
 	return profiles.some((p) => p.audioEnabled);
 }
+/**
+* What a preset id DOES on this camera.
+*
+* On several PTZ firmwares the preset namespace is shared: low ids are stored
+* positions, a reserved band triggers camera FUNCTIONS. The dispensa camera
+* (Hikvision) returns its own reserved band in the preset list, named by the
+* firmware:
+*
+*   34 Back to origin · 39 Day mode · 40 Night mode · 46 Day/Night Auto Mode
+*   92 Set manual limits · 93 Save manual limits · 94 Remote reboot
+*   95 Call OSD menu
+*
+* We used to hand all of these to the UI as ordinary presets. Saving over one
+* is what produced `PUT /ISAPI/PTZCtrl/channels/1/presets/34 -> HTTP 500`: the
+* camera refusing to let "Back to origin" be overwritten, surfaced to the
+* operator as a transport failure.
+*
+* A function preset stays fully usable as a DESTINATION -- `goToPreset('34')`
+* is the single most useful thing that camera can do. Only `savePreset` and
+* `deletePreset` are gated.
+*/
+var PtzPresetFunctionSchema = _enum([
+	"home",
+	"day-mode",
+	"night-mode",
+	"day-night-auto",
+	"set-limits",
+	"save-limits",
+	"reboot",
+	"osd-menu"
+]);
 var PtzPresetSchema = object({
 	id: string(),
-	name: string()
+	name: string(),
+	/**
+	* The firmware function this id performs, when the provider KNOWS the id is
+	* reserved. `null` = an ordinary stored position, OR a reserved id this
+	* provider does not recognise -- the two are told apart by `writable`.
+	*/
+	fn: PtzPresetFunctionSchema.nullable(),
+	/**
+	* Whether `savePreset` / `deletePreset` may target this id. A provider sets
+	* it false only for a band it KNOWS is reserved; where the firmware is not
+	* documented it stays true and a refusal comes from the camera, named.
+	*/
+	writable: boolean()
 });
+/**
+* Where the head is pointing -- per axis, and `null` when the driver cannot
+* read it.
+*
+* It used to be three REQUIRED numbers, which left a provider that cannot read
+* position no way to say so. All four said `0`:
+*
+*   reolink   `return { pan: 0, tilt: 0, zoom: 0 }`  "until a position-query
+*                                                     path lands upstream"
+*   hikvision stub, "firmware-dependent and frequently absent"
+*   amcrest   stub, "no generic absolute-position read for this model family"
+*   onvif     throws
+*
+* So every consumer asking where a camera points was told "perfectly centred"
+* by four cameras that had never looked. That is D393 -- a measurement that
+* FAILED is `null`, never `0`, and the type says so all the way to the
+* decision -- the same shape as the unreadable `statfs` folded into "0 bytes of
+* headroom", which evacuated a healthy disk.
+*
+* D393 also says to check for a narrower structural TWIN of the result type.
+* There is one: `PtzStatusSchema` extends this, so the lie had already
+* propagated into `getStatus`, which is the surface `getPosition`'s own comment
+* tells callers to migrate to.
+*/
 var PtzPositionSchema = object({
-	pan: number(),
-	tilt: number(),
-	zoom: number()
+	pan: number().nullable(),
+	tilt: number().nullable(),
+	zoom: number().nullable()
 });
 var PtzMoveCommandSchema = object({
 	pan: number().optional(),
@@ -31686,7 +31753,72 @@ var PtzOptionsSchema = object({
 	maxPresets: number().optional(),
 	/** Whether the camera exposes a controllable autofocus toggle
 	*  (boolean `hasX` per the getOptions availability convention). */
-	hasAutofocus: boolean()
+	hasAutofocus: boolean(),
+	/**
+	* How many distinct speeds this camera's NATIVE scale offers.
+	*
+	* The cap's `speed` is normalized 0..1 and each provider maps it down --
+	* Baichuan 1..63, Dahua 1..8, ISAPI's percentage -100..100. The normalized
+	* value hides how coarse that really is: asking an amcrest for `0.37` is
+	* meaningless, because it has eight steps and three of them round to the
+	* same one. A loop that tunes its own gain has to know the granularity of
+	* the knob it is turning.
+	*
+	* `null` = the driver does not know, or the scale is continuous (ONVIF takes
+	* a float). Never a made-up number.
+	*/
+	speedSteps: number().int().positive().nullable(),
+	/**
+	* How long ONE `move` pulse runs on this driver, ms.
+	*
+	* `move` is a self-terminating burst everywhere, but every provider hardcoded
+	* its own duration in private -- 200 reolink, 350 amcrest, 500 hikvision,
+	* 1000 onvif -- so no caller could read it. It is the DENOMINATOR of "how far
+	* did the head travel per pulse": without it a measured displacement has no
+	* gain to be divided into.
+	*
+	* `null` = the driver cannot say.
+	*/
+	moveImpulseMs: number().int().positive().nullable()
+});
+/**
+* Which preset `goHome` goes to, and WHO decided.
+*
+* `goHome` used to be three vendor "conventions" written in three comments --
+* Reolink preset 0, Hikvision preset '1', Dahua preset 1 -- and on this fleet
+* not one of the three cameras honours its own:
+*
+*   592  Videocamera camera Daniel (reolink)   preset 0 holds "stanza"
+*   1438 Videocamera dispensa (hikvision)      preset 1 holds "Credenza"
+*   3836 Videocamera studio (amcrest)          preset 1 holds "Preset1"
+*
+* So `goHome` meant "go wherever the operator happened to save in slot 0 or 1",
+* and two of the three swallowed the failure in a bare `catch`. For autotrack
+* this is the HOTTEST path -- it runs every time a subject is released -- so it
+* needs an answer that is true per camera and audible when it is missing.
+*
+* `source` is what makes it honest:
+*   - `operator` -- picked in the UI, stored by the provider.
+*   - `firmware` -- the camera itself named a preset `fn: 'home'` (Hikvision's
+*     "Back to origin"), adopted as the default with nothing to configure.
+*   - `native`   -- the driver homes WITHOUT a preset at all. ONVIF does:
+*     `goHome` is `ptzAbsoluteMove({x:0, y:0, zoom:0})`. `presetId` is null and
+*     that is not a failure -- there is nothing to pick, and the UI must offer
+*     no picker.
+*   - `none`     -- nothing is configured and the camera names nothing.
+*     `goHome` REFUSES rather than moving the head somewhere arbitrary.
+*
+* `source === 'none'` is the refusal condition, NOT `presetId === null`: the
+* native case has no preset and homes perfectly well.
+*/
+var PtzHomePresetSchema = object({
+	presetId: string().nullable(),
+	source: _enum([
+		"operator",
+		"firmware",
+		"native",
+		"none"
+	])
 });
 var ptzCapability = {
 	name: "ptz",
@@ -31727,7 +31859,25 @@ var ptzCapability = {
 			auth: "admin"
 		}),
 		getOptions: method(object({ deviceId: number() }), PtzOptionsSchema),
+		/**
+		* Move to the camera's configured home preset. THROWS when
+		* `getHomePreset()` resolves to `none` -- a head that did not move must
+		* never look like a head that went home.
+		*/
 		goHome: method(object({ deviceId: number() }), _void(), { kind: "mutation" }),
+		/** Which preset `goHome` targets, and who decided it. */
+		getHomePreset: method(object({ deviceId: number() }), PtzHomePresetSchema),
+		/**
+		* Pin the home preset for this camera. `null` clears the operator's choice
+		* and falls back to whatever the firmware names, or to `none`.
+		*/
+		setHomePreset: method(object({
+			deviceId: number(),
+			presetId: string().nullable()
+		}), _void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/**
 		* Pull the current PTZ position. Redundant with the auto-injected
 		* `getStatus` method (see `status` below); kept for callers that
@@ -41398,6 +41548,12 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"ptz.getHomePreset": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"ptz.getOptions": {
 		capName: "ptz",
 		capScope: "device",
@@ -41446,6 +41602,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"ptz.setHomePreset": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"ptz.stop": {
 		capName: "ptz",
 		capScope: "device",
@@ -44619,6 +44781,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.getHomePreset": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.getOptions": [{
 		name: "deviceId",
 		form: "single",
@@ -44659,6 +44826,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.setHomePreset": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.stop": [{
 		name: "deviceId",
 		form: "single",
@@ -148323,6 +148495,17 @@ var ReolinkStreamProfileOptionsSchema = object({
 	}).optional()
 });
 var reolinkCameraSchema = object({
+	/**
+	* Which preset `ptz.goHome` targets on THIS camera.
+	*
+	* Empty = nothing configured, and `goHome` then REFUSES. It used to go to a
+	* hardcoded slot on a vendor "convention" this fleet contradicts: reolink
+	* went to preset 0, which on device 592 holds "stanza"; amcrest went to
+	* preset 1, which on device 3836 holds "Preset1". Both swallowed the failure
+	* in a bare catch, so a head that never moved was indistinguishable from a
+	* head that went home.
+	*/
+	homePresetId: string().default("").describe("Preset id ptz.goHome targets (empty = goHome refuses)"),
 	host: string().describe("Camera IP or hostname"),
 	port: number().default(9e3).describe("Baichuan port (default 9000)"),
 	username: string().default("admin").describe("Username"),
@@ -149613,6 +149796,20 @@ function coerceNumber(value) {
 	return null;
 }
 /**
+* Baichuan's native PTZ speed scale is 1..63; `runPtz` maps the cap's
+* normalized 0..1 onto it. Named because the autotrack loop has to know the
+* GRANULARITY of the knob it turns -- a normalized 0.37 means something very
+* different on 63 steps than on amcrest's 8.
+*/
+var BAICHUAN_SPEED_STEPS = 63;
+/**
+* How long one `ptz.move` pulse runs, ms -- the `autoStopMs` handed to
+* Baichuan. It is the DENOMINATOR of "how far did the head travel per pulse",
+* so it is exported through `getOptions` rather than left a literal no caller
+* could read.
+*/
+var PTZ_MOVE_IMPULSE_MS = 200;
+/**
 * Per-device transient diagnostics blob populated from the lib's
 * `getOnlineUserSessionsForUi` + `getSocketPoolSummary` +
 * `getSocketPoolCooldownStatus` calls. NOT persisted — recomputed on
@@ -149954,6 +150151,24 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	* during `adoptDevice`). Standalone cameras default to 0 so the
 	* pre-Hub behavior is preserved verbatim.
 	*/
+	/**
+	* Which preset `goHome` targets, and who decided it.
+	*
+	* Baichuan names no home of its own, so the operator's pick is the only
+	* answer there can be. With none, `none` -- and `goHome` refuses rather than
+	* moving the head to whatever happens to sit in slot 0.
+	*/
+	async resolveHomePreset() {
+		const chosen = this.config.get("homePresetId") ?? "";
+		if (chosen === "") return {
+			presetId: null,
+			source: "none"
+		};
+		return {
+			presetId: chosen,
+			source: "operator"
+		};
+	}
 	getChannel() {
 		const ch = this.config.get("channel");
 		if (typeof ch === "number" && ch >= 0) return ch;
@@ -153331,7 +153546,9 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 						const channel = this.getChannel();
 						return (await api.getPtzPresets(channel)).map((p) => ({
 							id: String(p.id),
-							name: p.name
+							name: p.name,
+							fn: null,
+							writable: true
 						}));
 					} catch {
 						return [];
@@ -153367,7 +153584,9 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 						hasTilt: false,
 						hasZoom: false,
 						supportsPresets: false,
-						hasAutofocus: false
+						hasAutofocus: false,
+						speedSteps: BAICHUAN_SPEED_STEPS,
+						moveImpulseMs: PTZ_MOVE_IMPULSE_MS
 					};
 					const hasAutofocus = this.config.get("deviceCache")?.autoFocusSnapshot?.supported === true;
 					return this.resolveCapOptions({
@@ -153380,7 +153599,9 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 								hasTilt: capabilities.hasTilt,
 								hasZoom: capabilities.hasZoom,
 								supportsPresets: capabilities.hasPresets,
-								hasAutofocus
+								hasAutofocus,
+								speedSteps: BAICHUAN_SPEED_STEPS,
+								moveImpulseMs: PTZ_MOVE_IMPULSE_MS
 							};
 						},
 						fallback: () => {
@@ -153390,42 +153611,57 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 								hasTilt: hasPtz,
 								hasZoom: hasPtz,
 								supportsPresets: hasPtz,
-								hasAutofocus
+								hasAutofocus,
+								speedSteps: BAICHUAN_SPEED_STEPS,
+								moveImpulseMs: PTZ_MOVE_IMPULSE_MS
 							};
 						}
 					});
 				},
 				goHome: async ({ deviceId }) => {
 					if (deviceId !== this.id) return;
-					try {
-						const api = await this.ensureApi();
-						const channel = this.getChannel();
-						await api.moveToPtzPreset(channel, 0);
-					} catch {}
+					const home = await this.resolveHomePreset();
+					if (home.source === "none" || home.presetId === null) throw new Error("No home preset configured for this camera — set one in the PTZ settings");
+					const id = Number(home.presetId);
+					if (!Number.isFinite(id)) throw new Error(`Configured home preset is not a Baichuan id: ${home.presetId}`);
+					const api = await this.ensureApi();
+					const channel = this.getChannel();
+					await api.moveToPtzPreset(channel, id);
+				},
+				getHomePreset: async ({ deviceId }) => {
+					if (deviceId !== this.id) return {
+						presetId: null,
+						source: "none"
+					};
+					return this.resolveHomePreset();
+				},
+				setHomePreset: async ({ deviceId, presetId }) => {
+					if (deviceId !== this.id) return;
+					await this.config.setAll({ homePresetId: presetId ?? "" });
 				},
 				getPosition: async ({ deviceId }) => {
 					if (deviceId !== this.id) return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0
+						pan: null,
+						tilt: null,
+						zoom: null
 					};
 					return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0
+						pan: null,
+						tilt: null,
+						zoom: null
 					};
 				},
 				getStatus: async ({ deviceId }) => {
 					if (deviceId !== this.id) return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0,
+						pan: null,
+						tilt: null,
+						zoom: null,
 						autofocus: false
 					};
 					return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0,
+						pan: null,
+						tilt: null,
+						zoom: null,
 						autofocus: (this.config.get("deviceCache")?.autoFocusSnapshot)?.enabled === true
 					};
 				},
@@ -153476,13 +153712,13 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		if (tilt !== void 0 && Math.abs(tilt) > .01) cmds.push(tilt > 0 ? "Up" : "Down");
 		if (zoom !== void 0 && Math.abs(zoom) > .01) await this.runZoom(api, channel, zoom);
 		if (cmds.length === 0) return;
-		const baichuanSpeed = speed === void 0 ? 32 : Math.max(1, Math.min(63, Math.round(speed * 63)));
+		const baichuanSpeed = speed === void 0 ? Math.round(BAICHUAN_SPEED_STEPS / 2) : Math.max(1, Math.min(BAICHUAN_SPEED_STEPS, Math.round(speed * BAICHUAN_SPEED_STEPS)));
 		for (const command of cmds) try {
 			await api.ptz(channel, {
 				action: "start",
 				command,
 				speed: baichuanSpeed,
-				...continuous ? {} : { autoStopMs: 200 }
+				...continuous ? {} : { autoStopMs: PTZ_MOVE_IMPULSE_MS }
 			});
 		} catch (err) {
 			this.ctx.logger.warn("Baichuan ptz command failed", {

package/dist/addon.mjs

@@ -5381,7 +5381,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BDR76Ykr.mjs
+//#region ../types/dist/sleep-B1y0Fo1U.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -31652,14 +31652,81 @@ function summarisePrivacyAudio(profiles) {
 	if (profiles.length === 0) return null;
 	return profiles.some((p) => p.audioEnabled);
 }
+/**
+* What a preset id DOES on this camera.
+*
+* On several PTZ firmwares the preset namespace is shared: low ids are stored
+* positions, a reserved band triggers camera FUNCTIONS. The dispensa camera
+* (Hikvision) returns its own reserved band in the preset list, named by the
+* firmware:
+*
+*   34 Back to origin · 39 Day mode · 40 Night mode · 46 Day/Night Auto Mode
+*   92 Set manual limits · 93 Save manual limits · 94 Remote reboot
+*   95 Call OSD menu
+*
+* We used to hand all of these to the UI as ordinary presets. Saving over one
+* is what produced `PUT /ISAPI/PTZCtrl/channels/1/presets/34 -> HTTP 500`: the
+* camera refusing to let "Back to origin" be overwritten, surfaced to the
+* operator as a transport failure.
+*
+* A function preset stays fully usable as a DESTINATION -- `goToPreset('34')`
+* is the single most useful thing that camera can do. Only `savePreset` and
+* `deletePreset` are gated.
+*/
+var PtzPresetFunctionSchema = _enum([
+	"home",
+	"day-mode",
+	"night-mode",
+	"day-night-auto",
+	"set-limits",
+	"save-limits",
+	"reboot",
+	"osd-menu"
+]);
 var PtzPresetSchema = object({
 	id: string(),
-	name: string()
+	name: string(),
+	/**
+	* The firmware function this id performs, when the provider KNOWS the id is
+	* reserved. `null` = an ordinary stored position, OR a reserved id this
+	* provider does not recognise -- the two are told apart by `writable`.
+	*/
+	fn: PtzPresetFunctionSchema.nullable(),
+	/**
+	* Whether `savePreset` / `deletePreset` may target this id. A provider sets
+	* it false only for a band it KNOWS is reserved; where the firmware is not
+	* documented it stays true and a refusal comes from the camera, named.
+	*/
+	writable: boolean()
 });
+/**
+* Where the head is pointing -- per axis, and `null` when the driver cannot
+* read it.
+*
+* It used to be three REQUIRED numbers, which left a provider that cannot read
+* position no way to say so. All four said `0`:
+*
+*   reolink   `return { pan: 0, tilt: 0, zoom: 0 }`  "until a position-query
+*                                                     path lands upstream"
+*   hikvision stub, "firmware-dependent and frequently absent"
+*   amcrest   stub, "no generic absolute-position read for this model family"
+*   onvif     throws
+*
+* So every consumer asking where a camera points was told "perfectly centred"
+* by four cameras that had never looked. That is D393 -- a measurement that
+* FAILED is `null`, never `0`, and the type says so all the way to the
+* decision -- the same shape as the unreadable `statfs` folded into "0 bytes of
+* headroom", which evacuated a healthy disk.
+*
+* D393 also says to check for a narrower structural TWIN of the result type.
+* There is one: `PtzStatusSchema` extends this, so the lie had already
+* propagated into `getStatus`, which is the surface `getPosition`'s own comment
+* tells callers to migrate to.
+*/
 var PtzPositionSchema = object({
-	pan: number(),
-	tilt: number(),
-	zoom: number()
+	pan: number().nullable(),
+	tilt: number().nullable(),
+	zoom: number().nullable()
 });
 var PtzMoveCommandSchema = object({
 	pan: number().optional(),
@@ -31681,7 +31748,72 @@ var PtzOptionsSchema = object({
 	maxPresets: number().optional(),
 	/** Whether the camera exposes a controllable autofocus toggle
 	*  (boolean `hasX` per the getOptions availability convention). */
-	hasAutofocus: boolean()
+	hasAutofocus: boolean(),
+	/**
+	* How many distinct speeds this camera's NATIVE scale offers.
+	*
+	* The cap's `speed` is normalized 0..1 and each provider maps it down --
+	* Baichuan 1..63, Dahua 1..8, ISAPI's percentage -100..100. The normalized
+	* value hides how coarse that really is: asking an amcrest for `0.37` is
+	* meaningless, because it has eight steps and three of them round to the
+	* same one. A loop that tunes its own gain has to know the granularity of
+	* the knob it is turning.
+	*
+	* `null` = the driver does not know, or the scale is continuous (ONVIF takes
+	* a float). Never a made-up number.
+	*/
+	speedSteps: number().int().positive().nullable(),
+	/**
+	* How long ONE `move` pulse runs on this driver, ms.
+	*
+	* `move` is a self-terminating burst everywhere, but every provider hardcoded
+	* its own duration in private -- 200 reolink, 350 amcrest, 500 hikvision,
+	* 1000 onvif -- so no caller could read it. It is the DENOMINATOR of "how far
+	* did the head travel per pulse": without it a measured displacement has no
+	* gain to be divided into.
+	*
+	* `null` = the driver cannot say.
+	*/
+	moveImpulseMs: number().int().positive().nullable()
+});
+/**
+* Which preset `goHome` goes to, and WHO decided.
+*
+* `goHome` used to be three vendor "conventions" written in three comments --
+* Reolink preset 0, Hikvision preset '1', Dahua preset 1 -- and on this fleet
+* not one of the three cameras honours its own:
+*
+*   592  Videocamera camera Daniel (reolink)   preset 0 holds "stanza"
+*   1438 Videocamera dispensa (hikvision)      preset 1 holds "Credenza"
+*   3836 Videocamera studio (amcrest)          preset 1 holds "Preset1"
+*
+* So `goHome` meant "go wherever the operator happened to save in slot 0 or 1",
+* and two of the three swallowed the failure in a bare `catch`. For autotrack
+* this is the HOTTEST path -- it runs every time a subject is released -- so it
+* needs an answer that is true per camera and audible when it is missing.
+*
+* `source` is what makes it honest:
+*   - `operator` -- picked in the UI, stored by the provider.
+*   - `firmware` -- the camera itself named a preset `fn: 'home'` (Hikvision's
+*     "Back to origin"), adopted as the default with nothing to configure.
+*   - `native`   -- the driver homes WITHOUT a preset at all. ONVIF does:
+*     `goHome` is `ptzAbsoluteMove({x:0, y:0, zoom:0})`. `presetId` is null and
+*     that is not a failure -- there is nothing to pick, and the UI must offer
+*     no picker.
+*   - `none`     -- nothing is configured and the camera names nothing.
+*     `goHome` REFUSES rather than moving the head somewhere arbitrary.
+*
+* `source === 'none'` is the refusal condition, NOT `presetId === null`: the
+* native case has no preset and homes perfectly well.
+*/
+var PtzHomePresetSchema = object({
+	presetId: string().nullable(),
+	source: _enum([
+		"operator",
+		"firmware",
+		"native",
+		"none"
+	])
 });
 var ptzCapability = {
 	name: "ptz",
@@ -31722,7 +31854,25 @@ var ptzCapability = {
 			auth: "admin"
 		}),
 		getOptions: method(object({ deviceId: number() }), PtzOptionsSchema),
+		/**
+		* Move to the camera's configured home preset. THROWS when
+		* `getHomePreset()` resolves to `none` -- a head that did not move must
+		* never look like a head that went home.
+		*/
 		goHome: method(object({ deviceId: number() }), _void(), { kind: "mutation" }),
+		/** Which preset `goHome` targets, and who decided it. */
+		getHomePreset: method(object({ deviceId: number() }), PtzHomePresetSchema),
+		/**
+		* Pin the home preset for this camera. `null` clears the operator's choice
+		* and falls back to whatever the firmware names, or to `none`.
+		*/
+		setHomePreset: method(object({
+			deviceId: number(),
+			presetId: string().nullable()
+		}), _void(), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/**
 		* Pull the current PTZ position. Redundant with the auto-injected
 		* `getStatus` method (see `status` below); kept for callers that
@@ -41393,6 +41543,12 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"ptz.getHomePreset": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"ptz.getOptions": {
 		capName: "ptz",
 		capScope: "device",
@@ -41441,6 +41597,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"ptz.setHomePreset": {
+		capName: "ptz",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"ptz.stop": {
 		capName: "ptz",
 		capScope: "device",
@@ -44614,6 +44776,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.getHomePreset": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.getOptions": [{
 		name: "deviceId",
 		form: "single",
@@ -44654,6 +44821,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"ptz.setHomePreset": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"ptz.stop": [{
 		name: "deviceId",
 		form: "single",
@@ -148318,6 +148490,17 @@ var ReolinkStreamProfileOptionsSchema = object({
 	}).optional()
 });
 var reolinkCameraSchema = object({
+	/**
+	* Which preset `ptz.goHome` targets on THIS camera.
+	*
+	* Empty = nothing configured, and `goHome` then REFUSES. It used to go to a
+	* hardcoded slot on a vendor "convention" this fleet contradicts: reolink
+	* went to preset 0, which on device 592 holds "stanza"; amcrest went to
+	* preset 1, which on device 3836 holds "Preset1". Both swallowed the failure
+	* in a bare catch, so a head that never moved was indistinguishable from a
+	* head that went home.
+	*/
+	homePresetId: string().default("").describe("Preset id ptz.goHome targets (empty = goHome refuses)"),
 	host: string().describe("Camera IP or hostname"),
 	port: number().default(9e3).describe("Baichuan port (default 9000)"),
 	username: string().default("admin").describe("Username"),
@@ -149608,6 +149791,20 @@ function coerceNumber(value) {
 	return null;
 }
 /**
+* Baichuan's native PTZ speed scale is 1..63; `runPtz` maps the cap's
+* normalized 0..1 onto it. Named because the autotrack loop has to know the
+* GRANULARITY of the knob it turns -- a normalized 0.37 means something very
+* different on 63 steps than on amcrest's 8.
+*/
+var BAICHUAN_SPEED_STEPS = 63;
+/**
+* How long one `ptz.move` pulse runs, ms -- the `autoStopMs` handed to
+* Baichuan. It is the DENOMINATOR of "how far did the head travel per pulse",
+* so it is exported through `getOptions` rather than left a literal no caller
+* could read.
+*/
+var PTZ_MOVE_IMPULSE_MS = 200;
+/**
 * Per-device transient diagnostics blob populated from the lib's
 * `getOnlineUserSessionsForUi` + `getSocketPoolSummary` +
 * `getSocketPoolCooldownStatus` calls. NOT persisted — recomputed on
@@ -149949,6 +150146,24 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 	* during `adoptDevice`). Standalone cameras default to 0 so the
 	* pre-Hub behavior is preserved verbatim.
 	*/
+	/**
+	* Which preset `goHome` targets, and who decided it.
+	*
+	* Baichuan names no home of its own, so the operator's pick is the only
+	* answer there can be. With none, `none` -- and `goHome` refuses rather than
+	* moving the head to whatever happens to sit in slot 0.
+	*/
+	async resolveHomePreset() {
+		const chosen = this.config.get("homePresetId") ?? "";
+		if (chosen === "") return {
+			presetId: null,
+			source: "none"
+		};
+		return {
+			presetId: chosen,
+			source: "operator"
+		};
+	}
 	getChannel() {
 		const ch = this.config.get("channel");
 		if (typeof ch === "number" && ch >= 0) return ch;
@@ -153326,7 +153541,9 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 						const channel = this.getChannel();
 						return (await api.getPtzPresets(channel)).map((p) => ({
 							id: String(p.id),
-							name: p.name
+							name: p.name,
+							fn: null,
+							writable: true
 						}));
 					} catch {
 						return [];
@@ -153362,7 +153579,9 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 						hasTilt: false,
 						hasZoom: false,
 						supportsPresets: false,
-						hasAutofocus: false
+						hasAutofocus: false,
+						speedSteps: BAICHUAN_SPEED_STEPS,
+						moveImpulseMs: PTZ_MOVE_IMPULSE_MS
 					};
 					const hasAutofocus = this.config.get("deviceCache")?.autoFocusSnapshot?.supported === true;
 					return this.resolveCapOptions({
@@ -153375,7 +153594,9 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 								hasTilt: capabilities.hasTilt,
 								hasZoom: capabilities.hasZoom,
 								supportsPresets: capabilities.hasPresets,
-								hasAutofocus
+								hasAutofocus,
+								speedSteps: BAICHUAN_SPEED_STEPS,
+								moveImpulseMs: PTZ_MOVE_IMPULSE_MS
 							};
 						},
 						fallback: () => {
@@ -153385,42 +153606,57 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 								hasTilt: hasPtz,
 								hasZoom: hasPtz,
 								supportsPresets: hasPtz,
-								hasAutofocus
+								hasAutofocus,
+								speedSteps: BAICHUAN_SPEED_STEPS,
+								moveImpulseMs: PTZ_MOVE_IMPULSE_MS
 							};
 						}
 					});
 				},
 				goHome: async ({ deviceId }) => {
 					if (deviceId !== this.id) return;
-					try {
-						const api = await this.ensureApi();
-						const channel = this.getChannel();
-						await api.moveToPtzPreset(channel, 0);
-					} catch {}
+					const home = await this.resolveHomePreset();
+					if (home.source === "none" || home.presetId === null) throw new Error("No home preset configured for this camera — set one in the PTZ settings");
+					const id = Number(home.presetId);
+					if (!Number.isFinite(id)) throw new Error(`Configured home preset is not a Baichuan id: ${home.presetId}`);
+					const api = await this.ensureApi();
+					const channel = this.getChannel();
+					await api.moveToPtzPreset(channel, id);
+				},
+				getHomePreset: async ({ deviceId }) => {
+					if (deviceId !== this.id) return {
+						presetId: null,
+						source: "none"
+					};
+					return this.resolveHomePreset();
+				},
+				setHomePreset: async ({ deviceId, presetId }) => {
+					if (deviceId !== this.id) return;
+					await this.config.setAll({ homePresetId: presetId ?? "" });
 				},
 				getPosition: async ({ deviceId }) => {
 					if (deviceId !== this.id) return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0
+						pan: null,
+						tilt: null,
+						zoom: null
 					};
 					return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0
+						pan: null,
+						tilt: null,
+						zoom: null
 					};
 				},
 				getStatus: async ({ deviceId }) => {
 					if (deviceId !== this.id) return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0,
+						pan: null,
+						tilt: null,
+						zoom: null,
 						autofocus: false
 					};
 					return {
-						pan: 0,
-						tilt: 0,
-						zoom: 0,
+						pan: null,
+						tilt: null,
+						zoom: null,
 						autofocus: (this.config.get("deviceCache")?.autoFocusSnapshot)?.enabled === true
 					};
 				},
@@ -153471,13 +153707,13 @@ var ReolinkCamera = class ReolinkCamera extends BaseDevice {
 		if (tilt !== void 0 && Math.abs(tilt) > .01) cmds.push(tilt > 0 ? "Up" : "Down");
 		if (zoom !== void 0 && Math.abs(zoom) > .01) await this.runZoom(api, channel, zoom);
 		if (cmds.length === 0) return;
-		const baichuanSpeed = speed === void 0 ? 32 : Math.max(1, Math.min(63, Math.round(speed * 63)));
+		const baichuanSpeed = speed === void 0 ? Math.round(BAICHUAN_SPEED_STEPS / 2) : Math.max(1, Math.min(BAICHUAN_SPEED_STEPS, Math.round(speed * BAICHUAN_SPEED_STEPS)));
 		for (const command of cmds) try {
 			await api.ptz(channel, {
 				action: "start",
 				command,
 				speed: baichuanSpeed,
-				...continuous ? {} : { autoStopMs: 200 }
+				...continuous ? {} : { autoStopMs: PTZ_MOVE_IMPULSE_MS }
 			});
 		} catch (err) {
 			this.ctx.logger.warn("Baichuan ptz command failed", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-reolink",
-  "version": "1.2.138",
+  "version": "1.2.139",
   "description": "Reolink camera device provider addon for CamStack — native Baichuan protocol",
   "keywords": [
     "camstack",