xref: /linux-6.15/include/linux/fsi.h (revision 4efe37f4)
1 /* FSI device & driver interfaces
2  *
3  * Copyright (C) IBM Corporation 2016
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  */
14 
15 #ifndef LINUX_FSI_H
16 #define LINUX_FSI_H
17 
18 #include <linux/device.h>
19 
20 struct fsi_device {
21 	struct device		dev;
22 	u8			engine_type;
23 	u8			version;
24 	u8			unit;
25 	struct fsi_slave	*slave;
26 	uint32_t		addr;
27 	uint32_t		size;
28 };
29 
30 extern int fsi_device_read(struct fsi_device *dev, uint32_t addr,
31 		void *val, size_t size);
32 extern int fsi_device_write(struct fsi_device *dev, uint32_t addr,
33 		const void *val, size_t size);
34 extern int fsi_device_peek(struct fsi_device *dev, void *val);
35 
36 struct fsi_device_id {
37 	u8	engine_type;
38 	u8	version;
39 };
40 
41 #define FSI_VERSION_ANY		0
42 
43 #define FSI_DEVICE(t) \
44 	.engine_type = (t), .version = FSI_VERSION_ANY,
45 
46 #define FSI_DEVICE_VERSIONED(t, v) \
47 	.engine_type = (t), .version = (v),
48 
49 struct fsi_driver {
50 	struct device_driver		drv;
51 	const struct fsi_device_id	*id_table;
52 };
53 
54 #define to_fsi_dev(devp) container_of(devp, struct fsi_device, dev)
55 #define to_fsi_drv(drvp) container_of(drvp, struct fsi_driver, drv)
56 
57 extern struct bus_type fsi_bus_type;
58 
59 #endif /* LINUX_FSI_H */
60