{"route":"/skills/modbus/compare-maps","title":"Compare Maps","tab":"skills/modbus/compare-maps.md","description":"Compare two map versions and show which points were added, removed, moved, changed, or left unresolved.","updatedAt":"2026-08-28","enabled":true,"url":"https://studioseventeen.io/skills/modbus/compare-maps","markdown":"# Compare Maps\n\nREAD-ONLY\n\nCompare two map versions and show which points were added, removed, moved, changed, or left unresolved.\n\n## What you get\n\nIt writes `diff.json` without changing either map. Use it to compare manuals, device models, or firmware versions. It reports points that were added, removed, moved, or changed, including address, data type, scale, byte order, bit numbering, and source changes.\n\n## How it runs\n\n**Matches points before it compares fields.** The script first puts both inputs into the standard map format. It identifies a point by its device route, unit, register area, address, and logical name instead of by address alone. Every point from both maps appears in the comparison report.\n\n## Example request\n\n```text\n$compare-maps\n\nCompare `firmware-2-map.json` with `firmware-3-map.json`. Show which points were added, removed, moved, or changed, including changes to scaling and 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/compare-maps/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"}