xref: /linux-6.15/include/linux/can/dev.h (revision c75b81bf)
1 /*
2  * linux/can/dev.h
3  *
4  * Definitions for the CAN network device driver interface
5  *
6  * Copyright (C) 2006 Andrey Volkov <[email protected]>
7  *               Varma Electronics Oy
8  *
9  * Copyright (C) 2008 Wolfgang Grandegger <[email protected]>
10  *
11  * Send feedback to <[email protected]>
12  */
13 
14 #ifndef CAN_DEV_H
15 #define CAN_DEV_H
16 
17 #include <linux/can/netlink.h>
18 #include <linux/can/error.h>
19 
20 /*
21  * CAN mode
22  */
23 enum can_mode {
24 	CAN_MODE_STOP = 0,
25 	CAN_MODE_START,
26 	CAN_MODE_SLEEP
27 };
28 
29 /*
30  * CAN common private data
31  */
32 struct can_priv {
33 	struct can_device_stats can_stats;
34 
35 	struct can_bittiming bittiming;
36 	struct can_bittiming_const *bittiming_const;
37 	struct can_clock clock;
38 
39 	enum can_state state;
40 	u32 ctrlmode;
41 
42 	int restart_ms;
43 	struct timer_list restart_timer;
44 
45 	int (*do_set_bittiming)(struct net_device *dev);
46 	int (*do_set_mode)(struct net_device *dev, enum can_mode mode);
47 	int (*do_get_state)(const struct net_device *dev,
48 			    enum can_state *state);
49 
50 	unsigned int echo_skb_max;
51 	struct sk_buff **echo_skb;
52 };
53 
54 /*
55  * get_can_dlc(value) - helper macro to cast a given data length code (dlc)
56  * to __u8 and ensure the dlc value to be max. 8 bytes.
57  *
58  * To be used in the CAN netdriver receive path to ensure conformance with
59  * ISO 11898-1 Chapter 8.4.2.3 (DLC field)
60  */
61 #define get_can_dlc(i)	(min_t(__u8, (i), 8))
62 
63 struct net_device *alloc_candev(int sizeof_priv, unsigned int echo_skb_max);
64 void free_candev(struct net_device *dev);
65 
66 int open_candev(struct net_device *dev);
67 void close_candev(struct net_device *dev);
68 
69 int register_candev(struct net_device *dev);
70 void unregister_candev(struct net_device *dev);
71 
72 int can_restart_now(struct net_device *dev);
73 void can_bus_off(struct net_device *dev);
74 
75 void can_put_echo_skb(struct sk_buff *skb, struct net_device *dev,
76 		      unsigned int idx);
77 void can_get_echo_skb(struct net_device *dev, unsigned int idx);
78 void can_free_echo_skb(struct net_device *dev, unsigned int idx);
79 
80 struct sk_buff *alloc_can_skb(struct net_device *dev, struct can_frame **cf);
81 struct sk_buff *alloc_can_err_skb(struct net_device *dev,
82 				  struct can_frame **cf);
83 
84 #endif /* CAN_DEV_H */
85