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 位系统：✔️
相关推荐
永远快乐的攻城狮1 分钟前
二、学习电子元器件-电阻器
学习
LateFrames29 分钟前
泰勒级数：从 “单点” 到 “理论与实践的鸿沟”
学习·算法
武帝为此43 分钟前
【RC4加密算法介绍】
网络·python·算法
coding者在努力1 小时前
SQL使用NOT EXITS实现全称量词查询(数据库查询所有)详细讲解和技巧总结
网络·数据库·sql
航Hang*1 小时前
第3章：复习篇——第4节：创建、管理视图与索引---题库
网络·数据库·笔记·sql·学习·mysql·期末
爱学习的潇潇1 小时前
Postman学习之常用断言
自动化测试·软件测试·功能测试·学习·程序人生·lua·postman
JeffDingAI1 小时前
【Datawhale学习笔记】NLP 概述
笔记·学习·自然语言处理
非凡ghost1 小时前
SoftPerfect Network Scanner(网络扫描管理工具)
网络·windows·学习·软件需求
tobias.b1 小时前
408真题解析-2009-35-网络-后退N帧协议
网络·计算机考研·408真题解析
早日退休！！！1 小时前
Roofline模型核心原理：延迟、吞吐与并发的底层逻辑
大数据·网络·数据库
热门推荐
01GitHub 镜像站点022025 Telegram 最新免费社工库机器人（LetsTG可[特殊字符]）搭建指南（含 Python 脚本）032025年大语言模型技术全景报告04Linux下V2Ray安装配置指南05UV安装并设置国内源06安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）07Claude Code Skills 实用使用手册08BongoCat - 跨平台键盘猫动画工具09Labelme从安装到标注：零基础完整指南10AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南