plc_program_xref_config
Joins an exported PLC program’s addresses with a configured endpoint’s points using exact address matching, revealing which program symbol corresponds to each line point.
Instructions
[READ][risk=low] Join an exported program's addresses with one endpoint's configured points.
Answers "which program symbol is that point on the line?" by **exact address
match only** — never by name. A configured label that reads like a program
symbol, or a ref one character from a tag, is NOT a match (semantics are given
by a person, never guessed). Comparable pairs: Siemens AWL / .scl × an ``s7``
endpoint (area, DB, byte, bit and width must all agree) and Rockwell L5X × a
Logix ``ethernetip`` endpoint (the tag path is the CIP address). Every other
pair returns ``comparable: false`` with the reason and NO lists — e.g. Modbus
registers are assigned in the device's Modbus map, which no export contains.
Args:
path: Exported program file (.st/.scl/.awl/.l5x/.txt; must exist, ≤5 MB),
under $IAIOPS_HOME, the config dir or an IAIOPS_AGENT_READ_DIRS dir.
endpoint: Configured endpoint name whose ``tags`` are joined.
live: Also read MATCHED points now. Logix requires a matching live
controller name. AWL/SCL has no CPU identity, so MCP live reads are
refused; an operator can attest origin through the CLI. A failed
read is a gap with no value.
Returns dict: {program:{source_file, format, content_sha256}, endpoint:{name,
protocol, configured_tag_count}, comparable, address_space,
unmatchable:{program_format, protocol, reason}|null, refused (why an
unreadable export was not answered)|null, parse_errors, program.controller
(L5X: {name, processor_type}),
matched:[{address, program_symbol, configured_ref, label, role, match
('exact_address'|'member_of_tag'), sites_scope (L5X), sites:[{access, block, line,
source_line}], site_count}]|null, in_export_not_configured|null,
configured_not_in_export|null, configured_not_comparable, overlaps,
symbolic_only, indirect_access_sites, counts, notes,
live:{points:[{configured_ref, status, ...}], read_count, gap_count}
(only when live=True): a 'read' point has value, read_at, freshness; a 'gap'
has error and NO value (read_at only when an empty answer arrived)}.
Example: plc_program_xref_config(path="~/.iaiops/plc/OB1.awl", endpoint="line3").
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": {
"path": "<path>",
"endpoint": "<endpoint>"
},
"name": "plc_program_xref_config"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| live | No | ||
| path | Yes | ||
| endpoint | Yes |