xref: /linux/include/linux/fsi.h (revision a1ff5a7d78a036d6c2178ee5acd6ba4946243800)
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