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