common.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2016 OTA keys S.A.
3  *
4  * This file is subject to the terms and conditions of the GNU Lesser General
5  * Public License v2.1. See the file LICENSE in the top level directory for more
6  * details.
7  */
8 
9 #pragma once
10 
28 #ifdef __cplusplus
29 extern "C" {
30 #endif
31 
32 #include <stdint.h>
33 #include <sys/uio.h>
34 
35 #include "timex.h"
36 #include "thread.h"
37 #ifdef MODULE_CAN_MBOX
38 #include "mbox.h"
39 #endif
40 
44 #ifdef MODULE_FDCAN
45 #define DEFAULT_CAN_MAX_DLEN CANFD_MAX_DLEN
46 #else
47 #define DEFAULT_CAN_MAX_DLEN CAN_MAX_DLEN
48 #endif
49 
53 typedef enum {
62 #ifdef MODULE_FDCAN
63  CANOPT_FD_BITTIMING,
64  CANOPT_FD_BITTIMING_CONST,
65 #endif
66 } canopt_t;
67 
73 typedef enum {
80 
84 typedef struct {
86  uint16_t context;
87  void *data;
88  uint16_t data_len;
89 } can_opt_t;
90 
94 enum can_msg {
95  /* High level messages */
96  CAN_MSG_ACK = 0x100,
105 #if defined(MODULE_CAN_TRX) || defined(DOXYGEN)
107 #endif
108  /* candev internal messages */
109  CAN_MSG_EVENT = 0x200,
118 #if defined(MODULE_CAN_PM) || defined(DOXYGEN)
120 #endif
121  /* isotp messages */
122 #if defined(MODULE_CAN_ISOTP) || defined(DOXYGEN)
125 #endif
126 };
127 
134 typedef struct can_rx_data {
135  struct iovec data;
136  void *arg;
138 
142 typedef enum {
144 #if defined(MODULE_CAN_MBOX) || defined(DOXYGEN)
146 #endif
148 
155 typedef struct can_reg_entry {
156  struct can_reg_entry *next;
157  int ifnum;
158  union {
160 #if defined(MODULE_CAN_MBOX) || defined(DOXYGEN)
162 #endif
163  } target;
164 #if defined(MODULE_CAN_MBOX) || defined(DOXYGEN)
166 #endif
168 
169 #ifdef __cplusplus
170 }
171 #endif
172 
int16_t kernel_pid_t
Unique process identifier.
Definition: sched.h:138
canopt_state_t
CAN state options.
Definition: common.h:73
canopt_t
CAN options.
Definition: common.h:53
struct can_rx_data can_rx_data_t
Received data structure.
can_msg
Messages which can be sent through the CAN stack.
Definition: common.h:94
can_reg_type_t
registry entry types
Definition: common.h:142
struct can_reg_entry can_reg_entry_t
registry entry
@ CANOPT_STATE_OFF
powered off
Definition: common.h:74
@ CANOPT_STATE_SLEEP
sleep mode
Definition: common.h:75
@ CANOPT_STATE_LOOPBACK
loopback mode
Definition: common.h:78
@ CANOPT_STATE_ON
power on, rx / tx mode
Definition: common.h:77
@ CANOPT_STATE_LISTEN_ONLY
listen only mode
Definition: common.h:76
@ CANOPT_STATE
set controller state canopt_state_t
Definition: common.h:61
@ CANOPT_RX_FILTERS
rx filters
Definition: common.h:55
@ CANOPT_LEC
Last Error Code.
Definition: common.h:58
@ CANOPT_BITTIMING_CONST
controller bittiming parameters
Definition: common.h:60
@ CANOPT_REC
Receive Error Counter.
Definition: common.h:57
@ CANOPT_TEC
Transmit Error Counter.
Definition: common.h:56
@ CANOPT_CLOCK
controller main clock
Definition: common.h:59
@ CANOPT_BITTIMING
bit timing parameter
Definition: common.h:54
@ CAN_MSG_SET_TRX
set a transceiver
Definition: common.h:106
@ CAN_MSG_POWER_UP
power up
Definition: common.h:103
@ CAN_MSG_ERROR_WARNING
driver reached error warning
Definition: common.h:117
@ CAN_MSG_ERROR_PASSIVE
driver switched in error passive
Definition: common.h:116
@ CAN_MSG_SET_FILTER
set a filter
Definition: common.h:101
@ CAN_MSG_POWER_DOWN
power down
Definition: common.h:104
@ CAN_MSG_BUS_OFF
bus-off detected
Definition: common.h:115
@ CAN_MSG_EVENT
driver event
Definition: common.h:109
@ CAN_MSG_ACK
acknowledgment
Definition: common.h:96
@ CAN_MSG_WAKE_UP
driver has been woken up by bus
Definition: common.h:110
@ CAN_MSG_TX_CONFIRMATION
a frame has been sent
Definition: common.h:111
@ CAN_MSG_RX_ERROR
there was an error when receiving
Definition: common.h:114
@ CAN_MSG_SEND_FRAME
send a frame
Definition: common.h:97
@ CAN_MSG_SET
set an option
Definition: common.h:99
@ CAN_MSG_ISOTP_RX_TIMEOUT
isotp rx timeout
Definition: common.h:123
@ CAN_MSG_RX_INDICATION
a frame has been received
Definition: common.h:112
@ CAN_MSG_ABORT_FRAME
abort a frame
Definition: common.h:98
@ CAN_MSG_REMOVE_FILTER
remove a filter
Definition: common.h:102
@ CAN_MSG_PM
power management event
Definition: common.h:119
@ CAN_MSG_GET
get an option
Definition: common.h:100
@ CAN_MSG_ISOTP_TX_TIMEOUT
isotp tx timeout
Definition: common.h:124
@ CAN_MSG_TX_ERROR
there was an error when transmitting
Definition: common.h:113
@ CAN_TYPE_DEFAULT
default entry (use msg)
Definition: common.h:143
@ CAN_TYPE_MBOX
mbox entry
Definition: common.h:145
Mailbox API.
Structure to pass a CAN option.
Definition: common.h:84
uint16_t context
(optional) context for that option
Definition: common.h:86
canopt_t opt
the option to get/set
Definition: common.h:85
void * data
data to set or buffer to read into
Definition: common.h:87
registry entry
Definition: common.h:155
union can_reg_entry::@331 target
entry target
mbox_t * mbox
mbox pointer
Definition: common.h:161
kernel_pid_t pid
pid of the thread when using msg
Definition: common.h:159
can_reg_type_t type
entry type
Definition: common.h:165
int ifnum
interface number for the entry
Definition: common.h:157
struct can_reg_entry * next
next for linked list
Definition: common.h:156
Received data structure.
Definition: common.h:134
void * arg
upper layer private param
Definition: common.h:136
struct iovec data
iovec containing received data
Definition: common.h:135
Structure for scatter/gather I/O.
Definition: uio.h:33
Mailbox struct definition.
Definition: mbox.h:40
Utility library for comparing and computing timestamps.
libc header for scatter/gather I/O