QModem/docs/tom_modem.cn.md

工具介绍

更新介绍

0.9.2

特性变更

• 在AT通信中，优化了响应处理逻辑：在接收到初始响应后的特定时间内如果没有进一步的响应，则认为通信已结束。这种机制特别适用于那些可能无法正确返回终止符号的命令。（需要注意的是，当ATE功能启用时，命令回显会立即被读取，这可能导致对于执行时间较长的命令提前返回结果。）
• 在操作执行时，若是模组通讯异常（无返回、护法读写等），会在run_ops函数中返回-1，然后直接发送kill -9 命令（避免close时大量的花销），正常返回则返回0，若是与模组通讯无关的故障（如解析异常）应当返回>0的错误代码

优化

• 更新了超时处理机制，不再依赖alarm信号，而是通过设置阻塞的读写操作，并结合vmin和vtime参数实现超时控制。
• 实现了组件间的一定程度解耦，提高了系统的灵活性和可维护性。

概述

这个工具是一个 AT 命令行界面，用于与调制解调器进行通信。它支持多种操作，包括发送和读取短信、设置波特率和数据位等。

使用方法

命令格式

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，命令为tom_modem -d /dev/mhi_DUN -o b -c ATI时，会向/dev/mhi_DUN发送ATI\r\n (即会自动往命令追加\r\n)
  • binary_at (b) 需要发送控制字符（如^z）等，可使用16进制发送，如tom_modem -d /dev/mhi_DUN -o b -c 4154490D0A 表示向/dev/mhi_DUN发送ATI\r\n。（注意，此选项不会自动追加\r\n 。）
  • 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 命令和波特率、数据位：

  <tool_name> -c ATI -d /dev/ttyUSB2 -b 115200 -B 8 -o at
  

• 普通 AT 模式：

  <tool_name> -c ATI -d /dev/ttyUSB2
  

• 读取短信：

  <tool_name> -d /dev/mhi_DUN -o r