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 位系统:✔️