Ember+ icon

Ember+

Interact with Ember+ devices

Get

AI-generated

Summary

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: }.

Links

Discussion