LTE Socket 中继 API

适配有人云 LTE-7S0 · 双设备串口透传服务

● 运行中 服务时间 --

⚠️ 设备配套说明：本服务设计用于两台 LTE-7S0 设备互相转发串口数据。设备A 发送到串口的数据会原样转发给设备B，反之亦然。

📡 TCP Socket 接口（核心）

连接信息

参数值
协议TCP 透传（原始字节流）
主机lte.sriay.cn（域名解析到本服务器）
端口4769
模式TCP Client（设备作为客户端连接）
数据格式透传（无协议头，原始串口数据）
最大客户端2 个（即两台设备）
心跳超时60 秒（无数据则断开）

LTE-7S0 设备配置指引

登录有人云控制台，配置 LTE-7S0 的网络参数：

  1. 工作模式选择 TCP Client
  2. 服务器地址填写 lte.sriay.cn
  3. 服务器端口填写 4769
  4. 连接类型选择 长连接
  5. 数据格式选择 透传模式（即 Hex/原始字节流）
  6. 绑定串口（通常为 UART1：9600,8,N,1）

⚠️ 第 2 台设备用相同配置连接即可，自动配对互发数据。

数据流向示意

设备A(串口) ──TCP──→ [本服务4769] ──TCP──→ 设备B(串口)
       ↑                       │
       └───────── 双向透传 ─────┘

🌐 HTTP 接口（管理用）

GET/api/status

查看当前连接状态（推荐用 curl 调用）。

响应示例：

{
  "status": "running",
  "uptime_seconds": 1234,
  "tcp": {
    "bind": "0.0.0.0:4769",
    "max_clients": 2,
    "connected": 2,
    "clients": [
      { "id": "dev-1-1.2.3.4:55555", "remote": "1.2.3.4:55555", "last_active": "2026-07-11T10:30:00Z" }
    ]
  },
  "http": { "bind": "127.0.0.1:3000" }
}

GET/health

健康检查端点（用于监控），返回 ok。

GET/

你正在查看的页面（API 文档与状态总览）。

🔧 设备配对测试方法

  1. 用网络调试助手（如 SocketTool、Hercules）连接 lte.sriay.cn:4769 验证可达
  2. 在两个调试助手中互发文本，验证双向转发
  3. 配置两台 LTE-7S0 连接到同一个服务器（同一域端口），确认设备入网
  4. 通过有人云查看两台设备已建立 TCP 连接，观察串口互发数据

📝 行为说明与限制