Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 1 | /* |
| 2 | * linux/can/dev.h |
| 3 | * |
| 4 | * Definitions for the CAN network device driver interface |
| 5 | * |
| 6 | * Copyright (C) 2006 Andrey Volkov <avolkov@varma-el.com> |
| 7 | * Varma Electronics Oy |
| 8 | * |
| 9 | * Copyright (C) 2008 Wolfgang Grandegger <wg@grandegger.com> |
| 10 | * |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 11 | */ |
| 12 | |
| 13 | #ifndef CAN_DEV_H |
| 14 | #define CAN_DEV_H |
| 15 | |
Hans J. Koch | 829e001 | 2010-04-13 00:03:25 +0000 | [diff] [blame] | 16 | #include <linux/can.h> |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 17 | #include <linux/can/netlink.h> |
| 18 | #include <linux/can/error.h> |
Fabio Baltieri | 996a953 | 2012-12-18 18:50:55 +0100 | [diff] [blame] | 19 | #include <linux/can/led.h> |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 20 | |
| 21 | /* |
| 22 | * CAN mode |
| 23 | */ |
| 24 | enum can_mode { |
| 25 | CAN_MODE_STOP = 0, |
| 26 | CAN_MODE_START, |
| 27 | CAN_MODE_SLEEP |
| 28 | }; |
| 29 | |
| 30 | /* |
| 31 | * CAN common private data |
| 32 | */ |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 33 | struct can_priv { |
| 34 | struct can_device_stats can_stats; |
| 35 | |
| 36 | struct can_bittiming bittiming; |
Marc Kleine-Budde | 194b9a4 | 2012-07-16 12:58:31 +0200 | [diff] [blame] | 37 | const struct can_bittiming_const *bittiming_const; |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 38 | struct can_clock clock; |
| 39 | |
| 40 | enum can_state state; |
| 41 | u32 ctrlmode; |
Christian Pellegrin | ad72c34 | 2010-01-14 07:08:34 +0000 | [diff] [blame] | 42 | u32 ctrlmode_supported; |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 43 | |
| 44 | int restart_ms; |
| 45 | struct timer_list restart_timer; |
| 46 | |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 47 | int (*do_set_bittiming)(struct net_device *dev); |
| 48 | int (*do_set_mode)(struct net_device *dev, enum can_mode mode); |
| 49 | int (*do_get_state)(const struct net_device *dev, |
| 50 | enum can_state *state); |
Wolfgang Grandegger | 52c793f | 2010-02-22 22:21:17 +0000 | [diff] [blame] | 51 | int (*do_get_berr_counter)(const struct net_device *dev, |
| 52 | struct can_berr_counter *bec); |
Wolfgang Grandegger | a6e4bc5 | 2009-10-08 22:17:11 +0000 | [diff] [blame] | 53 | |
| 54 | unsigned int echo_skb_max; |
| 55 | struct sk_buff **echo_skb; |
Fabio Baltieri | 996a953 | 2012-12-18 18:50:55 +0100 | [diff] [blame] | 56 | |
| 57 | #ifdef CONFIG_CAN_LEDS |
| 58 | struct led_trigger *tx_led_trig; |
| 59 | char tx_led_trig_name[CAN_LED_NAME_SZ]; |
| 60 | struct led_trigger *rx_led_trig; |
| 61 | char rx_led_trig_name[CAN_LED_NAME_SZ]; |
| 62 | #endif |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 63 | }; |
| 64 | |
Oliver Hartkopp | c7cd606 | 2009-12-12 04:13:21 +0000 | [diff] [blame] | 65 | /* |
| 66 | * get_can_dlc(value) - helper macro to cast a given data length code (dlc) |
| 67 | * to __u8 and ensure the dlc value to be max. 8 bytes. |
| 68 | * |
| 69 | * To be used in the CAN netdriver receive path to ensure conformance with |
| 70 | * ISO 11898-1 Chapter 8.4.2.3 (DLC field) |
| 71 | */ |
Oliver Hartkopp | 1e0625f | 2012-06-13 20:48:21 +0200 | [diff] [blame] | 72 | #define get_can_dlc(i) (min_t(__u8, (i), CAN_MAX_DLC)) |
| 73 | #define get_canfd_dlc(i) (min_t(__u8, (i), CANFD_MAX_DLC)) |
Oliver Hartkopp | c7cd606 | 2009-12-12 04:13:21 +0000 | [diff] [blame] | 74 | |
Oliver Hartkopp | 3ccd4c6 | 2010-01-12 02:00:46 -0800 | [diff] [blame] | 75 | /* Drop a given socketbuffer if it does not contain a valid CAN frame. */ |
| 76 | static inline int can_dropped_invalid_skb(struct net_device *dev, |
| 77 | struct sk_buff *skb) |
| 78 | { |
Oliver Hartkopp | 1e0625f | 2012-06-13 20:48:21 +0200 | [diff] [blame] | 79 | const struct canfd_frame *cfd = (struct canfd_frame *)skb->data; |
Oliver Hartkopp | 3ccd4c6 | 2010-01-12 02:00:46 -0800 | [diff] [blame] | 80 | |
Oliver Hartkopp | 1e0625f | 2012-06-13 20:48:21 +0200 | [diff] [blame] | 81 | if (skb->protocol == htons(ETH_P_CAN)) { |
| 82 | if (unlikely(skb->len != CAN_MTU || |
| 83 | cfd->len > CAN_MAX_DLEN)) |
| 84 | goto inval_skb; |
| 85 | } else if (skb->protocol == htons(ETH_P_CANFD)) { |
| 86 | if (unlikely(skb->len != CANFD_MTU || |
| 87 | cfd->len > CANFD_MAX_DLEN)) |
| 88 | goto inval_skb; |
| 89 | } else |
| 90 | goto inval_skb; |
Oliver Hartkopp | 3ccd4c6 | 2010-01-12 02:00:46 -0800 | [diff] [blame] | 91 | |
| 92 | return 0; |
Oliver Hartkopp | 1e0625f | 2012-06-13 20:48:21 +0200 | [diff] [blame] | 93 | |
| 94 | inval_skb: |
| 95 | kfree_skb(skb); |
| 96 | dev->stats.tx_dropped++; |
| 97 | return 1; |
Oliver Hartkopp | 3ccd4c6 | 2010-01-12 02:00:46 -0800 | [diff] [blame] | 98 | } |
| 99 | |
Oliver Hartkopp | 1e0625f | 2012-06-13 20:48:21 +0200 | [diff] [blame] | 100 | /* get data length from can_dlc with sanitized can_dlc */ |
| 101 | u8 can_dlc2len(u8 can_dlc); |
| 102 | |
| 103 | /* map the sanitized data length to an appropriate data length code */ |
| 104 | u8 can_len2dlc(u8 len); |
| 105 | |
Wolfgang Grandegger | a6e4bc5 | 2009-10-08 22:17:11 +0000 | [diff] [blame] | 106 | struct net_device *alloc_candev(int sizeof_priv, unsigned int echo_skb_max); |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 107 | void free_candev(struct net_device *dev); |
| 108 | |
Kurt Van Dijck | bf03a53 | 2012-12-18 18:50:56 +0100 | [diff] [blame] | 109 | /* a candev safe wrapper around netdev_priv */ |
| 110 | struct can_priv *safe_candev_priv(struct net_device *dev); |
| 111 | |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 112 | int open_candev(struct net_device *dev); |
| 113 | void close_candev(struct net_device *dev); |
| 114 | |
| 115 | int register_candev(struct net_device *dev); |
| 116 | void unregister_candev(struct net_device *dev); |
| 117 | |
| 118 | int can_restart_now(struct net_device *dev); |
| 119 | void can_bus_off(struct net_device *dev); |
| 120 | |
Wolfgang Grandegger | a6e4bc5 | 2009-10-08 22:17:11 +0000 | [diff] [blame] | 121 | void can_put_echo_skb(struct sk_buff *skb, struct net_device *dev, |
| 122 | unsigned int idx); |
Marc Kleine-Budde | cf5046b | 2011-10-10 23:43:53 +0200 | [diff] [blame] | 123 | unsigned int can_get_echo_skb(struct net_device *dev, unsigned int idx); |
Wolfgang Grandegger | a6e4bc5 | 2009-10-08 22:17:11 +0000 | [diff] [blame] | 124 | void can_free_echo_skb(struct net_device *dev, unsigned int idx); |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 125 | |
Wolfgang Grandegger | 7b6856a | 2009-10-20 00:08:01 -0700 | [diff] [blame] | 126 | struct sk_buff *alloc_can_skb(struct net_device *dev, struct can_frame **cf); |
| 127 | struct sk_buff *alloc_can_err_skb(struct net_device *dev, |
| 128 | struct can_frame **cf); |
| 129 | |
Wolfgang Grandegger | 39549ee | 2009-05-15 23:39:29 +0000 | [diff] [blame] | 130 | #endif /* CAN_DEV_H */ |