transmit_canfd_sequential 是 TSMaster 新版本中新增的序列发送接口,该函数专为实现连续 CAN FD 报文间微秒级间隔的精确控制而生。相较于传统方式,它不仅显著提升了帧间隔的时间精度,在周期性发送场景下也更为稳定。内附完整代码,速来解锁高精度发帧技巧!
本文关键词:transmit_canfd_sequential函数,序列发送,帧间隔,C小程序
1. 应用场景
TSMaster 传统序列发送方式仅能实现毫秒级帧间隔控制,且存在一定误差波动,难以支持如uds诊断传输层测试等对时序敏感的应用场景。为此,TSMaster 推出 transmit_canfd_sequential 函数,支持脚本化微秒级连续帧发送,在精度与稳定性上相较原有方式均有显著提升。
2. transmit_canfd_sequential 函数说明
函数原型:
int transmit_canfd_sequential(s32 AIdxChn, PCANFD ACANFDs, pu32 AIntervalsUs, s32 ACount, u8 AFlags)
函数功能:请求以配置的间隔顺序发送一组CAN FD帧
参数说明:
- AIdxChn:报文发送的通道;
- ACANFDs:指向要发送的CAN FD帧的PCANFD数组的指针;
- AIntervalsUs:指向帧间隔数组的指针。第一个值表示硬件设备接收到顺序发送指令与触发发送第一帧之间的延迟时间;
- ACount:发送CAN FD帧的PCANFD数组和间隔数组的大小;
- AFlags:控制标志位,0表示正常运行。
说明:ACANFDs数组指针的大小指明了序列发送的报文条数,对Pro设备来说,一个设备最大支持发送600条序列报文。
使用 transmit_canfd_sequential 函数进行序列发送时,需依次完成以下配置:首先,声明一个 TCANFD 类型的数据对象,并定义一个用于存放帧间隔时间的数组(单位:微秒);随后,通过该报文结构体的 init_w_std_id 成员方法,构造待发送的报文数据;最后,调用 transmit_canfd_sequential 函数启动发送流程。脚本执行后,序列发送指令将被下发至硬件层,后续的连续帧发送任务均由硬件独立自主完成,无需主机端干预。
注意:使用transmit_canfd_sequential函数需要搭配最新固件版本的TC1016P设备。最新固件版本为2026-08-08版本。
3. 使用示例
/********
在需要发送连续帧的位置,调用以下代码,若用于诊断中发送连续帧一般在接收事件中调用
*********/
int i;
TCANFD frames[10];
u32 intervals[10] = {1000, 500, 500, 500, 500, 500, 500, 500, 500, 500};
for(i=0;i<10;i++)
{
frames[i].init_w_std_id(0x55+i, 8);
log("frames[%d].FIdentifier:0x%x",i,frames[i].FIdentifier);
}
if (0 == com.transmit_canfd_sequential(CH1, &frames[0], &intervals[0], 10, 0))
{
log("序列报文发送成功");
}
else
{
log("return:%d",com.transmit_canfd_sequential(CH1,&frames[0], &intervals[0], 10, 0));
}
4. 精度范围
- 测试设备:TC1016P(固件版本:2026-08-08);
- 测试环境:波特率为500kbit/s,总线负载率13%,CPU40%,内存68%;
- 测试用例:在TSMaster软件的C小程序中调用 transmit_canfd_sequential 函数发送CAN FD报文,设定帧间隔为500us,每组发送10帧报文,重复发送多组数据,测试 transmit_canfd_sequential 函数的精度;
- 测试说明:报文发送时间误差的大致计算,采用后一帧报文的绝对时间减去前一帧报文绝对时间,减去报文本身时间长度(报文本身时间长度由字节长度和填充位决定),并减去报文设定帧间隔。
设定500us间隔,CAN FD类型报文,字节长度8
| 测试组别号 | 原始间隔范围(s) | 误差时间范围(s) | 备注 |
| 1 | 0.000756~0.000767 | -0.000002~0.000018 | 未使能RBS位 |
| 2 | 0.000756~0.000767 | -0.000002~0.000019 | 未使能RBS位 |
| 3 | 0.000754~0.000766 | -0.000004~0.000017 | 未使能RBS位 |
| 4 | 0.000755~0.000766 | -0.000003~0.000018 | 未使能RBS位 |
| 5 | 0.000754~0.000767 | -0.000004~0.000018 | 未使能RBS位 |
| 6 | 0.000609~0.000614 | 0.000004~0.000010 | 使能RBS位 |
| 7 | 0.000609~0.000613 | 0.000004~0.000010 | 使能RBS位 |
| 8 | 0.000609~0.000613 | 0.000004~0.000010 | 使能RBS位 |
| 9 | 0.000610~0.000614 | 0.000006~0.000012 | 使能RBS位 |
| 10 | 0.000610~0.000615 | 0.000004~0.000013 | 使能RBS位 |
| 总述 | 0.000609~0.000767 | -0.000004~0.000019 | — |
* 以上数据为特定测试条件下的结果,仅供测试参考,不能完全代表实际工况下的真实表现。


测试结论:根据以上模拟多场景报文发送效果对应的时间样品,计算报文发送时间误差,测试结果表明,使用 transmit_canfd_sequential 函数进行序列发送时,实际报文发送周期与设定值之间的偏差稳定在20µs左右,即误差范围在±4%以内,且整体偏差波动幅度较小,具备良好的稳定性,符合预期测试结果。
【文末互动】您对TSMaster的哪个功能最感兴趣?或在实际应用中遇到过哪些问题?欢迎在评论区分享你的经验或疑问,任何想法或建议也可以评论区留言互动,将有机会获得TOSUN神秘大礼包哦~
TSMaster 技术交流群
如您有关于TSMaster软件使用问题需要技术支持,欢迎扫码添加TOSUN同星技术客服企微直接联系和咨询:

小贴士:
- 软件下载:
点击下方软件下载链接,直接下载安装,建议下载 beta 版本 - 软件升级:
在电脑有互联网连接的前提下,可以在软件内检查升级至最新版本。
注:同星智能技术支持邮箱:support@tosunai.cn,欢迎大家前来咨询!(须注明公司及联系方式)


