CANoe CAPL——CAN CAPL函数
CAN 总线统计（Bus Statistics）
| 函数名 | 简要说明 |
|---|---|
canEnableStatistics |
启用或禁用特定（Form 1）或全部（Form 2）CAN通道的统计功能 |
canGetBurstsCount |
获取CAN通道的总突发传输数 |
canGetBurstTime |
获取CAN通道突发传输传输的持续时间（微秒） |
canGetBusLoad |
获取CAN通道的总线负载（百分比） |
canGetChipState |
获取CAN通道的芯片当前状态 |
canGetErrorFrameCount |
获取CAN通道的错误帧总数 |
canGetErrorFrameRate |
获取CAN通道的错误帧速率（帧/秒） |
canGetExtDataCount |
获取CAN通道的扩展数据帧总数 |
canGetExtDataRate |
获取扩展数据帧速率（帧/秒） |
canGetExtRemoteCount |
获取扩展远程帧总数 |
canGetExtRemoteRate |
获取扩展远程帧速率（帧/秒） |
canGetFramesPerBurstCount |
获取每个突发传输中包含的帧数量 |
canGetMinSendDistance |
获取两帧之间的最小发送间隔（毫秒） |
canGetOverloadFrameCount |
获取CAN通道的过载帧总数 |
canGetOverloadFrameRate |
获取过载帧速率（帧/秒） |
canGetRxErrorCount |
获取CAN通道的接收错误总数 |
canGetStdDataCount |
获取标准数据帧总数 |
canGetStdDataRate |
获取标准数据帧速率（帧/秒） |
canGetStdRemoteCount |
获取标准远程帧总数 |
canGetStdRemoteRate |
获取标准远程帧速率（帧/秒） |
canGetTransceiverErrorCount |
获取CAN通道的收发器错误总数 |
canGetTxErrorCount |
获取CAN通道的发送错误总数 |
CANdb 数据库 （CANdb API）
| 函数名 | 中文说明 |
|---|---|
getFirstCANdbFilename |
获取第一个分配的 CAN 数据库的文件名。 |
getFirstCANdbName |
获取第一个分配的 CAN 数据库的名称。 |
getSignalName |
根据起始位索引返回CAN网络中CAN 报文或者PDU 中信号的名称。 |
getMessageAttrInt |
从数据库中获取某个消息的属性。 |
GetMessageID |
获取消息 ID。 |
GetMessageName |
获取消息名称。 |
getNextCANdbFilename |
获取其他已分配数据库的文件名。 |
getNextCANdbName |
获取其他已分配数据库的名称。 |
setSignalStartValues |
将信号值设置为数据库中定义的初始值。 |
事件过程（Event Procedures）
| 事件名 | 简要说明 |
|---|---|
on errorFrame |
当发生错误帧时触发 |
on message |
当接收到 CAN 消息时触发 |
on signal |
每次信号值变化时触发 |
on signal_change |
每次信号值变化时触发 |
on signal_update |
每次信号被接收到时触发（即使值未变化） |
CAN 控制器相关事件
| 事件名 | 简要说明 |
|---|---|
on busOff |
当 CAN 控制器进入 Bus Off 状态时触发 |
on errorActive |
当控制器进入 ErrorActive 状态时触发 |
on errorPassive |
当控制器进入 ErrorPassive 状态时触发 |
on warningLimit |
当控制器达到警告极限（Warning Limit）时触发 |
通用函数（General Functions）
| 函数名 | 简要说明 |
|---|---|
canConfigureBusOff |
设置总线状态为 BusOff |
canGetDataLength |
返回 CAN 消息的有效负载长度 |
canOutputErrorFrame |
向 CAN 总线输出一个错误帧 |
getPayloadData |
获取在传输过程中被中断的帧的有效负载 |
isStdId |
判断参数是否为标准 ID |
isExtId |
判断参数是否为扩展 ID |
mkExtId |
返回一个扩展 ID |
output |
从程序块中输出一条CAN消息或错误帧 |
valOfId |
获取消息标识符的值 |
硬件 API（Hardware API）
| 函数名 | 简要说明 |
|---|---|
canActivateTxSelfAck |
启用/禁用指定通道的传输自确认功能（self ack feature） |
canFdGetConfiguration |
获取 CAN控制器仲裁和数据段参数 |
canFdSetConfiguration |
设置 CAN控制器仲裁和数据段参数 |
canFlushTxQueue |
清空指定通道的发送队列 |
canGetConfiguration |
读取 CAN 控制器参数配置 |
canSetChannelAcc |
设置接受过滤器，通过CANoe DE发送接收消息 |
canSetChannelMode |
启用/禁用 CAN 控制器的 TXRQ |
canSetChannelOutput |
设置控制器对总线流量的响应行为，设置ACK bit |
canSetConfiguration |
设置 CAN 控制器参数配置 |
GetCanBittimingConfiguration |
获取bit timings设置 |
getCardTypeEx |
获取 CAN 通道的硬件卡类型 |
getChipType |
获取使用的 CAN 控制器芯片类型 |
resetCan |
重置 CAN 控制器 |
ResetCanEx |
重置指定 CAN 通道的控制器 |
ScanBaudrateActive |
检测指定通道波特率 |
ScanBaudratePassive |
开始扫描并检测指定通道波特率 |
setBtr |
设置另一个波特率 |
SetCanBittimingConfiguration |
设置bit timings配置 |
setOcr |
设置输出控制寄存器 |
选择器（Selectors）
| 选择器名 | 简要说明 |
|---|---|
Message |
CAN 消息选择器的详细说明 |
ErrorFrame |
CAN 错误帧选择器的详细说明 |
统计 API（Statistics API）
| 函数名 | 简要说明 |
|---|---|
canResetStatistics |
重置 CAN 通道的统计数据 |
BusLoad |
返回当前通道的总线负载（单位：百分比） |
ChipState |
返回 CAN 控制器当前的芯片状态 |
ExtendedFrameRate |
返回当前通道上扩展CAN 消息的传输速率（帧/秒） |
ExtendedRemoteFrameRate |
返回从测量开始至今接收到的扩展远程帧数量 |
RxChipErrorCount |
返回当前通道接收端的接收错误计数值 |
StandardFrameRate |
返回标准CAN 消息的当前传输速率（帧/秒） |
StandardRemoteFrameRate |
返回当前通道上标准远程帧的传输速率（帧/秒） |
TxChipErrorCount |
返回当前通道发送端的发送错误计数值 |