Skip to content

@mega-yfue/eufy-sdk / ReadDescriptor

Interface: ReadDescriptor ​

One read installed on a bound capability object — a value the device reports, and what it means.

Properties ​

accessor ​

ts
accessor: string;

The getter's name on the capability object (dev.battery()?.level → level).


description? ​

ts
description?: string;

kind? ​

ts
kind?: ValueKind;

What the value MEANS, as opposed to how it is stored. See ValueKind.


labels? ​

ts
labels?: Readonly<Record<string, string>>;

Labels for values, keyed by the raw value as a string.


property ​

ts
property: string;

The name the same value carries in the device's flat property namespace (getProperty).


type ​

ts
type: PropertyValueType;

How the value is stored.


unit? ​

ts
unit?: string;

The unit the device reports the value in, when it has one ("%", "°C", "dBm").


values? ​

ts
values?: readonly (string | number)[];

The option set, for a value out of a fixed domain.


writable ​

ts
writable: boolean;

Whether a setter for this value is installed BESIDE the getter on the same object.

Read off the bound object rather than the schema, so it means "a caller can write this on THIS device" — a write the device gave no evidence for, or one whose wire is not confirmed, is not installed and reads false here. A value driven by a differently-named method (a pair of frames, a validating setter) is false too and appears under the capability's CapabilityDescriptor.actions instead, which is where its signature is described.

Independent and unofficial. Not affiliated with, endorsed by, or sponsored by Anker Innovations, Anker eufy, or eufy. "Anker eufy", "eufy" and "Anker" are trademarks of their respective owners. Use responsibly — rapid or failed logins can trigger captcha or temporary cooldowns.