1、概述
CanIf的发送请求函数CanIf_Transmit()是上层模块传输L-PDU的通用接口。上层通信层模块需要通过CanIf的服务启动传输,无法直接访问CanDrv。如果CanDrv能够将L-PDU数据写入CAN硬件传输对象中,则发起的传输请求成功完成。上层模块使用API服务CanIf_Transmit ()来发起一个传输请求。
CanIf在调用服务CanIf_Transmit()时对L-PDU传输执行以下操作:
- 检查,初始化CanIf的状态
- 当使用多个CanDrv时,识别CanDrv
- 确定访问CAN硬件传输对象的HTH
- 调用CanDrv的Can_Write()
2、发送描述
如果传输请求服务CanIf_Transmit()返回E_OK,则传输成功完成。
如果一个L-PDU被请求通过一个PDU通道模式来传输,这个模式等于CANIF_OFFLINE,那么CanIf应该向DET的Det_ReportRuntimeError()服务报告运行时的错误代码CANIF_E_STOPPED,而CanIf_Transmit() 将返回E_NOT_OK。
2.1 发送数据流
发送请求服务CanIf_Transmit ()是基于L-PDU的。对L-SDU特定数据的访问按以下参数组织:
- 传输L-PDU =>L-SDU ID
- 引用包含L-SDU相关数据的数据结构:指向L-SDU的指针,指向元数据的指针和L-SDU长度。
对L-SDU数据结构的引用被用作几个CanIf API服务中的一个参数,例如CanIf_Transmit()或回调服务 ()。如果L-PDU配置为触发传输,则L-SDU指针为空指针。
CanIf会存储为传输而配置的硬件对象信息。函数CanIf_Transmit()将CanTxPduId映射到对应的HTH,并调用函数Can_Write()。
如果总线镜像是全局启用的CanIfBusMirroringSupport(),并且通过调用CAN控制器的CanIf_EnableBusMirroring()来激活,那么CanIf通过Can_Write()在控制器上传输每帧内容之前将其存储。只有在实际发送时,才提供总线镜像模块。因此,为了能够从CanIf_TxConfirmation()将其提供给总线镜像模块,必须考虑存储内容。不推荐
2.2 发送缓存
在CanIf的范围内,传输过程从调用CanIf_Transmit()开始,到调用上层模块的回调服务()结束。在传输过程中,CanIf、CanDrv和CAN Mailbox一起存储L-PDU,只在一个位置传输一次。根据传送方式的不同,分为:
- CAN硬件传输对象
- 如果发送缓冲使能,发送L-PDU缓冲区在CanIf内。
对于触发传输,CanIf只需要存储给定L-PDU的传输请求,而不需要存储它的数据。当HTH空闲时,通过触发器传递函数及时获取数据。一个单独的发送 L-PDU,请求传输,永远不会被存储两次。这种行为对应于CAN网络上常用的周期性通信方式。
如果CanIf在传输请求时被CanDrv拒绝,CanIf将启用传输缓冲,并将在传输L-PDU缓冲区(CanIfBufferCfg)中存储一个发送 L-PDU。
基本上,用于缓冲发送L-PDU的整个CanIf中的缓冲区包含一个或多个CanIfBufferCfg。而每个CanIfBufferCfg被分配给一个或多个专用的CanIfBufferHthRef,可以配置为缓冲一个或多个发送I-PDU。但是,在CanIfBufferCfg的总体数量中,每个发送 L-PDU只能缓冲一个实例。
在相应的发送 L-PDU配置中是否启用传输缓冲,CanIf在L-PDU传输期间对应的行为是不同的。如果发送缓冲被禁用,并且发送到CanDrv的请求失败,那么L-PDU不会被复制到CAN控制器,CanIf_Transmit()将返回值E_NOT_OK。如果启用了传输缓冲,并且发送到CanDrv的请求失败,根据CanIfTxBuffer配置,L-PDU可以存储在CanIfTxBuffer中。在这种情况下,尽管无法执行传输,API CanIf_Transmit()返回E_OK值(这块和上面函数原型需求[SWS_CANIF_00162]是对应的)。在这种情况下,CanIf通过CanIf_TxConfirmation()回调和处理L-PDU未完成的传输,而上层不必重试传输请求。
传输CanIf 发送L-PDU缓冲区的数量,可以独立于CAN网络描述文件中定义的传输L-PDU的数量来配置。
发送L-PDU通过CanIfBufferCfg配置容器引用HTH,如果不需要传输缓冲,也是有效的。在这种情况下,必须将CanIfBufferCfg的缓冲区大小设置为0,然后CanIfBufferCfg配置容器仅用于引用一个HTH。
2.3 发送确认回调
如果前一个传输请求成功完成,CanDrv会通过调用CanIf_TxConfirmation()将其通知给CanIf。注意一下这个函数的描述,是发送成功之后才调用
如果对于CAN控制器,启用了全局总线镜像CanIfBusMirroringSupport和激活调用CanIf_EnableBusMirroring(), CanIf将会调用Mirror_ReportCanFrame()对每一帧传输控制器确认CanIf_TxConfirmation(),提供存储内容和实际的ID。
调用回调函数CanIf_TxConfirmation()时,CanIf标识与成功传输L-PDU相连的上层通信层,通过调用CanIf的传输确认服务(E_OK)来通知其传输执行情况。回调服务()是由通知的上层模块实现的。
可以配置上层通信层模块,通过对不同的I-PDU或I-PDU组使用单个或多个(一般我们使用的是单个)回调服务来处理发送确认。所有那些服务在发送确认L-PDU传输请求时,会被CanIf调用。传输L-PDU允许分派与目标上层模块关联的不同确认服务,该分配是在静态配置期间完成。
一个发送L-PDU只能分配给一个发送确认回调服务。
如果启用了CanIfPublicTxConfirmPollingSupport,那么每个CAN控制器的模式处于CAN_CS_STARTED状态,CanIf将缓冲接收到的TxConfirmation的信息。