STM32F1 Standard Peripheral bibliotheek  1.0
ST Microelectronics bibliotheek documentatie voor de STM32F1 Standard Peripheral Library
 All Data Structures Files Functions Variables Enumerations Groups
stm32f10x_can.h
Go to the documentation of this file.
1 
22 /* Define to prevent recursive inclusion -------------------------------------*/
23 #ifndef __STM32F10x_CAN_H
24 #define __STM32F10x_CAN_H
25 
26 #ifdef __cplusplus
27  extern "C" {
28 #endif
29 
30 /* Includes ------------------------------------------------------------------*/
31 #include "stm32f10x.h"
32 
45 #define IS_CAN_ALL_PERIPH(PERIPH) (((PERIPH) == CAN1) || \
46  ((PERIPH) == CAN2))
47 
52 typedef struct
53 {
54  uint16_t CAN_Prescaler;
56  uint8_t CAN_Mode;
59  uint8_t CAN_SJW;
63  uint8_t CAN_BS1;
66  uint8_t CAN_BS2;
69  FunctionalState CAN_TTCM;
72  FunctionalState CAN_ABOM;
75  FunctionalState CAN_AWUM;
78  FunctionalState CAN_NART;
81  FunctionalState CAN_RFLM;
84  FunctionalState CAN_TXFP;
87 
92 typedef struct
93 {
94  uint16_t CAN_FilterIdHigh;
98  uint16_t CAN_FilterIdLow;
102  uint16_t CAN_FilterMaskIdHigh;
107  uint16_t CAN_FilterMaskIdLow;
112  uint16_t CAN_FilterFIFOAssignment;
117  uint8_t CAN_FilterMode;
120  uint8_t CAN_FilterScale;
123  FunctionalState CAN_FilterActivation;
126 
131 typedef struct
132 {
133  uint32_t StdId;
136  uint32_t ExtId;
139  uint8_t IDE;
142  uint8_t RTR;
145  uint8_t DLC;
148  uint8_t Data[8];
149 } CanTxMsg;
150 
155 typedef struct
156 {
157  uint32_t StdId;
160  uint32_t ExtId;
163  uint8_t IDE;
166  uint8_t RTR;
169  uint8_t DLC;
172  uint8_t Data[8];
174  uint8_t FMI;
176 } CanRxMsg;
177 
190 #define CANINITFAILED ((uint8_t)0x00)
191 #define CANINITOK ((uint8_t)0x01)
201 #define CAN_Mode_Normal ((uint8_t)0x00)
202 #define CAN_Mode_LoopBack ((uint8_t)0x01)
203 #define CAN_Mode_Silent ((uint8_t)0x02)
204 #define CAN_Mode_Silent_LoopBack ((uint8_t)0x03)
206 #define IS_CAN_MODE(MODE) (((MODE) == CAN_Mode_Normal) || ((MODE) == CAN_Mode_LoopBack)|| \
207  ((MODE) == CAN_Mode_Silent) || ((MODE) == CAN_Mode_Silent_LoopBack))
208 
216 #define CAN_SJW_1tq ((uint8_t)0x00)
217 #define CAN_SJW_2tq ((uint8_t)0x01)
218 #define CAN_SJW_3tq ((uint8_t)0x02)
219 #define CAN_SJW_4tq ((uint8_t)0x03)
221 #define IS_CAN_SJW(SJW) (((SJW) == CAN_SJW_1tq) || ((SJW) == CAN_SJW_2tq)|| \
222  ((SJW) == CAN_SJW_3tq) || ((SJW) == CAN_SJW_4tq))
223 
231 #define CAN_BS1_1tq ((uint8_t)0x00)
232 #define CAN_BS1_2tq ((uint8_t)0x01)
233 #define CAN_BS1_3tq ((uint8_t)0x02)
234 #define CAN_BS1_4tq ((uint8_t)0x03)
235 #define CAN_BS1_5tq ((uint8_t)0x04)
236 #define CAN_BS1_6tq ((uint8_t)0x05)
237 #define CAN_BS1_7tq ((uint8_t)0x06)
238 #define CAN_BS1_8tq ((uint8_t)0x07)
239 #define CAN_BS1_9tq ((uint8_t)0x08)
240 #define CAN_BS1_10tq ((uint8_t)0x09)
241 #define CAN_BS1_11tq ((uint8_t)0x0A)
242 #define CAN_BS1_12tq ((uint8_t)0x0B)
243 #define CAN_BS1_13tq ((uint8_t)0x0C)
244 #define CAN_BS1_14tq ((uint8_t)0x0D)
245 #define CAN_BS1_15tq ((uint8_t)0x0E)
246 #define CAN_BS1_16tq ((uint8_t)0x0F)
248 #define IS_CAN_BS1(BS1) ((BS1) <= CAN_BS1_16tq)
249 
257 #define CAN_BS2_1tq ((uint8_t)0x00)
258 #define CAN_BS2_2tq ((uint8_t)0x01)
259 #define CAN_BS2_3tq ((uint8_t)0x02)
260 #define CAN_BS2_4tq ((uint8_t)0x03)
261 #define CAN_BS2_5tq ((uint8_t)0x04)
262 #define CAN_BS2_6tq ((uint8_t)0x05)
263 #define CAN_BS2_7tq ((uint8_t)0x06)
264 #define CAN_BS2_8tq ((uint8_t)0x07)
266 #define IS_CAN_BS2(BS2) ((BS2) <= CAN_BS2_8tq)
267 
276 #define IS_CAN_PRESCALER(PRESCALER) (((PRESCALER) >= 1) && ((PRESCALER) <= 1024))
277 
285 #ifndef STM32F10X_CL
286  #define IS_CAN_FILTER_NUMBER(NUMBER) ((NUMBER) <= 13)
287 #else
288  #define IS_CAN_FILTER_NUMBER(NUMBER) ((NUMBER) <= 27)
289 #endif /* STM32F10X_CL */
290 
298 #define CAN_FilterMode_IdMask ((uint8_t)0x00)
299 #define CAN_FilterMode_IdList ((uint8_t)0x01)
301 #define IS_CAN_FILTER_MODE(MODE) (((MODE) == CAN_FilterMode_IdMask) || \
302  ((MODE) == CAN_FilterMode_IdList))
303 
311 #define CAN_FilterScale_16bit ((uint8_t)0x00)
312 #define CAN_FilterScale_32bit ((uint8_t)0x01)
314 #define IS_CAN_FILTER_SCALE(SCALE) (((SCALE) == CAN_FilterScale_16bit) || \
315  ((SCALE) == CAN_FilterScale_32bit))
316 
325 #define CAN_FilterFIFO0 ((uint8_t)0x00)
326 #define CAN_FilterFIFO1 ((uint8_t)0x01)
327 #define IS_CAN_FILTER_FIFO(FIFO) (((FIFO) == CAN_FilterFIFO0) || \
328  ((FIFO) == CAN_FilterFIFO1))
329 
337 #define IS_CAN_BANKNUMBER(BANKNUMBER) (((BANKNUMBER) >= 1) && ((BANKNUMBER) <= 27))
338 
346 #define IS_CAN_TRANSMITMAILBOX(TRANSMITMAILBOX) ((TRANSMITMAILBOX) <= ((uint8_t)0x02))
347 #define IS_CAN_STDID(STDID) ((STDID) <= ((uint32_t)0x7FF))
348 #define IS_CAN_EXTID(EXTID) ((EXTID) <= ((uint32_t)0x1FFFFFFF))
349 #define IS_CAN_DLC(DLC) ((DLC) <= ((uint8_t)0x08))
350 
359 #define CAN_ID_STD ((uint32_t)0x00000000)
360 #define CAN_ID_EXT ((uint32_t)0x00000004)
361 #define IS_CAN_IDTYPE(IDTYPE) (((IDTYPE) == CAN_ID_STD) || ((IDTYPE) == CAN_ID_EXT))
362 
371 #define CAN_RTR_DATA ((uint32_t)0x00000000)
372 #define CAN_RTR_REMOTE ((uint32_t)0x00000002)
373 #define IS_CAN_RTR(RTR) (((RTR) == CAN_RTR_DATA) || ((RTR) == CAN_RTR_REMOTE))
374 
383 #define CANTXFAILED ((uint8_t)0x00)
384 #define CANTXOK ((uint8_t)0x01)
385 #define CANTXPENDING ((uint8_t)0x02)
386 #define CAN_NO_MB ((uint8_t)0x04)
396 #define CAN_FIFO0 ((uint8_t)0x00)
397 #define CAN_FIFO1 ((uint8_t)0x01)
399 #define IS_CAN_FIFO(FIFO) (((FIFO) == CAN_FIFO0) || ((FIFO) == CAN_FIFO1))
400 
409 #define CANSLEEPFAILED ((uint8_t)0x00)
410 #define CANSLEEPOK ((uint8_t)0x01)
420 #define CANWAKEUPFAILED ((uint8_t)0x00)
421 #define CANWAKEUPOK ((uint8_t)0x01)
431 #define CAN_FLAG_EWG ((uint32_t)0x00000001)
432 #define CAN_FLAG_EPV ((uint32_t)0x00000002)
433 #define CAN_FLAG_BOF ((uint32_t)0x00000004)
435 #define IS_CAN_FLAG(FLAG) (((FLAG) == CAN_FLAG_EWG) || ((FLAG) == CAN_FLAG_EPV) ||\
436  ((FLAG) == CAN_FLAG_BOF))
437 
446 #define CAN_IT_RQCP0 ((uint32_t)0x00000005)
447 #define CAN_IT_RQCP1 ((uint32_t)0x00000006)
448 #define CAN_IT_RQCP2 ((uint32_t)0x00000007)
449 #define CAN_IT_TME ((uint32_t)0x00000001)
450 #define CAN_IT_FMP0 ((uint32_t)0x00000002)
451 #define CAN_IT_FF0 ((uint32_t)0x00000004)
452 #define CAN_IT_FOV0 ((uint32_t)0x00000008)
453 #define CAN_IT_FMP1 ((uint32_t)0x00000010)
454 #define CAN_IT_FF1 ((uint32_t)0x00000020)
455 #define CAN_IT_FOV1 ((uint32_t)0x00000040)
456 #define CAN_IT_EWG ((uint32_t)0x00000100)
457 #define CAN_IT_EPV ((uint32_t)0x00000200)
458 #define CAN_IT_BOF ((uint32_t)0x00000400)
459 #define CAN_IT_LEC ((uint32_t)0x00000800)
460 #define CAN_IT_ERR ((uint32_t)0x00008000)
461 #define CAN_IT_WKU ((uint32_t)0x00010000)
462 #define CAN_IT_SLK ((uint32_t)0x00020000)
464 #define IS_CAN_ITConfig(IT) (((IT) == CAN_IT_TME) || ((IT) == CAN_IT_FMP0) ||\
465  ((IT) == CAN_IT_FF0) || ((IT) == CAN_IT_FOV0) ||\
466  ((IT) == CAN_IT_FMP1) || ((IT) == CAN_IT_FF1) ||\
467  ((IT) == CAN_IT_FOV1) || ((IT) == CAN_IT_EWG) ||\
468  ((IT) == CAN_IT_EPV) || ((IT) == CAN_IT_BOF) ||\
469  ((IT) == CAN_IT_LEC) || ((IT) == CAN_IT_ERR) ||\
470  ((IT) == CAN_IT_WKU) || ((IT) == CAN_IT_SLK))
471 
472 #define IS_CAN_ITStatus(IT) (((IT) == CAN_IT_RQCP0) || ((IT) == CAN_IT_RQCP1) ||\
473  ((IT) == CAN_IT_RQCP2) || ((IT) == CAN_IT_FF0) ||\
474  ((IT) == CAN_IT_FOV0) || ((IT) == CAN_IT_FF1) ||\
475  ((IT) == CAN_IT_FOV1) || ((IT) == CAN_IT_EWG) ||\
476  ((IT) == CAN_IT_EPV) || ((IT) == CAN_IT_BOF) ||\
477  ((IT) == CAN_IT_WKU) || ((IT) == CAN_IT_SLK))
478 
498 void CAN_DeInit(CAN_TypeDef* CANx);
499 uint8_t CAN_Init(CAN_TypeDef* CANx, CAN_InitTypeDef* CAN_InitStruct);
500 void CAN_FilterInit(CAN_FilterInitTypeDef* CAN_FilterInitStruct);
501 void CAN_StructInit(CAN_InitTypeDef* CAN_InitStruct);
502 void CAN_SlaveStartBank(uint8_t CAN_BankNumber);
503 void CAN_ITConfig(CAN_TypeDef* CANx, uint32_t CAN_IT, FunctionalState NewState);
504 uint8_t CAN_Transmit(CAN_TypeDef* CANx, CanTxMsg* TxMessage);
505 uint8_t CAN_TransmitStatus(CAN_TypeDef* CANx, uint8_t TransmitMailbox);
506 void CAN_CancelTransmit(CAN_TypeDef* CANx, uint8_t Mailbox);
507 void CAN_FIFORelease(CAN_TypeDef* CANx, uint8_t FIFONumber);
508 uint8_t CAN_MessagePending(CAN_TypeDef* CANx, uint8_t FIFONumber);
509 void CAN_Receive(CAN_TypeDef* CANx, uint8_t FIFONumber, CanRxMsg* RxMessage);
510 void CAN_DBGFreeze(CAN_TypeDef* CANx, FunctionalState NewState);
511 uint8_t CAN_Sleep(CAN_TypeDef* CANx);
512 uint8_t CAN_WakeUp(CAN_TypeDef* CANx);
513 FlagStatus CAN_GetFlagStatus(CAN_TypeDef* CANx, uint32_t CAN_FLAG);
514 void CAN_ClearFlag(CAN_TypeDef* CANx, uint32_t CAN_FLAG);
515 ITStatus CAN_GetITStatus(CAN_TypeDef* CANx, uint32_t CAN_IT);
516 void CAN_ClearITPendingBit(CAN_TypeDef* CANx, uint32_t CAN_IT);
517 
518 #ifdef __cplusplus
519 }
520 #endif
521 
522 #endif /* __STM32F10x_CAN_H */
523 
535 /******************* (C) COPYRIGHT 2010 STMicroelectronics *****END OF FILE****/