# lis-simulator

**Repository Path**: Mq-b/lis-simulator

## Basic Information

- **Project Name**: lis-simulator
- **Description**: 基于ASTM 协议的 TCP/Serial LIS 模拟器
- **Primary Language**: Rust
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://mq-b.github.io/lis-simulator/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-06-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Rust, Slint, Linux, Windows, LIS

## README

# LIS 模拟器

基于 ASTM E1381/E1394 协议的实验室信息系统（LIS）模拟器，用于测试医疗检验仪器的串口通信功能。

**跨平台支持**：Windows / Linux

> [!Tip]
> [**🪟 下载 Windows x64 版本 (最新版)**](https://github.com/Mq-b/lis-simulator/releases/latest/download/lis-simulator-windows-x64.zip)
>
> [**🐧 下载 Linux x64 版本 (最新版)**](https://github.com/Mq-b/lis-simulator/releases/latest/download/lis-simulator-linux-x64.zip)

![主界面截图](images/screenshot_light.png)

![串口主界面截图](images/screenshot_serial_dark.png)

## 功能特性

- **协议实现**：完整支持 ASTM E1381 传输层与 E1394 数据内容标准
- **通信模式**：支持单向（接收结果）与双向（查询/应答）两种 LIS 工作模式
- **数据解析**：实时解析 H/P/O/R/L/Q/C 记录，结构化展示检验结果
- **传输方式**：支持传统串口（RS232）和 TCP 网络通信
- **调试工具**：原始数据日志、HEX 显示、UTF-8 解码、数据导出

## 技术栈

| 组件     | 技术                                          |
| -------- | --------------------------------------------- |
| 语言     | Rust (Edition 2021)                           |
| UI 框架  | [Slint](https://slint.dev) (Fluent 风格)      |
| 串口通信 | [serialport](https://docs.rs/serialport) 4.x |
| 集成测试 | Python 3 + pyserial                           |

## 构建与运行

### 环境要求

- Rust 工具链（推荐通过 [rustup](https://rustup.rs) 安装）
- Windows：MSVC Build Tools
- Linux：`build-essential`、`pkg-config`、`libfontconfig-dev`

### 编译

```bash
cargo build --release
```

### 运行

```bash
cargo run --release
```

## 使用说明

1. 启动程序，在配置面板选择串口号/波特率或 TCP 模式
2. 选择单向或双向通信模式
3. 点击 **开始监听**
4. 仪器发送数据后，原始日志和解析结果实时显示

## 测试

### 单元测试与集成测试

```bash
cargo test
```

### TCP 无头模式（无需物理串口）

```bash
# 终端 1：启动无头 TCP 服务器
cargo run -- --headless --tcp 12345

# 终端 2：运行测试脚本
python tests/test_tcp.py --port 12345
```

### 串口模式（需要 com0com 或物理串口线）

```bash
# 终端 1：启动 GUI
cargo run

# 终端 2：模拟仪器端
python tests/instrument_simulator.py --port COM11 --baud 9600
```

## 协议说明

### ASTM E1381 握手流程

仪器与 LIS 之间的通信建立过程：

![ASTM 握手流程](images/astm_handshake.svg)

完整流程：`ENQ` → `ACK` → 数据帧(可多帧) → `ACK`(每帧) → `EOT`

### 数据帧格式

ASTM 数据帧由以下部分组成：

![数据帧格式](images/astm_frame_format.svg)

- **STX** (0x02)：帧开始标志
- **帧号**：0-9 循环，用于检测丢失/重复帧
- **数据区**：一条或多条记录，以 CR 分隔
- **ETX** (0x03)：帧结束标志（ETB 表示分帧）
- **校验和**：从帧号到 ETX 所有字节之和 mod 256
- **CR LF**：帧终止符

### 数据区记录格式

![数据区记录格式](images/astm_record_types.svg)

| 记录类型 | 说明 |
|---------|------|
| `H` | Header Record - 消息头 |
| `P` | Patient Record - 患者信息 |
| `O` | Order Record - 检验申请 |
| `R` | Result Record - 检验结果 |
| `Q` | Request Record - 查询请求（双向模式） |
| `C` | Comment Record - 备注 |
| `L` | Terminator Record - 结束标记 |

### 协议配置

不同仪器的帧格式存在细微差异（帧号有无、校验和范围、hex 补零等），通过 `protocol.json` 适配：

```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](LICENSE) 许可证开源。