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 位系统：✔️
相关推荐
caimouse8 小时前
TDI (传输驱动接口 Transport Driver Interface) 详细分析
网络协议
weixin_4462608510 小时前
从被动镜像到主动智能体：面向网络物理人工智能的整体论数字孪生（HDT-Net）
网络·人工智能
ZJH__GO10 小时前
网络编程v4pro--实现聊天室文件传输功能
java·服务器·网络·计算机网络
圆奋奋12 小时前
FreeRTOS学习（三）- 任务调度模块
学习·开源·freertos
shengnan_wsn12 小时前
【协议】【TCP】
网络·网络协议·tcp/ip
烟雨江南78512 小时前
2026汽车制造与新能源整车柔性产线Agentic-Workflow白皮书：跨APS_MES_ERP多智能体动态排产与装配容错实战
大数据·网络·人工智能·自动化·ai客服·企业agent
吃着火锅x唱着歌12 小时前
Effective C++ 学习笔记 条款40 明智而审慎地使用多重继承
c++·笔记·学习
小僧景贤13 小时前
CAN调试全套配件+详细实操使用方法（从零排查、步骤落地、现场通用）
网络·can通信·嵌入式通信
消失的旧时光-194313 小时前
第 3 篇：机器人 TCP 长连接如何稳定运行？心跳、掉线检测与自动重连
网络协议·tcp/ip·机器人
xian_wwq13 小时前
【学习笔记】Prompt Engineering 没死，只是它不再够用了-2/16
笔记·学习·prompt
热门推荐
01GitHub 镜像站点02VSCode+CodeX扩展，无法启动03国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）04如何新建文件夹？ 电脑新建文件夹的4种方法05微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新062026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？07Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费08AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路09历年考研数学一、数学二、数学三真题试卷及答案PDF102026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片