CAN物理控制单元
配置：
生成的代码：
CanIf_CtrlStates 解析
类型：
typedef union CanIf_CtrlStatesUTag
{
CanIf_CtrlStatesType raw[3];
CanIf_CtrlStatesStructSType str;
}CanIf_CtrlStatesUType;
typedef struct sCanIf_CtrlStatesType
{
CanIf_ControllerModeType CtrlMode;
CanIf_PduGetModeType PduMode;
CanIf_NotifStatusType TxConfState;
}CanIf_CtrlStatesType;
typedef struct CanIf_CtrlStatesStructSTag
{
CanIf_CtrlStatesType ADSCAN;
CanIf_CtrlStatesType BCAN;
CanIf_CtrlStatesType PCAN;
}CanIf_CtrlStatesStructSType;CAN控制器模式：
typedef enum
{
CANIF_CS_UNINIT = 0u,
CANIF_CS_STOPPED,
CANIF_CS_STARTED,
CANIF_CS_SLEEP
} CanIf_ControllerModeType;PDU模式：
只允许在对应的控制器模式等于CAN_CS_STARTED时，更改PDU通道模式，在初始化期间，CanIf应该将每个通道切换到CANIF_OFFLINE。如果调用CanIf_SetControllerMode()，则CanIf会将对应通道的PDU通道模式设置为CANIF_OFFLINE。
如果调用CanIf_SetControllerMode()或CanIf_ControllerBusOff()，则CanIf应将相应通道的PDU通道模式设置为CANIF_TX_OFFLINE。
示意图：
发送状态：
typedef enum
{
CANIF_NO_NOTIFICATION = 0u,
CANIF_TX_RX_NOTIFICATION
} CanIf_NotifStatusType;CanIf_TxPduConfig
typedef struct sCanIf_TxPduConfigType
{
CanIf_UpperLayerTxPduIdOfTxPduConfigType UpperLayerTxPduId;
uint16 CanId;
boolean IsDataChecksumTxPdu;
boolean IsTxPduTruncation;
CanIf_ControllerType CtrlStatesIdx;
uint8 MailBoxConfigIdx;
CanIf_TxConfFctListIdxType TxConfirmationFctListIdx;
uint8 TxPduLength;
}CanIf_TxPduConfigType;- CtrlStatesIdx: CAN控制器的通道
配置：
- CanId: canid 有四种配置 扩展CAN 、标准CAN、扩展CANFD、标准CANFD。
- IsDataChecksumTxPdu ：数据校验
配置：
代码位置：
- IsTxPduTruncation： 为TRUE时，配置最大长度。
上位机配置：
代码位置：
- UpperLayerTxPduId： PDU 的ID
示例：
代码：
- MailBoxConfigIdx ：CANIF 信箱，后面介绍
- TxConfirmationFctListIdx:CanIf_TxConfirmationFctList[]数组下标
发送确认回调函数
CONST(CanIf_TxConfirmationFctType, CANIF_VAR_NOINIT) CanIf_TxConfirmationFctList[2] = {
CAN_NM_CanIfTxConfirmation,
PDUR_CanIfTxConfirmation,
};- TxPduLength: 发送PDU长度
上位机配置：
CanIf_MailBoxConfig
mailbox 涉及的数据结构挺多的，主要是CAN控制器发送的缓存buffer fifo之类的
CanIf_CanIfCtrlId2MappedTxBuffersConfig
/* Get all HTHs with configured Tx-buffer of affected CAN-channel */
for(idx2MappedTxBufferCfg = CanIf_CanIfCtrlId2MappedTxBuffersConfig[ControllerId].StartIdx;
idx2MappedTxBufferCfg < CanIf_CanIfCtrlId2MappedTxBuffersConfig[ControllerId].EndIdx;
idx2MappedTxBufferCfg++ )从上面的代码可以得出，主要是为每个CAN控制器所配置的TX buffer
CONST(CanIf_CanIfCtrlId2MappedTxBuffersConfigType, CANIF_VAR_NOINIT) CanIf_CanIfCtrlId2MappedTxBuffersConfig[1] = {
{ 3u, 0u },
};typedef struct sCanIf_CanIfCtrlId2MappedTxBuffersConfigType
{
uint8 EndIdx;
uint8 StartIdx;
}CanIf_CanIfCtrlId2MappedTxBuffersConfigType;CanIf_MappedTxBuffersConfig
hth = CanIf_MappedTxBuffersConfig[idx2MappedTxBufferCfg].MailBoxConfigIdx;
typedef struct sCanIf_MappedTxBuffersConfigType
{
uint8 MailBoxConfigIdx;
}CanIf_MappedTxBuffersConfigType;
CONST(CanIf_MappedTxBuffersConfigType, CANIF_VAR_NOINIT) CanIf_MappedTxBuffersConfig[3] = {
{ 1u },
{ 2u },
{ 5u },
};主要是此变量主要是去映射到CanIf_MailBoxConfig的配置。
CanIf_MailBoxConfig
定义：
typedef struct sCanIf_MailBoxConfigType
{
uint8 CtrlStatesIdx;
uint8 PduIdFirst;
uint8 PduIdLast;
uint8 TxBufferCfgIdx;
uint8 TxBufferHandlingType;
CanIf_MailBoxTypeType MailBoxType;
}CanIf_MailBoxConfigType;
CONST(CanIf_MailBoxConfigType, CANIF_VAR_NOINIT) CanIf_MailBoxConfig[6] = {
{ 0u, 0u, 1u, 255u, CANIF_TXBUFFER_HANDLINGTYPE_NONE, CANIF_UnusedCANMailbox },
{ 0u, 0u, 0u, 0u, CANIF_TXBUFFER_HANDLINGTYPE_FIFO, CANIF_TxBasicCANMailbox },
{ 1u, 0u, 0u, 2u, CANIF_TXBUFFER_HANDLINGTYPE_FIFO, CANIF_TxBasicCANMailbox },
{ 1u, 2u, 47u, 255u, CANIF_TXBUFFER_HANDLINGTYPE_NONE, CANIF_UnusedCANMailbox },
{ 2u, 49u, 50u, 255u, CANIF_TXBUFFER_HANDLINGTYPE_NONE, CANIF_UnusedCANMailbox },
{ 2u, 0u, 0u, 1u, CANIF_TXBUFFER_HANDLINGTYPE_FIFO, CANIF_TxBasicCANMailbox },
};这里面有个TxBufferCfgIdx，是CanIf_TxBufferFifoConfig的下标。
CanIf_TxBufferFifoConfig
主要是TXBuffer位置的配置
typedef struct sCanIf_TxBufferFifoConfigType
{
uint16 TxFifoQueueDataEndIdx;
uint16 TxFifoQueueDataStartIdx;
uint8 SizeOfOnePayloadEl;
uint8 TxBufferFifoBaseIdx;
uint16 TxFifoQueueBaseEndIdx;
uint8 TxFifoQueueBaseLength;
uint16 TxFifoQueueBaseStartIdx;
}CanIf_TxBufferFifoConfigType;
CONST(CanIf_TxBufferFifoConfigType, CANIF_VAR_NOINIT) CanIf_TxBufferFifoConfig[3] = {
{ 800u, 0u, 8u, 0u, 100u, 100u, 0u },
{ 1600u, 800u, 8u, 1u, 200u, 100u, 100u },
{ 2400u, 1600u, 8u, 2u, 300u, 100u, 200u },
};其中的8为单位递增单元，0、800、1600、为3个buff开始的位置，3个100 对应的是 800 除以8，TxFifoQueueBaseEndIdx的结构没有用到，与之对应的结构是CanIf_TxFifoQueueData。
其中TxBufferFifoBaseIdx为 CanIf_TxBufferFifoBase.raw数组的下标。其中TxFifoQueueBaseLength 为100是上位机配置的：
CanIf_TxBufferFifoBase
typedef union CanIf_TxBufferFifoBaseUTag
{
CanIf_TxBufferFifoBaseType raw[3];
CanIf_TxBufferFifoBaseStructSType str;
}CanIf_TxBufferFifoBaseUType;在CanIf_ClearQueue函数中进行初始化的
switch (CanIf_MailBoxConfig[hth].TxBufferHandlingType)
{
case CANIF_TXBUFFER_HANDLINGTYPE_FIFO:
/* Clearing of FIFO */
txBufferFifoBaseIdx = CanIf_TxBufferFifoConfig[txBufferCfgIdx].TxBufferFifoBaseIdx;
/* Set ReadIdx, WriteIdx and QueueCounter to 0 */
CanIf_TxBufferFifoBase.raw[txBufferFifoBaseIdx].eWriteIdx = 0;
CanIf_TxBufferFifoBase.raw[txBufferFifoBaseIdx].eReadIdx = 0;
CanIf_TxBufferFifoBase.raw[txBufferFifoBaseIdx].eQueueCounter = 0;
break;
default:
break;
}CanIf_TxFifoQueueData
typedef union CanIf_TxFifoQueueDataUTag
{
uint8 raw[2400];
CanIf_TxFifoQueueDataStructSType str;
}CanIf_TxFifoQueueDataUType;CanIf_TransmitSubWrite API 介绍
定义：
CANIF_LOCAL_INLINE FUNC(Std_ReturnType, CANIF_CODE) CanIf_TransmitSubWrite(P2CONST(Can_PduType, AUTOMATIC, AUTOMATIC) localPduPtr)此函数传递的参数为PDU，数据结构为：
typedef struct Can_PduTypeTag
{
Can_IdType id;
uint8 length;
Can_SduPtrType sdu;
PduIdType swPduHandle;
} Can_PduType;此函数主要判断CAN控制器的模式是否使能，PDU是否使能，以及PDU的校验，之后调用CanIf_TransmitSubWrite 函数。
CanIf_TransmitSubWrite
在此函数中判断此PDU的发送方式是否为FIFO，如果为FIFO则判断FIFO是否为空，为空则直接调用Can_Write().
相关代码：
if(CanIf_MailBoxConfig[CanIf_TxPduConfig[localPduPtr->swPduHandle].MailBoxConfigIdx].TxBufferHandlingType == CANIF_TXBUFFER_HANDLINGTYPE_FIFO)
{
/* If Tx-PDU is mapped to Tx-buffer of handling type FIFO it must only be transmitted directly if FIFO is empty */
doCanWrite = CanIf_TransmitSubCheckFiFoQueueEmpty(localPduPtr->swPduHandle);
}
if(doCanWrite == TRUE)
{
//txResult = Can_Write((CanIf_HwHandleType)CanIf_TxPduConfig[localPduPtr->swPduHandle].MailBoxConfigIdx, (P2CONST(Can_PduType, AUTOMATIC, CANIF_VAR_STACK))localPduPtr);
}否则调用CanIf_TransmitSubHandleTxResBusy，缓存到队列 buffer中。
CanIf_TransmitSubHandleTxResBusy
此函数主要是将PDU的数据拷贝到缓冲区，也就是TX buffer中。
/* Evaluate FIFO-WriteIdx */
txFifoQueueBaseStartIdx = CanIf_TxBufferFifoConfig[txBufferCfgIdx].TxFifoQueueBaseStartIdx;
writeIdx = CanIf_TxBufferFifoBase.raw[txBufferFifoBaseIdx].eWriteIdx;
/* Store length of Tx-PDU at FIFO-WriteIdx */
CanIf_TxFifoQueueBase.raw[writeIdx + txFifoQueueBaseStartIdx].eBaseParams.eSduLength = localPduPtr->length;
/* Store the PDU ID of the Tx-PDU at FIFO-WriteIdx */
CanIf_TxFifoQueueBase.raw[writeIdx + txFifoQueueBaseStartIdx].eTxPduId = localPduPtr->swPduHandle;其中txFifoQueueBaseStartIdx为0,100,200 乘以8 就是每个buff开始写的位置。0,800,1600.
后面的是用CanIf_TxFifoQueueBase保存PDU的长度和PDU 的ID。
queueDataStartIdx = ((uint32_least)writeIdx * (uint32_least)CanIf_TxBufferFifoConfig[txBufferCfgIdx].SizeOfOnePayloadEl) + CanIf_TxBufferFifoConfig[txBufferCfgIdx].TxFifoQueueDataStartIdx;
/* Store data of Tx-PDU at FIFO-WriteIdx */
memcpy(&CanIf_TxFifoQueueData.raw[queueDataStartIdx], localPduPtr->sdu, localPduPtr->length);
/* Increment the FIFO-counter */
CanIf_TxBufferFifoBase.raw[txBufferFifoBaseIdx].eQueueCounter++;将PDU的数据拷贝的缓冲区。
