mbtoolcli 0.3.1__py3-none-any.whl

modbus_slave_sim/gui_server.py

@@ -0,0 +1,1049 @@
+"""
+Modbus Tool Web GUI Server.
+
+Launches a local HTTP server with a web-based UI for controlling
+all Modbus Master/Slave/Scan operations through a browser.
+Zero extra dependencies - uses only Python stdlib + pymodbus.
+"""
+
+import csv
+import io
+import json
+import logging
+import threading
+import time
+import uuid
+from http.server import HTTPServer, BaseHTTPRequestHandler
+from typing import Optional
+from urllib.parse import urlparse, parse_qs
+
+from .master import ModbusMaster
+from .registers import ModbusRegisterMap
+from .tcp_server import ModbusTCPServer
+from .rtu_server import ModbusSerialServer
+from .simulation import SimulationEngine
+from .datatypes import (
+    ByteOrder, DataType, parse_data_type, parse_byte_order, format_value,
+)
+
+logger = logging.getLogger(__name__)
+
+# ── Global state ──
+
+_poll_threads: dict = {}
+_poll_buffers: dict = {}
+_scan_progress: dict = {}
+_slave_server = {"instance": None, "engine": None, "config": {}}
+
+
+# ── Helper functions ──
+
+def _make_response(data: dict, status=200) -> tuple:
+    body = json.dumps(data, ensure_ascii=False).encode("utf-8")
+    return (status, {"Content-Type": "application/json; charset=utf-8"}, body)
+
+
+def _read_body(handler) -> dict:
+    length = int(handler.headers.get("Content-Length", 0))
+    raw = handler.rfile.read(length) if length else b"{}"
+    return json.loads(raw)
+
+
+def _build_master(args: dict) -> Optional[ModbusMaster]:
+    port = args.get("port", "502")
+    try:
+        port_int = int(port)
+    except ValueError:
+        port_int = port
+    master = ModbusMaster(
+        host=args.get("host", "127.0.0.1"),
+        port=port_int,
+        mode=args.get("mode", "tcp"),
+        slave_id=int(args.get("slave_id", 1)),
+        timeout=float(args.get("timeout", 3.0)),
+        baudrate=int(args.get("baudrate", 9600)),
+        parity=args.get("parity", "N"),
+        stopbits=int(args.get("stopbits", 1)),
+        bytesize=int(args.get("bytesize", 8)),
+    )
+    if not master.connect():
+        return None
+    return master
+
+
+# ── API Handlers ──
+
+def api_read(body: dict) -> tuple:
+    master = _build_master(body)
+    if not master:
+        return _make_response({"success": False, "error": "Connection failed"})
+    try:
+        data_type = parse_data_type(body.get("data_type", "int16"))
+        byte_order = parse_byte_order(body.get("byte_order", "ABCD"))
+        function_code = int(body.get("function_code", 3))
+        value = master.read_and_convert(
+            address=int(body.get("register", 0)),
+            count=int(body.get("count", 1)),
+            data_type=data_type,
+            function_code=function_code,
+            byte_order=byte_order,
+        )
+        if value is None:
+            return _make_response({"success": False, "error": "Read failed"})
+        if isinstance(value, list):
+            vals = [v if isinstance(v, (int, float)) else str(v) for v in value]
+        else:
+            vals = [value if isinstance(value, (int, float)) else str(value)]
+        return _make_response({"success": True, "values": vals})
+    except Exception as e:
+        return _make_response({"success": False, "error": str(e)})
+    finally:
+        master.disconnect()
+
+
+def api_write(body: dict) -> tuple:
+    master = _build_master(body)
+    if not master:
+        return _make_response({"success": False, "error": "Connection failed"})
+    try:
+        data_type = parse_data_type(body.get("data_type", "int16"))
+        byte_order = parse_byte_order(body.get("byte_order", "ABCD"))
+        value_str = body.get("value", "0")
+        # batch write
+        parts = [v.strip() for v in value_str.split(",")]
+        if len(parts) > 1:
+            regs_per = {DataType.INT32: 2, DataType.UINT32: 2, DataType.FLOAT32: 2}.get(data_type, 1)
+            all_ok = True
+            for i, p in enumerate(parts):
+                val = float(p) if data_type == DataType.FLOAT32 else int(float(p))
+                addr = int(body.get("register", 0)) + i * regs_per
+                if not master.write_converted(addr, val, data_type, byte_order=byte_order):
+                    all_ok = False
+            return _make_response({"success": all_ok})
+        else:
+            val = float(parts[0]) if data_type == DataType.FLOAT32 else int(float(parts[0]))
+            ok = master.write_converted(
+                int(body.get("register", 0)), val, data_type, byte_order=byte_order,
+            )
+            return _make_response({"success": ok})
+    except Exception as e:
+        return _make_response({"success": False, "error": str(e)})
+    finally:
+        master.disconnect()
+
+
+def api_write_coil(body: dict) -> tuple:
+    master = _build_master(body)
+    if not master:
+        return _make_response({"success": False, "error": "Connection failed"})
+    try:
+        ok = master.write_single_coil(
+            int(body.get("register", 0)),
+            bool(int(body.get("coil_state", 1))),
+        )
+        return _make_response({"success": ok})
+    except Exception as e:
+        return _make_response({"success": False, "error": str(e)})
+    finally:
+        master.disconnect()
+
+
+def api_poll_start(body: dict) -> tuple:
+    poll_id = uuid.uuid4().hex[:8]
+    _poll_buffers[poll_id] = []
+    stop_event = threading.Event()
+    _poll_threads[poll_id] = stop_event
+
+    def _run():
+        master = _build_master(body)
+        if not master:
+            _poll_buffers[poll_id].append({"error": "Connection failed"})
+            return
+        try:
+            data_type = parse_data_type(body.get("data_type", "int16"))
+            byte_order = parse_byte_order(body.get("byte_order", "ABCD"))
+            function_code = int(body.get("function_code", 3))
+            register = int(body.get("register", 0))
+            count = int(body.get("count", 1))
+            interval = float(body.get("interval", 1.0))
+            iteration = 0
+            while not stop_event.is_set():
+                iteration += 1
+                value = master.read_and_convert(
+                    address=register, count=count, data_type=data_type,
+                    function_code=function_code, byte_order=byte_order,
+                )
+                entry = {"iteration": iteration}
+                if value is not None:
+                    if isinstance(value, list):
+                        entry["values"] = [v if isinstance(v, (int, float)) else str(v) for v in value]
+                    else:
+                        entry["values"] = [value if isinstance(value, (int, float)) else str(value)]
+                else:
+                    entry["error"] = "Read failed"
+                _poll_buffers[poll_id].append(entry)
+                # keep buffer limited
+                if len(_poll_buffers[poll_id]) > 200:
+                    _poll_buffers[poll_id] = _poll_buffers[poll_id][-100:]
+                time.sleep(interval)
+        except Exception as e:
+            _poll_buffers[poll_id].append({"error": str(e)})
+        finally:
+            master.disconnect()
+
+    t = threading.Thread(target=_run, daemon=True)
+    t.start()
+    return _make_response({"success": True, "poll_id": poll_id})
+
+
+def api_poll_data(poll_id: str) -> tuple:
+    if poll_id not in _poll_buffers:
+        return _make_response({"success": False, "error": "Poll not found"})
+    data = list(_poll_buffers[poll_id])
+    running = poll_id in _poll_threads and not _poll_threads[poll_id].is_set()
+    return _make_response({"success": True, "data": data, "running": running})
+
+
+def api_poll_stop(poll_id: str) -> tuple:
+    if poll_id in _poll_threads:
+        _poll_threads[poll_id].set()
+        _poll_buffers.pop(poll_id, None)
+    return _make_response({"success": True})
+
+
+def api_slave_start(body: dict) -> tuple:
+    global _slave_server
+    if _slave_server["instance"] and _slave_server["instance"].is_running():
+        return _make_response({"success": False, "error": "Slave already running"})
+
+    register_map = ModbusRegisterMap()
+    register_map.create_default_map()
+    sim = None
+    server = None
+    try:
+        mode = body.get("mode", "tcp")
+        port = body.get("port", "502")
+        slave_id = int(body.get("slave_id", 1))
+
+        if mode == "tcp":
+            server = ModbusTCPServer(
+                register_map=register_map,
+                host=body.get("host", "0.0.0.0"),
+                port=int(port),
+                slave_id=slave_id,
+            )
+        else:
+            framer = __import__("pymodbus.framer", fromlist=[""]).FramerType
+            from pymodbus.framer import FramerType
+            server = ModbusSerialServer(
+                register_map=register_map,
+                port=str(port),
+                baudrate=int(body.get("baudrate", 9600)),
+                parity=body.get("parity", "N"),
+                stopbits=int(body.get("stopbits", 1)),
+                bytesize=int(body.get("bytesize", 8)),
+                timeout=float(body.get("timeout", 1.0)),
+                slave_id=slave_id,
+                framer=FramerType.ASCII if mode == "ascii" else FramerType.RTU,
+            )
+
+        if body.get("simulate"):
+            sim = SimulationEngine(register_map)
+            sim.interval = float(body.get("sim_interval", 0.1))
+            sim.setup_default_simulations()
+
+        server.start()
+        if sim:
+            sim.start()
+
+        _slave_server = {
+            "instance": server,
+            "engine": sim,
+            "config": {"mode": mode, "port": port, "slave_id": slave_id, "simulate": body.get("simulate", False)},
+        }
+        return _make_response({"success": True})
+    except Exception as e:
+        return _make_response({"success": False, "error": str(e)})
+
+
+def api_slave_stop() -> tuple:
+    global _slave_server
+    if _slave_server["engine"]:
+        _slave_server["engine"].stop()
+    if _slave_server["instance"]:
+        _slave_server["instance"].stop()
+    _slave_server = {"instance": None, "engine": None, "config": {}}
+    return _make_response({"success": True})
+
+
+def api_slave_status() -> tuple:
+    s = _slave_server
+    running = s["instance"] is not None and s["instance"].is_running()
+    return _make_response({
+        "success": True,
+        "running": running,
+        "config": s["config"],
+    })
+
+
+def api_scan(body: dict) -> tuple:
+    scan_id = uuid.uuid4().hex[:8]
+    _scan_progress[scan_id] = {"found": [], "current": 0, "total": 247, "done": False}
+
+    def _run():
+        master = _build_master(body)
+        if not master:
+            _scan_progress[scan_id] = {"found": [], "current": 0, "total": 0, "done": True, "error": "Connection failed"}
+            return
+        try:
+            found = master.scan_slaves(
+                start=1, end=247,
+                timeout_per=min(float(body.get("timeout", 3.0)), 0.5),
+            )
+            _scan_progress[scan_id] = {"found": found, "current": 247, "total": 247, "done": True}
+        except Exception as e:
+            _scan_progress[scan_id]["error"] = str(e)
+            _scan_progress[scan_id]["done"] = True
+        finally:
+            master.disconnect()
+
+    t = threading.Thread(target=_run, daemon=True)
+    t.start()
+    return _make_response({"success": True, "scan_id": scan_id})
+
+
+def api_scan_status(scan_id: str) -> tuple:
+    data = _scan_progress.get(scan_id, {"done": False, "found": [], "current": 0, "total": 247})
+    return _make_response({"success": True, **data})
+
+
+def api_register_map_get(body: dict) -> tuple:
+    """Return default register map for display in the UI."""
+    rm = ModbusRegisterMap()
+    if body.get("filepath"):
+        try:
+            rm = ModbusRegisterMap.load_from_json(body["filepath"])
+        except Exception as e:
+            return _make_response({"success": False, "error": str(e)})
+    else:
+        rm.create_default_map()
+    sections = {}
+    for key in ["coils", "discrete_inputs", "input_registers", "holding_registers"]:
+        regs = getattr(rm, key, {})
+        sections[key] = [
+            {"address": addr, "value": reg.value, "description": reg.description}
+            for addr, reg in sorted(regs.items())
+        ]
+    return _make_response({"success": True, "sections": sections})
+
+
+# ── HTTP Router ──
+
+ROUTES = {
+    "/api/master/read": ("POST", api_read),
+    "/api/master/write": ("POST", api_write),
+    "/api/master/write-coil": ("POST", api_write_coil),
+    "/api/master/poll/start": ("POST", api_poll_start),
+    "/api/master/poll/stop": ("POST", lambda b: _not_found),
+    "/api/slave/start": ("POST", api_slave_start),
+    "/api/slave/stop": ("POST", lambda b: api_slave_stop()),
+    "/api/slave/status": ("GET", lambda b: api_slave_status()),
+    "/api/scan": ("POST", api_scan),
+    "/api/register-map": ("POST", api_register_map_get),
+}
+
+
+def _not_found() -> tuple:
+    return _make_response({"success": False, "error": "Not found"}, 404)
+
+
+class _Handler(BaseHTTPRequestHandler):
+    def log_message(self, fmt, *args):
+        pass  # suppress default logging
+
+    def _send(self, status, headers, body):
+        self.send_response(status)
+        for k, v in headers.items():
+            self.send_header(k, v)
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.end_headers()
+        if body:
+            self.wfile.write(body)
+
+    def do_GET(self):
+        parsed = urlparse(self.path)
+        path = parsed.path
+
+        # SSE for poll data
+        if path.startswith("/api/master/poll/") and path.endswith("/data"):
+            poll_id = path.split("/")[4]
+            self.send_response(200)
+            self.send_header("Content-Type", "text/event-stream")
+            self.send_header("Cache-Control", "no-cache")
+            self.send_header("Access-Control-Allow-Origin", "*")
+            self.end_headers()
+            try:
+                while True:
+                    data = _poll_buffers.get(poll_id, [])
+                    running = poll_id in _poll_threads and not _poll_threads[poll_id].is_set()
+                    payload = json.dumps({"data": data[-1] if data else None, "running": running})
+                    self.wfile.write(f"data: {payload}\n\n".encode())
+                    if not running:
+                        break
+                    time.sleep(0.3)
+            except (BrokenPipeError, ConnectionResetError):
+                pass
+            return
+
+        # Scan status SSE
+        if path.startswith("/api/scan/") and path.endswith("/status"):
+            scan_id = path.split("/")[3]
+            self.send_response(200)
+            self.send_header("Content-Type", "text/event-stream")
+            self.send_header("Cache-Control", "no-cache")
+            self.send_header("Access-Control-Allow-Origin", "*")
+            self.end_headers()
+            try:
+                while True:
+                    data = _scan_progress.get(scan_id, {})
+                    payload = json.dumps(data)
+                    self.wfile.write(f"data: {payload}\n\n".encode())
+                    if data.get("done"):
+                        break
+                    time.sleep(0.5)
+            except (BrokenPipeError, ConnectionResetError):
+                pass
+            return
+
+        # API routes
+        if path in ROUTES:
+            method, handler = ROUTES[path]
+            if method == "GET":
+                status, headers, body = handler({})
+                self._send(status, headers, body)
+                return
+
+        self._send(*_make_response({"error": "Not found"}, 404))
+
+    def do_POST(self):
+        parsed = urlparse(self.path)
+        path = parsed.path
+        body = _read_body(self)
+
+        # dynamic routes: /api/master/poll/<id>/stop
+        if path.startswith("/api/master/poll/") and path.endswith("/stop"):
+            poll_id = path.split("/")[4]
+            status, headers, body = api_poll_stop(poll_id)
+            self._send(status, headers, body)
+            return
+
+        if path.startswith("/api/master/poll/") and path.endswith("/data"):
+            poll_id = path.split("/")[4]
+            status, headers, body = api_poll_data(poll_id)
+            self._send(status, headers, body)
+            return
+
+        if path.startswith("/api/scan/"):
+            scan_id = path.split("/")[3]
+            status, headers, body = api_scan_status(scan_id)
+            self._send(status, headers, body)
+            return
+
+        if path in ROUTES:
+            method, handler = ROUTES[path]
+            if method == "POST":
+                status, headers, body = handler(body)
+                self._send(status, headers, body)
+                return
+
+        self._send(*_make_response({"error": "Not found"}, 404))
+
+    def do_OPTIONS(self):
+        self.send_response(204)
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.send_header("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
+        self.send_header("Access-Control-Allow-Headers", "Content-Type")
+        self.end_headers()
+
+    def do_HEAD(self):
+        self.do_GET()
+
+    # ── Serve the embedded frontend ──
+
+    def _serve_frontend(self):
+        html = FRONTEND_HTML
+        self.send_response(200)
+        self.send_header("Content-Type", "text/html; charset=utf-8")
+        self.send_header("Access-Control-Allow-Origin", "*")
+        self.end_headers()
+        self.wfile.write(html.encode("utf-8"))
+
+    def _route_get(self):
+        """Route GET requests - either serve frontend or API."""
+        parsed = urlparse(self.path)
+        path = parsed.path
+
+        # Serve frontend for root paths
+        if path in ("/", "/ui"):
+            self._serve_frontend()
+            return
+
+        # SSE for poll data
+        if path.startswith("/api/master/poll/") and path.endswith("/data"):
+            poll_id = path.split("/")[4]
+            self.send_response(200)
+            self.send_header("Content-Type", "text/event-stream")
+            self.send_header("Cache-Control", "no-cache")
+            self.send_header("Access-Control-Allow-Origin", "*")
+            self.end_headers()
+            try:
+                while True:
+                    data = _poll_buffers.get(poll_id, [])
+                    running = poll_id in _poll_threads and not _poll_threads[poll_id].is_set()
+                    payload = json.dumps({"data": data[-1] if data else None, "running": running})
+                    self.wfile.write(f"data: {payload}\n\n".encode())
+                    if not running:
+                        break
+                    time.sleep(0.3)
+            except (BrokenPipeError, ConnectionResetError):
+                pass
+            return
+
+        # Scan status SSE
+        if path.startswith("/api/scan/") and path.endswith("/status"):
+            scan_id = path.split("/")[3]
+            self.send_response(200)
+            self.send_header("Content-Type", "text/event-stream")
+            self.send_header("Cache-Control", "no-cache")
+            self.send_header("Access-Control-Allow-Origin", "*")
+            self.end_headers()
+            try:
+                while True:
+                    data = _scan_progress.get(scan_id, {})
+                    payload = json.dumps(data)
+                    self.wfile.write(f"data: {payload}\n\n".encode())
+                    if data.get("done"):
+                        break
+                    time.sleep(0.5)
+            except (BrokenPipeError, ConnectionResetError):
+                pass
+            return
+
+        # API routes
+        if path in ROUTES:
+            method, handler = ROUTES[path]
+            if method == "GET":
+                status, headers, body = handler({})
+                self._send(status, headers, body)
+                return
+
+        self._send(*_make_response({"error": "Not found"}, 404))
+
+    # Override do_GET to route properly
+    def do_GET(self):
+        self._route_get()
+
+
+# Monkey-patch: save original do_GET for backward compat
+_Handler.do_GET_original = _Handler.do_GET
+
+# ── Embedded Frontend HTML ──
+
+FRONTEND_HTML = r"""<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Modbus Tool Web UI</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0f1117;color:#e1e4e8;min-height:100vh}
+.header{background:#161b22;border-bottom:1px solid #30363d;padding:16px 24px;display:flex;align-items:center;gap:12px}
+.header h1{font-size:20px;color:#58a6ff;font-weight:600}
+.header span{color:#8b949e;font-size:13px}
+.tabs{display:flex;background:#161b22;border-bottom:1px solid #30363d;padding:0 16px;gap:0}
+.tab{padding:12px 20px;cursor:pointer;color:#8b949e;font-size:14px;border-bottom:2px solid transparent;transition:.2s}
+.tab:hover{color:#e1e4e8;background:#1c2128}
+.tab.active{color:#58a6ff;border-bottom-color:#58a6ff}
+.panels{display:none;padding:20px 24px}
+.panels.active{display:block}
+.card{background:#161b22;border:1px solid #30363d;border-radius:8px;padding:16px;margin-bottom:16px}
+.card h3{font-size:14px;color:#8b949e;margin-bottom:12px;text-transform:uppercase;letter-spacing:.5px}
+.row{display:flex;gap:12px;flex-wrap:wrap;align-items:end;margin-bottom:12px}
+.row:last-child{margin-bottom:0}
+.field{display:flex;flex-direction:column;gap:4px}
+.field label{font-size:12px;color:#8b949e}
+.field input,.field select{background:#0d1117;border:1px solid #30363d;border-radius:6px;padding:8px 12px;color:#e1e4e8;font-size:13px;outline:none;min-width:80px}
+.field input:focus,.field select:focus{border-color:#58a6ff}
+.btn{background:#238636;color:#fff;border:none;border-radius:6px;padding:8px 20px;cursor:pointer;font-size:13px;font-weight:500;transition:.2s}
+.btn:hover{background:#2ea043}
+.btn.danger{background:#da3633}
+.btn.danger:hover{background:#f85149}
+.btn.secondary{background:#21262d;border:1px solid #30363d;color:#e1e4e8}
+.btn.secondary:hover{background:#30363d}
+.btn:disabled{opacity:.6;cursor:not-allowed}
+table{width:100%;border-collapse:collapse;font-size:13px}
+th,td{padding:8px 12px;text-align:left;border-bottom:1px solid #21262d}
+th{color:#8b949e;font-weight:500}
+td{font-family:monospace}
+.status-dot{display:inline-block;width:10px;height:10px;border-radius:50%;margin-right:6px}
+.status-dot.green{background:#3fb950}
+.status-dot.red{background:#f85149}
+.status-dot.yellow{background:#d29922}
+#chart-canvas{width:100%;height:200px;background:#0d1117;border:1px solid #30363d;border-radius:6px;margin-top:8px}
+.poll-controls{display:flex;gap:8px;align-items:center}
+.result-msg{padding:8px 12px;border-radius:6px;margin-top:8px;font-size:13px}
+.result-msg.ok{background:#1b3a1f;color:#3fb950;border:1px solid #238636}
+.result-msg.err{background:#3a1b1b;color:#f85149;border:1px solid #da3633}
+@media(max-width:768px){.row{flex-direction:column}.field{width:100%}.field input,.field select{width:100%}}
+</style>
+</head>
+<body>
+
+<div class="header">
+  <h1>⚡ Modbus Tool</h1>
+  <span>Web UI · v0.2.0</span>
+</div>
+
+<div class="tabs">
+  <div class="tab active" onclick="switchTab('master')">📡 主站 (Master)</div>
+  <div class="tab" onclick="switchTab('slave')">🖥️ 从站 (Slave)</div>
+  <div class="tab" onclick="switchTab('scan')">🔍 扫描 (Scan)</div>
+</div>
+
+<!-- ── MASTER PANEL ── -->
+<div id="panel-master" class="panels active">
+
+  <div class="card">
+    <h3>连接配置</h3>
+    <div class="row">
+      <div class="field"><label>协议</label><select id="m-proto"><option value="tcp">TCP</option><option value="rtu">RTU</option><option value="ascii">ASCII</option></select></div>
+      <div class="field" id="m-host-field"><label>主机</label><input id="m-host" value="127.0.0.1"></div>
+      <div class="field" id="m-port-field"><label>端口/串口</label><input id="m-port" value="502"></div>
+      <div class="field"><label>从站ID</label><input id="m-sid" value="1"></div>
+      <div class="field"><label>超时(s)</label><input id="m-timeout" value="3.0"></div>
+    </div>
+    <div class="row" id="m-serial-opts" style="display:none">
+      <div class="field"><label>波特率</label><select id="m-baud"><option>9600</option><option>19200</option><option>38400</option><option>57600</option><option>115200</option></select></div>
+      <div class="field"><label>校验</label><select id="m-parity"><option value="N">N</option><option value="E">E</option><option value="O">O</option></select></div>
+      <div class="field"><label>停止位</label><select id="m-stop"><option value="1">1</option><option value="2">2</option></select></div>
+    </div>
+  </div>
+
+  <div style="display:flex;gap:16px;flex-wrap:wrap">
+    <!-- Read -->
+    <div class="card" style="flex:1;min-width:320px">
+      <h3>读取寄存器</h3>
+      <div class="row">
+        <div class="field"><label>地址</label><input id="mr-addr" value="0"></div>
+        <div class="field"><label>数量</label><input id="mr-count" value="10"></div>
+        <div class="field"><label>数据类型</label><select id="mr-type"><option>int16</option><option>uint16</option><option>int32</option><option>uint32</option><option>float</option><option>hex</option></select></div>
+        <div class="field"><label>功能码</label><select id="mr-fc"><option value="3">FC03-保持寄存器</option><option value="1">FC01-线圈</option><option value="2">FC02-离散输入</option><option value="4">FC04-输入寄存器</option></select></div>
+        <div class="field"><label>字节序</label><select id="mr-bo"><option value="ABCD">ABCD</option><option value="CDBA">CDBA</option><option value="BADC">BADC</option><option value="DCBA">DCBA</option></select></div>
+      </div>
+      <button class="btn secondary" onclick="masterRead()">📖 读取</button>
+      <div id="mr-result"></div>
+    </div>
+
+    <!-- Write -->
+    <div class="card" style="flex:1;min-width:320px">
+      <h3>写入寄存器</h3>
+      <div class="row">
+        <div class="field"><label>地址</label><input id="mw-addr" value="0"></div>
+        <div class="field"><label>值(逗号分隔=批量)</label><input id="mw-val" value="100"></div>
+        <div class="field"><label>数据类型</label><select id="mw-type"><option>int16</option><option>uint16</option><option>int32</option><option>uint32</option><option>float</option></select></div>
+      </div>
+      <button class="btn" onclick="masterWrite()">✏️ 写入</button>
+      <div id="mw-result"></div>
+    </div>
+
+    <!-- Write Coil -->
+    <div class="card" style="flex:1;min-width:320px">
+      <h3>写线圈</h3>
+      <div class="row">
+        <div class="field"><label>线圈地址</label><input id="mwc-addr" value="0"></div>
+        <div class="field"><label>状态</label><select id="mwc-state"><option value="1">ON (闭合)</option><option value="0">OFF (断开)</option></select></div>
+      </div>
+      <button class="btn" onclick="masterWriteCoil()">✏️ 写线圈</button>
+      <div id="mwc-result"></div>
+    </div>
+  </div>
+
+  <!-- Poll -->
+  <div class="card">
+    <h3>连续轮询</h3>
+    <div class="row">
+      <div class="field"><label>地址</label><input id="mp-addr" value="0"></div>
+      <div class="field"><label>数量</label><input id="mp-count" value="5"></div>
+      <div class="field"><label>数据类型</label><select id="mp-type"><option>int16</option><option>uint16</option><option>int32</option><option>uint32</option><option>float</option><option>hex</option></select></div>
+      <div class="field"><label>间隔(s)</label><input id="mp-interval" value="1.0"></div>
+      <div class="field"><label>告警</label><input id="mp-alarm" placeholder="0>1000" style="width:100px"></div>
+      <div class="poll-controls">
+        <button class="btn" id="poll-start-btn" onclick="pollStart()">▶ 启动</button>
+        <button class="btn danger" id="poll-stop-btn" onclick="pollStop()" disabled>⏹ 停止</button>
+      </div>
+    </div>
+    <canvas id="chart-canvas"></canvas>
+    <div id="mp-result" style="margin-top:8px;max-height:150px;overflow-y:auto;font-family:monospace;font-size:12px"></div>
+    <div id="poll-id" style="display:none"></div>
+  </div>
+</div>
+
+<!-- ── SLAVE PANEL ── -->
+<div id="panel-slave" class="panels">
+  <div class="card">
+    <h3>从站配置</h3>
+    <div class="row">
+      <div class="field"><label>协议</label><select id="s-proto"><option value="tcp">TCP</option><option value="rtu">RTU</option><option value="ascii">ASCII</option></select></div>
+      <div class="field"><label>端口/串口</label><input id="s-port" value="502"></div>
+      <div class="field"><label>从站ID</label><input id="s-sid" value="1"></div>
+      <div class="field"><label><input type="checkbox" id="s-sim"> 启用模拟</label></div>
+    </div>
+    <div class="row" id="s-serial-opts" style="display:none">
+      <div class="field"><label>波特率</label><select id="s-baud"><option>9600</option><option>19200</option></select></div>
+      <div class="field"><label>校验</label><select id="s-parity"><option value="N">N</option><option value="E">E</option><option value="O">O</option></select></div>
+    </div>
+    <div style="display:flex;gap:12px;align-items:center">
+      <button class="btn" id="s-start-btn" onclick="slaveStart()">▶ 启动从站</button>
+      <button class="btn danger" id="s-stop-btn" onclick="slaveStop()" disabled>⏹ 停止从站</button>
+      <span id="s-status" style="font-size:13px;color:#8b949e">已停止</span>
+    </div>
+  </div>
+  <div class="card">
+    <h3>寄存器状态</h3>
+    <div id="s-registers"><p style="color:#8b949e;font-size:13px">启动从站后自动加载</p></div>
+  </div>
+</div>
+
+<!-- ── SCAN PANEL ── -->
+<div id="panel-scan" class="panels">
+  <div class="card">
+    <h3>扫描配置</h3>
+    <div class="row">
+      <div class="field"><label>协议</label><select id="sc-proto"><option value="tcp">TCP</option><option value="rtu">RTU</option></select></div>
+      <div class="field"><label>主机</label><input id="sc-host" value="127.0.0.1"></div>
+      <div class="field"><label>端口/串口</label><input id="sc-port" value="502"></div>
+    </div>
+    <button class="btn" id="sc-start-btn" onclick="scanStart()">🔍 开始扫描</button>
+    <div id="sc-progress" style="margin-top:8px;font-size:13px;color:#8b949e"></div>
+  </div>
+  <div class="card">
+    <h3>扫描结果</h3>
+    <div id="sc-result"><p style="color:#8b949e;font-size:13px">点击"开始扫描"发现活动设备</p></div>
+  </div>
+</div>
+
+<script>
+// ── Tab switching ──
+function switchTab(name) {
+    document.querySelectorAll('.tab').forEach(t=>t.classList.remove('active'));
+    document.querySelectorAll('.panels').forEach(p=>p.classList.remove('active'));
+    document.querySelector(`.tab[onclick*='${name}']`).classList.add('active');
+    document.getElementById(`panel-${name}`).classList.add('active');
+}
+
+// ── Serial option toggles ──
+function toggleSerialOpts() {
+    const isSerial = document.getElementById('m-proto').value !== 'tcp';
+    document.getElementById('m-serial-opts').style.display = isSerial ? 'flex' : 'none';
+    document.getElementById('m-host-field').style.display = isSerial?'none':'flex';
+    document.getElementById('m-port-field').querySelector('label').textContent = isSerial?'串口路径':'端口';
+}
+document.getElementById('m-proto').addEventListener('change', toggleSerialOpts);
+document.getElementById('s-proto').addEventListener('change', ()=>{
+    const s = document.getElementById('s-proto').value !== 'tcp';
+    document.getElementById('s-serial-opts').style.display = s?'flex':'none';
+});
+
+// ── Connection config helper ──
+function connConfig(prefix) {
+    const proto = document.getElementById(prefix+'-proto').value;
+    const cfg = {
+        mode: proto,
+        host: document.getElementById(prefix+'-host')?.value || '127.0.0.1',
+        port: document.getElementById(prefix+'-port')?.value || '502',
+        slave_id: document.getElementById(prefix+'-sid')?.value || '1',
+        timeout: document.getElementById(prefix+'-timeout')?.value || '3.0',
+        baudrate: document.getElementById(prefix+'-baud')?.value || '9600',
+        parity: document.getElementById(prefix+'-parity')?.value || 'N',
+        stopbits: document.getElementById(prefix+'-stop')?.value || '1',
+        bytesize: document.getElementById(prefix+'-bytesize')?.value || '8',
+    };
+    if (proto === 'tcp') { cfg.bytesize='8'; cfg.stopbits='1'; cfg.parity='N'; }
+    return cfg;
+}
+
+// ── API helper ──
+async function api(path, body) {
+    const r = await fetch(path, {
+        method:'POST', headers:{'Content-Type':'application/json'},
+        body: JSON.stringify(body)
+    });
+    return r.json();
+}
+
+// ── Master Read ──
+async function masterRead() {
+    const el = document.getElementById('mr-result');
+    el.innerHTML = '<span style="color:#8b949e">读取中...</span>';
+    const cfg = connConfig('m');
+    const r = await api('/api/master/read', {
+        ...cfg,
+        register: document.getElementById('mr-addr').value,
+        count: document.getElementById('mr-count').value,
+        data_type: document.getElementById('mr-type').value,
+        function_code: document.getElementById('mr-fc').value,
+        byte_order: document.getElementById('mr-bo').value,
+    });
+    if (r.success) {
+        let html = '<table><tr><th>#</th><th>值</th></tr>';
+        r.values.forEach((v,i) => {
+            html += `<tr><td>${i}</td><td style="color:#58a6ff;font-weight:600">${v}</td></tr>`;
+        });
+        html += '</table>';
+        el.innerHTML = html;
+    } else {
+        el.innerHTML = `<div class="result-msg err">${r.error}</div>`;
+    }
+}
+
+// ── Master Write ──
+async function masterWrite() {
+    const el = document.getElementById('mw-result');
+    el.innerHTML = '<span style="color:#8b949e">写入中...</span>';
+    const cfg = connConfig('m');
+    const r = await api('/api/master/write', {
+        ...cfg,
+        register: document.getElementById('mw-addr').value,
+        value: document.getElementById('mw-val').value,
+        data_type: document.getElementById('mw-type').value,
+    });
+    el.innerHTML = r.success
+        ? `<div class="result-msg ok">✅ 写入成功</div>`
+        : `<div class="result-msg err">${r.error}</div>`;
+}
+
+// ── Master Write Coil ──
+async function masterWriteCoil() {
+    const el = document.getElementById('mwc-result');
+    const cfg = connConfig('m');
+    const r = await api('/api/master/write-coil', {
+        ...cfg,
+        register: document.getElementById('mwc-addr').value,
+        coil_state: document.getElementById('mwc-state').value,
+    });
+    el.innerHTML = r.success
+        ? `<div class="result-msg ok">✅ 线圈写入成功</div>`
+        : `<div class="result-msg err">${r.error}</div>`;
+}
+
+// ── Poll ──
+let _pollActive = false;
+async function pollStart() {
+    if (_pollActive) return;
+    const cfg = connConfig('m');
+    const r = await api('/api/master/poll/start', {
+        ...cfg,
+        register: document.getElementById('mp-addr').value,
+        count: document.getElementById('mp-count').value,
+        data_type: document.getElementById('mp-type').value,
+        interval: document.getElementById('mp-interval').value,
+    });
+    if (!r.success) { alert(r.error); return; }
+    _pollActive = true;
+    document.getElementById('poll-start-btn').disabled = true;
+    document.getElementById('poll-stop-btn').disabled = false;
+    document.getElementById('poll-id').textContent = r.poll_id;
+
+    const resultEl = document.getElementById('mp-result');
+    const canvas = document.getElementById('chart-canvas');
+    const ctx = canvas.getContext('2d');
+    const chartData = [];
+
+    // SSE
+    const evt = new EventSource(`/api/master/poll/${r.poll_id}/data`);
+    evt.onmessage = (e) => {
+        const d = JSON.parse(e.data);
+        if (!d.data) return;
+        if (d.data.error) {
+            resultEl.innerHTML += `<div style="color:#f85149">${d.data.error}</div>`;
+            return;
+        }
+        const iterHtml = `<span style="color:#8b949e">[${d.data.iteration}]</span> ` +
+            (d.data.values||[]).map(v => `<span style="color:#58a6ff;font-weight:600">${v}</span>`).join(' ');
+        resultEl.innerHTML += `<div>${iterHtml}</div>`;
+        resultEl.scrollTop = resultEl.scrollHeight;
+
+        // Chart data
+        if (d.data.values && d.data.values.length > 0) {
+            chartData.push({iter: d.data.iteration, val: parseFloat(d.data.values[0])});
+            if (chartData.length > 100) chartData.shift();
+            drawChart(ctx, canvas, chartData);
+        }
+
+        if (!d.running) { pollCleanup(); evt.close(); }
+    };
+    document.getElementById('poll-stop-btn').onclick = () => {
+        fetch(`/api/master/poll/${r.poll_id}/stop`, {method:'POST'});
+        pollCleanup();
+        evt.close();
+    };
+}
+
+function pollCleanup() {
+    _pollActive = false;
+    document.getElementById('poll-start-btn').disabled = false;
+    document.getElementById('poll-stop-btn').disabled = true;
+}
+
+function drawChart(ctx, canvas, data) {
+    const w = canvas.width = canvas.clientWidth * (window.devicePixelRatio||1);
+    const h = canvas.height = canvas.clientHeight * (window.devicePixelRatio||1);
+    ctx.scale(window.devicePixelRatio||1, window.devicePixelRatio||1);
+    ctx.clearRect(0,0,canvas.width,canvas.height);
+    if (data.length < 2) return;
+    const vals = data.map(d=>d.val);
+    const min = Math.min(...vals), max = Math.max(...vals);
+    const range = max-min || 1;
+    const pad = 10;
+    const cw = canvas.clientWidth, ch = canvas.clientHeight;
+
+    ctx.strokeStyle = '#58a6ff';
+    ctx.lineWidth = 2;
+    ctx.beginPath();
+    data.forEach((d,i) => {
+        const x = pad + (i/(data.length-1))*(cw-2*pad);
+        const y = ch - pad - ((d.val-min)/range)*(ch-2*pad);
+        i===0 ? ctx.moveTo(x,y) : ctx.lineTo(x,y);
+    });
+    ctx.stroke();
+
+    // grid
+    ctx.strokeStyle = '#21262d';
+    ctx.lineWidth = 1;
+    for (let i=0; i<4; i++) {
+        const y = pad + (i/3)*(ch-2*pad);
+        ctx.beginPath(); ctx.moveTo(pad,y); ctx.lineTo(cw-pad,y); ctx.stroke();
+        ctx.fillStyle='#8b949e'; ctx.font='10px monospace';
+        ctx.fillText((max-(i/3)*range).toFixed(1), 2, y-2);
+    }
+}
+
+// ── Slave ──
+async function slaveStart() {
+    const proto = document.getElementById('s-proto').value;
+    const body = {
+        mode: proto,
+        port: document.getElementById('s-port').value,
+        slave_id: document.getElementById('s-sid').value,
+        simulate: document.getElementById('s-sim').checked,
+        baudrate: document.getElementById('s-baud')?.value || '9600',
+        parity: document.getElementById('s-parity')?.value || 'N',
+    };
+    const r = await api('/api/slave/start', body);
+    if (r.success) {
+        document.getElementById('s-status').innerHTML = '<span class="status-dot green"></span>运行中';
+        document.getElementById('s-start-btn').disabled = true;
+        document.getElementById('s-stop-btn').disabled = false;
+        loadRegisterMap();
+    } else {
+        alert(r.error);
+    }
+}
+
+async function slaveStop() {
+    const r = await api('/api/slave/stop', {});
+    if (r.success) {
+        document.getElementById('s-status').innerHTML = '<span class="status-dot red"></span>已停止';
+        document.getElementById('s-start-btn').disabled = false;
+        document.getElementById('s-stop-btn').disabled = true;
+    }
+}
+
+async function loadRegisterMap() {
+    const r = await api('/api/register-map', {});
+    if (!r.success) return;
+    const el = document.getElementById('s-registers');
+    let html = '';
+    for (const [section, regs] of Object.entries(r.sections)) {
+        if (regs.length === 0) continue;
+        const label = {coils:'线圈', discrete_inputs:'离散输入', input_registers:'输入寄存器', holding_registers:'保持寄存器'}[section]||section;
+        html += `<div style="margin-bottom:12px"><strong style="color:#8b949e;font-size:13px">${label}</strong>`;
+        html += '<table><tr><th>地址</th><th>值</th><th>描述</th></tr>';
+        regs.forEach(r => {
+            const val = typeof r.value === 'boolean' ? (r.value?'<span style="color:#3fb950">ON</span>':'<span style="color:#f85149">OFF</span>') : `<span style="color:#58a6ff">${r.value}</span>`;
+            html += `<tr><td>${r.address}</td><td>${val}</td><td style="color:#8b949e">${r.description||''}</td></tr>`;
+        });
+        html += '</table></div>';
+    }
+    el.innerHTML = html;
+}
+
+// ── Scan ──
+async function scanStart() {
+    const btn = document.getElementById('sc-start-btn');
+    const prog = document.getElementById('sc-progress');
+    const result = document.getElementById('sc-result');
+    btn.disabled = true;
+    prog.innerHTML = '连接中...';
+    result.innerHTML = '';
+
+    const proto = document.getElementById('sc-proto').value;
+    const body = {
+        mode: proto,
+        host: document.getElementById('sc-host').value,
+        port: document.getElementById('sc-port').value,
+        timeout: '3.0',
+    };
+    const r = await api('/api/scan', body);
+    if (!r.success) { alert(r.error); btn.disabled=false; return; }
+
+    const evt = new EventSource(`/api/scan/${r.scan_id}/status`);
+    evt.onmessage = (e) => {
+        const d = JSON.parse(e.data);
+        if (d.total) {
+            prog.innerHTML = `扫描进度: ${d.current}/${d.total}`;
+        }
+        if (d.done) {
+            evt.close();
+            btn.disabled = false;
+            if (d.error) {
+                prog.innerHTML = `<span style="color:#f85149">${d.error}</span>`;
+                return;
+            }
+            if (d.found && d.found.length > 0) {
+                prog.innerHTML = `<span style="color:#3fb950">✅ 发现 ${d.found.length} 个活动设备</span>`;
+                result.innerHTML = '<table><tr><th>从站ID</th></tr>' +
+                    d.found.map(id => `<tr><td style="color:#58a6ff;font-weight:600">${id}</td></tr>`).join('') +
+                    '</table>';
+            } else {
+                prog.innerHTML = '<span style="color:#d29922">未发现活动设备</span>';
+                result.innerHTML = '<p style="color:#8b949e">没有从站响应。检查连接和网络配置。</p>';
+            }
+        }
+    };
+}
+
+// ── Init ──
+toggleSerialOpts();
+</script>
+</body>
+</html>"""
+
+_Handler.HTML = FRONTEND_HTML
+
+
+# ── Server launcher ──
+
+def run_gui(host: str = "127.0.0.1", port: int = 8080):
+    """Start the Web GUI server."""
+    server = HTTPServer((host, port), _Handler)
+    url = f"http://{host}:{port}"
+    print(f"\n  == Modbus Tool Web UI ==")
+    print(f"  Open in browser: {url}")
+    print(f"  Press Ctrl+C to stop\n")
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        print("\nShutting down GUI server...")
+        server.shutdown()