Read raw Modbus values
read_registersRead raw Modbus values from one table to verify byte order, scaling, or addresses before relying on engineering values. Returns table, start address, and values without changing device state.
Instructions
Read raw values straight from one Modbus table of a device, exactly as a client would receive them: 0 or 1 for coil and discrete, unscaled 16-bit words (0-65535) for holding and input. Use it to verify byte order, scaling or addresses; use read_points for engineering values by name. Addresses no point covers read 0, even on strict devices. Changes nothing and is not recorded in the traffic log. Returns the table, start address and list of values.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"device_id": "<device_id>",
"table": "<table>",
"address": "<address>",
"quantity": "<quantity>"
},
"name": "read_registers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| table | Yes | Modbus table: coil and discrete hold bits, holding and input hold 16-bit registers. | |
| address | Yes | Zero-based address of the first value. | |
| quantity | Yes | How many consecutive values to read. | |
| device_id | Yes | Id of a running device, as returned by create_device, clone_device or list_devices. |