1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * Greybus Host Device 4 * 5 * Copyright 2014-2015 Google Inc. 6 * Copyright 2014-2015 Linaro Ltd. 7 */ 8 9 #ifndef __HD_H 10 #define __HD_H 11 12 struct gb_host_device; 13 struct gb_message; 14 15 struct gb_hd_driver { 16 size_t hd_priv_size; 17 18 int (*cport_allocate)(struct gb_host_device *hd, int cport_id, 19 unsigned long flags); 20 void (*cport_release)(struct gb_host_device *hd, u16 cport_id); 21 int (*cport_enable)(struct gb_host_device *hd, u16 cport_id, 22 unsigned long flags); 23 int (*cport_disable)(struct gb_host_device *hd, u16 cport_id); 24 int (*cport_connected)(struct gb_host_device *hd, u16 cport_id); 25 int (*cport_flush)(struct gb_host_device *hd, u16 cport_id); 26 int (*cport_shutdown)(struct gb_host_device *hd, u16 cport_id, 27 u8 phase, unsigned int timeout); 28 int (*cport_quiesce)(struct gb_host_device *hd, u16 cport_id, 29 size_t peer_space, unsigned int timeout); 30 int (*cport_clear)(struct gb_host_device *hd, u16 cport_id); 31 32 int (*message_send)(struct gb_host_device *hd, u16 dest_cport_id, 33 struct gb_message *message, gfp_t gfp_mask); 34 void (*message_cancel)(struct gb_message *message); 35 int (*latency_tag_enable)(struct gb_host_device *hd, u16 cport_id); 36 int (*latency_tag_disable)(struct gb_host_device *hd, u16 cport_id); 37 int (*output)(struct gb_host_device *hd, void *req, u16 size, u8 cmd, 38 bool async); 39 }; 40 41 struct gb_host_device { 42 struct device dev; 43 int bus_id; 44 const struct gb_hd_driver *driver; 45 46 struct list_head modules; 47 struct list_head connections; 48 struct ida cport_id_map; 49 50 /* Number of CPorts supported by the UniPro IP */ 51 size_t num_cports; 52 53 /* Host device buffer constraints */ 54 size_t buffer_size_max; 55 56 struct gb_svc *svc; 57 /* Private data for the host driver */ 58 unsigned long hd_priv[0] __aligned(sizeof(s64)); 59 }; 60 #define to_gb_host_device(d) container_of(d, struct gb_host_device, dev) 61 62 int gb_hd_cport_reserve(struct gb_host_device *hd, u16 cport_id); 63 void gb_hd_cport_release_reserved(struct gb_host_device *hd, u16 cport_id); 64 int gb_hd_cport_allocate(struct gb_host_device *hd, int cport_id, 65 unsigned long flags); 66 void gb_hd_cport_release(struct gb_host_device *hd, u16 cport_id); 67 68 struct gb_host_device *gb_hd_create(struct gb_hd_driver *driver, 69 struct device *parent, 70 size_t buffer_size_max, 71 size_t num_cports); 72 int gb_hd_add(struct gb_host_device *hd); 73 void gb_hd_del(struct gb_host_device *hd); 74 void gb_hd_shutdown(struct gb_host_device *hd); 75 void gb_hd_put(struct gb_host_device *hd); 76 int gb_hd_output(struct gb_host_device *hd, void *req, u16 size, u8 cmd, 77 bool in_irq); 78 79 int gb_hd_init(void); 80 void gb_hd_exit(void); 81 82 #endif /* __HD_H */ 83