CAPL学习-CAN相关函数-统计API函数

车载测试工程师2025-12-27 23:54

Statistics API

BusLoad

CAPL 函数 >> CAN >> BusLoad

函数语法

long BusLoad ()

方法语法

CANx.BusLoad

描述

返回通道 x 的当前总线负载。
有效 x 值：1...32

参数

无

返回值

通道 x 的当前总线负载（百分比）。

示例

write ("CAN1 busload = %d", CAN1.BusLoad);

可用性
  • 版本要求：7.1 及以上，8.0 及以上
  • 适用总线：CAN
  • 测量设置 ：✔ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn:: 替代，详情参见统计系统变量）
  • 仿真/测试设置：✔ ✔
  • 32 位系统：✔ ✔
  • 64 位系统：✔ ✔

ChipState

CAPL 函数 >> CAN >> ChipState

函数语法

long ChipState ()

方法语法

CANx.ChipState

描述

返回 CAN x 控制器的当前芯片状态。
有效 x 值：1...32

参数

无

返回值

CAN x 控制器的芯片状态。返回值说明如下表：

返回值 描述
0 值不可用
1 仿真状态
2 未使用
3 错误主动状态
4 警告级别
5 错误被动状态
6 总线关闭状态

芯片状态的详细描述也可参见：CAN 选项的 总线统计窗口。

示例

write ("Chip state of CAN1 = %d", CAN1.ChipState);

可用性
  • 版本要求：7.1 及以上，8.0 及以上
  • 适用总线：CAN
  • 测量设置 ：✔ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn:: 替代，详情参见统计系统变量：CAN）
  • 仿真/测试设置：✔ ✔
  • 32 位系统：✔ ✔
  • 64 位系统：✔ ✔

ErrorFrameCount

CAPL 函数 >> CAN >> ErrorFrameCount

函数语法

long ErrorFrameCount ()

方法语法

CANx.ErrorFrameCount

描述

返回自测量开始以来通道 x 上的错误帧数量。
有效 x 值：1...32

参数

无

返回值

自测量开始以来通道 x 上的错误帧数量。

示例

write ("Number of error frames on CAN1 = %d", CAN1.ErrorFrameCount);

可用性
  • 版本要求：7.1 及以上，8.0 及以上
  • 适用总线：CAN
  • 测量设置 ：✔ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn:: 替代，详情参见统计系统变量）
  • 仿真/测试设置：✔ ✔
  • 32 位系统：✔ ✔
  • 64 位系统：✔ ✔

ErrorFrameRate

CAPL 函数 >> CAN >> ErrorFrameRate

函数语法

long ErrorFrameRate ()

方法语法

CANx.ErrorFrameRate

描述

返回通道 x 上 CAN 错误消息的当前速率。
有效 x 值：1...32

参数

无

返回值

通道 x 上 CAN 错误消息的当前速率（消息/秒）。

示例

write ("Rate of error messages on CAN1 = %d", CAN1.ErrorFrameRate);

可用性
  • 版本要求：7.1 及以上，8.0 及以上
  • 适用总线：CAN
  • 测量设置 ：✔ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn:: 替代，详情参见统计系统变量）
  • 仿真/测试设置：✔ ✔
  • 32 位系统：✔ ✔
  • 64 位系统：✔ ✔

ExtendedFrameCount

CAPL 函数 >> CAN >> ExtendedFrameCount

函数语法

long ExtendedFrameCount ()

方法语法

CANx.ExtendedFrameCount

描述

返回自测量开始以来通道 x 上的扩展帧 CAN 消息数量。
有效 x 值：1...32

参数

无

返回值

自测量开始以来通道 x 上的扩展帧 CAN 消息数量。

示例

write ("Number of extended frames on CAN1 = %d", CAN1.ExtendedFrameCount);

可用性
  • 版本要求：7.1 及以上，8.0 及以上
  • 适用总线：CAN
  • 测量设置 ：✔ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::ExtData 替代，详情参见统计系统变量）
  • 仿真/测试设置：✔ ✔
  • 32 位系统：✔ ✔
  • 64 位系统：✔ ✔

ExtendedFrameRate

CAPL 函数 >> CAN >> ExtendedFrameRate

函数语法

long ExtendedFrameRate ()

方法语法

CANx.ExtendedFrameRate

描述

返回通道 x 上扩展帧 CAN 消息的当前速率。
有效 x 值：1...32

参数

无

返回值

通道 x 上扩展帧 CAN 消息的当前速率（消息/秒）。

示例

write ("Rate of extended frames on CAN1 = %d", CAN1.ExtendedFrameRate);

可用性
  • 版本要求：7.1 及以上，8.0 及以上
  • 适用总线：CAN
  • 测量设置 ：✔ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::ExtDataRate 替代，详情参见统计系统变量）
  • 仿真/测试设置：✔ ✔
  • 32 位系统：✔ ✔
  • 64 位系统：✔ ✔

ExtendedRemoteFrameCount

CAPL 函数 >> CAN >> ExtendedRemoteFrameCount

函数语法

long ExtendedRemoteFrameCount ()

方法语法

CANx.ExtendedRemoteFrameCount

描述

返回自测量开始以来通道 x 上的扩展远程帧 CAN 消息数量。
有效 x 值：1...32

参数

无

返回值

自测量开始以来通道 x 上的扩展远程帧 CAN 消息数量。

示例

write ("Number of extended remote messages on CAN1 = %d", CAN1.ExtendedRemoteFrameCount);

可用性
  • 版本要求：7.1 及以上，8.0 及以上
  • 适用总线：CAN
  • 测量设置 ：✔ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::ExtRemote 替代，详情参见统计系统变量）
  • 仿真/测试设置：✔ ✔
  • 32 位系统：✔ ✔
  • 64 位系统：✔ ✔

ExtendedRemoteFrameRate

CAPL 函数 >> CAN >> ExtendedRemoteFrameRate

函数语法

long ExtendedRemoteFrameRate ()

方法语法

CANx.ExtendedRemoteFrameRate

描述

返回通道 x 上扩展远程帧 CAN 消息的当前速率。
有效 x 值：1...32

参数

无

返回值

通道 x 上扩展远程帧 CAN 消息的当前速率（帧/秒）。

示例

write ("Rate of extended remote messages on CAN1 = %d", CAN1.ExtendedRemoteFrameRate);

可用性
  • 版本要求：7.1 及以上，8.0 及以上
  • 适用总线：CAN
  • 测量设置 ：✔ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::ExtRemoteRate 替代，详情参见统计系统变量）
  • 仿真/测试设置：✔ ✔
  • 32 位系统：✔ ✔
  • 64 位系统：✔ ✔

canResetStatistics

CAPL 函数 >> CAN >> canResetStatistics

函数语法

void canResetStatistics();
void canResetStatistics(long channel);

描述

重置 CAN 通道统计信息。

注意

调用该函数有两种方式：

  • 无显式通道：仅可在仿真/测试设置中定义的 CAPL 程序中调用，重置当前总线上下文中确定的通道统计信息。
  • 带显式通道：仅可在测量设置中定义的 CAPL 程序中调用。
参数

channel：CAN 通道（1 为起始）

返回值

无

示例
c 复制代码 
on key 'r'  
{  
  // 重置 CAN 1 的统计信息  
  canResetStatistics(1);  
}
可用性
  • 版本要求：8.0 及以上
  • 适用总线：CAN
  • 测量设置：✔
  • 仿真/测试设置：✔
  • 32 位系统：✔
  • 64 位系统：✔

OverloadFrameCount

CAPL 函数 >> CAN >> OverloadFrameCount

函数语法

long OverloadFrameCount ()

方法语法

CANx.OverloadFrameCount

描述

返回自测量开始以来，通道 x 上的 CAN 过载帧数量。
有效值 x：1 ... 32

参数
返回值

自测量开始以来，通道 x 上的 CAN 过载帧数量。

示例

write ("CAN1 过载帧数量 = %d", CAN1.OverloadFrameCount);

可用性
  • 版本要求：7.1 及以上
  • 适用总线：CAN
  • 测量模式：✔️
  • 仿真/测试模式：✔️
  • 32 位系统：✔️
  • 64 位系统：✔️

OverloadFrameRate

CAPL 函数 >> CAN >> OverloadFrameRate

函数语法

long OverloadFrameRate ()

方法语法

CANx.OverloadFrameRate

描述

返回通道 x 上 CAN 过载帧的当前速率。
有效值 x：1 ... 32

参数
返回值

通道 x 上 CAN 过载帧的当前速率（单位：帧/秒）。

示例

write ("CAN1 过载帧速率 = %d", CAN1.OverloadFrameRate);

可用性
  • 版本要求：7.1 及以上
  • 适用总线：CAN
  • 测量模式：✔️
  • 仿真/测试模式：✔️
  • 32 位系统：✔️
  • 64 位系统：✔️

PeakLoad

CAPL 函数 >> CAN >> PeakLoad

函数语法

long PeakLoad ()

方法语法

CANx.PeakLoad

描述

返回通道 x 的峰值负载。
有效值 x：1...32

参数
返回值

通道 x 的峰值负载（单位：%）。

示例

write ("CAN1 峰值负载 = %d", CAN1.PeakLoad);

可用性
  • 版本要求：7.1 / 8.0
  • 适用总线：CAN
  • 测量模式：✔️ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::BusloadMax 替代，详见统计系统变量）
  • 仿真/测试模式：✔️
  • 32 位系统：✔️
  • 64 位系统：✔️

RxChipErrorCount

CAPL 函数 >> CAN >> RxChipErrorCount

函数语法

long RxChipErrorCount ()

方法语法

CANx.RxChipErrorCount

描述

返回通道 x 接收器中的当前接收错误计数。
有效值 x：1...32

参数
返回值

通道 x 接收器中的当前错误计数。

示例

write ("CAN1 接收器接收错误计数 = %d", CAN1.RxChipErrorCount);

可用性
  • 版本要求：7.1 / 8.0
  • 适用总线：CAN
  • 测量模式：✔️ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::ChipStateRxErr 替代 StandardFrameCount
    CAPL 函数 >> CAN >> StandardFrameCount
函数语法

long StandardFrameCount ()

方法语法

CANx.StandardFrameCount

描述

返回自测量开始以来，通道 x 上的标准 CAN 报文数量。
有效值 x：1...32

参数
返回值

自测量开始以来，通道 x 上的标准 CAN 报文数量。

示例

write ("CAN1 标准帧数量 = %d", CAN1.StandardFrameCount);

可用性
  • 版本要求：7.1 / 8.0
  • 适用总线：CAN
  • 测量模式：✔️ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::StdData 替代，详见统计系统变量）
  • 仿真/测试模式：✔️
  • 32 位系统：✔️
  • 64 位系统：✔️

StandardFrameRate

CAPL 函数 >> CAN >> StandardFrameRate

函数语法

long StandardFrameRate ()

方法语法

CANx.StandardFrameRate

描述

返回通道 x 上标准 CAN 报文的当前速率。
有效值 x：1...32

参数
返回值

通道 x 上标准 CAN 帧的当前速率（单位：帧/秒）。

示例

write ("CAN1 标准帧速率 = %d", CAN1.StandardFrameRate);

可用性
  • 版本要求：7.1 / 8.0
  • 适用总线：CAN
  • 测量模式：✔️ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::StdDataRate 替代，详见统计系统变量）
  • 仿真/测试模式：✔️
  • 32 位系统：✔️
  • 64 位系统：✔️

StandardRemoteFrameCount

CAPL 函数 >> CAN >> StandardRemoteFrameCount

函数语法

long StandardRemoteFrameCount ()

方法语法

CANx.StandardRemoteFrameCount

描述

返回自测量开始以来，通道 x 上的标准远程 CAN 帧数量。
有效值 x：1...32

参数
返回值

自测量开始以来，通道 x 上的标准远程 CAN 帧数量。

示例

write ("CAN1 标准远程帧数量 = %d", CAN1.StandardRemoteFrameCount);

可用性
  • 版本要求：7.1 / 8.0
  • 适用总线：CAN
  • 测量模式：✔️ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::StdRemote 替代，详见统计系统变量）
  • 仿真/测试模式：✔️
  • 32 位系统：✔️
  • 64 位系统：✔️

StandardRemoteFrameRate

CAPL 函数 >> CAN >> StandardRemoteFrameRate

函数语法

long StandardRemoteFrameRate ()

方法语法

CANx.StandardRemoteFrameRate

描述

返回通道 x 上标准远程 CAN 帧的当前速率。
有效值 x：1...32

参数
返回值

通道 x 上标准远程 CAN 帧的当前速率（单位：帧/秒）。

示例

write ("CAN1 标准远程帧速率 = %d", CAN1.StandardRemoteFrameRate);

可用性
  • 版本要求：7.1 / 8.0
  • 适用总线：CAN
  • 测量模式：✔️ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::StdRemoteRate 替代，详见统计系统变量）
  • 仿真/测试模式：✔️
  • 32 位系统：✔️
  • 64 位系统：✔️

TxChipErrorCount

CAPL 函数 >> CAN >> TxChipErrorCount

函数语法

long TxChipErrorCount ()

方法语法

CANx.TxChipErrorCount

描述

返回通道 x 的 CAN 接收器中的当前发送错误数量。
有效值 x：1...32

参数
返回值

通道 x 的 CAN 接收器中的当前错误数量。

示例

write ("CAN1 接收器发送错误数量 = %d", CAN1.TxChipErrorCount);

可用性
  • 版本要求：7.1 / 8.0
  • 适用总线：CAN
  • 测量模式：✔️ ---（已弃用，由预定义系统变量 sysvar::_Statistics::CANn::ChipStateTxErr 替代，详见统计系统变量）
  • 仿真/测试模式：✔️
  • 32 位系统：✔️
  • 64 位系统：✔️
相关推荐
XGStudio20249 分钟前
免费安全的 - 二维码转换工具
学习·ai
hengmeida19 分钟前
楼宇控制柜标准化项目交付完整规范
大数据·网络·笔记
2501_9378609420 分钟前
上篇：网络编程基础与UDP套接字编程
java·网络·计算机网络
邵奈一25 分钟前
【紧急处理ZCode事件】ZCode 工作区快照静默上传：检测方法与三层防护实践
人工智能·学习·大模型·国产
那年窗外下的雪.39 分钟前
AIDC 学习日志｜第 27 天｜EVPN 多归属收敛时间线与 Leaf2 接管验证
网络协议·学习·http·tcpdump
xixiaoyunya41 分钟前
制造业生产数据备份：在“不停产“前提下的自动化实践
网络·安全
秦哈哈1 小时前
【HelloAgents】学习笔记(四)
学习·ai·agent
Figo_Cheung1 小时前
Figo权重动力学：递归本体论与跨尺度演化的形式化基础——揭示：宇宙的演化，本质上就是一场由无数观测者共同参与的、永不停歇的、跨尺度的权重重构盛宴。
网络·人工智能·量子计算
j7～1 小时前
【Linux】三十八.C++ 手写 HTTP 服务器：裸 socket + fork 多进程，从 HTTP 报文解析到浏览器打开网页
linux·网络·网络协议·学习·http·网络编程
FW-Linker1 小时前
偏远山区户外直播网络优化：多链路聚合如何保障稳定低时延传输
网络·5g·智能路由器
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接03GitHub 镜像站点04历年考研数学一、数学二、数学三真题试卷及答案PDF05人工智能（AI）发展史：详细里程碑06微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新072026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？08ZCode 周末送额度活动开启：3 亿 Token 免费领取09数学公理体系大全:第六章 选择公理的等价形式及证明102026 爱知・名古屋亚运会怎么看？直播平台+赛程安排分享