{"route":"/skills/modbus/build-modscan","title":"Build ModScan (BETA)","tab":"skills/modbus/build-modscan.md","description":"Create BETA documented setup and CSV files for a read-only ModScan test.","updatedAt":"2026-08-28","enabled":true,"url":"https://studioseventeen.io/skills/modbus/build-modscan","markdown":"# Build ModScan (BETA)\n\nREAD-ONLY · BETA\n\nCreate BETA documented setup and CSV files for a read-only ModScan test.\n\n## What you get\n\nThe BETA ModScan folder contains `read-plan.csv`, `point-map.csv`, test messages, and setup instructions for ModScan32 or ModScan64. It can also include `pymodbus-read-once.py` for one reviewed read when ModScan is unavailable. Native application verification has not been run.\n\n## How it runs\n\n**Builds files for the ModScan version you use.** The script uses the checked map and matching read plan to create probe or final output. It checks the setup and CSV files. It reports native verification as unavailable unless the files were loaded in the named ModScan application.\n\n## Files this skill creates\n\n- **Enter in ModScan:** `modscan/read-plan.csv · modscan/test-message-plan.csv` — The bounded read blocks and optional protocol test messages.\n- **Use as a reference:** `modscan/point-map.csv · modscan/README.md` — The register names, meanings, and manual setup instructions.\n- **Keep with the plan:** `modscan/setup-manifest.json · modscan/manifest.json · modscan-result.json` — The source hashes, selected target, generated status, and holds.\n- **Optional fallback:** `modscan/pymodbus-read-once.py` — Runs one reviewed FC01–FC04 request when ModScan is not available.\n\n## Requirements\n\n- **Plugin files (included):** SKILL.md, the Python wrapper, generator source, and optional one-read fallback source.\n- **Python 3.11+ (install separately):** Required to generate the files. Plugin installation does not install Python.\n- **ModScan32 or ModScan64 (install separately):** Required to use the plan in the native Windows application. The CSV files are instructions, not native .tst or .cfg projects.\n- **PyModbus (install separately):** Required only if you use pymodbus-read-once.py instead of ModScan.\n\n## Example request\n\n```text\n$build-modscan\n\nCreate a read-only ModScan64 setup from `reviewed-map.json` and `read-plan.json`. Include the connection settings, poll blocks, point map, and protocol test messages.\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/build-modscan/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"}