Describe the gateway: host, API version, mode, group and device count.

List the devices of this group.

Connection state of one device: state, port, endpoints, last update time.

Show the protocol and stream stack of the port a device is attached to.

The ISN stack is a compound object tree: MESSAGE / TRANSPORT / FRAME / USER / CUSTOM layers can nest to any depth, and new protocol types appear without notice. Layers are returned flattened, each with its path. A layer carrying a tcp_port is a stream: connect to <gateway_host>:<tcp_port> for the raw byte stream.

List the TCP streams the gateway exposes, with their names.

De-duplicated across devices that share one connection port.

List the gateway's physical connections with link counters.

Shows every connection the gateway holds - USB, serial or a TCP client it dialled for a stream - including one with no device behind it, which the device and stream views cannot represent.

Start here: fetch the gateway's own HTML page for a device.

This is the description layer. It groups parameters into sections (System, Acquire, Trigger, Channels, ...), shows units, live values and free-text diagnostics (status, message, error number), and every value carries its parameter name - so it is how you learn what a device is and what its parameters mean before reading or writing them.

It honours the server's access level: with development/hidden enabled the page grows (140 -> 195 parameters on this gateway). Fetching it marks the device as described, which the write tools report back.

Read the gateway's recent activity log.

This is the real receipt for a write: the gateway reports rejected commands here as "Command not found: ...".

Read raw bytes from a stream.

Attaches to the stream for the read and detaches again unless it was already opened with idm_open_stream. Returns the bytes as hex and text.

List a device's parameter paths without their values.

Fetch a whole sub-structure in one request (get("") on that path).

Use this instead of idm_get_parameters when you want the gateway's own nested JSON for one section, e.g. "cfg" or "ch/PGA_in", including hidden/development sections.

Read current values of a device's parameters, flattened to path -> {value, unit}.

Read a single parameter, e.g. device="device0", parameter="ec/E".

Read recorded samples of one parameter, aggregated by the gateway.

Four modes, chosen by which arguments are set: regular (default) - max_points samples from the span. scale - exactly scale points spanning the span, each with m records. average - scale plus average: interval duration in SECONDS; adds n, sd. calc - one aggregate over the whole record set, e.g. "avg".

Also works for inactive devices: the gateway keeps their records.