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 位系统：✔️
相关推荐
2501_901147831 天前
学习笔记：单调递增数字求解的迭代优化与工程实践
linux·服务器·笔记·学习·算法
苦逼IT运维1 天前
从 0 到 1 理解 Kubernetes：一次“破坏式”学习实践（一）
linux·学习·docker·容器·kubernetes
野犬寒鸦1 天前
从零起步学习并发编程 || 第五章：悲观锁与乐观锁的思想与实现及实战应用与问题
java·服务器·数据库·学习·语言模型
阿蒙Amon1 天前
TypeScript学习-第13章：实战与最佳实践
javascript·学习·typescript
hrw_embedded1 天前
基于CH395Q网卡移植ftplib的FTP客户端
网络·stm32·ftp·linux库
不是起点的终点1 天前
内网穿透（FRP）
网络
北京耐用通信1 天前
耐达讯自动化Profinet转Devicenet网关：精细化工行业的“协议融合利器”
人工智能·物联网·网络协议·自动化·信息与通信
Blurpath住宅代理1 天前
动态代理的五大优点：提升爬虫效率与安全性
网络·爬虫·动态ip·住宅ip·住宅代理
XHW___0011 天前
webrtc 关键模块创建的时机
网络·音视频·webrtc
Trouvaille ~1 天前
【Linux】UDP Socket编程实战（二）：网络字典与回调设计
linux·运维·服务器·网络·c++·udp·操作系统
热门推荐
01GitHub 镜像站点02Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services03使用 1panel面板 部署 php网站04Vue-skills的中文文档05OpenClaw Chrome扩展使用教程 - 浏览器中继控制06Linux下V2Ray安装配置指南07让 Trae IDE 智能体 “读懂”文档 Excel+PDF+DOCX ：mcp-documents-reader 工具使用指南08从零搭建一个 PHP 登录注册系统（含完整源码）09UV安装并设置国内源10一文了解国产算子编程语言 TileLang，TileLang 对国产开源生态的影响与启示