stm32f0xx_hal_can.h 43 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847
  1. /**
  2. ******************************************************************************
  3. * @file stm32f0xx_hal_can.h
  4. * @author MCD Application Team
  5. * @brief Header file of CAN HAL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2016 STMicroelectronics.
  10. * All rights reserved.
  11. *
  12. * This software is licensed under terms that can be found in the LICENSE file
  13. * in the root directory of this software component.
  14. * If no LICENSE file comes with this software, it is provided AS-IS.
  15. *
  16. ******************************************************************************
  17. */
  18. /* Define to prevent recursive inclusion -------------------------------------*/
  19. #ifndef STM32F0xx_HAL_CAN_H
  20. #define STM32F0xx_HAL_CAN_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32f0xx_hal_def.h"
  26. /** @addtogroup STM32F0xx_HAL_Driver
  27. * @{
  28. */
  29. #if defined (CAN)
  30. /** @addtogroup CAN
  31. * @{
  32. */
  33. /* Exported types ------------------------------------------------------------*/
  34. /** @defgroup CAN_Exported_Types CAN Exported Types
  35. * @{
  36. */
  37. /**
  38. * @brief HAL State structures definition
  39. */
  40. typedef enum
  41. {
  42. HAL_CAN_STATE_RESET = 0x00U, /*!< CAN not yet initialized or disabled */
  43. HAL_CAN_STATE_READY = 0x01U, /*!< CAN initialized and ready for use */
  44. HAL_CAN_STATE_LISTENING = 0x02U, /*!< CAN receive process is ongoing */
  45. HAL_CAN_STATE_SLEEP_PENDING = 0x03U, /*!< CAN sleep request is pending */
  46. HAL_CAN_STATE_SLEEP_ACTIVE = 0x04U, /*!< CAN sleep mode is active */
  47. HAL_CAN_STATE_ERROR = 0x05U /*!< CAN error state */
  48. } HAL_CAN_StateTypeDef;
  49. /**
  50. * @brief CAN init structure definition
  51. */
  52. typedef struct
  53. {
  54. uint32_t Prescaler; /*!< Specifies the length of a time quantum.
  55. This parameter must be a number between Min_Data = 1 and Max_Data = 1024. */
  56. uint32_t Mode; /*!< Specifies the CAN operating mode.
  57. This parameter can be a value of @ref CAN_operating_mode */
  58. uint32_t SyncJumpWidth; /*!< Specifies the maximum number of time quanta the CAN hardware
  59. is allowed to lengthen or shorten a bit to perform resynchronization.
  60. This parameter can be a value of @ref CAN_synchronisation_jump_width */
  61. uint32_t TimeSeg1; /*!< Specifies the number of time quanta in Bit Segment 1.
  62. This parameter can be a value of @ref CAN_time_quantum_in_bit_segment_1 */
  63. uint32_t TimeSeg2; /*!< Specifies the number of time quanta in Bit Segment 2.
  64. This parameter can be a value of @ref CAN_time_quantum_in_bit_segment_2 */
  65. FunctionalState TimeTriggeredMode; /*!< Enable or disable the time triggered communication mode.
  66. This parameter can be set to ENABLE or DISABLE. */
  67. FunctionalState AutoBusOff; /*!< Enable or disable the automatic bus-off management.
  68. This parameter can be set to ENABLE or DISABLE. */
  69. FunctionalState AutoWakeUp; /*!< Enable or disable the automatic wake-up mode.
  70. This parameter can be set to ENABLE or DISABLE. */
  71. FunctionalState AutoRetransmission; /*!< Enable or disable the non-automatic retransmission mode.
  72. This parameter can be set to ENABLE or DISABLE. */
  73. FunctionalState ReceiveFifoLocked; /*!< Enable or disable the Receive FIFO Locked mode.
  74. This parameter can be set to ENABLE or DISABLE. */
  75. FunctionalState TransmitFifoPriority;/*!< Enable or disable the transmit FIFO priority.
  76. This parameter can be set to ENABLE or DISABLE. */
  77. } CAN_InitTypeDef;
  78. /**
  79. * @brief CAN filter configuration structure definition
  80. */
  81. typedef struct
  82. {
  83. uint32_t FilterIdHigh; /*!< Specifies the filter identification number (MSBs for a 32-bit
  84. configuration, first one for a 16-bit configuration).
  85. This parameter must be a number between
  86. Min_Data = 0x0000 and Max_Data = 0xFFFF. */
  87. uint32_t FilterIdLow; /*!< Specifies the filter identification number (LSBs for a 32-bit
  88. configuration, second one for a 16-bit configuration).
  89. This parameter must be a number between
  90. Min_Data = 0x0000 and Max_Data = 0xFFFF. */
  91. uint32_t FilterMaskIdHigh; /*!< Specifies the filter mask number or identification number,
  92. according to the mode (MSBs for a 32-bit configuration,
  93. first one for a 16-bit configuration).
  94. This parameter must be a number between
  95. Min_Data = 0x0000 and Max_Data = 0xFFFF. */
  96. uint32_t FilterMaskIdLow; /*!< Specifies the filter mask number or identification number,
  97. according to the mode (LSBs for a 32-bit configuration,
  98. second one for a 16-bit configuration).
  99. This parameter must be a number between
  100. Min_Data = 0x0000 and Max_Data = 0xFFFF. */
  101. uint32_t FilterFIFOAssignment; /*!< Specifies the FIFO (0 or 1U) which will be assigned to the filter.
  102. This parameter can be a value of @ref CAN_filter_FIFO */
  103. uint32_t FilterBank; /*!< Specifies the filter bank which will be initialized.
  104. This parameter mus be a number between Min_Data = 0 and Max_Data = 13. */
  105. uint32_t FilterMode; /*!< Specifies the filter mode to be initialized.
  106. This parameter can be a value of @ref CAN_filter_mode */
  107. uint32_t FilterScale; /*!< Specifies the filter scale.
  108. This parameter can be a value of @ref CAN_filter_scale */
  109. uint32_t FilterActivation; /*!< Enable or disable the filter.
  110. This parameter can be a value of @ref CAN_filter_activation */
  111. uint32_t SlaveStartFilterBank; /*!< Select the start filter bank for the slave CAN instance.
  112. STM32F0xx devices don't support slave CAN instance (dual CAN). Therefore
  113. this parameter is meaningless but it has been kept for compatibility across
  114. STM32 families. */
  115. } CAN_FilterTypeDef;
  116. /**
  117. * @brief CAN Tx message header structure definition
  118. */
  119. typedef struct
  120. {
  121. uint32_t StdId; /*!< Specifies the standard identifier.
  122. This parameter must be a number between Min_Data = 0 and Max_Data = 0x7FF. */
  123. uint32_t ExtId; /*!< Specifies the extended identifier.
  124. This parameter must be a number between Min_Data = 0 and Max_Data = 0x1FFFFFFF. */
  125. uint32_t IDE; /*!< Specifies the type of identifier for the message that will be transmitted.
  126. This parameter can be a value of @ref CAN_identifier_type */
  127. uint32_t RTR; /*!< Specifies the type of frame for the message that will be transmitted.
  128. This parameter can be a value of @ref CAN_remote_transmission_request */
  129. uint32_t DLC; /*!< Specifies the length of the frame that will be transmitted.
  130. This parameter must be a number between Min_Data = 0 and Max_Data = 8. */
  131. FunctionalState TransmitGlobalTime; /*!< Specifies whether the timestamp counter value captured on start
  132. of frame transmission, is sent in DATA6 and DATA7 replacing pData[6] and pData[7].
  133. @note: Time Triggered Communication Mode must be enabled.
  134. @note: DLC must be programmed as 8 bytes, in order these 2 bytes are sent.
  135. This parameter can be set to ENABLE or DISABLE. */
  136. } CAN_TxHeaderTypeDef;
  137. /**
  138. * @brief CAN Rx message header structure definition
  139. */
  140. typedef struct
  141. {
  142. uint32_t StdId; /*!< Specifies the standard identifier.
  143. This parameter must be a number between Min_Data = 0 and Max_Data = 0x7FF. */
  144. uint32_t ExtId; /*!< Specifies the extended identifier.
  145. This parameter must be a number between Min_Data = 0 and Max_Data = 0x1FFFFFFF. */
  146. uint32_t IDE; /*!< Specifies the type of identifier for the message that will be transmitted.
  147. This parameter can be a value of @ref CAN_identifier_type */
  148. uint32_t RTR; /*!< Specifies the type of frame for the message that will be transmitted.
  149. This parameter can be a value of @ref CAN_remote_transmission_request */
  150. uint32_t DLC; /*!< Specifies the length of the frame that will be transmitted.
  151. This parameter must be a number between Min_Data = 0 and Max_Data = 8. */
  152. uint32_t Timestamp; /*!< Specifies the timestamp counter value captured on start of frame reception.
  153. @note: Time Triggered Communication Mode must be enabled.
  154. This parameter must be a number between Min_Data = 0 and Max_Data = 0xFFFF. */
  155. uint32_t FilterMatchIndex; /*!< Specifies the index of matching acceptance filter element.
  156. This parameter must be a number between Min_Data = 0 and Max_Data = 0xFF. */
  157. } CAN_RxHeaderTypeDef;
  158. /**
  159. * @brief CAN handle Structure definition
  160. */
  161. typedef struct __CAN_HandleTypeDef
  162. {
  163. CAN_TypeDef *Instance; /*!< Register base address */
  164. CAN_InitTypeDef Init; /*!< CAN required parameters */
  165. __IO HAL_CAN_StateTypeDef State; /*!< CAN communication state */
  166. __IO uint32_t ErrorCode; /*!< CAN Error code.
  167. This parameter can be a value of @ref CAN_Error_Code */
  168. #if USE_HAL_CAN_REGISTER_CALLBACKS == 1
  169. void (* TxMailbox0CompleteCallback)(struct __CAN_HandleTypeDef *hcan);/*!< CAN Tx Mailbox 0 complete callback */
  170. void (* TxMailbox1CompleteCallback)(struct __CAN_HandleTypeDef *hcan);/*!< CAN Tx Mailbox 1 complete callback */
  171. void (* TxMailbox2CompleteCallback)(struct __CAN_HandleTypeDef *hcan);/*!< CAN Tx Mailbox 2 complete callback */
  172. void (* TxMailbox0AbortCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Tx Mailbox 0 abort callback */
  173. void (* TxMailbox1AbortCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Tx Mailbox 1 abort callback */
  174. void (* TxMailbox2AbortCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Tx Mailbox 2 abort callback */
  175. void (* RxFifo0MsgPendingCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Rx FIFO 0 msg pending callback */
  176. void (* RxFifo0FullCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Rx FIFO 0 full callback */
  177. void (* RxFifo1MsgPendingCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Rx FIFO 1 msg pending callback */
  178. void (* RxFifo1FullCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Rx FIFO 1 full callback */
  179. void (* SleepCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Sleep callback */
  180. void (* WakeUpFromRxMsgCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Wake Up from Rx msg callback */
  181. void (* ErrorCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Error callback */
  182. void (* MspInitCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Msp Init callback */
  183. void (* MspDeInitCallback)(struct __CAN_HandleTypeDef *hcan); /*!< CAN Msp DeInit callback */
  184. #endif /* (USE_HAL_CAN_REGISTER_CALLBACKS) */
  185. } CAN_HandleTypeDef;
  186. #if USE_HAL_CAN_REGISTER_CALLBACKS == 1
  187. /**
  188. * @brief HAL CAN common Callback ID enumeration definition
  189. */
  190. typedef enum
  191. {
  192. HAL_CAN_TX_MAILBOX0_COMPLETE_CB_ID = 0x00U, /*!< CAN Tx Mailbox 0 complete callback ID */
  193. HAL_CAN_TX_MAILBOX1_COMPLETE_CB_ID = 0x01U, /*!< CAN Tx Mailbox 1 complete callback ID */
  194. HAL_CAN_TX_MAILBOX2_COMPLETE_CB_ID = 0x02U, /*!< CAN Tx Mailbox 2 complete callback ID */
  195. HAL_CAN_TX_MAILBOX0_ABORT_CB_ID = 0x03U, /*!< CAN Tx Mailbox 0 abort callback ID */
  196. HAL_CAN_TX_MAILBOX1_ABORT_CB_ID = 0x04U, /*!< CAN Tx Mailbox 1 abort callback ID */
  197. HAL_CAN_TX_MAILBOX2_ABORT_CB_ID = 0x05U, /*!< CAN Tx Mailbox 2 abort callback ID */
  198. HAL_CAN_RX_FIFO0_MSG_PENDING_CB_ID = 0x06U, /*!< CAN Rx FIFO 0 message pending callback ID */
  199. HAL_CAN_RX_FIFO0_FULL_CB_ID = 0x07U, /*!< CAN Rx FIFO 0 full callback ID */
  200. HAL_CAN_RX_FIFO1_MSG_PENDING_CB_ID = 0x08U, /*!< CAN Rx FIFO 1 message pending callback ID */
  201. HAL_CAN_RX_FIFO1_FULL_CB_ID = 0x09U, /*!< CAN Rx FIFO 1 full callback ID */
  202. HAL_CAN_SLEEP_CB_ID = 0x0AU, /*!< CAN Sleep callback ID */
  203. HAL_CAN_WAKEUP_FROM_RX_MSG_CB_ID = 0x0BU, /*!< CAN Wake Up from Rx msg callback ID */
  204. HAL_CAN_ERROR_CB_ID = 0x0CU, /*!< CAN Error callback ID */
  205. HAL_CAN_MSPINIT_CB_ID = 0x0DU, /*!< CAN MspInit callback ID */
  206. HAL_CAN_MSPDEINIT_CB_ID = 0x0EU, /*!< CAN MspDeInit callback ID */
  207. } HAL_CAN_CallbackIDTypeDef;
  208. /**
  209. * @brief HAL CAN Callback pointer definition
  210. */
  211. typedef void (*pCAN_CallbackTypeDef)(CAN_HandleTypeDef *hcan); /*!< pointer to a CAN callback function */
  212. #endif /* USE_HAL_CAN_REGISTER_CALLBACKS */
  213. /**
  214. * @}
  215. */
  216. /* Exported constants --------------------------------------------------------*/
  217. /** @defgroup CAN_Exported_Constants CAN Exported Constants
  218. * @{
  219. */
  220. /** @defgroup CAN_Error_Code CAN Error Code
  221. * @{
  222. */
  223. #define HAL_CAN_ERROR_NONE (0x00000000U) /*!< No error */
  224. #define HAL_CAN_ERROR_EWG (0x00000001U) /*!< Protocol Error Warning */
  225. #define HAL_CAN_ERROR_EPV (0x00000002U) /*!< Error Passive */
  226. #define HAL_CAN_ERROR_BOF (0x00000004U) /*!< Bus-off error */
  227. #define HAL_CAN_ERROR_STF (0x00000008U) /*!< Stuff error */
  228. #define HAL_CAN_ERROR_FOR (0x00000010U) /*!< Form error */
  229. #define HAL_CAN_ERROR_ACK (0x00000020U) /*!< Acknowledgment error */
  230. #define HAL_CAN_ERROR_BR (0x00000040U) /*!< Bit recessive error */
  231. #define HAL_CAN_ERROR_BD (0x00000080U) /*!< Bit dominant error */
  232. #define HAL_CAN_ERROR_CRC (0x00000100U) /*!< CRC error */
  233. #define HAL_CAN_ERROR_RX_FOV0 (0x00000200U) /*!< Rx FIFO0 overrun error */
  234. #define HAL_CAN_ERROR_RX_FOV1 (0x00000400U) /*!< Rx FIFO1 overrun error */
  235. #define HAL_CAN_ERROR_TX_ALST0 (0x00000800U) /*!< TxMailbox 0 transmit failure due to arbitration lost */
  236. #define HAL_CAN_ERROR_TX_TERR0 (0x00001000U) /*!< TxMailbox 0 transmit failure due to transmit error */
  237. #define HAL_CAN_ERROR_TX_ALST1 (0x00002000U) /*!< TxMailbox 1 transmit failure due to arbitration lost */
  238. #define HAL_CAN_ERROR_TX_TERR1 (0x00004000U) /*!< TxMailbox 1 transmit failure due to transmit error */
  239. #define HAL_CAN_ERROR_TX_ALST2 (0x00008000U) /*!< TxMailbox 2 transmit failure due to arbitration lost */
  240. #define HAL_CAN_ERROR_TX_TERR2 (0x00010000U) /*!< TxMailbox 2 transmit failure due to transmit error */
  241. #define HAL_CAN_ERROR_TIMEOUT (0x00020000U) /*!< Timeout error */
  242. #define HAL_CAN_ERROR_NOT_INITIALIZED (0x00040000U) /*!< Peripheral not initialized */
  243. #define HAL_CAN_ERROR_NOT_READY (0x00080000U) /*!< Peripheral not ready */
  244. #define HAL_CAN_ERROR_NOT_STARTED (0x00100000U) /*!< Peripheral not started */
  245. #define HAL_CAN_ERROR_PARAM (0x00200000U) /*!< Parameter error */
  246. #if USE_HAL_CAN_REGISTER_CALLBACKS == 1
  247. #define HAL_CAN_ERROR_INVALID_CALLBACK (0x00400000U) /*!< Invalid Callback error */
  248. #endif /* USE_HAL_CAN_REGISTER_CALLBACKS */
  249. #define HAL_CAN_ERROR_INTERNAL (0x00800000U) /*!< Internal error */
  250. /**
  251. * @}
  252. */
  253. /** @defgroup CAN_InitStatus CAN InitStatus
  254. * @{
  255. */
  256. #define CAN_INITSTATUS_FAILED (0x00000000U) /*!< CAN initialization failed */
  257. #define CAN_INITSTATUS_SUCCESS (0x00000001U) /*!< CAN initialization OK */
  258. /**
  259. * @}
  260. */
  261. /** @defgroup CAN_operating_mode CAN Operating Mode
  262. * @{
  263. */
  264. #define CAN_MODE_NORMAL (0x00000000U) /*!< Normal mode */
  265. #define CAN_MODE_LOOPBACK ((uint32_t)CAN_BTR_LBKM) /*!< Loopback mode */
  266. #define CAN_MODE_SILENT ((uint32_t)CAN_BTR_SILM) /*!< Silent mode */
  267. #define CAN_MODE_SILENT_LOOPBACK ((uint32_t)(CAN_BTR_LBKM | CAN_BTR_SILM)) /*!< Loopback combined with
  268. silent mode */
  269. /**
  270. * @}
  271. */
  272. /** @defgroup CAN_synchronisation_jump_width CAN Synchronization Jump Width
  273. * @{
  274. */
  275. #define CAN_SJW_1TQ (0x00000000U) /*!< 1 time quantum */
  276. #define CAN_SJW_2TQ ((uint32_t)CAN_BTR_SJW_0) /*!< 2 time quantum */
  277. #define CAN_SJW_3TQ ((uint32_t)CAN_BTR_SJW_1) /*!< 3 time quantum */
  278. #define CAN_SJW_4TQ ((uint32_t)CAN_BTR_SJW) /*!< 4 time quantum */
  279. /**
  280. * @}
  281. */
  282. /** @defgroup CAN_time_quantum_in_bit_segment_1 CAN Time Quantum in Bit Segment 1
  283. * @{
  284. */
  285. #define CAN_BS1_1TQ (0x00000000U) /*!< 1 time quantum */
  286. #define CAN_BS1_2TQ ((uint32_t)CAN_BTR_TS1_0) /*!< 2 time quantum */
  287. #define CAN_BS1_3TQ ((uint32_t)CAN_BTR_TS1_1) /*!< 3 time quantum */
  288. #define CAN_BS1_4TQ ((uint32_t)(CAN_BTR_TS1_1 | CAN_BTR_TS1_0)) /*!< 4 time quantum */
  289. #define CAN_BS1_5TQ ((uint32_t)CAN_BTR_TS1_2) /*!< 5 time quantum */
  290. #define CAN_BS1_6TQ ((uint32_t)(CAN_BTR_TS1_2 | CAN_BTR_TS1_0)) /*!< 6 time quantum */
  291. #define CAN_BS1_7TQ ((uint32_t)(CAN_BTR_TS1_2 | CAN_BTR_TS1_1)) /*!< 7 time quantum */
  292. #define CAN_BS1_8TQ ((uint32_t)(CAN_BTR_TS1_2 | CAN_BTR_TS1_1 | CAN_BTR_TS1_0)) /*!< 8 time quantum */
  293. #define CAN_BS1_9TQ ((uint32_t)CAN_BTR_TS1_3) /*!< 9 time quantum */
  294. #define CAN_BS1_10TQ ((uint32_t)(CAN_BTR_TS1_3 | CAN_BTR_TS1_0)) /*!< 10 time quantum */
  295. #define CAN_BS1_11TQ ((uint32_t)(CAN_BTR_TS1_3 | CAN_BTR_TS1_1)) /*!< 11 time quantum */
  296. #define CAN_BS1_12TQ ((uint32_t)(CAN_BTR_TS1_3 | CAN_BTR_TS1_1 | CAN_BTR_TS1_0)) /*!< 12 time quantum */
  297. #define CAN_BS1_13TQ ((uint32_t)(CAN_BTR_TS1_3 | CAN_BTR_TS1_2)) /*!< 13 time quantum */
  298. #define CAN_BS1_14TQ ((uint32_t)(CAN_BTR_TS1_3 | CAN_BTR_TS1_2 | CAN_BTR_TS1_0)) /*!< 14 time quantum */
  299. #define CAN_BS1_15TQ ((uint32_t)(CAN_BTR_TS1_3 | CAN_BTR_TS1_2 | CAN_BTR_TS1_1)) /*!< 15 time quantum */
  300. #define CAN_BS1_16TQ ((uint32_t)CAN_BTR_TS1) /*!< 16 time quantum */
  301. /**
  302. * @}
  303. */
  304. /** @defgroup CAN_time_quantum_in_bit_segment_2 CAN Time Quantum in Bit Segment 2
  305. * @{
  306. */
  307. #define CAN_BS2_1TQ (0x00000000U) /*!< 1 time quantum */
  308. #define CAN_BS2_2TQ ((uint32_t)CAN_BTR_TS2_0) /*!< 2 time quantum */
  309. #define CAN_BS2_3TQ ((uint32_t)CAN_BTR_TS2_1) /*!< 3 time quantum */
  310. #define CAN_BS2_4TQ ((uint32_t)(CAN_BTR_TS2_1 | CAN_BTR_TS2_0)) /*!< 4 time quantum */
  311. #define CAN_BS2_5TQ ((uint32_t)CAN_BTR_TS2_2) /*!< 5 time quantum */
  312. #define CAN_BS2_6TQ ((uint32_t)(CAN_BTR_TS2_2 | CAN_BTR_TS2_0)) /*!< 6 time quantum */
  313. #define CAN_BS2_7TQ ((uint32_t)(CAN_BTR_TS2_2 | CAN_BTR_TS2_1)) /*!< 7 time quantum */
  314. #define CAN_BS2_8TQ ((uint32_t)CAN_BTR_TS2) /*!< 8 time quantum */
  315. /**
  316. * @}
  317. */
  318. /** @defgroup CAN_filter_mode CAN Filter Mode
  319. * @{
  320. */
  321. #define CAN_FILTERMODE_IDMASK (0x00000000U) /*!< Identifier mask mode */
  322. #define CAN_FILTERMODE_IDLIST (0x00000001U) /*!< Identifier list mode */
  323. /**
  324. * @}
  325. */
  326. /** @defgroup CAN_filter_scale CAN Filter Scale
  327. * @{
  328. */
  329. #define CAN_FILTERSCALE_16BIT (0x00000000U) /*!< Two 16-bit filters */
  330. #define CAN_FILTERSCALE_32BIT (0x00000001U) /*!< One 32-bit filter */
  331. /**
  332. * @}
  333. */
  334. /** @defgroup CAN_filter_activation CAN Filter Activation
  335. * @{
  336. */
  337. #define CAN_FILTER_DISABLE (0x00000000U) /*!< Disable filter */
  338. #define CAN_FILTER_ENABLE (0x00000001U) /*!< Enable filter */
  339. /**
  340. * @}
  341. */
  342. /** @defgroup CAN_filter_FIFO CAN Filter FIFO
  343. * @{
  344. */
  345. #define CAN_FILTER_FIFO0 (0x00000000U) /*!< Filter FIFO 0 assignment for filter x */
  346. #define CAN_FILTER_FIFO1 (0x00000001U) /*!< Filter FIFO 1 assignment for filter x */
  347. /**
  348. * @}
  349. */
  350. /** @defgroup CAN_identifier_type CAN Identifier Type
  351. * @{
  352. */
  353. #define CAN_ID_STD (0x00000000U) /*!< Standard Id */
  354. #define CAN_ID_EXT (0x00000004U) /*!< Extended Id */
  355. /**
  356. * @}
  357. */
  358. /** @defgroup CAN_remote_transmission_request CAN Remote Transmission Request
  359. * @{
  360. */
  361. #define CAN_RTR_DATA (0x00000000U) /*!< Data frame */
  362. #define CAN_RTR_REMOTE (0x00000002U) /*!< Remote frame */
  363. /**
  364. * @}
  365. */
  366. /** @defgroup CAN_receive_FIFO_number CAN Receive FIFO Number
  367. * @{
  368. */
  369. #define CAN_RX_FIFO0 (0x00000000U) /*!< CAN receive FIFO 0 */
  370. #define CAN_RX_FIFO1 (0x00000001U) /*!< CAN receive FIFO 1 */
  371. /**
  372. * @}
  373. */
  374. /** @defgroup CAN_Tx_Mailboxes CAN Tx Mailboxes
  375. * @{
  376. */
  377. #define CAN_TX_MAILBOX0 (0x00000001U) /*!< Tx Mailbox 0 */
  378. #define CAN_TX_MAILBOX1 (0x00000002U) /*!< Tx Mailbox 1 */
  379. #define CAN_TX_MAILBOX2 (0x00000004U) /*!< Tx Mailbox 2 */
  380. /**
  381. * @}
  382. */
  383. /** @defgroup CAN_flags CAN Flags
  384. * @{
  385. */
  386. /* Transmit Flags */
  387. #define CAN_FLAG_RQCP0 (0x00000500U) /*!< Request complete MailBox 0 flag */
  388. #define CAN_FLAG_TXOK0 (0x00000501U) /*!< Transmission OK MailBox 0 flag */
  389. #define CAN_FLAG_ALST0 (0x00000502U) /*!< Arbitration Lost MailBox 0 flag */
  390. #define CAN_FLAG_TERR0 (0x00000503U) /*!< Transmission error MailBox 0 flag */
  391. #define CAN_FLAG_RQCP1 (0x00000508U) /*!< Request complete MailBox1 flag */
  392. #define CAN_FLAG_TXOK1 (0x00000509U) /*!< Transmission OK MailBox 1 flag */
  393. #define CAN_FLAG_ALST1 (0x0000050AU) /*!< Arbitration Lost MailBox 1 flag */
  394. #define CAN_FLAG_TERR1 (0x0000050BU) /*!< Transmission error MailBox 1 flag */
  395. #define CAN_FLAG_RQCP2 (0x00000510U) /*!< Request complete MailBox2 flag */
  396. #define CAN_FLAG_TXOK2 (0x00000511U) /*!< Transmission OK MailBox 2 flag */
  397. #define CAN_FLAG_ALST2 (0x00000512U) /*!< Arbitration Lost MailBox 2 flag */
  398. #define CAN_FLAG_TERR2 (0x00000513U) /*!< Transmission error MailBox 2 flag */
  399. #define CAN_FLAG_TME0 (0x0000051AU) /*!< Transmit mailbox 0 empty flag */
  400. #define CAN_FLAG_TME1 (0x0000051BU) /*!< Transmit mailbox 1 empty flag */
  401. #define CAN_FLAG_TME2 (0x0000051CU) /*!< Transmit mailbox 2 empty flag */
  402. #define CAN_FLAG_LOW0 (0x0000051DU) /*!< Lowest priority mailbox 0 flag */
  403. #define CAN_FLAG_LOW1 (0x0000051EU) /*!< Lowest priority mailbox 1 flag */
  404. #define CAN_FLAG_LOW2 (0x0000051FU) /*!< Lowest priority mailbox 2 flag */
  405. /* Receive Flags */
  406. #define CAN_FLAG_FF0 (0x00000203U) /*!< RX FIFO 0 Full flag */
  407. #define CAN_FLAG_FOV0 (0x00000204U) /*!< RX FIFO 0 Overrun flag */
  408. #define CAN_FLAG_FF1 (0x00000403U) /*!< RX FIFO 1 Full flag */
  409. #define CAN_FLAG_FOV1 (0x00000404U) /*!< RX FIFO 1 Overrun flag */
  410. /* Operating Mode Flags */
  411. #define CAN_FLAG_INAK (0x00000100U) /*!< Initialization acknowledge flag */
  412. #define CAN_FLAG_SLAK (0x00000101U) /*!< Sleep acknowledge flag */
  413. #define CAN_FLAG_ERRI (0x00000102U) /*!< Error flag */
  414. #define CAN_FLAG_WKU (0x00000103U) /*!< Wake up interrupt flag */
  415. #define CAN_FLAG_SLAKI (0x00000104U) /*!< Sleep acknowledge interrupt flag */
  416. /* Error Flags */
  417. #define CAN_FLAG_EWG (0x00000300U) /*!< Error warning flag */
  418. #define CAN_FLAG_EPV (0x00000301U) /*!< Error passive flag */
  419. #define CAN_FLAG_BOF (0x00000302U) /*!< Bus-Off flag */
  420. /**
  421. * @}
  422. */
  423. /** @defgroup CAN_Interrupts CAN Interrupts
  424. * @{
  425. */
  426. /* Transmit Interrupt */
  427. #define CAN_IT_TX_MAILBOX_EMPTY ((uint32_t)CAN_IER_TMEIE) /*!< Transmit mailbox empty interrupt */
  428. /* Receive Interrupts */
  429. #define CAN_IT_RX_FIFO0_MSG_PENDING ((uint32_t)CAN_IER_FMPIE0) /*!< FIFO 0 message pending interrupt */
  430. #define CAN_IT_RX_FIFO0_FULL ((uint32_t)CAN_IER_FFIE0) /*!< FIFO 0 full interrupt */
  431. #define CAN_IT_RX_FIFO0_OVERRUN ((uint32_t)CAN_IER_FOVIE0) /*!< FIFO 0 overrun interrupt */
  432. #define CAN_IT_RX_FIFO1_MSG_PENDING ((uint32_t)CAN_IER_FMPIE1) /*!< FIFO 1 message pending interrupt */
  433. #define CAN_IT_RX_FIFO1_FULL ((uint32_t)CAN_IER_FFIE1) /*!< FIFO 1 full interrupt */
  434. #define CAN_IT_RX_FIFO1_OVERRUN ((uint32_t)CAN_IER_FOVIE1) /*!< FIFO 1 overrun interrupt */
  435. /* Operating Mode Interrupts */
  436. #define CAN_IT_WAKEUP ((uint32_t)CAN_IER_WKUIE) /*!< Wake-up interrupt */
  437. #define CAN_IT_SLEEP_ACK ((uint32_t)CAN_IER_SLKIE) /*!< Sleep acknowledge interrupt */
  438. /* Error Interrupts */
  439. #define CAN_IT_ERROR_WARNING ((uint32_t)CAN_IER_EWGIE) /*!< Error warning interrupt */
  440. #define CAN_IT_ERROR_PASSIVE ((uint32_t)CAN_IER_EPVIE) /*!< Error passive interrupt */
  441. #define CAN_IT_BUSOFF ((uint32_t)CAN_IER_BOFIE) /*!< Bus-off interrupt */
  442. #define CAN_IT_LAST_ERROR_CODE ((uint32_t)CAN_IER_LECIE) /*!< Last error code interrupt */
  443. #define CAN_IT_ERROR ((uint32_t)CAN_IER_ERRIE) /*!< Error Interrupt */
  444. /**
  445. * @}
  446. */
  447. /**
  448. * @}
  449. */
  450. /* Exported macros -----------------------------------------------------------*/
  451. /** @defgroup CAN_Exported_Macros CAN Exported Macros
  452. * @{
  453. */
  454. /** @brief Reset CAN handle state
  455. * @param __HANDLE__ CAN handle.
  456. * @retval None
  457. */
  458. #if USE_HAL_CAN_REGISTER_CALLBACKS == 1
  459. #define __HAL_CAN_RESET_HANDLE_STATE(__HANDLE__) do{ \
  460. (__HANDLE__)->State = HAL_CAN_STATE_RESET; \
  461. (__HANDLE__)->MspInitCallback = NULL; \
  462. (__HANDLE__)->MspDeInitCallback = NULL; \
  463. } while(0)
  464. #else
  465. #define __HAL_CAN_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_CAN_STATE_RESET)
  466. #endif /*USE_HAL_CAN_REGISTER_CALLBACKS */
  467. /**
  468. * @brief Enable the specified CAN interrupts.
  469. * @param __HANDLE__ CAN handle.
  470. * @param __INTERRUPT__ CAN Interrupt sources to enable.
  471. * This parameter can be any combination of @arg CAN_Interrupts
  472. * @retval None
  473. */
  474. #define __HAL_CAN_ENABLE_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->IER) |= (__INTERRUPT__))
  475. /**
  476. * @brief Disable the specified CAN interrupts.
  477. * @param __HANDLE__ CAN handle.
  478. * @param __INTERRUPT__ CAN Interrupt sources to disable.
  479. * This parameter can be any combination of @arg CAN_Interrupts
  480. * @retval None
  481. */
  482. #define __HAL_CAN_DISABLE_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->IER) &= ~(__INTERRUPT__))
  483. /** @brief Check if the specified CAN interrupt source is enabled or disabled.
  484. * @param __HANDLE__ specifies the CAN Handle.
  485. * @param __INTERRUPT__ specifies the CAN interrupt source to check.
  486. * This parameter can be a value of @arg CAN_Interrupts
  487. * @retval The state of __IT__ (TRUE or FALSE).
  488. */
  489. #define __HAL_CAN_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->IER) & (__INTERRUPT__))
  490. /** @brief Check whether the specified CAN flag is set or not.
  491. * @param __HANDLE__ specifies the CAN Handle.
  492. * @param __FLAG__ specifies the flag to check.
  493. * This parameter can be one of @arg CAN_flags
  494. * @retval The state of __FLAG__ (TRUE or FALSE).
  495. */
  496. #define __HAL_CAN_GET_FLAG(__HANDLE__, __FLAG__) \
  497. ((((__FLAG__) >> 8U) == 5U)? ((((__HANDLE__)->Instance->TSR) & (1U << ((__FLAG__) & CAN_FLAG_MASK))) == (1U << ((__FLAG__) & CAN_FLAG_MASK))): \
  498. (((__FLAG__) >> 8U) == 2U)? ((((__HANDLE__)->Instance->RF0R) & (1U << ((__FLAG__) & CAN_FLAG_MASK))) == (1U << ((__FLAG__) & CAN_FLAG_MASK))): \
  499. (((__FLAG__) >> 8U) == 4U)? ((((__HANDLE__)->Instance->RF1R) & (1U << ((__FLAG__) & CAN_FLAG_MASK))) == (1U << ((__FLAG__) & CAN_FLAG_MASK))): \
  500. (((__FLAG__) >> 8U) == 1U)? ((((__HANDLE__)->Instance->MSR) & (1U << ((__FLAG__) & CAN_FLAG_MASK))) == (1U << ((__FLAG__) & CAN_FLAG_MASK))): \
  501. (((__FLAG__) >> 8U) == 3U)? ((((__HANDLE__)->Instance->ESR) & (1U << ((__FLAG__) & CAN_FLAG_MASK))) == (1U << ((__FLAG__) & CAN_FLAG_MASK))): 0U)
  502. /** @brief Clear the specified CAN pending flag.
  503. * @param __HANDLE__ specifies the CAN Handle.
  504. * @param __FLAG__ specifies the flag to check.
  505. * This parameter can be one of the following values:
  506. * @arg CAN_FLAG_RQCP0: Request complete MailBox 0 Flag
  507. * @arg CAN_FLAG_TXOK0: Transmission OK MailBox 0 Flag
  508. * @arg CAN_FLAG_ALST0: Arbitration Lost MailBox 0 Flag
  509. * @arg CAN_FLAG_TERR0: Transmission error MailBox 0 Flag
  510. * @arg CAN_FLAG_RQCP1: Request complete MailBox 1 Flag
  511. * @arg CAN_FLAG_TXOK1: Transmission OK MailBox 1 Flag
  512. * @arg CAN_FLAG_ALST1: Arbitration Lost MailBox 1 Flag
  513. * @arg CAN_FLAG_TERR1: Transmission error MailBox 1 Flag
  514. * @arg CAN_FLAG_RQCP2: Request complete MailBox 2 Flag
  515. * @arg CAN_FLAG_TXOK2: Transmission OK MailBox 2 Flag
  516. * @arg CAN_FLAG_ALST2: Arbitration Lost MailBox 2 Flag
  517. * @arg CAN_FLAG_TERR2: Transmission error MailBox 2 Flag
  518. * @arg CAN_FLAG_FF0: RX FIFO 0 Full Flag
  519. * @arg CAN_FLAG_FOV0: RX FIFO 0 Overrun Flag
  520. * @arg CAN_FLAG_FF1: RX FIFO 1 Full Flag
  521. * @arg CAN_FLAG_FOV1: RX FIFO 1 Overrun Flag
  522. * @arg CAN_FLAG_WKUI: Wake up Interrupt Flag
  523. * @arg CAN_FLAG_SLAKI: Sleep acknowledge Interrupt Flag
  524. * @retval None
  525. */
  526. #define __HAL_CAN_CLEAR_FLAG(__HANDLE__, __FLAG__) \
  527. ((((__FLAG__) >> 8U) == 5U)? (((__HANDLE__)->Instance->TSR) = (1U << ((__FLAG__) & CAN_FLAG_MASK))): \
  528. (((__FLAG__) >> 8U) == 2U)? (((__HANDLE__)->Instance->RF0R) = (1U << ((__FLAG__) & CAN_FLAG_MASK))): \
  529. (((__FLAG__) >> 8U) == 4U)? (((__HANDLE__)->Instance->RF1R) = (1U << ((__FLAG__) & CAN_FLAG_MASK))): \
  530. (((__FLAG__) >> 8U) == 1U)? (((__HANDLE__)->Instance->MSR) = (1U << ((__FLAG__) & CAN_FLAG_MASK))): 0U)
  531. /**
  532. * @}
  533. */
  534. /* Exported functions --------------------------------------------------------*/
  535. /** @addtogroup CAN_Exported_Functions CAN Exported Functions
  536. * @{
  537. */
  538. /** @addtogroup CAN_Exported_Functions_Group1 Initialization and de-initialization functions
  539. * @brief Initialization and Configuration functions
  540. * @{
  541. */
  542. /* Initialization and de-initialization functions *****************************/
  543. HAL_StatusTypeDef HAL_CAN_Init(CAN_HandleTypeDef *hcan);
  544. HAL_StatusTypeDef HAL_CAN_DeInit(CAN_HandleTypeDef *hcan);
  545. void HAL_CAN_MspInit(CAN_HandleTypeDef *hcan);
  546. void HAL_CAN_MspDeInit(CAN_HandleTypeDef *hcan);
  547. #if USE_HAL_CAN_REGISTER_CALLBACKS == 1
  548. /* Callbacks Register/UnRegister functions ***********************************/
  549. HAL_StatusTypeDef HAL_CAN_RegisterCallback(CAN_HandleTypeDef *hcan, HAL_CAN_CallbackIDTypeDef CallbackID,
  550. void (* pCallback)(CAN_HandleTypeDef *_hcan));
  551. HAL_StatusTypeDef HAL_CAN_UnRegisterCallback(CAN_HandleTypeDef *hcan, HAL_CAN_CallbackIDTypeDef CallbackID);
  552. #endif /* (USE_HAL_CAN_REGISTER_CALLBACKS) */
  553. /**
  554. * @}
  555. */
  556. /** @addtogroup CAN_Exported_Functions_Group2 Configuration functions
  557. * @brief Configuration functions
  558. * @{
  559. */
  560. /* Configuration functions ****************************************************/
  561. HAL_StatusTypeDef HAL_CAN_ConfigFilter(CAN_HandleTypeDef *hcan, const CAN_FilterTypeDef *sFilterConfig);
  562. /**
  563. * @}
  564. */
  565. /** @addtogroup CAN_Exported_Functions_Group3 Control functions
  566. * @brief Control functions
  567. * @{
  568. */
  569. /* Control functions **********************************************************/
  570. HAL_StatusTypeDef HAL_CAN_Start(CAN_HandleTypeDef *hcan);
  571. HAL_StatusTypeDef HAL_CAN_Stop(CAN_HandleTypeDef *hcan);
  572. HAL_StatusTypeDef HAL_CAN_RequestSleep(CAN_HandleTypeDef *hcan);
  573. HAL_StatusTypeDef HAL_CAN_WakeUp(CAN_HandleTypeDef *hcan);
  574. uint32_t HAL_CAN_IsSleepActive(const CAN_HandleTypeDef *hcan);
  575. HAL_StatusTypeDef HAL_CAN_AddTxMessage(CAN_HandleTypeDef *hcan, const CAN_TxHeaderTypeDef *pHeader,
  576. const uint8_t aData[], uint32_t *pTxMailbox);
  577. HAL_StatusTypeDef HAL_CAN_AbortTxRequest(CAN_HandleTypeDef *hcan, uint32_t TxMailboxes);
  578. uint32_t HAL_CAN_GetTxMailboxesFreeLevel(const CAN_HandleTypeDef *hcan);
  579. uint32_t HAL_CAN_IsTxMessagePending(const CAN_HandleTypeDef *hcan, uint32_t TxMailboxes);
  580. uint32_t HAL_CAN_GetTxTimestamp(const CAN_HandleTypeDef *hcan, uint32_t TxMailbox);
  581. HAL_StatusTypeDef HAL_CAN_GetRxMessage(CAN_HandleTypeDef *hcan, uint32_t RxFifo,
  582. CAN_RxHeaderTypeDef *pHeader, uint8_t aData[]);
  583. uint32_t HAL_CAN_GetRxFifoFillLevel(const CAN_HandleTypeDef *hcan, uint32_t RxFifo);
  584. /**
  585. * @}
  586. */
  587. /** @addtogroup CAN_Exported_Functions_Group4 Interrupts management
  588. * @brief Interrupts management
  589. * @{
  590. */
  591. /* Interrupts management ******************************************************/
  592. HAL_StatusTypeDef HAL_CAN_ActivateNotification(CAN_HandleTypeDef *hcan, uint32_t ActiveITs);
  593. HAL_StatusTypeDef HAL_CAN_DeactivateNotification(CAN_HandleTypeDef *hcan, uint32_t InactiveITs);
  594. void HAL_CAN_IRQHandler(CAN_HandleTypeDef *hcan);
  595. /**
  596. * @}
  597. */
  598. /** @addtogroup CAN_Exported_Functions_Group5 Callback functions
  599. * @brief Callback functions
  600. * @{
  601. */
  602. /* Callbacks functions ********************************************************/
  603. void HAL_CAN_TxMailbox0CompleteCallback(CAN_HandleTypeDef *hcan);
  604. void HAL_CAN_TxMailbox1CompleteCallback(CAN_HandleTypeDef *hcan);
  605. void HAL_CAN_TxMailbox2CompleteCallback(CAN_HandleTypeDef *hcan);
  606. void HAL_CAN_TxMailbox0AbortCallback(CAN_HandleTypeDef *hcan);
  607. void HAL_CAN_TxMailbox1AbortCallback(CAN_HandleTypeDef *hcan);
  608. void HAL_CAN_TxMailbox2AbortCallback(CAN_HandleTypeDef *hcan);
  609. void HAL_CAN_RxFifo0MsgPendingCallback(CAN_HandleTypeDef *hcan);
  610. void HAL_CAN_RxFifo0FullCallback(CAN_HandleTypeDef *hcan);
  611. void HAL_CAN_RxFifo1MsgPendingCallback(CAN_HandleTypeDef *hcan);
  612. void HAL_CAN_RxFifo1FullCallback(CAN_HandleTypeDef *hcan);
  613. void HAL_CAN_SleepCallback(CAN_HandleTypeDef *hcan);
  614. void HAL_CAN_WakeUpFromRxMsgCallback(CAN_HandleTypeDef *hcan);
  615. void HAL_CAN_ErrorCallback(CAN_HandleTypeDef *hcan);
  616. /**
  617. * @}
  618. */
  619. /** @addtogroup CAN_Exported_Functions_Group6 Peripheral State and Error functions
  620. * @brief CAN Peripheral State functions
  621. * @{
  622. */
  623. /* Peripheral State and Error functions ***************************************/
  624. HAL_CAN_StateTypeDef HAL_CAN_GetState(const CAN_HandleTypeDef *hcan);
  625. uint32_t HAL_CAN_GetError(const CAN_HandleTypeDef *hcan);
  626. HAL_StatusTypeDef HAL_CAN_ResetError(CAN_HandleTypeDef *hcan);
  627. /**
  628. * @}
  629. */
  630. /**
  631. * @}
  632. */
  633. /* Private types -------------------------------------------------------------*/
  634. /** @defgroup CAN_Private_Types CAN Private Types
  635. * @{
  636. */
  637. /**
  638. * @}
  639. */
  640. /* Private variables ---------------------------------------------------------*/
  641. /** @defgroup CAN_Private_Variables CAN Private Variables
  642. * @{
  643. */
  644. /**
  645. * @}
  646. */
  647. /* Private constants ---------------------------------------------------------*/
  648. /** @defgroup CAN_Private_Constants CAN Private Constants
  649. * @{
  650. */
  651. #define CAN_FLAG_MASK (0x000000FFU)
  652. /**
  653. * @}
  654. */
  655. /* Private Macros -----------------------------------------------------------*/
  656. /** @defgroup CAN_Private_Macros CAN Private Macros
  657. * @{
  658. */
  659. #define IS_CAN_MODE(MODE) (((MODE) == CAN_MODE_NORMAL) || \
  660. ((MODE) == CAN_MODE_LOOPBACK)|| \
  661. ((MODE) == CAN_MODE_SILENT) || \
  662. ((MODE) == CAN_MODE_SILENT_LOOPBACK))
  663. #define IS_CAN_SJW(SJW) (((SJW) == CAN_SJW_1TQ) || ((SJW) == CAN_SJW_2TQ) || \
  664. ((SJW) == CAN_SJW_3TQ) || ((SJW) == CAN_SJW_4TQ))
  665. #define IS_CAN_BS1(BS1) (((BS1) == CAN_BS1_1TQ) || ((BS1) == CAN_BS1_2TQ) || \
  666. ((BS1) == CAN_BS1_3TQ) || ((BS1) == CAN_BS1_4TQ) || \
  667. ((BS1) == CAN_BS1_5TQ) || ((BS1) == CAN_BS1_6TQ) || \
  668. ((BS1) == CAN_BS1_7TQ) || ((BS1) == CAN_BS1_8TQ) || \
  669. ((BS1) == CAN_BS1_9TQ) || ((BS1) == CAN_BS1_10TQ)|| \
  670. ((BS1) == CAN_BS1_11TQ)|| ((BS1) == CAN_BS1_12TQ)|| \
  671. ((BS1) == CAN_BS1_13TQ)|| ((BS1) == CAN_BS1_14TQ)|| \
  672. ((BS1) == CAN_BS1_15TQ)|| ((BS1) == CAN_BS1_16TQ))
  673. #define IS_CAN_BS2(BS2) (((BS2) == CAN_BS2_1TQ) || ((BS2) == CAN_BS2_2TQ) || \
  674. ((BS2) == CAN_BS2_3TQ) || ((BS2) == CAN_BS2_4TQ) || \
  675. ((BS2) == CAN_BS2_5TQ) || ((BS2) == CAN_BS2_6TQ) || \
  676. ((BS2) == CAN_BS2_7TQ) || ((BS2) == CAN_BS2_8TQ))
  677. #define IS_CAN_PRESCALER(PRESCALER) (((PRESCALER) >= 1U) && ((PRESCALER) <= 1024U))
  678. #define IS_CAN_FILTER_ID_HALFWORD(HALFWORD) ((HALFWORD) <= 0xFFFFU)
  679. #define IS_CAN_FILTER_BANK_SINGLE(BANK) ((BANK) <= 13U)
  680. #define IS_CAN_FILTER_MODE(MODE) (((MODE) == CAN_FILTERMODE_IDMASK) || \
  681. ((MODE) == CAN_FILTERMODE_IDLIST))
  682. #define IS_CAN_FILTER_SCALE(SCALE) (((SCALE) == CAN_FILTERSCALE_16BIT) || \
  683. ((SCALE) == CAN_FILTERSCALE_32BIT))
  684. #define IS_CAN_FILTER_ACTIVATION(ACTIVATION) (((ACTIVATION) == CAN_FILTER_DISABLE) || \
  685. ((ACTIVATION) == CAN_FILTER_ENABLE))
  686. #define IS_CAN_FILTER_FIFO(FIFO) (((FIFO) == CAN_FILTER_FIFO0) || \
  687. ((FIFO) == CAN_FILTER_FIFO1))
  688. #define IS_CAN_TX_MAILBOX(TRANSMITMAILBOX) (((TRANSMITMAILBOX) == CAN_TX_MAILBOX0 ) || \
  689. ((TRANSMITMAILBOX) == CAN_TX_MAILBOX1 ) || \
  690. ((TRANSMITMAILBOX) == CAN_TX_MAILBOX2 ))
  691. #define IS_CAN_TX_MAILBOX_LIST(TRANSMITMAILBOX) ((TRANSMITMAILBOX) <= (CAN_TX_MAILBOX0 | CAN_TX_MAILBOX1 | \
  692. CAN_TX_MAILBOX2))
  693. #define IS_CAN_STDID(STDID) ((STDID) <= 0x7FFU)
  694. #define IS_CAN_EXTID(EXTID) ((EXTID) <= 0x1FFFFFFFU)
  695. #define IS_CAN_DLC(DLC) ((DLC) <= 8U)
  696. #define IS_CAN_IDTYPE(IDTYPE) (((IDTYPE) == CAN_ID_STD) || \
  697. ((IDTYPE) == CAN_ID_EXT))
  698. #define IS_CAN_RTR(RTR) (((RTR) == CAN_RTR_DATA) || ((RTR) == CAN_RTR_REMOTE))
  699. #define IS_CAN_RX_FIFO(FIFO) (((FIFO) == CAN_RX_FIFO0) || ((FIFO) == CAN_RX_FIFO1))
  700. #define IS_CAN_IT(IT) ((IT) <= (CAN_IT_TX_MAILBOX_EMPTY | CAN_IT_RX_FIFO0_MSG_PENDING | \
  701. CAN_IT_RX_FIFO0_FULL | CAN_IT_RX_FIFO0_OVERRUN | \
  702. CAN_IT_RX_FIFO1_MSG_PENDING | CAN_IT_RX_FIFO1_FULL | \
  703. CAN_IT_RX_FIFO1_OVERRUN | CAN_IT_WAKEUP | \
  704. CAN_IT_SLEEP_ACK | CAN_IT_ERROR_WARNING | \
  705. CAN_IT_ERROR_PASSIVE | CAN_IT_BUSOFF | \
  706. CAN_IT_LAST_ERROR_CODE | CAN_IT_ERROR))
  707. /**
  708. * @}
  709. */
  710. /* End of private macros -----------------------------------------------------*/
  711. /**
  712. * @}
  713. */
  714. #endif /* CAN */
  715. /**
  716. * @}
  717. */
  718. #ifdef __cplusplus
  719. }
  720. #endif
  721. #endif /* STM32F0xx_HAL_CAN_H */