fdcandev_stm32.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2024 COGIP Robotics association
3  *
4  * This file is subject to the terms and conditions of the GNU Lesser
5  * General Public License v2.1. See the file LICENSE in the top level
6  * directory for more details.
7  */
8 
31 #ifndef FDCANDEV_STM32_H
32 #define FDCANDEV_STM32_H
33 
34 #ifdef __cplusplus
35 extern "C" {
36 #endif
37 
38 #include "can/candev.h"
39 
41 #if defined(FDCAN3)
42 #define FDCANDEV_STM32_CHAN_NUMOF 3
43 #elif defined(FDCAN2)
44 #define FDCANDEV_STM32_CHAN_NUMOF 2
45 #elif defined(FDCAN1) || DOXYGEN
46 #define FDCANDEV_STM32_CHAN_NUMOF 1
47 #else
48 #error "FDCAN STM32: CPU not supported"
49 #endif
50 
55 #define ISR_FDCAN1_IT0 isr_fdcan1_it0
56 #define ISR_FDCAN1_IT1 isr_fdcan1_it1
63 #define FDCAN_STM32_NB_STD_FILTER 28U
64 #define FDCAN_STM32_NB_EXT_FILTER 8U
65 #define FDCAN_STM32_NB_FILTER \
66  (FDCAN_STM32_NB_STD_FILTER + FDCAN_STM32_NB_EXT_FILTER)
73 #ifndef FDCANDEV_STM32_DEFAULT_BITRATE
74 #define FDCANDEV_STM32_DEFAULT_BITRATE 500000U
76 #endif
77 #ifndef FDCANDEV_STM32_DEFAULT_FD_DATA_BITRATE
78 #define FDCANDEV_STM32_DEFAULT_FD_DATA_BITRATE 1000000U
80 #endif
83 #ifndef FDCANDEV_STM32_DEFAULT_SPT
85 #define FDCANDEV_STM32_DEFAULT_SPT 875
86 #endif
87 
89 typedef struct {
90  FDCAN_GlobalTypeDef *can;
91  uint32_t rcc_mask;
92  gpio_t rx_pin;
93  gpio_t tx_pin;
94  gpio_af_t af;
95  bool en_deep_sleep_wake_up;
96  uint8_t it0_irqn;
97  uint8_t it1_irqn;
98  uint8_t ttcm : 1;
99  uint8_t abom : 1;
100  uint8_t awum : 1;
101  uint8_t nart : 1;
102  uint8_t rflm : 1;
103  uint8_t txfp : 1;
104  uint8_t lbkm : 1;
105  uint8_t silm : 1;
106 } can_conf_t;
108 #define HAVE_CAN_CONF_T
109 
114 #define FDCAN_STM32_TX_MAILBOXES 3
116 #define FDCAN_STM32_RX_MAILBOXES (FDCANDEV_STM32_CHAN_NUMOF * 6)
122 typedef struct can can_t;
124 #define HAVE_CAN_T
125 
126 #define FDCAN_SRAM_MESSAGE_RAM_SIZE 0x350
132 #define FDCAN_SRAM_FLESA 0x1CU
133 #define FDCAN_SRAM_F0SA 0x2CU
134 #define FDCAN_SRAM_F1SA 0x62U
135 #define FDCAN_SRAM_EFSA 0x98U
136 #define FDCAN_SRAM_TBSA 0x9EU
143 #define FDCAN_SRAM_FLS_SFID1_Pos (16U)
145 #define FDCAN_SRAM_FLS_SFID1_Msk (0x7FFU << FDCAN_SRAM_FLS_SFID1_Pos)
147 #define FDCAN_SRAM_FLS_SFID1 FDCAN_SRAM_FLS_SFID1_Msk
149 #define FDCAN_SRAM_FLS_SFID2_Msk (0x7FFU)
151 #define FDCAN_SRAM_FLS_SFID2 FDCAN_SRAM_FLS_SFID2_Msk
153 #define FDCAN_SRAM_FLS_SFT_Pos (30U)
155 #define FDCAN_SRAM_FLS_SFT_Msk (0x3U << FDCAN_SRAM_FLS_SFT_Pos)
157 #define FDCAN_SRAM_FLS_SFT FDCAN_SRAM_FLS_SFT_Msk
159 #define FDCAN_SRAM_FLS_SFEC_Pos (27U)
161 #define FDCAN_SRAM_FLS_SFEC_Msk (0x7U << FDCAN_SRAM_FLS_SFEC_Pos)
163 #define FDCAN_SRAM_FLS_SFEC FDCAN_SRAM_FLS_SFEC_Msk
171 #define FDCAN_SRAM_FLS_FILTER_SIZE 1U
173 #define FDCAN_SRAM_FLS_SFT_DISABLED (0x3U << FDCAN_SRAM_FLS_SFT_Pos)
175 #define FDCAN_SRAM_FLS_SFT_CLASSIC (0x2U << FDCAN_SRAM_FLS_SFT_Pos)
177 #define FDCAN_SRAM_FLS_SFEC_DISABLED (0x0U << FDCAN_SRAM_FLS_SFEC_Pos)
179 #define FDCAN_SRAM_FLS_SFEC_FIFO0 (0x1U << FDCAN_SRAM_FLS_SFEC_Pos)
181 #define FDCAN_SRAM_FLS_SFEC_FIFO1 (0x2U << FDCAN_SRAM_FLS_SFEC_Pos)
189 #define FDCAN_SRAM_FLE_F0_EFID1_Msk 0x1FFFFFFFU
191 #define FDCAN_SRAM_FLE_F0_EFID1 FDCAN_SRAM_FLE_F0_EFID1_Msk
193 #define FDCAN_SRAM_FLE_F1_EFID2_Msk 0x1FFFFFFFU
195 #define FDCAN_SRAM_FLE_F1_EFID2 FDCAN_SRAM_FLE_F1_EFID2_Msk
197 #define FDCAN_SRAM_FLE_F1_EFT_Pos 30U
199 #define FDCAN_SRAM_FLE_F1_EFT_Msk (0x3U << FDCAN_SRAM_FLE_F1_EFT_Pos)
201 #define FDCAN_SRAM_FLE_F1_EFT FDCAN_SRAM_FLE_F1_EFT_Msk
203 #define FDCAN_SRAM_FLE_F0_EFEC_Pos 29U
205 #define FDCAN_SRAM_FLE_F0_EFEC_Msk (0x7U << FDCAN_SRAM_FLE_F0_EFEC_Pos)
207 #define FDCAN_SRAM_FLE_F0_EFEC FDCAN_SRAM_FLE_F0_EFEC_Msk
215 #define FDCAN_SRAM_FLE_FILTER_SIZE 2U
217 #define FDCAN_SRAM_FLE_F1_EFT_CLASSIC (0x2U << FDCAN_SRAM_FLE_F1_EFT_Pos)
219 #define FDCAN_SRAM_FLE_F0_EFEC_DISABLED (0x0U)
221 #define FDCAN_SRAM_FLE_F0_EFEC_FIFO0 (0x1U << FDCAN_SRAM_FLE_F0_EFEC_Pos)
223 #define FDCAN_SRAM_FLE_F0_EFEC_FIFO1 (0x2U << FDCAN_SRAM_FLE_F0_EFEC_Pos)
231 #define FDCAN_SRAM_TXBUFFER_T0_ESI_Pos 31U
233 #define FDCAN_SRAM_TXBUFFER_T0_ESI_Msk (0x1U << FDCAN_SRAM_TXBUFFER_T0_ESI_Pos)
235 #define FDCAN_SRAM_TXBUFFER_T0_ESI FDCAN_SRAM_TXBUFFER_T0_ESI_Msk
237 #define FDCAN_SRAM_TXBUFFER_T0_XTD_Pos 30U
239 #define FDCAN_SRAM_TXBUFFER_T0_XTD_Msk (0x1U << FDCAN_SRAM_TXBUFFER_T0_XTD_Pos)
241 #define FDCAN_SRAM_TXBUFFER_T0_XTD FDCAN_SRAM_TXBUFFER_T0_XTD_Msk
243 #define FDCAN_SRAM_TXBUFFER_T0_RTR_Pos 29U
245 #define FDCAN_SRAM_TXBUFFER_T0_RTR_Msk (0x1U << FDCAN_SRAM_TXBUFFER_T0_RTR_Pos)
247 #define FDCAN_SRAM_TXBUFFER_T0_RTR FDCAN_SRAM_TXBUFFER_T0_RTR_Msk
249 #define FDCAN_SRAM_TXBUFFER_T0_ID_Pos 18U
251 #define FDCAN_SRAM_TXBUFFER_T1_EFC_Pos 23U
253 #define FDCAN_SRAM_TXBUFFER_T1_EFC_Msk (0x1U << FDCAN_SRAM_TXBUFFER_T1_EFC_Pos)
255 #define FDCAN_SRAM_TXBUFFER_T1_EFC FDCAN_SRAM_TXBUFFER_T1_EFC_Msk
257 #define FDCAN_SRAM_TXBUFFER_T1_FDF_Pos 21U
259 #define FDCAN_SRAM_TXBUFFER_T1_FDF_Msk (0x1U << FDCAN_SRAM_TXBUFFER_T1_FDF_Pos)
261 #define FDCAN_SRAM_TXBUFFER_T1_FDF FDCAN_SRAM_TXBUFFER_T1_FDF_Msk
263 #define FDCAN_SRAM_TXBUFFER_T1_BRS_Pos 20U
265 #define FDCAN_SRAM_TXBUFFER_T1_BRS_Msk (0x1U << FDCAN_SRAM_TXBUFFER_T1_BRS_Pos)
267 #define FDCAN_SRAM_TXBUFFER_T1_BRS FDCAN_SRAM_TXBUFFER_T1_BRS_Msk
269 #define FDCAN_SRAM_TXBUFFER_T1_DLC_Pos 16U
271 #define FDCAN_SRAM_TXBUFFER_T1_DLC_Msk (0xFU << FDCAN_SRAM_TXBUFFER_T1_DLC_Pos)
273 #define FDCAN_SRAM_TXBUFFER_T1_DLC FDCAN_SRAM_TXBUFFER_T1_DLC_Msk
281 #define FDCAN_SRAM_TXBUFFER_SIZE 18U
283 #define FDCAN_SRAM_TXBUFFER_T0_ESI_PASSIVE_FLAG (0x0U << FDCAN_SRAM_TXBUFFER_T0_ESI_Pos)
285 #define FDCAN_SRAM_TXBUFFER_T0_ESI_RECESSIVE (0x1U << FDCAN_SRAM_TXBUFFER_T0_ESI_Pos)
287 #define FDCAN_SRAM_TXBUFFER_T1_EFC_DISABLE (0x0U << FDCAN_SRAM_TXBUFFER_T1_EFC_Pos)
289 #define FDCAN_SRAM_TXBUFFER_T1_EFC_STORE_EVENTS (0x1U << FDCAN_SRAM_TXBUFFER_T1_EFC_Pos)
291 #define FDCAN_SRAM_TXBUFFER_T1_FDF_CLASSIC (0x0U << FDCAN_SRAM_TXBUFFER_T1_FDF_Pos)
293 #define FDCAN_SRAM_TXBUFFER_T1_FDF_FD (0x1U << FDCAN_SRAM_TXBUFFER_T1_FDF_Pos)
295 #define FDCAN_SRAM_TXBUFFER_T1_BRS_OFF (0x0U << FDCAN_SRAM_TXBUFFER_T1_BRS_Pos)
297 #define FDCAN_SRAM_TXBUFFER_T1_BRS_ON (0x1U << FDCAN_SRAM_TXBUFFER_T1_BRS_Pos)
305 #define FDCAN_SRAM_RXFIFO_R0_ESI_Pos 31U
307 #define FDCAN_SRAM_RXFIFO_R0_ESI_Msk (0x1U << FDCAN_SRAM_RXFIFO_R0_ESI_Pos)
309 #define FDCAN_SRAM_RXFIFO_R0_ESI FDCAN_SRAM_RXFIFO_R0_ESI_Msk
311 #define FDCAN_SRAM_RXFIFO_R0_XTD_Pos 30U
313 #define FDCAN_SRAM_RXFIFO_R0_XTD_Msk (0x1U << FDCAN_SRAM_RXFIFO_R0_XTD_Pos)
315 #define FDCAN_SRAM_RXFIFO_R0_XTD FDCAN_SRAM_RXFIFO_R0_XTD_Msk
317 #define FDCAN_SRAM_RXFIFO_R0_RTR_Pos 29U
319 #define FDCAN_SRAM_RXFIFO_R0_RTR_Msk (0x1U << FDCAN_SRAM_RXFIFO_R0_RTR_Pos)
321 #define FDCAN_SRAM_RXFIFO_R0_RTR FDCAN_SRAM_RXFIFO_R0_RTR_Msk
323 #define FDCAN_SRAM_RXFIFO_R0_ID_Pos 18U
325 #define FDCAN_SRAM_RXFIFO_R0_ID_Msk 0x1FFFFFFFU
327 #define FDCAN_SRAM_RXFIFO_R0_ID FDCAN_SRAM_RXFIFO_R0_ID_Msk
329 #define FDCAN_SRAM_RXFIFO_R1_EFC_Pos 23U
331 #define FDCAN_SRAM_RXFIFO_R1_EFC_Msk (0x1U << FDCAN_SRAM_RXFIFO_R1_EFC_Pos)
333 #define FDCAN_SRAM_RXFIFO_R1_EFC FDCAN_SRAM_RXFIFO_R1_EFC_Msk
335 #define FDCAN_SRAM_RXFIFO_R1_FDF_Pos 21U
337 #define FDCAN_SRAM_RXFIFO_R1_FDF_Msk (0x1U << FDCAN_SRAM_RXFIFO_R1_FDF_Pos)
339 #define FDCAN_SRAM_RXFIFO_R1_FDF FDCAN_SRAM_RXFIFO_R1_FDF_Msk
341 #define FDCAN_SRAM_RXFIFO_R1_BRS_Pos 20U
343 #define FDCAN_SRAM_RXFIFO_R1_BRS_Msk (0x1U << FDCAN_SRAM_RXFIFO_R1_BRS_Pos)
345 #define FDCAN_SRAM_RXFIFO_R1_BRS FDCAN_SRAM_RXFIFO_R1_BRS_Msk
347 #define FDCAN_SRAM_RXFIFO_R1_DLC_Pos 16U
349 #define FDCAN_SRAM_RXFIFO_R1_DLC_Msk (0xFU << FDCAN_SRAM_RXFIFO_R1_DLC_Pos)
351 #define FDCAN_SRAM_RXFIFO_R1_DLC FDCAN_SRAM_RXFIFO_R1_DLC_Msk
359 #define FDCAN_SRAM_RXFIFO_SIZE 54U
361 #define FDCAN_SRAM_RXFIFO_ELEMENT_SIZE 18U
363 #define FDCAN_SRAM_RXFIFO_R0_ESI_PASSIVE_FLAG (0x0U << FDCAN_SRAM_RXFIFO_R0_ESI_Pos)
365 #define FDCAN_SRAM_RXFIFO_R0_ESI_RECESSIVE (0x1U << FDCAN_SRAM_RXFIFO_R0_ESI_Pos)
367 #define FDCAN_SRAM_RXFIFO_R1_EFC_DISABLE (0x0U << FDCAN_SRAM_RXFIFO_R1_EFC_Pos)
369 #define FDCAN_SRAM_RXFIFO_R1_EFC_STORE_EVENTS (0x1U << FDCAN_SRAM_RXFIFO_R1_EFC_Pos)
371 #define FDCAN_SRAM_RXFIFO_R1_FDF_CLASSIC (0x0U << FDCAN_SRAM_RXFIFO_R1_FDF_Pos)
373 #define FDCAN_SRAM_RXFIFO_R1_FDF_FD (0x1U << FDCAN_SRAM_RXFIFO_R1_FDF_Pos)
375 #define FDCAN_SRAM_RXFIFO_R1_BRS_OFF (0x0U << FDCAN_SRAM_RXFIFO_R1_BRS_Pos)
377 #define FDCAN_SRAM_RXFIFO_R1_BRS_ON (0x1U << FDCAN_SRAM_RXFIFO_R1_BRS_Pos)
382 typedef struct candev_stm32_rx_mailbox {
387  int read_idx;
389  int is_full;
392 
394 typedef struct candev_stm32_isr {
395  int isr_tx : 3;
396  int isr_rx : 2;
397  int isr_wkup : 1;
399 
401 struct can {
402  candev_t candev;
403  const can_conf_t *conf;
404  gpio_t rx_pin;
405  gpio_t tx_pin;
406  gpio_af_t af;
407  const can_frame_t
411 };
412 
421 void candev_stm32_set_pins(can_t *dev, gpio_t tx_pin, gpio_t rx_pin,
422  gpio_af_t af);
423 #ifdef __cplusplus
424 }
425 #endif
426 
427 #endif /* FDCANDEV_STM32_H */
Definitions for low-level CAN driver interface.
#define FDCAN_STM32_RX_MAILBOXES
Maximum number of frame the driver can receive simultaneously.
struct candev_stm32_rx_mailbox candev_stm32_rx_mailbox_t
This structure holds anything related to the receive part.
#define FDCAN_STM32_TX_MAILBOXES
Number of frame the driver can transmit simultaneously.
void candev_stm32_set_pins(can_t *dev, gpio_t tx_pin, gpio_t rx_pin, gpio_af_t af)
Set the pins of an stm32 CAN device.
struct candev_stm32_isr candev_stm32_isr_t
Internal interrupt flags.
gpio_af_t
Override alternative GPIO mode options.
Definition: periph_cpu.h:166
struct candev_conf can_conf_t
Linux candev configuration.
ESP CAN device configuration.
Definition: can_esp.h:88
FDCAN_GlobalTypeDef * can
CAN device.
uint8_t it1_irqn
Interrupt line 1 IRQ channel.
uint8_t it0_irqn
Interrupt line 0 IRQ channel.
Controller Area Network frame.
Definition: can.h:101
Low level device structure for ESP32 CAN (extension of candev_t)
Definition: can_esp.h:64
const struct can_frame * tx_mailbox[CAN_STM32_TX_MAILBOXES]
Tx mailboxes.
Definition: candev_stm32.h:172
candev_stm32_isr_t isr_flags
ISR flags.
Definition: candev_stm32.h:174
gpio_t rx_pin
RX pin.
Definition: candev_stm32.h:168
candev_stm32_rx_mailbox_t rx_mailbox
Rx mailboxes.
candev_t candev
candev base structure
Definition: can_esp.h:65
gpio_t tx_pin
TX pin.
Definition: candev_stm32.h:169
const can_conf_t * conf
Configuration.
Definition: candev_stm32.h:167
gpio_af_t af
Alternate pin function to use.
Definition: candev_stm32.h:170
Internal interrupt flags.
Definition: candev_stm32.h:158
int isr_rx
Rx FIFO interrupt.
Definition: candev_stm32.h:160
int isr_tx
Tx mailboxes interrupt.
Definition: candev_stm32.h:159
int isr_wkup
Wake up interrupt.
Definition: candev_stm32.h:161
This structure holds anything related to the receive part.
int write_idx
Write index in the receive FIFO.
can_frame_t frame[FDCAN_STM32_RX_MAILBOXES]
Receive FIFO.
int read_idx
Read index in the receive FIFO.
int is_full
Flag set when the FIFO is full.
Structure to hold driver state.
Definition: candev.h:77