lis-simulator
LIS 模拟器
基于 ASTM E1381/E1394 协议的实验室信息系统（LIS）模拟器，用于测试医疗检验仪器的串口通信功能。
跨平台支持：Windows / Linux
[!Tip] 🪟 下载 Windows x64 版本 (最新版)
功能特性
- 协议实现：完整支持 ASTM E1381 传输层与 E1394 数据内容标准
- 通信模式：支持单向（接收结果）与双向（查询/应答）两种 LIS 工作模式
- 数据解析：实时解析 H/P/O/R/L/Q/C 记录，结构化展示检验结果
- 传输方式：支持传统串口（RS232）和 TCP 网络通信
- 调试工具：原始数据日志、HEX 显示、UTF-8 解码、数据导出
技术栈
| 组件 | 技术 |
|---|---|
| 语言 | Rust (Edition 2021) |
| UI 框架 | Slint (Fluent 风格) |
| 串口通信 | serialport 4.x |
| 集成测试 | Python 3 + pyserial |
构建与运行
环境要求
- Rust 工具链（推荐通过 rustup 安装）
- Windows：MSVC Build Tools
- Linux：
build-essential、pkg-config、libfontconfig-dev
编译
cargo build --release
运行
cargo run --release
使用说明
- 启动程序，在配置面板选择串口号/波特率或 TCP 模式
- 选择单向或双向通信模式
- 点击 开始监听
- 仪器发送数据后，原始日志和解析结果实时显示
测试
单元测试与集成测试
cargo test
TCP 无头模式（无需物理串口）
# 终端 1：启动无头 TCP 服务器
cargo run -- --headless --tcp 12345
# 终端 2：运行测试脚本
python tests/test_tcp.py --port 12345
串口模式（需要 com0com 或物理串口线）
# 终端 1：启动 GUI
cargo run
# 终端 2：模拟仪器端
python tests/instrument_simulator.py --port COM11 --baud 9600
协议说明
ASTM E1381 握手流程
仪器与 LIS 之间的通信建立过程：
完整流程：ENQ → ACK → 数据帧(可多帧) → ACK(每帧) → EOT
数据帧格式
ASTM 数据帧由以下部分组成：
- STX (0x02)：帧开始标志
- 帧号：0-9 循环，用于检测丢失/重复帧
- 数据区：一条或多条记录，以 CR 分隔
- ETX (0x03)：帧结束标志（ETB 表示分帧）
- 校验和：从帧号到 ETX 所有字节之和 mod 256
- CR LF：帧终止符
数据区记录格式
| 记录类型 | 说明 |
|---|---|
H |
Header Record - 消息头 |
P |
Patient Record - 患者信息 |
O |
Order Record - 检验申请 |
R |
Result Record - 检验结果 |
Q |
Request Record - 查询请求（双向模式） |
C |
Comment Record - 备注 |
L |
Terminator Record - 结束标记 |
协议配置
不同仪器的帧格式存在细微差异（帧号有无、校验和范围、hex 补零等），通过 protocol.json 适配：
{
"astm": {
"has_frame_number": false,
"checksum_includes_stx": true,
"checksum_zero_padded": false
}
}
| 配置项 | 说明 | 默认值 |
|---|---|---|
has_frame_number |
STX 后是否有帧号字节 | false |
checksum_includes_stx |
校验和计算是否包含 STX | true |
checksum_zero_padded |
校验和 hex 是否补零（2位） | false |
配置文件路径：settings/protocol.json 或项目根目录 protocol.json
根据实际仪器的协议文档调整配置，抓包对比即可确认。
License
Copyright (C) 2026 Mq-b
本项目基于 GPL-3.0 许可证开源。