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 位系统：✔️
相关推荐
chilix3 小时前
Linux 跨网段路由转发配置
网络协议
DianSan_ERP2 天前
电商API接口全链路监控：构建坚不可摧的线上运维防线
大数据·运维·网络·人工智能·git·servlet
西岸行者2 天前
学习笔记：SKILLS 能帮助更好的vibe coding
笔记·学习
呉師傅2 天前
火狐浏览器报错配置文件缺失如何解决#操作技巧#
运维·网络·windows·电脑
gihigo19982 天前
基于TCP协议实现视频采集与通信
网络协议·tcp/ip·音视频
悠哉悠哉愿意2 天前
【单片机学习笔记】串口、超声波、NE555的同时使用
笔记·单片机·学习
别催小唐敲代码2 天前
嵌入式学习路线
学习
2501_946205522 天前
晶圆机器人双臂怎么选型？适配2-12寸晶圆的末端效应器有哪些？
服务器·网络·机器人
linux kernel2 天前
第七部分：高级IO
服务器·网络
数字护盾（和中）2 天前
BAS+ATT&CK：企业主动防御的黄金组合
服务器·网络·数据库
热门推荐
01GitHub 镜像站点02【OpenClaw 本地实战 Ep.3】突破瓶颈：强制修改 openclaw.json 解锁 32k 上下文记忆03OpenClaw 使用和管理 MCP 完全指南04AI Agent 平台横评：ZeroClaw vs OpenClaw vs Nanobot05Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services06Clawdbot部署教程：解决‘gateway token missing’授权问题的完整步骤07AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南08Window 10部署openclaw报错node.exe : npm error code 12809让 Trae IDE 智能体 “读懂”文档 Excel+PDF+DOCX ：mcp-documents-reader 工具使用指南10OpenClaw + 飞书（Feishu）环境搭建指南