Get
AI-generatedSummary
Read a value or node metadata from an Ember+ device at the specified path.
Inputs
- path (required) — The path to the Ember+ node (numeric or identifier-based). Paths use numeric format (e.g., 0.1.2) or identifier format (e.g., root.device.parameter). Empty path is rejected; a valid path is required for the operation to proceed.
Output shape
If the path resolves to a parameter (has a value), the parameter's value is returned directly. If the path resolves to a node/structure, the output contains: path, identifier, description, type, and value (which may be undefined if the node has no value).
The operation first validates the path format, ensures the device is connected, then reads the element at the given path. Errors are returned as NodeOperationError instances if the path is invalid, not found, or the device is not connected.
Examples
Example 1: Read a numeric parameter
path: '0.1.2' returns the value at that numeric path, e.g., 42 or true depending on the device state.
Example 2: Read a node descriptor
path: 'root.zone.temperature' returns { path: 'root.zone.temperature', identifier: '...', description: '...', type: 'parameter', value: