Skip to content

Commit 92b1461

Browse files
BrentIOclaude
andcommitted
Document device object properties in haDiscoveryConfigPayload
Expand the device object schema to list all published fields, with explicit documentation that sw_version is "VERSION (COMMIT_HASH)". Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 8096026 commit 92b1461

1 file changed

Lines changed: 36 additions & 0 deletions

File tree

Controller/asyncapi.yaml

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1551,6 +1551,42 @@ components:
15511551
device:
15521552
type: object
15531553
description: Device grouping information
1554+
properties:
1555+
identifiers:
1556+
type: array
1557+
description: List of unique device identifiers
1558+
items:
1559+
type: string
1560+
name:
1561+
type: string
1562+
description: Device display name
1563+
manufacturer:
1564+
type: string
1565+
description: Device manufacturer name
1566+
model:
1567+
type: string
1568+
description: Device model name
1569+
model_id:
1570+
type: string
1571+
description: Device model identifier
1572+
serial_number:
1573+
type: string
1574+
description: Device serial number (UUID)
1575+
sw_version:
1576+
type: string
1577+
description: >
1578+
Installed firmware version concatenated with the short commit hash in the
1579+
format "VERSION (COMMIT_HASH)", e.g. "2026.06.05 (1a2b3c4d)".
1580+
examples:
1581+
- "2026.06.05 (1a2b3c4d)"
1582+
configuration_url:
1583+
type: string
1584+
description: URL of the device's local web UI
1585+
examples:
1586+
- "http://192.168.1.100"
1587+
suggested_area:
1588+
type: string
1589+
description: Suggested Home Assistant area; omitted when not configured
15541590

15551591
clientCertStatePayload:
15561592
type: object

0 commit comments

Comments
 (0)