1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * Greybus connections 4 * 5 * Copyright 2014 Google Inc. 6 * Copyright 2014 Linaro Ltd. 7 */ 8 9 #ifndef __CONNECTION_H 10 #define __CONNECTION_H 11 12 #include <linux/bits.h> 13 #include <linux/list.h> 14 #include <linux/kfifo.h> 15 #include <linux/kref.h> 16 #include <linux/workqueue.h> 17 18 #define GB_CONNECTION_FLAG_CSD BIT(0) 19 #define GB_CONNECTION_FLAG_NO_FLOWCTRL BIT(1) 20 #define GB_CONNECTION_FLAG_OFFLOADED BIT(2) 21 #define GB_CONNECTION_FLAG_CDSI1 BIT(3) 22 #define GB_CONNECTION_FLAG_CONTROL BIT(4) 23 #define GB_CONNECTION_FLAG_HIGH_PRIO BIT(5) 24 25 #define GB_CONNECTION_FLAG_CORE_MASK GB_CONNECTION_FLAG_CONTROL 26 27 enum gb_connection_state { 28 GB_CONNECTION_STATE_DISABLED = 0, 29 GB_CONNECTION_STATE_ENABLED_TX = 1, 30 GB_CONNECTION_STATE_ENABLED = 2, 31 GB_CONNECTION_STATE_DISCONNECTING = 3, 32 }; 33 34 struct gb_operation; 35 36 typedef int (*gb_request_handler_t)(struct gb_operation *); 37 38 struct gb_connection { 39 struct gb_host_device *hd; 40 struct gb_interface *intf; 41 struct gb_bundle *bundle; 42 struct kref kref; 43 u16 hd_cport_id; 44 u16 intf_cport_id; 45 46 struct list_head hd_links; 47 struct list_head bundle_links; 48 49 gb_request_handler_t handler; 50 unsigned long flags; 51 52 struct mutex mutex; 53 spinlock_t lock; 54 enum gb_connection_state state; 55 struct list_head operations; 56 57 char name[16]; 58 struct workqueue_struct *wq; 59 60 atomic_t op_cycle; 61 62 void *private; 63 64 bool mode_switch; 65 }; 66 67 struct gb_connection *gb_connection_create_static(struct gb_host_device *hd, 68 u16 hd_cport_id, gb_request_handler_t handler); 69 struct gb_connection *gb_connection_create_control(struct gb_interface *intf); 70 struct gb_connection *gb_connection_create(struct gb_bundle *bundle, 71 u16 cport_id, gb_request_handler_t handler); 72 struct gb_connection *gb_connection_create_flags(struct gb_bundle *bundle, 73 u16 cport_id, gb_request_handler_t handler, 74 unsigned long flags); 75 struct gb_connection *gb_connection_create_offloaded(struct gb_bundle *bundle, 76 u16 cport_id, unsigned long flags); 77 void gb_connection_destroy(struct gb_connection *connection); 78 79 static inline bool gb_connection_is_static(struct gb_connection *connection) 80 { 81 return !connection->intf; 82 } 83 84 int gb_connection_enable(struct gb_connection *connection); 85 int gb_connection_enable_tx(struct gb_connection *connection); 86 void gb_connection_disable_rx(struct gb_connection *connection); 87 void gb_connection_disable(struct gb_connection *connection); 88 void gb_connection_disable_forced(struct gb_connection *connection); 89 90 void gb_connection_mode_switch_prepare(struct gb_connection *connection); 91 void gb_connection_mode_switch_complete(struct gb_connection *connection); 92 93 void greybus_data_rcvd(struct gb_host_device *hd, u16 cport_id, 94 u8 *data, size_t length); 95 96 void gb_connection_latency_tag_enable(struct gb_connection *connection); 97 void gb_connection_latency_tag_disable(struct gb_connection *connection); 98 99 static inline bool gb_connection_e2efc_enabled(struct gb_connection *connection) 100 { 101 return !(connection->flags & GB_CONNECTION_FLAG_CSD); 102 } 103 104 static inline bool 105 gb_connection_flow_control_disabled(struct gb_connection *connection) 106 { 107 return connection->flags & GB_CONNECTION_FLAG_NO_FLOWCTRL; 108 } 109 110 static inline bool gb_connection_is_offloaded(struct gb_connection *connection) 111 { 112 return connection->flags & GB_CONNECTION_FLAG_OFFLOADED; 113 } 114 115 static inline bool gb_connection_is_control(struct gb_connection *connection) 116 { 117 return connection->flags & GB_CONNECTION_FLAG_CONTROL; 118 } 119 120 static inline void *gb_connection_get_data(struct gb_connection *connection) 121 { 122 return connection->private; 123 } 124 125 static inline void gb_connection_set_data(struct gb_connection *connection, 126 void *data) 127 { 128 connection->private = data; 129 } 130 131 #endif /* __CONNECTION_H */ 132