Device Evidence Bundle · draft schema 0.1
Follow the evidence behind a device capability, and help fill the gaps.
Candidate · version 0.1.0
The ZIP link is available in the hosted or built report. An extracted archive already contains these files and does not include another copy of itself.
Feature · battery
The manual describes a local low-battery warning. Two upstream implementations adapt a battery value at different layers. Raw reports and final platform values are still needed to explain whether those paths agree for a particular firmware and signature.
No physical-device observations recorded for this feature.
The inspected manual explains the warning indicator and replacement batteries, but supplies no value scale for the Zigbee battery attribute. It provides context rather than a numeric binding.
#/locations/1#/locations/2The pinned quirk selects DoublingPowerConfigurationCluster, whose battery_percentage_remaining update multiplies attribute 0x0021 by two. This describes an intermediate value; the final Home Assistant entity pipeline has not been traced in this record.
#/observations/0#/artifacts/1The pinned model entry sets dontDividePercentage to true. The selected converter branch retains the reported percentage instead of applying its default divide-by-two step. This does not contradict a cluster-level adjustment followed by different downstream processing.
#/observations/1#/artifacts/1Proposed procedure; no execution result is implied.
One source, observation, correction or scoped review is a useful contribution.
Feature · lock-state
The referenced device also carries a bounded comparison of ZHA's cluster declaration and Zigbee2MQTT's command/state exposure. It is retained as context, with no complete semantic mapping or hardware result.
No physical-device observations recorded for this feature.
The pinned ZHA quirk declares a DoorLock cluster. Zigbee2MQTT separately exposes a command-capable state field and a reported lock_state field with a not_fully_locked value. These declarations alone cannot establish identical runtime behavior.
#/observations/0#/observations/1One source, observation, correction or scoped review is a useful contribution.
Traceable records
Expand a record for its scope, citations and complete metadata. Record hashes pin the packaged metadata; upstream documents and driver code remain at their referenced locations.
{
"features": [
{
"corroboration_ids": [
"yrd210-battery-normalization"
],
"id": "battery",
"mapping_ids": [],
"next_steps": [
"Compare the exact manufacturer/model and full endpoint/cluster signature.",
"Report a sanitized raw battery attribute and final entity value, including firmware and platform versions.",
"Do not apply either adjustment twice or treat this report as a patch recommendation."
],
"summary": "Two upstream adaptations for the same model string, at different layers. Raw cluster values and final entity percentages are not interchangeable.",
"title": "Battery normalization"
},
{
"corroboration_ids": [
"yrd210-lock-exposure"
],
"id": "lock-state",
"mapping_ids": [],
"next_steps": [
"Distinguish a requested lock command from the reported actual lock state.",
"Retain partially locked and unknown values when investigating a correspondence.",
"Contribute a source correction or sanitized observation; never include real PINs or user identifiers."
],
"summary": "A cluster declaration and a richer exposes declaration are different evidence scopes. No complete cross-platform or SDF mapping has been established.",
"title": "Lock control and observed state"
}
],
"firmware": "Unknown; exact endpoint/cluster signature and installed platform versions unconfirmed",
"hardware_evidence": [],
"id": "yale-yrd210-pb-db",
"identifiers": {
"manufacturer": "Yale",
"model": "YRD210 PB DB"
},
"identity_evidence": {
"artifact_id": "zha-yale-realliving",
"locator": "YRD210PBDB220TSLL.signature.MODELS_INFO",
"manifest_id": "zha-yale-d6fcec5"
},
"kind": "catalog-device",
"limitations": [
"Founder-authored candidate corroboration only; no independent review or hardware testing.",
"Not the YRD156 Z-Wave case; protocol variants and nearby marketing models are not interchangeable.",
"ZHA requires the full device signature; Zigbee2MQTT's selected entry uses a weaker model-only matcher.",
"No SDF binding, safe installation recipe or automatic repair is provided for this case.",
"Source lineage is declared and incomplete; no independent-source or adoption score is inferred."
],
"manufacturer": "Yale",
"model": "YRD210 PB DB (Zigbee)",
"protocol": "zigbee",
"schema_version": "0.1"
}Both snapshots account for nonstandard battery reporting, but at different layers. Compare the raw attribute and the final entity value before proposing a numeric binding; do not copy either adjustment twice.
Code declarations and upstream test fixtures describe source evidence; they are not physical-device results.
The Yale YRD210 PB DB signature selects a replacement DoublingPowerConfigurationCluster. That cluster multiplies battery_percentage_remaining (0x0021) by two.
The YRD210 PB DB entry uses dontDividePercentage: true. The battery converter therefore skips its default divide-by-two step, when the reported percentage exists and is below 255.
{
"device_id": "yale-yrd210-pb-db",
"feature_id": "battery",
"id": "yrd210-battery-normalization",
"kind": "catalog-corroboration",
"limitations": [
"Human-authored candidate observations; no independent EdgeLoom review or physical-device test.",
"Sources are pinned snapshots, not a claim about the currently installed integration, coordinator or firmware.",
"Relationship labels are curator interpretations, not computed semantic equivalence. Conflicting observations must remain visible.",
"Different declared source families are not proof of independence: shared specs, authors or copied knowledge may exist.",
"No raw device report, final-entity comparison, unit-test result or SDF binding is established."
],
"lineage": [
{
"depends_on": [],
"family": "zha-quirks",
"manifest_id": "zha-yale-d6fcec5"
},
{
"depends_on": [],
"family": "zigbee-herdsman-converters",
"manifest_id": "z2m-yale-5750b44"
}
],
"observations": [
{
"claim": "The Yale YRD210 PB DB signature selects a replacement DoublingPowerConfigurationCluster. That cluster multiplies battery_percentage_remaining (0x0021) by two.",
"conditions": [
"The full endpoint/cluster signature must also match; manufacturer/model alone is insufficient for quirk selection.",
"This is a cluster-attribute adjustment, not a claim that the final HA entity shows twice the battery percentage.",
"Firmware and downstream ZHA entity normalization are not inspected in this record."
],
"evidence_kind": "code-declaration",
"id": "zha-doubling",
"identity_evidence": {
"artifact_id": "zha-yale-realliving",
"locator": "YRD210PBDB220TSLL.signature.MODELS_INFO",
"manifest_id": "zha-yale-d6fcec5"
},
"identity_match": {
"manufacturer": "Yale",
"model": "YRD210 PB DB"
},
"platform": "ZHA quirk",
"references": [
{
"artifact_id": "zha-yale-realliving",
"locator": "YRD210PBDB220TSLL.signature and replacement",
"manifest_id": "zha-yale-d6fcec5"
},
{
"artifact_id": "zha-battery-cluster",
"locator": "DoublingPowerConfigurationCluster._update_attribute",
"manifest_id": "zha-yale-d6fcec5"
}
],
"relationship": "supports",
"scope": "device-model"
},
{
"claim": "The YRD210 PB DB entry uses dontDividePercentage: true. The battery converter therefore skips its default divide-by-two step, when the reported percentage exists and is below 255.",
"conditions": [
"This definition matches zigbeeModel, without an explicit manufacturer constraint; vendor is descriptive metadata.",
"voltageToPercentage must be absent for the selected percentage branch.",
"Static source inspection only; no converter or upstream driver is executed."
],
"evidence_kind": "code-declaration",
"id": "z2m-no-halving",
"identity_evidence": {
"artifact_id": "z2m-yale-definitions",
"locator": "definitions[zigbeeModel includes YRD210 PB DB]",
"manifest_id": "z2m-yale-5750b44"
},
"identity_match": {
"model": "YRD210 PB DB"
},
"platform": "Zigbee2MQTT converter",
"references": [
{
"artifact_id": "z2m-yale-definitions",
"locator": "YRD210-HA-605; lockExtend({battery: {dontDividePercentage: true}})",
"manifest_id": "z2m-yale-5750b44"
},
{
"artifact_id": "z2m-battery-converter",
"locator": "battery.convert; batteryPercentageRemaining; dontDividePercentage",
"manifest_id": "z2m-yale-5750b44"
}
],
"relationship": "supports",
"scope": "device-model"
}
],
"review": {
"author": "github:@infinitywings",
"lifecycle": "candidate",
"reviewers": []
},
"schema_version": "0.1",
"source_manifests": [
{
"id": "zha-yale-d6fcec5",
"path": "catalog/sources/zha-yale-d6fcec5.json",
"sha256": "dec7079fabb43777be098f10d5e6dda11642bd926f45df9cc030342380a0e4d7"
},
{
"id": "z2m-yale-5750b44",
"path": "catalog/sources/z2m-yale-5750b44.json",
"sha256": "b1b7c256d3d3d805125684a3c680144d8f05b5f9a4b86067e4730cd5953ffa00"
}
],
"summary": "Both snapshots account for nonstandard battery reporting, but at different layers. Compare the raw attribute and the final entity value before proposing a numeric binding; do not copy either adjustment twice.",
"title": "Same battery intent, different adaptation"
}The matching ZHA quirk retains a DoorLock cluster. Zigbee2MQTT declares separate command/state and actual-state fields. These artifacts alone do not establish equal UI behavior or a complete cross-platform mapping.
Code declarations and upstream test fixtures describe source evidence; they are not physical-device results.
YRD210PBDB220TSLL includes DoorLock in its signature and replacement input clusters. The quirk itself does not define the downstream HA lock entity's states.
The shared e.lock() constructor declares state as LOCK/UNLOCK with state/set/get access, and lock_state as not_fully_locked/locked/unlocked with state-only access.
{
"device_id": "yale-yrd210-pb-db",
"feature_id": "lock-state",
"id": "yrd210-lock-exposure",
"kind": "catalog-corroboration",
"limitations": [
"Human-authored candidate observations; no independent EdgeLoom review or physical-device test.",
"Sources are pinned snapshots, not a claim about the currently installed integration, coordinator or firmware.",
"Relationship labels are curator interpretations, not computed semantic equivalence. Conflicting observations must remain visible.",
"No SDF correspondence is added for this Zigbee case; lack of a catalog binding is not a limitation of SDF.",
"Commands, observations and partially locked state must not be collapsed into a single binary semantic binding."
],
"lineage": [
{
"depends_on": [],
"family": "zha-quirks",
"manifest_id": "zha-yale-d6fcec5"
},
{
"depends_on": [],
"family": "zigbee-herdsman-converters",
"manifest_id": "z2m-yale-5750b44"
}
],
"observations": [
{
"claim": "YRD210PBDB220TSLL includes DoorLock in its signature and replacement input clusters. The quirk itself does not define the downstream HA lock entity's states.",
"conditions": [
"Endpoint and complete cluster signature must match.",
"Cluster presence is not whole-platform exposure or hardware success."
],
"evidence_kind": "code-declaration",
"id": "zha-lock-cluster",
"identity_evidence": {
"artifact_id": "zha-yale-realliving",
"locator": "YRD210PBDB220TSLL.signature.MODELS_INFO",
"manifest_id": "zha-yale-d6fcec5"
},
"identity_match": {
"manufacturer": "Yale",
"model": "YRD210 PB DB"
},
"platform": "ZHA quirk",
"references": [
{
"artifact_id": "zha-yale-realliving",
"locator": "YRD210PBDB220TSLL.signature and replacement; DoorLock.cluster_id",
"manifest_id": "zha-yale-d6fcec5"
}
],
"relationship": "context",
"scope": "device-model"
},
{
"claim": "The shared e.lock() constructor declares state as LOCK/UNLOCK with state/set/get access, and lock_state as not_fully_locked/locked/unlocked with state-only access.",
"conditions": [
"Model-only matcher; no explicit manufacturer constraint in this definition.",
"Exposed metadata is not a firmware capability test or confirmation that all state values occur."
],
"evidence_kind": "code-declaration",
"id": "z2m-lock-exposes",
"identity_evidence": {
"artifact_id": "z2m-yale-definitions",
"locator": "definitions[zigbeeModel includes YRD210 PB DB]",
"manifest_id": "z2m-yale-5750b44"
},
"identity_match": {
"model": "YRD210 PB DB"
},
"platform": "Zigbee2MQTT exposes",
"references": [
{
"artifact_id": "z2m-yale-definitions",
"locator": "YRD210-HA-605; lockExtend; exposes e.lock()",
"manifest_id": "z2m-yale-5750b44"
},
{
"artifact_id": "z2m-exposes",
"locator": "presets.lock; Lock.withState; Lock.withLockState; access",
"manifest_id": "z2m-yale-5750b44"
}
],
"relationship": "context",
"scope": "device-model"
}
],
"review": {
"author": "github:@infinitywings",
"lifecycle": "candidate",
"reviewers": []
},
"schema_version": "0.1",
"source_manifests": [
{
"id": "zha-yale-d6fcec5",
"path": "catalog/sources/zha-yale-d6fcec5.json",
"sha256": "dec7079fabb43777be098f10d5e6dda11642bd926f45df9cc030342380a0e4d7"
},
{
"id": "z2m-yale-5750b44",
"path": "catalog/sources/z2m-yale-5750b44.json",
"sha256": "b1b7c256d3d3d805125684a3c680144d8f05b5f9a4b86067e4730cd5953ffa00"
}
],
"summary": "The matching ZHA quirk retains a DoorLock cluster. Zigbee2MQTT declares separate command/state and actual-state fields. These artifacts alone do not establish equal UI behavior or a complete cross-platform mapping.",
"title": "Cluster declaration versus exposed state"
}Merged Yale Real Living signature and battery quirk declarations. Device selection also depends on endpoint/cluster signatures, not just a marketing name.
Upstream repository ↗ · commit d6fcec59eff9f63f154723500be9378be926d927
Manufacturer/model and endpoint signature; replacement power-configuration cluster.
Declared source SHA-256:c481e5b44fc3f00b6e58e44134ae1bbd5d42a5af074df6fd39a7dafe5765c402DoublingPowerConfigurationCluster implementation; not a full downstream entity pipeline.
Declared source SHA-256:5481da1a0ce5fd6d2a4592f1a95c6ed1e1d4288a83edce817d0995981a42209bPinned upstream license text.
Declared source SHA-256:c71d239df91726fc519c6eb72d318ec65820627232b2f796219e87dcf35d0ab4Source references describe pinned implementation snapshots. Upstream code is not included or executed by this bundle.
{
"artifacts": [
{
"artifact_role": "evidence",
"description": "Manufacturer/model and endpoint signature; replacement power-configuration cluster.",
"id": "zha-yale-realliving",
"layer": "platform-exposure",
"license": {
"evidence_path": "LICENSE.md",
"expression": "Apache-2.0"
},
"media_type": "text/x-python",
"path": "zhaquirks/yale/realliving.py",
"sha256": "c481e5b44fc3f00b6e58e44134ae1bbd5d42a5af074df6fd39a7dafe5765c402",
"source_maturity": "community"
},
{
"artifact_role": "evidence",
"description": "DoublingPowerConfigurationCluster implementation; not a full downstream entity pipeline.",
"id": "zha-battery-cluster",
"layer": "platform-exposure",
"license": {
"evidence_path": "LICENSE.md",
"expression": "Apache-2.0"
},
"media_type": "text/x-python",
"path": "zhaquirks/__init__.py",
"sha256": "5481da1a0ce5fd6d2a4592f1a95c6ed1e1d4288a83edce817d0995981a42209b",
"source_maturity": "community"
},
{
"artifact_role": "evidence",
"description": "Pinned upstream license text.",
"id": "zha-license",
"layer": "platform-exposure",
"license": {
"evidence_path": "LICENSE.md",
"expression": "Apache-2.0"
},
"media_type": "text/plain",
"path": "LICENSE.md",
"sha256": "c71d239df91726fc519c6eb72d318ec65820627232b2f796219e87dcf35d0ab4",
"source_maturity": "community"
}
],
"description": "Merged Yale Real Living signature and battery quirk declarations. Device selection also depends on endpoint/cluster signatures, not just a marketing name.",
"ecosystem": "zha",
"id": "zha-yale-d6fcec5",
"kind": "source-manifest",
"repository": {
"commit": "d6fcec59eff9f63f154723500be9378be926d927",
"url": "https://github.com/zigpy/zha-device-handlers"
},
"schema_version": "0.1"
}Yale converter definitions, exposure constructors and battery converter. Sources are statically inspected, not imported; firmware and coordinator behavior remain untested.
Upstream repository ↗ · commit 5750b44559405203b202e0f5539dc0d6f46f1c8d
Model-only matching, battery metadata and shared lock exposure declarations.
Declared source SHA-256:ba8a4e8d896c09c40fc4268d5d0106617f10d897fcf97d8c010f682072d5c8c6Battery conversion with dontDividePercentage condition and invalid-value guard.
Declared source SHA-256:a04ba5f429f4e04808b05327248f867b88b98229af7ac37a10ff589e507a9dc2Lock state, access and numeric exposure constructors.
Declared source SHA-256:498bc040fe1badcd8f8cd9acccb722589f9faaf407405a0e0818570c27a04067Pinned upstream license text.
Declared source SHA-256:b5ffb673900b5ec1f84e929f45077d429a0645b43c4b4eda65de815dfd02aef1Source references describe pinned implementation snapshots. Upstream code is not included or executed by this bundle.
{
"artifacts": [
{
"artifact_role": "evidence",
"description": "Model-only matching, battery metadata and shared lock exposure declarations.",
"id": "z2m-yale-definitions",
"layer": "platform-exposure",
"license": {
"evidence_path": "LICENSE",
"expression": "MIT"
},
"media_type": "text/typescript",
"path": "src/devices/yale.ts",
"sha256": "ba8a4e8d896c09c40fc4268d5d0106617f10d897fcf97d8c010f682072d5c8c6",
"source_maturity": "community"
},
{
"artifact_role": "evidence",
"description": "Battery conversion with dontDividePercentage condition and invalid-value guard.",
"id": "z2m-battery-converter",
"layer": "platform-exposure",
"license": {
"evidence_path": "LICENSE",
"expression": "MIT"
},
"media_type": "text/typescript",
"path": "src/converters/fromZigbee.ts",
"sha256": "a04ba5f429f4e04808b05327248f867b88b98229af7ac37a10ff589e507a9dc2",
"source_maturity": "community"
},
{
"artifact_role": "evidence",
"description": "Lock state, access and numeric exposure constructors.",
"id": "z2m-exposes",
"layer": "platform-exposure",
"license": {
"evidence_path": "LICENSE",
"expression": "MIT"
},
"media_type": "text/typescript",
"path": "src/lib/exposes.ts",
"sha256": "498bc040fe1badcd8f8cd9acccb722589f9faaf407405a0e0818570c27a04067",
"source_maturity": "community"
},
{
"artifact_role": "evidence",
"description": "Pinned upstream license text.",
"id": "z2m-license",
"layer": "platform-exposure",
"license": {
"evidence_path": "LICENSE",
"expression": "MIT"
},
"media_type": "text/plain",
"path": "LICENSE",
"sha256": "b5ffb673900b5ec1f84e929f45077d429a0645b43c4b4eda65de815dfd02aef1",
"source_maturity": "community"
}
],
"description": "Yale converter definitions, exposure constructors and battery converter. Sources are statically inspected, not imported; firmware and coordinator behavior remain untested.",
"ecosystem": "zigbee2mqtt",
"id": "z2m-yale-5750b44",
"kind": "source-manifest",
"repository": {
"commit": "5750b44559405203b202e0f5539dc0d6f46f1c8d",
"url": "https://github.com/Koenkk/zigbee-herdsman-converters"
},
"schema_version": "0.1"
}official source declaration · family-context
Content digest declared; document bytes are not included or checked by this report.
Declared document SHA-256: 189029b598d750309251129d99018c9b0e50d349f80da01f7727c9f2caff8446
Redistribution: not-granted. The cited publisher notice reserves reproduction rights. No redistribution permission was obtained. Only catalog-authored metadata, paraphrases, the upstream link and the inspected file digest are included; the PDF and page images are not distributed.
{
"accessed_at": "2026-10-08",
"applicability": {
"manufacturer": "Yale",
"model": "YRD210 product family",
"notes": [
"Yale's official support directory links this PDF as the YRD210 keypad deadbolt manual: https://support.shopyalehome.com/where-do-i-find-installation-manuals-for-yrl-previous-generation--SJKr09bBH . The directory and linked PDF were inspected on the access date.",
"The main manual names YRD210, and the PDF includes separate Z-Wave and Zigbee module sheets. This does not identify the exact YRD210 PB DB firmware or full ZHA endpoint/cluster signature.",
"Use the manual for family-level battery and local indicator context, not as proof of a Zigbee raw-value scale or a correspondence between platform outputs."
],
"scope": "family-context"
},
"capture": {
"byte_size": 3378722,
"media_type": "application/pdf",
"mode": "digest-recorded",
"sha256": "189029b598d750309251129d99018c9b0e50d349f80da01f7727c9f2caff8446"
},
"contributed_by": "github:@infinitywings",
"document_version": "P/N AYRD-210-INST-FUL Rev G; 24-page PDF including Z-Wave and Zigbee module supplements",
"id": "yale-yrd210-manual-rev-g",
"kind": "document-source",
"limitations": [
"The official directory establishes the publisher link; the CDN URL itself is mutable. The recorded digest identifies the inspected bytes but does not guarantee future availability or archive them.",
"No exact firmware applicability, raw battery attribute scale, downstream platform percentage, independent review or hardware observation is established.",
"Catalog metadata was prepared with Codex assistance under the contributor's direction; source inspection is not an independent review."
],
"locations": [
{
"description": "Names the YRD210 push-button deadbolt and the Rev G document identifier.",
"id": "model-and-revision",
"locator": "PDF page 1, title and footer"
},
{
"description": "Describes the local red low-battery indicator; no numeric Zigbee attribute encoding is supplied.",
"id": "low-battery-indicator",
"locator": "PDF/printed pages 11 and 16, Programming Instructions and Low Battery definition"
},
{
"description": "Connects the local warning to replacement of four AA alkaline batteries.",
"id": "battery-replacement",
"locator": "PDF/printed page 18, Programming Troubleshooting, intermittent red flashes row"
},
{
"description": "Includes a separate Zigbee module installation and enrollment sheet; it does not specify battery normalization.",
"id": "zigbee-module-supplement",
"locator": "PDF page 23, Yale Real Living ZigBee Module supplement, P/N AYR200-ZB-INSTAL-FUL Rev F"
},
{
"description": "Identifies Yale Security Inc., copyright 2017, and requires express written permission for reproduction.",
"id": "copyright-notice",
"locator": "PDF/printed page 20, publisher and copyright footer"
}
],
"publisher": "Yale Locks & Hardware / Yale Security Inc.",
"rights": {
"notice": "The cited publisher notice reserves reproduction rights. No redistribution permission was obtained. Only catalog-authored metadata, paraphrases, the upstream link and the inspected file digest are included; the PDF and page images are not distributed.",
"redistribution": "not-granted"
},
"schema_version": "0.1",
"source_maturity": "official",
"title": "Yale Real Living Push Button Deadbolt (YRD210): Installation and Programming Instructions",
"url": "https://cdn.shopify.com/s/files/1/0097/2433/0084/files/Installation_Manual_YRD210.pdf?227461"
}People & progress
No scoped reviews recorded in this bundle.
Record hashes and reference checks establish package consistency. They do not authenticate a publisher, establish independent review, or demonstrate device behavior.
{
"implementation_digest": "4da04cad7e70ead6ab57c7ac26a24a1795b2e30883534af1366cb8f35790979f",
"package_version_label": "0.2.0",
"version_label_is_not_release_attestation": true
}{
"contracts": "passed",
"hardware": "not-tested-by-this-tool",
"record_digests": "matched",
"references": "passed",
"review_identity": "not-authenticated",
"upstream_bytes": "not-checked"
}