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的数据拷贝的缓冲区。