1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* FSI device & driver interfaces 3 * 4 * Copyright (C) IBM Corporation 2016 5 */ 6 7 #ifndef LINUX_FSI_H 8 #define LINUX_FSI_H 9 10 #include <linux/device.h> 11 12 struct fsi_device { 13 struct device dev; 14 u8 engine_type; 15 u8 version; 16 u8 unit; 17 struct fsi_slave *slave; 18 uint32_t addr; 19 uint32_t size; 20 }; 21 22 extern int fsi_device_read(struct fsi_device *dev, uint32_t addr, 23 void *val, size_t size); 24 extern int fsi_device_write(struct fsi_device *dev, uint32_t addr, 25 const void *val, size_t size); 26 extern int fsi_device_peek(struct fsi_device *dev, void *val); 27 28 struct fsi_device_id { 29 u8 engine_type; 30 u8 version; 31 }; 32 33 #define FSI_VERSION_ANY 0 34 35 #define FSI_DEVICE(t) \ 36 .engine_type = (t), .version = FSI_VERSION_ANY, 37 38 #define FSI_DEVICE_VERSIONED(t, v) \ 39 .engine_type = (t), .version = (v), 40 41 struct fsi_driver { 42 struct device_driver drv; 43 const struct fsi_device_id *id_table; 44 }; 45 46 #define to_fsi_dev(devp) container_of(devp, struct fsi_device, dev) 47 #define to_fsi_drv(drvp) container_of_const(drvp, struct fsi_driver, drv) 48 49 extern int fsi_driver_register(struct fsi_driver *fsi_drv); 50 extern void fsi_driver_unregister(struct fsi_driver *fsi_drv); 51 52 /* module_fsi_driver() - Helper macro for drivers that don't do 53 * anything special in module init/exit. This eliminates a lot of 54 * boilerplate. Each module may only use this macro once, and 55 * calling it replaces module_init() and module_exit() 56 */ 57 #define module_fsi_driver(__fsi_driver) \ 58 module_driver(__fsi_driver, fsi_driver_register, \ 59 fsi_driver_unregister) 60 61 /* direct slave API */ 62 extern int fsi_slave_claim_range(struct fsi_slave *slave, 63 uint32_t addr, uint32_t size); 64 extern void fsi_slave_release_range(struct fsi_slave *slave, 65 uint32_t addr, uint32_t size); 66 extern int fsi_slave_read(struct fsi_slave *slave, uint32_t addr, 67 void *val, size_t size); 68 extern int fsi_slave_write(struct fsi_slave *slave, uint32_t addr, 69 const void *val, size_t size); 70 71 extern struct bus_type fsi_bus_type; 72 extern const struct device_type fsi_cdev_type; 73 74 enum fsi_dev_type { 75 fsi_dev_cfam, 76 fsi_dev_sbefifo, 77 fsi_dev_scom, 78 fsi_dev_occ 79 }; 80 81 extern int fsi_get_new_minor(struct fsi_device *fdev, enum fsi_dev_type type, 82 dev_t *out_dev, int *out_index); 83 extern void fsi_free_minor(dev_t dev); 84 85 #endif /* LINUX_FSI_H */ 86