批量任务

批量任务可以把一组 CAN、CAN FD 或 RS485 指令保存在开发板中，再由开发板按顺序执行。电脑断开后任务仍可运行，适合出厂初始化、循环测试和固定动作流程。

批量任务会直接向外部设备发送控制指令。首次测试请断开负载、降低速度和电流限制，并准备急停或断电措施。

基本规则

  • 所有命令通过 USB 串口发送，行尾使用 CRLF。

  • 批次编号为 1～99，名称为 1～16 个字符，只能包含字母、数字、_ 和 -。

  • 条目编号必须从 1 开始连续增加，不能跳号或重复。

  • 单条 payload 最多 80 字节；RS485 条目最多使用其中 68 字节。

  • 固件内部允许较多条目，但为便于维护并减少存储压力，单个批次建议不超过 64 条。

  • Channel=0 同时发送到当前 MCU 管理的两路同类接口；1/3 选择第一路，2/4 选择第二路。

创建并运行一个批次

下面的示例创建一个 CAN FD 扩展帧任务，并只执行一次：

AT+BATBEGIN=1,fd_test
AT+BATADD=1,1,5,1,10,000001230A01020304050607081112131415161718
AT+BATCOMMIT=1
AT+BATRUN=1,1,0,1

每条命令成功时返回：

OK

执行后可查询状态：

AT+BATSTAT?

典型返回：

BATSTAT:run=0,batch_id=1,mode=1,idx=2,count=1,repeat_cfg=1,repeat_done=0,last_err=0,tx_ok=1,tx_fail=0

重点检查 last_err=0、tx_ok 增加且 tx_fail=0。

条目格式

AT+BATADD=<id>,<idx>,<proto>,<ch>,<delay_ms>,<hex_payload>

字段

说明

id

批次编号，1～99

idx

条目编号，从 1 开始连续增加

proto

总线和帧类型，见下表

ch

目标通道；0 表示当前 MCU 的两路接口

delay_ms

本条发送成功后，到下一条开始前的等待时间，0～9999 ms

hex_payload

不带空格的十六进制内容

proto 和 payload 的定义如下，CAN ID 使用高字节在前：

proto

类型

hex_payload

1

经典 CAN 标准帧

CANID(2B) + Len(1B) + Data(0～8B)

2

经典 CAN 扩展帧

CANID(4B) + Len(1B) + Data(0～8B)

3

RS485

原始设备指令 Data(1～68B)

4

CAN FD 标准帧

CANID(2B) + 长度编码(1B) + Data(0～64B)

5

CAN FD 扩展帧

CANID(4B) + 长度编码(1B) + Data(0～64B)

经典 CAN 的 Len 就是实际字节数。CAN FD 使用长度编码：

编码

字节数

编码

字节数

00

0

08

8

01

1

09

12

02

2

0A

16

03

3

0B

20

04

4

0C

24

05

5

0D

32

06

6

0E

48

07

7

0F

64

运行方式

AT+BATRUN=<id>,<mode>,<period_ms>,<repeat>

字段

说明

mode=1

顺序执行一遍后停止

mode=2

周期执行

period_ms

周期模式下，两轮任务之间的等待时间，0～65535 ms

repeat

周期模式的执行轮数；0 表示持续执行，直到收到 AT+BATSTOP

例如，每 100 ms 执行一轮，共执行 10 轮：

AT+BATRUN=1,2,100,10

停止当前任务：

AT+BATSTOP

上电自动运行

确认批次已测试无误后，可设置上电自动运行：

AT+BATAUTOSET=<id>,<mode>,<period_ms>,<repeat>

查询或清除：

AT+BATAUTO?
AT+BATAUTOCLR

该设置会保存到 Flash。mode=1 时 period_ms 必须为 0。

查询和删除

命令

用途

AT+BATLIST?

列出已保存的批次

AT+BATREAD=<id>,<idx>

读取指定条目

AT+BATSTAT?

查看运行状态和收发统计

AT+BATDEL=<id>

删除指定批次

AT+BATERASE

清空全部批次

AT+BATERASE 不会清除设备身份和通信参数，但已保存的批次无法恢复。

较长命令分片上传

如果串口工具不能稳定发送较长的 AT 命令，可分片上传同一个 payload：

AT+BATADDX=<id>,<idx>,<proto>,<ch>,<delay_ms>,<total_len>,<seq>,<off>,<hex_part>
AT+BATADDEND=<id>,<idx>,<crc16>

  • 第一片从 seq=1、off=0 开始。

  • 后续 seq 连续增加，off 等于之前已上传的总字节数。

  • 所有分片完成后，对完整 payload 计算 CRC16-CCITT，初始值为 0x0000，再发送 AT+BATADDEND。

  • 一个条目完成后才能继续上传下一个编号。

错误返回

失败时返回 ERR,<code>：

code

说明

常见处理

1

参数格式错误

检查字段数、十六进制内容和 payload 布局

2

当前状态不允许

检查是否已 BATBEGIN、编号是否连续、分片是否结束

3

参数超出范围

检查批次、通道、延时和长度

4

CRC 不一致

重新计算完整 payload 的 CRC16

5

存储空间不足

删除无用批次；通信配置写满时使用 AT+CFGERASE

6

批次不存在

先用 AT+BATLIST? 确认编号

7

发送队列忙

降低任务频率或增大条目间隔

8

Flash 读写失败

重新上电后复测，仍失败则检查硬件

通信波特率、SPI 长度模式和 RS485 透传设置见通信参数配置。