6
6
******************************************************************************
7
7
* @attention
8
8
*
9
- * <h2><center>© Copyright (c) 2016 STMicroelectronics.
10
- * All rights reserved.</center></h2>
9
+ * Copyright (c) 2016 STMicroelectronics.
10
+ * All rights reserved.
11
11
*
12
- * This software component is licensed by ST under BSD 3-Clause license,
13
- * the "License"; You may not use this file except in compliance with the
14
- * License. You may obtain a copy of the License at:
15
- * opensource.org/licenses/BSD-3-Clause
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.
16
15
*
17
16
******************************************************************************
18
17
*/
@@ -103,21 +102,25 @@ typedef struct
103
102
{
104
103
uint32_t FilterIdHigh ; /*!< Specifies the filter identification number (MSBs for a 32-bit
105
104
configuration, first one for a 16-bit configuration).
106
- This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF. */
105
+ This parameter must be a number between
106
+ Min_Data = 0x0000 and Max_Data = 0xFFFF. */
107
107
108
108
uint32_t FilterIdLow ; /*!< Specifies the filter identification number (LSBs for a 32-bit
109
109
configuration, second one for a 16-bit configuration).
110
- This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF. */
110
+ This parameter must be a number between
111
+ Min_Data = 0x0000 and Max_Data = 0xFFFF. */
111
112
112
113
uint32_t FilterMaskIdHigh ; /*!< Specifies the filter mask number or identification number,
113
114
according to the mode (MSBs for a 32-bit configuration,
114
115
first one for a 16-bit configuration).
115
- This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF. */
116
+ This parameter must be a number between
117
+ Min_Data = 0x0000 and Max_Data = 0xFFFF. */
116
118
117
119
uint32_t FilterMaskIdLow ; /*!< Specifies the filter mask number or identification number,
118
120
according to the mode (LSBs for a 32-bit configuration,
119
121
second one for a 16-bit configuration).
120
- This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0xFFFF. */
122
+ This parameter must be a number between
123
+ Min_Data = 0x0000 and Max_Data = 0xFFFF. */
121
124
122
125
uint32_t FilterFIFOAssignment ; /*!< Specifies the FIFO (0 or 1U) which will be assigned to the filter.
123
126
This parameter can be a value of @ref CAN_filter_FIFO */
@@ -136,7 +139,7 @@ typedef struct
136
139
137
140
uint32_t SlaveStartFilterBank ; /*!< Select the start filter bank for the slave CAN instance.
138
141
STM32F3xx devices don't support slave CAN instance (dual CAN). Therefore
139
- this parameter is meaningless but it has been kept for compatibility accross
142
+ this parameter is meaningless but it has been kept for compatibility across
140
143
STM32 families. */
141
144
142
145
} CAN_FilterTypeDef ;
@@ -290,11 +293,11 @@ typedef void (*pCAN_CallbackTypeDef)(CAN_HandleTypeDef *hcan); /*!< pointer to
290
293
#define HAL_CAN_ERROR_RX_FOV0 (0x00000200U) /*!< Rx FIFO0 overrun error */
291
294
#define HAL_CAN_ERROR_RX_FOV1 (0x00000400U) /*!< Rx FIFO1 overrun error */
292
295
#define HAL_CAN_ERROR_TX_ALST0 (0x00000800U) /*!< TxMailbox 0 transmit failure due to arbitration lost */
293
- #define HAL_CAN_ERROR_TX_TERR0 (0x00001000U) /*!< TxMailbox 0 transmit failure due to transmit error */
296
+ #define HAL_CAN_ERROR_TX_TERR0 (0x00001000U) /*!< TxMailbox 0 transmit failure due to transmit error */
294
297
#define HAL_CAN_ERROR_TX_ALST1 (0x00002000U) /*!< TxMailbox 1 transmit failure due to arbitration lost */
295
- #define HAL_CAN_ERROR_TX_TERR1 (0x00004000U) /*!< TxMailbox 1 transmit failure due to transmit error */
298
+ #define HAL_CAN_ERROR_TX_TERR1 (0x00004000U) /*!< TxMailbox 1 transmit failure due to transmit error */
296
299
#define HAL_CAN_ERROR_TX_ALST2 (0x00008000U) /*!< TxMailbox 2 transmit failure due to arbitration lost */
297
- #define HAL_CAN_ERROR_TX_TERR2 (0x00010000U) /*!< TxMailbox 2 transmit failure due to transmit error */
300
+ #define HAL_CAN_ERROR_TX_TERR2 (0x00010000U) /*!< TxMailbox 2 transmit failure due to transmit error */
298
301
#define HAL_CAN_ERROR_TIMEOUT (0x00020000U) /*!< Timeout error */
299
302
#define HAL_CAN_ERROR_NOT_INITIALIZED (0x00040000U) /*!< Peripheral not initialized */
300
303
#define HAL_CAN_ERROR_NOT_READY (0x00080000U) /*!< Peripheral not ready */
@@ -325,7 +328,8 @@ typedef void (*pCAN_CallbackTypeDef)(CAN_HandleTypeDef *hcan); /*!< pointer to
325
328
#define CAN_MODE_NORMAL (0x00000000U) /*!< Normal mode */
326
329
#define CAN_MODE_LOOPBACK ((uint32_t)CAN_BTR_LBKM) /*!< Loopback mode */
327
330
#define CAN_MODE_SILENT ((uint32_t)CAN_BTR_SILM) /*!< Silent mode */
328
- #define CAN_MODE_SILENT_LOOPBACK ((uint32_t)(CAN_BTR_LBKM | CAN_BTR_SILM)) /*!< Loopback combined with silent mode */
331
+ #define CAN_MODE_SILENT_LOOPBACK ((uint32_t)(CAN_BTR_LBKM | CAN_BTR_SILM)) /*!< Loopback combined with
332
+ silent mode */
329
333
/**
330
334
* @}
331
335
*/
@@ -640,7 +644,8 @@ void HAL_CAN_MspDeInit(CAN_HandleTypeDef *hcan);
640
644
641
645
#if USE_HAL_CAN_REGISTER_CALLBACKS == 1
642
646
/* Callbacks Register/UnRegister functions ***********************************/
643
- HAL_StatusTypeDef HAL_CAN_RegisterCallback (CAN_HandleTypeDef * hcan , HAL_CAN_CallbackIDTypeDef CallbackID , void (* pCallback )(CAN_HandleTypeDef * _hcan ));
647
+ HAL_StatusTypeDef HAL_CAN_RegisterCallback (CAN_HandleTypeDef * hcan , HAL_CAN_CallbackIDTypeDef CallbackID ,
648
+ void (* pCallback )(CAN_HandleTypeDef * _hcan ));
644
649
HAL_StatusTypeDef HAL_CAN_UnRegisterCallback (CAN_HandleTypeDef * hcan , HAL_CAN_CallbackIDTypeDef CallbackID );
645
650
646
651
#endif /* (USE_HAL_CAN_REGISTER_CALLBACKS) */
@@ -654,7 +659,7 @@ HAL_StatusTypeDef HAL_CAN_UnRegisterCallback(CAN_HandleTypeDef *hcan, HAL_CAN_Ca
654
659
*/
655
660
656
661
/* Configuration functions ****************************************************/
657
- HAL_StatusTypeDef HAL_CAN_ConfigFilter (CAN_HandleTypeDef * hcan , CAN_FilterTypeDef * sFilterConfig );
662
+ HAL_StatusTypeDef HAL_CAN_ConfigFilter (CAN_HandleTypeDef * hcan , const CAN_FilterTypeDef * sFilterConfig );
658
663
659
664
/**
660
665
* @}
@@ -670,14 +675,16 @@ HAL_StatusTypeDef HAL_CAN_Start(CAN_HandleTypeDef *hcan);
670
675
HAL_StatusTypeDef HAL_CAN_Stop (CAN_HandleTypeDef * hcan );
671
676
HAL_StatusTypeDef HAL_CAN_RequestSleep (CAN_HandleTypeDef * hcan );
672
677
HAL_StatusTypeDef HAL_CAN_WakeUp (CAN_HandleTypeDef * hcan );
673
- uint32_t HAL_CAN_IsSleepActive (CAN_HandleTypeDef * hcan );
674
- HAL_StatusTypeDef HAL_CAN_AddTxMessage (CAN_HandleTypeDef * hcan , CAN_TxHeaderTypeDef * pHeader , uint8_t aData [], uint32_t * pTxMailbox );
678
+ uint32_t HAL_CAN_IsSleepActive (const CAN_HandleTypeDef * hcan );
679
+ HAL_StatusTypeDef HAL_CAN_AddTxMessage (CAN_HandleTypeDef * hcan , const CAN_TxHeaderTypeDef * pHeader ,
680
+ const uint8_t aData [], uint32_t * pTxMailbox );
675
681
HAL_StatusTypeDef HAL_CAN_AbortTxRequest (CAN_HandleTypeDef * hcan , uint32_t TxMailboxes );
676
- uint32_t HAL_CAN_GetTxMailboxesFreeLevel (CAN_HandleTypeDef * hcan );
677
- uint32_t HAL_CAN_IsTxMessagePending (CAN_HandleTypeDef * hcan , uint32_t TxMailboxes );
678
- uint32_t HAL_CAN_GetTxTimestamp (CAN_HandleTypeDef * hcan , uint32_t TxMailbox );
679
- HAL_StatusTypeDef HAL_CAN_GetRxMessage (CAN_HandleTypeDef * hcan , uint32_t RxFifo , CAN_RxHeaderTypeDef * pHeader , uint8_t aData []);
680
- uint32_t HAL_CAN_GetRxFifoFillLevel (CAN_HandleTypeDef * hcan , uint32_t RxFifo );
682
+ uint32_t HAL_CAN_GetTxMailboxesFreeLevel (const CAN_HandleTypeDef * hcan );
683
+ uint32_t HAL_CAN_IsTxMessagePending (const CAN_HandleTypeDef * hcan , uint32_t TxMailboxes );
684
+ uint32_t HAL_CAN_GetTxTimestamp (const CAN_HandleTypeDef * hcan , uint32_t TxMailbox );
685
+ HAL_StatusTypeDef HAL_CAN_GetRxMessage (CAN_HandleTypeDef * hcan , uint32_t RxFifo ,
686
+ CAN_RxHeaderTypeDef * pHeader , uint8_t aData []);
687
+ uint32_t HAL_CAN_GetRxFifoFillLevel (const CAN_HandleTypeDef * hcan , uint32_t RxFifo );
681
688
682
689
/**
683
690
* @}
@@ -725,8 +732,8 @@ void HAL_CAN_ErrorCallback(CAN_HandleTypeDef *hcan);
725
732
* @{
726
733
*/
727
734
/* Peripheral State and Error functions ***************************************/
728
- HAL_CAN_StateTypeDef HAL_CAN_GetState (CAN_HandleTypeDef * hcan );
729
- uint32_t HAL_CAN_GetError (CAN_HandleTypeDef * hcan );
735
+ HAL_CAN_StateTypeDef HAL_CAN_GetState (const CAN_HandleTypeDef * hcan );
736
+ uint32_t HAL_CAN_GetError (const CAN_HandleTypeDef * hcan );
730
737
HAL_StatusTypeDef HAL_CAN_ResetError (CAN_HandleTypeDef * hcan );
731
738
732
739
/**
@@ -801,7 +808,8 @@ HAL_StatusTypeDef HAL_CAN_ResetError(CAN_HandleTypeDef *hcan);
801
808
#define IS_CAN_TX_MAILBOX (TRANSMITMAILBOX ) (((TRANSMITMAILBOX) == CAN_TX_MAILBOX0 ) || \
802
809
((TRANSMITMAILBOX) == CAN_TX_MAILBOX1 ) || \
803
810
((TRANSMITMAILBOX) == CAN_TX_MAILBOX2 ))
804
- #define IS_CAN_TX_MAILBOX_LIST (TRANSMITMAILBOX ) ((TRANSMITMAILBOX) <= (CAN_TX_MAILBOX0 | CAN_TX_MAILBOX1 | CAN_TX_MAILBOX2))
811
+ #define IS_CAN_TX_MAILBOX_LIST (TRANSMITMAILBOX ) ((TRANSMITMAILBOX) <= (CAN_TX_MAILBOX0 | CAN_TX_MAILBOX1 | \
812
+ CAN_TX_MAILBOX2))
805
813
#define IS_CAN_STDID (STDID ) ((STDID) <= 0x7FFU)
806
814
#define IS_CAN_EXTID (EXTID ) ((EXTID) <= 0x1FFFFFFFU)
807
815
#define IS_CAN_DLC (DLC ) ((DLC) <= 8U)
@@ -837,6 +845,3 @@ HAL_StatusTypeDef HAL_CAN_ResetError(CAN_HandleTypeDef *hcan);
837
845
#endif
838
846
839
847
#endif /* STM32F3xx_HAL_CAN_H */
840
-
841
-
842
- /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
0 commit comments