/* * Copyright (c) 2022, Shenzhen CVA Innovation CO.,LTD * All rights reserved. * * Shenzhen CVA Innovation CO.,LTD (CVA chip) is supplying this file for use * exclusively with CVA's microcontroller products. This file can be freely * distributed within development tools that are supporting such microcontroller * products. * * THIS SOFTWARE IS PROVIDED "AS IS". NO WARRANTIES, WHETHER EXPRESS, IMPLIED * OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. * CVA SHALL NOT, IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL, * OR CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER. */ #ifndef _ISOTP_H_ #define _ISOTP_H_ /*! \brief Contains public interface to various functions related * to the ISO TP (ISO 17987-2) */ /******************************************************************************* * the includes ******************************************************************************/ #include #include #ifdef __cplusplus extern "C" { #endif /******************************************************************************* * the defines ******************************************************************************/ /*! \brief Defines all the return values */ #define ISOTP_RET_OK (0) #define ISOTP_RET_ERROR (-1) #define ISOTP_RET_INPROGRESS (-2) #define ISOTP_RET_OVERFLOW (-3) #define ISOTP_RET_WRONG_SN (-4) #define ISOTP_RET_NO_DATA (-5) #define ISOTP_RET_TIMEOUT (-6) #define ISOTP_RET_LENGTH (-7) #define ISOTP_RET_WRONG_NAD (-8) /*! \brief The default timeout to use when waiting for a response during a multi-frame receive. */ #define ISOTP_DEFAULT_RESPONSE_TIMEOUT (1000) /*! \brief The default timeout to use when waiting for a frame send confirmed. */ #define ISOTP_DEFAULT_CONFIRM_TIMEOUT (1000) /******************************************************************************* * the typedefs ******************************************************************************/ /*! \brief The declaration of the buffer used for both send and receive */ typedef uint8_t *IsoTp_Buffer; /*! \brief User implemented, print debug message */ typedef void (*IsoTp_DebugShim)(const char *message, ...); /*! \brief User implemented, send can message */ typedef int8_t (*IsoTp_SendLinMsgShim)(const uint8_t *pData, const uint8_t size); /*! \brief User implemented, get whether send complete or not */ typedef bool (*IsoTp_IsLinSendComplete)(void); /*! \brief User implemented, get millisecond */ typedef int64_t (*IsoTp_GetTimeShimMs)(void); /*! \brief Defines all the parameters used to initialize ISOTP object */ typedef struct _IsoTp_Params_ { uint8_t physNad; /*!< physical addressing id */ uint8_t funcNad; /*!< functional addressing id */ uint8_t broadcastNad; /*!< functional addressing id */ uint8_t *sendBuf; /*!< message send buffer */ uint16_t sendBufSize; /*!< the size of send buffer */ uint8_t *recvBuf; /*!< message receive buffer */ uint16_t recvBufSize; /*!< the size of receive buffer */ IsoTp_DebugShim debug; /*!< the adapter of debug function */ IsoTp_SendLinMsgShim sendLinMsg; /*!< the adapter of lin-send-message function */ IsoTp_IsLinSendComplete isLinSendComplete; /*!< the adapter of is-lin-send-complete function return value: false--data is sending or waiting send true--data send complete or no data need to send */ IsoTp_GetTimeShimMs getTimeMs; /*!< the adapter of get-time-stamp function */ } IsoTp_Params; /*! \brief Structure containing the data for linking an application to a CAN instance. * The data stored in this structure is used internally and may be used by software programs * using this library. */ typedef struct _IsoTpType_ { uint8_t physNad; /*!< physical addressing id */ uint8_t funcNad; /*!< functional addressing id */ uint8_t broadcastNad; /*!< functional addressing id */ IsoTp_Buffer sendBuffer; /*!< send buffer */ uint16_t sendBufferSize; /*!< the size of send buffer */ uint16_t sendSize; /*!< the size of data to send */ uint16_t sendOffset; /*!< the offset of current send process */ uint8_t sendSN; /*!< serial number of send message */ int64_t sendTimerAs; /*!< Time until of the Frame N_PDU start at send start end at send confirmed */ int64_t sendTimerSeptime; /*!< Last time send consecutive frame */ int sendProtocolResult; /*!< the result of send protocol */ uint8_t sendStatus; /*!< the send status */ uint8_t receiveArbitrationNad; /*! used to determine whether physical or functional addressing */ IsoTp_Buffer receiveBuffer; /*!< message receive buffer */ uint16_t receiveBufferSize; /*!< the size of RX buffer */ uint16_t receiveSize; /*!< the size to receive */ uint16_t receiveOffset; /*!< the offset of receive process */ uint8_t receiveSN; /*!< serial number of receive message */ int64_t receiveTimerCr; /*!< Time until reception of the next ConsecutiveFrame N_PDU start at receive FF or CF end at receive CF */ int8_t receiveProtocolResult; /*!< the result of receive protocol */ uint8_t receiveStatus; /*!< the receive status */ IsoTp_DebugShim debug; /*!< the adapter of debug function */ IsoTp_SendLinMsgShim sendLinMsg; /*!< the adapter of lin-send-message function */ IsoTp_IsLinSendComplete isLinSendComplete; /*!< the adapter of is-lin-send-complete function return value: false--data is sending waiting send true--data send complete or no data need to send */ IsoTp_GetTimeShimMs getTimeMs; /*!< the adapter of get-time-stamp function */ } IsoTpType; /******************************************************************************* * the globals ******************************************************************************/ /******************************************************************************* * the function prototypes ******************************************************************************/ /*! \brief Initializes the ISO-TP library. * * This function intiliaze the ISO-TP instance * * \param[in] obj : pointer to ISOTP instance * \param[in] pParams : pointer to the initialization parameters */ extern void IsoTp_Init(IsoTpType *obj, const IsoTp_Params *pParams); /*! \brief Polling function * * Call this function periodically to handle timeouts, send consecutive frames, etc. * * \param[in] obj : pointer to ISOTP instance */ extern void IsoTp_Poll(IsoTpType *obj); /*! \brief Handles incoming CAN messages. * * Determines whether an incoming message is a valid ISO-TP frame or not and handles it accordingly. * * \param[in] obj : pointer to ISOTP instance * \param[in] pData : pointer to data of incoming CAN frame * \param[in] len : the length of data of incoming CAN frame */ extern void IsoTp_HandleIncomingLinMsg(IsoTpType *obj, const uint8_t *pData, uint8_t len); /*! \brief Sends ISO-TP frames via CAN, using the ID set in the initializing function. * * Single-frame messages will be sent immediately when calling this function. * Multi-frame messages will be sent consecutively when calling isotp_poll. * * \param[in] obj : pointer to ISOTP instance * \param[in] pPayload : the incoming CAN frame ID * \param[in] size : pointer to data of incoming CAN frame */ extern int8_t IsoTp_Send(IsoTpType *obj, const uint8_t pPayload[], uint16_t size); /*! \brief Receives and parses the received data and copies the parsed data in to the internal buffer. * * This function receives and parses the received data and copies the parsed data in to the internal buffer. * * \param[in] obj : pointer to ISOTP instance * \param[out] IsFuncAddr : pointer the result of whether is functional addressing * \param[out] pPayload : pointer to the payload * \param[in] payloadSize : the payload size * \param[out] pOutSize : the size of actual output payload */ extern int8_t IsoTp_Receive(IsoTpType *obj, bool *IsFuncAddr, uint8_t *pPayload, uint16_t payloadSize, uint16_t *pOutSize); #ifdef __cplusplus } #endif /* extern "C" */ #endif /* _ISOTP_H_ */