QModem/docs/tom_modem.cn.md
2024-11-06 15:33:23 +08:00

71 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 工具介绍
## 更新介绍
### 0.9.2
#### 特性变更
- 在AT通信中优化了响应处理逻辑在接收到初始响应后的特定时间内如果没有进一步的响应则认为通信已结束。这种机制特别适用于那些可能无法正确返回终止符号的命令。需要注意的是当ATE功能启用时命令回显会立即被读取这可能导致对于执行时间较长的命令提前返回结果。
- 在操作执行时若是模组通讯异常无返回、护法读写等会在run_ops函数中返回-1然后直接发送kill -9 命令避免close时大量的花销正常返回则返回0若是与模组通讯无关的故障如解析异常应当返回>0的错误代码
#### 优化
- 更新了超时处理机制不再依赖alarm信号而是通过设置阻塞的读写操作并结合vmin和vtime参数实现超时控制。
- 实现了组件间的一定程度解耦,提高了系统的灵活性和可维护性。
## 概述
这个工具是一个 AT 命令行界面,用于与调制解调器进行通信。它支持多种操作,包括发送和读取短信、设置波特率和数据位等。
## 使用方法
### 命令格式
```bash
usage: <tool_name> [options]
```
### 选项
- `-c, --at_cmd <AT command>`
指定要发送的 AT 命令。
- `-d, --tty_dev <TTY device>`
指定 TTY 设备 **必填**
- `-b, --baud_rate <baud rate>`
设置波特率,默认值为 115200。支持的波特率有4800, 9600, 19200, 38400, 57600, 115200。
- `-B, --data_bits <data bits>`
设置数据位,默认值为 8。支持的数据位有5, 6, 7, 8。
- `-t, --timeout <timeout>`
设置超时时间,默认值为 3 秒。
- `-o, --operation <operation>`指定操作类型,支持的操作有:
- `at` (a) 无-o参数默认为at
- `sms_read` (r)
- `sms_send` (s)
- `sms_delete` (d)
- `-D, --debug`
启用调试模式,默认值为关闭。可以打印大量该工具的台哦是信息和与模组通信的原始数据。
- `-p, --sms_pdu <sms pdu>`
指定 SMS PDU。
- `-i, --sms_index <sms index>`
指定 SMS 索引。
### 示例
- 设置 AT 命令和波特率、数据位:
```bash
<tool_name> -c ATI -d /dev/ttyUSB2 -b 115200 -B 8 -o at
```
- 普通 AT 模式:
```bash
<tool_name> -c ATI -d /dev/ttyUSB2
```
- 读取短信:
```bash
<tool_name> -d /dev/mhi_DUN -o r
```