编程

iaiops-building

试用

Building edition of iaiops — facility / HVAC / BMS / 厂务 over BACnet/IP (ASHRAE 135): Who-Is discovery, object/point lists, presentValue snapshots, COV capture, TrendLog reads, one MOC-gated property write; plus Modbus-TCP/RTU for meters/chillers and optional plain MQTT for IoT sensors, with the cross-protocol brain. Use when the task mentions BACnet, BACnet-IP, HVAC, AHU, chiller, VAV, BMS, building automation, facility management, 厂务, 楼宇自控, Who-Is, presentValue, or TrendLog; also IO-Link masters for smart building sensors (JSON interface, read-only), and the vendor supervisory-controller REST layer above BACnet (Metasys/OpenBlue, Niagara/oBIX) for point/alarm/trend reads and one MOC-gated command. Read-first, MOC-gated writes.

它能做什么

Building edition of iaiops — facility / HVAC / BMS / 厂务 over BACnet/IP (ASHRAE 135): Who-Is discovery, object/point lists, presentValue snapshots, COV capture, TrendLog reads, one MOC-gated property write; plus Modbus-TCP/RTU for meters/chillers and optional plain MQTT for IoT sensors, with the cross-protocol brain. Use when the task mentions BACnet, BACnet-IP, HVAC, AHU, chiller, VAV, BMS, building automation, facility management, 厂务, 楼宇自控, Who-Is, presentValue, or TrendLog; also IO-Link masters for smart building sensors (JSON interface, read-only), and the vendor supervisory-controller REST layer above BACnet (Metasys/OpenBlue, Niagara/oBIX) for point/alarm/trend reads and one MOC-gated command. Read-first, MOC-gated writes.

技能文档

iaiops-building — 楼宇/厂务 edition（BACnet + Modbus + IO-Link + MQTT + 脑）

启动：IAIOPS_MCP=building / iaiops-mcp-building（= bacnet + modbus + opcua + iolink + 脑）。 IoT 传感器走 MQTT 时叠加：IAIOPS_MCP=building,sparkplug。 安装：pip install iaiops[building]。BACnet 的 host 是本机 BACnet/IP 接口 （ip 或 ip/mask）。

工具

BACnet/IP（read-first；暖通/楼宇/厂务）

  • bacnet_discover — Who-Is：本地 BACnet/IP 网上的设备
  • bacnet_object_list — 设备的 object/point 列表
  • bacnet_read_property — 单对象属性（默认 presentValue）
  • bacnet_read_points — 所有 analog/binary/multistate 点的 presentValue（HVAC 快照）
  • bacnet_cov_subscribe — 单对象有界 Change-of-Value 捕获
  • bacnet_read_trend_log — 读设备 TrendLog 缓冲记录
  • bacnet_write_property — [WRITE][HIGH][MOC] 写单对象属性（默认 off： dry_run=True + 审批双确认；可指挥楼宇设备 — 设定值、输出）

Modbus-TCP / Modbus-RTU（只读；电表/冷机/表计）

  • modbus_read_holding modbus_read_input modbus_read_coils modbus_read_discrete
  • modbus_detect_byte_order / modbus_list_templates / modbus_apply_template
  • modbus_health_summary

IO-Link（只读；主站 JSON 接口 — 楼宇智能传感器）

  • iolink_master_info — 主站身份（/deviceinfo）
  • iolink_ports — 有界端口扫描（≤32：mode/status + 在线设备身份）
  • iolink_device_info — 单端口设备身份
  • iolink_read_pdin — 过程数据输入（raw hex + 字节数组；按 IODD 解码）
  • iolink_read_isdu — ISDU 参数读（index/subindex 有界）
  • iolink_scan — 主站 + 全端口一次性快照
  • 配置 flavor: iotcore（ifm IoT-Core，默认）或 rest（plain-REST 主站）；v1 只读

BAS 控制器层（edition 工具；厂商监控控制器 REST，在 BACnet 之上）

厂商监控控制器（Johnson Controls Metasys/OpenBlue、Tridium Niagara oBIX/REST）把大量 BACnet 现场点/告警/趋势聚合在一个带鉴权的企业 REST 接口后面——与 bacnet（现场总线）互补、非重复。 Bearer/token 从加密 secret store 按 key 取（secret_name），不走明文参数。

  • bas_point_list — 列控制器 point/object（跨厂商归一化：id/name/value/unit/status）
  • bas_point_read — 单/多点 present-value
  • bas_alarm_list — 控制器活动告警/事件（归一化）
  • bas_trend_read — 单点历史趋势样本（有界 ≤5000）
  • bas_command — [WRITE][HIGH][MOC]（默认 off：dry_run=True + 审批双确认；捕获改前值供 undo）。 生命安全点(fire/smoke/egress/加压)一律拒绝——联网前即拒，绝不下发。
  • 厂商方言（metasys/niagara：资源路径 + 字段别名）仅存在于连接器内；oBIX 原生 XML / 精确写语义 待核实。

MQTT（可选叠加 sparkplug 组；IoT 传感器/网关）

  • mqtt_read_topic — 裸 MQTT 有界收集；uns_browse — 主题树浏览
  • 完整 Sparkplug B/UNS 工具清单见 iaiops-factory skill
  • mqtt_publish — [WRITE][HIGH][MOC]（默认 off）

楼宇专属（edition 工具;仅随 building edition 加载,不进全局脑）

  • economizer_check — AHU 经济器故障检测(FDD):检出同时供冷供热(纯浪费)、该用自然冷却 却没用(室外够冷但新风阀在最小位且机械制冷开)、越高限还开阀(把热风引进来)。逐 AHU 判定, worst-first,每故障引用温度/状态。读数来自 BACnet AI/BI 点。
  • zone_comfort — 区域舒适度 + 室内空气质量(ASHRAE 55/62.1):逐区判温度 20–26°C、相对湿度 30–60%、CO₂ ≤1000 ppm(通风充分性代理),越界即 breach,worst-first,引用数值。读数来自 BACnet AI 点。

跨协议脑（永远随 server 暴露）

  • 诊断：diagnose_dataflow downtime_root_cause downtime_root_cause_live downtime_triage learn_cause_weights rca_corpus_from_maintenance historian_health alarm_bad_actors tag_health subscription_health heartbeat_health alarm_flood_analysis alarm_cascade alarm_rationalization_worksheet
  • 数据质量：data_quality_scorecard data_quality_fleet_rollup
  • 分析：oee_compute downtime_events oee_multidim monitor_changes health_summary (deprecated) anomaly_scan (deprecated)
  • 资产：asset_inventory cross_protocol_asset_model adopt_alias_map diff_alias_map
  • 基线：baseline_learn baseline_check baseline_record_change baseline_status （change-log 基线：拒学薄历史、只报持续越带、每次告警必引基线样本 —— 非黑盒异常检测）
  • 合规/信创：compliance_mapping compliance_frameworks compliance_dengbao_levels compliance_report compliance_evidence_bundle historian_push export_data historian_query historian_coverage stream_publish stream_publish_event rca_narrate fleet_status fleet_incidents pdm_forecast historian_push export_data
  • 程序解读：plc_program_outline plc_program_xref plc_program_section plc_program_visibility（解读导出的 ST/AWL/L5X 程序,只读文件,强制引用行号）
  • 医疗设施（healthcare facility 安全）：isolation_room_check — 隔离病房压差合规（ASHRAE 170 / CDC：空气传染隔离 AII 负压、保护性环境 PE 正压，≥2.5 Pa）；检出反向/不足/低裕度,worst-first,每项引用读数。读数来自 bacnet_read_points 的压差 AI 点或历史库,纯分析。
  • 元：protocols_supported

Workflows

  1. Doctor-first：protocols_supported → iaiops doctor → bacnet_discover （Who-Is 有响应才谈读点）。
  2. Read-first：bacnet_object_list → bacnet_read_points 快照 → 趋势用 bacnet_read_trend_log，变化捕获用 bacnet_cov_subscribe； "没数据"用 diagnose_dataflow，坏点排名用 tag_health。
  3. MOC 写：bacnet_write_property（与可选 mqtt_publish）为 [WRITE][HIGH][MOC]：默认 dry_run=True、捕获改前值供 undo、 iaiops approve 具名审批双确认。写设定值可影响在运楼宇设备 —— 未经授权绝不写。

支持版本矩阵（内部 HLD §8，设计文档不随本仓发布；待核实 不得当既成事实）

协议库(pin)规范/版本覆盖传输自测
BACnet/IPBAC0>=2023.6,<2026（extra）ASHRAE 135 Annex J暖通/楼宇/厂务控制器UDP/47808✅ 读路径 verified 2026-07-02（真 bacpypes3 虚拟设备）；live HVAC 写/COV/trend 待核实
Modbus-TCPpymodbus>=3.5,<4App 1.1b3；FC 1/2/3/4/5/6/15/16电表/冷机/任意 TCP 从站TCP/502✅
Modbus-RTUpymodbus>=3.5,<4 + pyserial>=3.5Modbus serial (RTU)串口表计RS-485/serial✅ socat PTY verified 2026-07-02；物理 RS-485 待核实
IO-Linkrequests>=2.31,<3（复用 MTConnect pin）IO-Link Master JSON Integration（IOLINK-JSON）；ifm IoT-Core / plain-REST 双 flavor带 JSON/REST 接口的主站（ifm/Balluff/Turck 类）HTTP REST/JSON✅ mock 主站（双 flavor）；live master 待核实
MQTTpaho-mqtt>=2.0,<3MQTT 3.1.1/5（裸 MQTT + SpB）IoT 传感器/网关/BrokerTCP/1883/8883✅
BAS: Metasys OpenBlue RESTrequests>=2.31,<3（复用 MTConnect pin，无新 HTTP 依赖）Metasys REST API v4（/objects·/alarms·/trendedAttributes）；JC OpenBlue 监控控制器NAE/SNE/SNC 类监控控制器聚合的 BACnet 现场点HTTPS + Bearer token✅ mock 控制器（in-repo）；live 设备写/trend/告警 待核实
BAS: Niagara 4 oBIX/RESTrequests>=2.31,<3（复用 MTConnect pin，无新 HTTP 依赖）Niagara 4 oBIX/REST（/obix/config·/obix/alarms·/obix/histories）；JSON 建模，原生 oBIX-XML 待核实Tridium JACE / Niagara Supervisor 下的点/告警/历史HTTPS + Bearer token✅ mock 控制器（in-repo）；live 设备 + oBIX-XML 编码 待核实

相关技能

iaiops-factory

Factory edition of iaiops — discrete-manufacturing lines: OPC-UA, Modbus-TCP/RTU, Siemens S7comm (S7-300/400/1200/1500), Mitsubishi MC/MELSEC, Omron FINS (CS/CJ/CP/NX), Allen-Bradley EtherNet/IP (ControlLogix/CompactLogix), EtherCAT (CoE/SOEM), PROFINET (DCP discovery), MTConnect (CNC machine tools), IO-Link (master JSON — sensor-level visibility), MQTT/Sparkplug B/UNS, plus the cross-protocol brain (downtime root-cause, OEE, asset inventory). Use for PLC, CNC, servo/drive bus, name-of-station, tag browse, Unified Namespace, or production-line troubleshooting tasks. Read-first, MOC-gated writes. Also covers Phoenix Contact PLCnext vPLC (via its built-in OPC-UA + Modbus servers).

1 次安装

iaiops-process

Process-industry edition of iaiops — chemical / pharma / food & beverage / oil & gas plants: HART-IP process instrumentation (transmitters, valve positioners, loop current), OPC-UA (DCS / gateway read), Modbus-TCP/RTU (skids, analyzers), optional MQTT/Sparkplug B UNS, plus the cross-protocol brain (downtime root-cause, data quality, OEE). Use when the task mentions HART, HART-IP, transmitter, 变送器, valve positioner, process instrumentation, PV/SV/TV/QV, loop current, burst mode, DCS tap, or a process plant. Read-first, MOC-gated writes.

1 次安装

iaiops

Vendor-neutral, governed industrial/OT data tap + intelligent troubleshooting. Read (and, gated, write) PLCs, controllers, machine tools and IIoT brokers over OPC-UA, Modbus-TCP, Siemens S7comm, Mitsubishi MC, Omron FINS, MTConnect, MQTT/Sparkplug B, Allen-Bradley EtherNet/IP, EtherCAT (pysoem/SOEM), SECS/GEM (semiconductor / display fab equipment over HSMS), PROFINET (DCP discovery), the building edition (BACnet/IP), and Phoenix Contact PLCnext vPLC — plus cross-protocol diagnostics ("no-data" dataflow diagnosis, OPC-UA connection self-diagnosis, subscription health, ISA-18.2 alarm bad-actors, tag/historian health, and the AI downtime root-cause copilot) and analytics (OEE/downtime, asset inventory, OPC-UA HDA, change-of-value). Use when the task names any industrial protocol, a PLC/SCADA/HMI/historian/CNC/RTU/IED, a semiconductor/display fab or SECS/GEM equipment, an electrical substation, an opc.tcp:// or mqtt:// endpoint, OEE/downtime, downtime root-cause, or OT asset inventory. Ro

iaiops-clinical

Clinical-facility edition of iaiops — hospital / healthcare facilities as a distinct vertical from generic building management, with patient-safety framing. BACnet/IP BMS (isolation-room pressurization + medical-gas source monitoring), Modbus (medical-gas alarm panels / energy meters), OPC-UA (plant SCADA), plus the cross-protocol brain. Two signature safety checks: isolation_room_check (ASHRAE 170 / CDC negative/positive pressure) and medical_gas_check (NFPA 99 / HTM 02-01 O2 / medical air / vacuum source pressures). Use when the task mentions hospital, 医院, healthcare facility, clinical, 医疗设施, isolation room / 隔离病房 / 负压病房 / AII / PE, operating room / OR / 手术室, ICU, medical gas / 医用气体 / 医疗气体, oxygen / 氧气 / medical vacuum / 医用真空, or NFPA 99. Read-first; this edition's tool surface is read-only.

1 次安装

iaiops-water

Water-treatment edition of iaiops — waterworks / wastewater plants / pump stations: Modbus-TCP/RTU (dosing skids, analyzers, flow meters), OPC-UA (plant SCADA / PLC read), HART-IP process instrumentation (pH, turbidity, conductivity, level, flow transmitters), plus the cross-protocol brain (downtime root-cause, data quality watchdog, OEE). Use when the task mentions water treatment, 水处理, 水厂, 污水, pH, 浊度, turbidity, 电导率, conductivity, dissolved oxygen, 加药, dosing pump, 泵站, pump station, aeration / 曝气, or lift station. Read-first; this edition's tool surface is read-only.

1 次安装

iaiops-pharma

Pharmaceutical-manufacturing edition of iaiops — GMP drug/biologics plants as a distinct vertical from generic buildings and municipal water. BACnet/IP BMS+EMS (cleanroom pressure cascade, temperature/RH), Modbus (PW/WFI skids, stills, EDI, analysers), HART-IP (conductivity / TOC / level transmitters), OPC-UA (DCS, bioreactors, plant SCADA), plus the cross-protocol brain. Three signature checks: cleanroom_pressure_cascade (EU GMP Annex 1 cascade, door by door), cleanroom_particle_check and pharma_water_check (USP <645> stage-1 procedure). Use when the task mentions pharma, 制药, 药厂, GMP, cleanroom / 洁净室 / 洁净区, Annex 1, 压差梯度, pressure cascade, grade A/B/C/D, 尘埃粒子 / particle count, EMS / 环境监测, PW / WFI / 纯化水 / 注射用水, TOC, 电导率, conductivity, bioreactor / 生物反应器, 冻干机 / lyophilizer, 灌装线 / filling line, CSV, IQ/OQ, Annex 11, Part 11, or 数据完整性 / ALCOA. Read-first; this edition's tool surface is read-only.