1/* SPDX-License-Identifier: GPL-2.0 */ 2/* 3 * Copyright (c) 2013-2016, Intel Corporation. All rights reserved. 4 */ 5#ifndef _LINUX_MEI_CL_BUS_H 6#define _LINUX_MEI_CL_BUS_H 7 8#include <linux/device.h> 9#include <linux/uuid.h> 10#include <linux/mod_devicetable.h> 11 12struct mei_cl_device; 13struct mei_device; 14struct scatterlist; 15 16typedef void (*mei_cldev_cb_t)(struct mei_cl_device *cldev); 17 18/** 19 * struct mei_cl_device - MEI device handle 20 * An mei_cl_device pointer is returned from mei_add_device() 21 * and links MEI bus clients to their actual ME host client pointer. 22 * Drivers for MEI devices will get an mei_cl_device pointer 23 * when being probed and shall use it for doing ME bus I/O. 24 * 25 * @bus_list: device on the bus list 26 * @bus: parent mei device 27 * @dev: linux driver model device pointer 28 * @me_cl: me client 29 * @cl: mei client 30 * @name: device name 31 * @rx_work: async work to execute Rx event callback 32 * @rx_cb: Drivers register this callback to get asynchronous ME 33 * Rx buffer pending notifications. 34 * @notif_work: async work to execute FW notify event callback 35 * @notif_cb: Drivers register this callback to get asynchronous ME 36 * FW notification pending notifications. 37 * 38 * @do_match: whether the device can be matched with a driver 39 * @is_added: device is already scanned 40 * @priv_data: client private data 41 */ 42struct mei_cl_device { 43 struct list_head bus_list; 44 struct mei_device *bus; 45 struct device dev; 46 47 struct mei_me_client *me_cl; 48 struct mei_cl *cl; 49 char name[MEI_CL_NAME_SIZE]; 50 51 struct work_struct rx_work; 52 mei_cldev_cb_t rx_cb; 53 struct work_struct notif_work; 54 mei_cldev_cb_t notif_cb; 55 56 unsigned int do_match:1; 57 unsigned int is_added:1; 58 59 void *priv_data; 60}; 61 62#define to_mei_cl_device(d) container_of(d, struct mei_cl_device, dev) 63 64struct mei_cl_driver { 65 struct device_driver driver; 66 const char *name; 67 68 const struct mei_cl_device_id *id_table; 69 70 int (*probe)(struct mei_cl_device *cldev, 71 const struct mei_cl_device_id *id); 72 void (*remove)(struct mei_cl_device *cldev); 73}; 74 75int __mei_cldev_driver_register(struct mei_cl_driver *cldrv, 76 struct module *owner); 77#define mei_cldev_driver_register(cldrv) \ 78 __mei_cldev_driver_register(cldrv, THIS_MODULE) 79 80void mei_cldev_driver_unregister(struct mei_cl_driver *cldrv); 81 82/** 83 * module_mei_cl_driver - Helper macro for registering mei cl driver 84 * 85 * @__mei_cldrv: mei_cl_driver structure 86 * 87 * Helper macro for mei cl drivers which do not do anything special in module 88 * init/exit, for eliminating a boilerplate code. 89 */ 90#define module_mei_cl_driver(__mei_cldrv) \ 91 module_driver(__mei_cldrv, \ 92 mei_cldev_driver_register,\ 93 mei_cldev_driver_unregister) 94 95ssize_t mei_cldev_send(struct mei_cl_device *cldev, const u8 *buf, 96 size_t length); 97ssize_t mei_cldev_send_timeout(struct mei_cl_device *cldev, const u8 *buf, 98 size_t length, unsigned long timeout); 99ssize_t mei_cldev_recv(struct mei_cl_device *cldev, u8 *buf, size_t length); 100ssize_t mei_cldev_recv_nonblock(struct mei_cl_device *cldev, u8 *buf, 101 size_t length); 102ssize_t mei_cldev_recv_timeout(struct mei_cl_device *cldev, u8 *buf, size_t length, 103 unsigned long timeout); 104ssize_t mei_cldev_send_vtag(struct mei_cl_device *cldev, const u8 *buf, 105 size_t length, u8 vtag); 106ssize_t mei_cldev_send_vtag_timeout(struct mei_cl_device *cldev, const u8 *buf, 107 size_t length, u8 vtag, unsigned long timeout); 108ssize_t mei_cldev_recv_vtag(struct mei_cl_device *cldev, u8 *buf, size_t length, 109 u8 *vtag); 110ssize_t mei_cldev_recv_nonblock_vtag(struct mei_cl_device *cldev, u8 *buf, 111 size_t length, u8 *vtag); 112ssize_t mei_cldev_recv_vtag_timeout(struct mei_cl_device *cldev, u8 *buf, size_t length, 113 u8 *vtag, unsigned long timeout); 114 115int mei_cldev_register_rx_cb(struct mei_cl_device *cldev, mei_cldev_cb_t rx_cb); 116int mei_cldev_register_notif_cb(struct mei_cl_device *cldev, 117 mei_cldev_cb_t notif_cb); 118 119const uuid_le *mei_cldev_uuid(const struct mei_cl_device *cldev); 120u8 mei_cldev_ver(const struct mei_cl_device *cldev); 121 122void *mei_cldev_get_drvdata(const struct mei_cl_device *cldev); 123void mei_cldev_set_drvdata(struct mei_cl_device *cldev, void *data); 124 125int mei_cldev_enable(struct mei_cl_device *cldev); 126int mei_cldev_disable(struct mei_cl_device *cldev); 127bool mei_cldev_enabled(const struct mei_cl_device *cldev); 128ssize_t mei_cldev_send_gsc_command(struct mei_cl_device *cldev, 129 u8 client_id, u32 fence_id, 130 struct scatterlist *sg_in, 131 size_t total_in_len, 132 struct scatterlist *sg_out); 133 134void *mei_cldev_dma_map(struct mei_cl_device *cldev, u8 buffer_id, size_t size); 135int mei_cldev_dma_unmap(struct mei_cl_device *cldev); 136 137#endif /* _LINUX_MEI_CL_BUS_H */ 138