AVB Interaction Layer
功能函数
1. AVB交互层（AVB Interaction Layer）
CAPL函数 >> 以太网 >> AVB交互层
仅在.Ethernet选项下可用。
使用CAPL函数需包含AVB_IL.DLL。
本页内容
- 回调函数（Callback Functions）
- 控制函数（Control Functions）
- 通用函数（General Functions）
- 监听器函数（Listener Functions）
- 监听器/发送器函数（Listener/Talker Functions）
- 发送器（Talker）
回调函数
| 函数名 | 描述 |
|---|---|
| OnAvbConnect | 异步连接操作完成时触发。 |
| OnAvbListen | 指定监听器收到连接请求时触发。 |
| OnAvbReceive | 监听器异步接收操作完成时触发。 |
| OnAvbSend | 发送器异步发送操作完成时触发。 |
控制函数
| 函数名 | 描述 |
|---|---|
| AvbILControlInit | 初始化AVB交互层。 |
| AvbILControlResume | 恢复先前暂停的AVB/TSN自动消息发送行为。 |
| AvbILControlStart | 启动AVB交互层。 |
| AvbILControlStop | 停止AVB交互层。 |
| AvbILControlWait | 停止发送AVB/TSN相关消息。 |
通用函数
| 函数名 | 描述 |
|---|---|
| AvbGetLastError | 检查AVB交互层最后调用的函数是否成功执行。 |
| AvbGetLastErrorText | 获取AVB交互层最后发生的错误（字符串形式）。 |
| AvbSetProperty | 设置属性以配置AVB交互层行为。 |
| AvbSetVerbosity | 设置AVB交互层消息在"输出窗口"中的详细级别。 |
| PtpSetProperty | 通过属性配置PTP层行为。 |
| PtpSimulationTimespanFromPtpTimespan | 将PTP时间跨度转换为等效的仿真时间跨度。 |
| PtpTimeFromSimulationTime | 将仿真时间转换为对应的全局PTP时间。 |
| PtpTimeNow | 返回当前全局PTP时间。 |
监听器函数
| 函数名 | 描述 |
|---|---|
| AvbAccept | 接受指定监听器上的传入连接请求，创建新监听器。 |
| AvbCloseListener | 关闭监听器。 |
| AvbListen | 使监听器监听传入连接请求。 |
| AvbOpenListener | 创建用于基于连接的面向消息通信的监听器。 |
| AvbReceive | 将数据接收到指定缓冲区。 |
监听器/发送器函数
| 函数名 | 描述 |
|---|---|
| AvbGetMediaType | 获取监听器或发送器的媒体类型。 |
| AvbGetProtocol | 获取监听器接收或发送器生成的流中AAF样本的位深度。 |
| AvbGetStreamId | 获取监听器或发送器的流标识符（ID）。 |
| AvbGetStreamSourceAddress | 获取监听器或发送器的流源地址。 |
| AvbGetStreamUniqueId | 获取监听器或发送器流的唯一标识符（作为流ID的一部分）。 |
发送器函数
| 函数名 | 描述 |
|---|---|
| AvbCloseTalker | 关闭发送器。 |
| AvbConnect | 与指定目标建立连接。 |
| AvbOpenTalker | 创建用于基于连接的面向消息通信的发送器。 |
| AvbSend | 将数据接收到指定缓冲区（原文可能有误，应为"发送数据"）。 |
| AvbSetMediaType | 设置发送器的媒体类型。 |
| AvbSetProtocol | 设置发送器的AVTP协议。 |
2. AVB交互层：设置（AVB IL: Setup）
以太网 >> AVB交互层 >> 设置
AVB交互层通过添加CAPL函数扩展仿真节点功能。需将AVB交互层分配给节点，节点才能使用AVB扩展。
操作步骤
- 从上下文菜单打开节点配置对话框。
- 切换到"组件"页。
- 点击 [添加...] 打开文件选择对话框。
- 选择CANoe安装目录中
exec32文件夹下的AVB_IL.DLL文件。 - 点击 [确定] 关闭对话框。
- 从上下文菜单打开节点的TCP/IP配置对话框。
- 在"TCP/IP堆栈选择"区域，启用"独立TCP/IP堆栈实例"选项。
- 为每个通道配置唯一MAC地址。
（可选）若需自定义VLAN ID和PCP，可配置发送器的VLAN设置。 - 点击 [确定] 关闭对话框。
完成上述步骤后，即可通过CAPL API使用AVB交互层功能。
3. AVB交互层错误码（AVB IL Error Codes）
CAPL函数 >> 以太网 >> AVB交互层 >> AVB交互层错误码
| 错误码 | 描述 |
|---|---|
| 0 | 成功/无错误 |
| 46-0600 | 通用错误 |
| 46-0603 | 参数无效 |
| 46-0604 | 函数无效 |
| 46-0606 | 配置无效 |
| 46-0607 | 缓冲区不足 |
| 46-0608 | 状态无效 |
| 46-0609 | I/O挂起 |
| 46-0610 | 无可用接收缓冲区 |
| 46-0611 | 数据被遗漏 |
| 46-0614 | 字段值无效 |
| 46-0615 | 字段访问无效 |
| 46-0616 | 数据长度无效 |
| 46-0617 | 序列号无效 |
| 46-0618 | 呈现时间小于数据包时间戳 |
| 46-0620 | 已建立流中AVTP协议变更 |
| 46-0621 | 已建立流中AVTP协议格式变更 |