{"route":"/skills/modbus/capture-sample","title":"Capture Sample","tab":"skills/modbus/capture-sample.md","description":"Create a manual, read-only probe pack for one defined register range and stop before the physical read.","updatedAt":"2026-08-28","enabled":true,"url":"https://studioseventeen.io/skills/modbus/capture-sample","markdown":"# Capture Sample\n\nREAD-ONLY\n\nCreate a manual, read-only probe pack for one defined register range and stop before the physical read.\n\n## What you get\n\nGive it the device connection, unit ID, register area, start offset, word count, and field tool. It creates a selected tool folder, `README.md`, `tool-pack.zip`, and verification files for one limited read. `capture.json` appears only after the operator runs the read; this skill does not create it.\n\n## How it runs\n\n**Builds the probe, then stops for the physical read.** The skill checks that the request uses only read function codes 01–04 and contains no credentials or automatic polling. It validates the complete probe pack, presents one live-read gate, and stops. The operator runs the read and saves the raw words with the complete sample identity.\n\n## Example request\n\n```text\n$capture-sample\n\nBuild a one-read Modpoll test for holding registers 120–121 on unit 1 at `192.168.10.25:502`. Save the raw words and point details to `capture.json` to check the byte order.\n```\n\n## Safety\n\nNo writes. No broadcasts. No discovery scans. No polls without a defined limit. Unknown values stay blank and remain visible for review.\n\n## Source\n\n- [Canonical SKILL.md](https://github.com/studioxvii/modbus-skills/blob/v0.2.2/plugins/modbus-skills/skills/capture-sample/SKILL.md)\n- [Modbus Skills 0.2.2 release](https://github.com/studioxvii/modbus-skills/releases/tag/v0.2.2)\n- [All Modbus Skills](/skills/modbus.md)\n"}