summaryrefslogblamecommitdiff
path: root/include/linux/fsi.h
blob: 3df8c54868df59d9f6b2c19cd7be3c1c166a3f59 (plain) (tree) 
1802d0beecaf ^

0508ad1fff11 ^



0508ad1fff11 ^







fda07a6c94ac ^

dd37eed7db0f ^



f7ade2a603cf ^




fda07a6c94ac ^


4efe37f4c4ef ^






dd37eed7db0f ^













fda07a6c94ac ^

dd37eed7db0f ^


fda07a6c94ac ^





356d8009a5a4 ^












da36cadf89a7 ^










0ab5fe537474 ^


da36cadf89a7 ^

0ab5fe537474 ^






da36cadf89a7 ^

0ab5fe537474 ^



0508ad1fff11 ^


1

2
3
4

5
6
7
8
9
10
11

12

13
14
15

16
17
18
19

20
21

22
23
24
25
26
27

28
29
30
31
32
33
34
35
36
37
38
39
40

41

42
43

44
45
46
47
48

49
50
51
52
53
54
55
56
57
58
59
60

61
62
63
64
65
66
67
68
69
70

71
72

73

74
75
76
77
78
79

80

81
82
83

84
85

                                           


                                     






                         
                   


                                            



                                       

  





                                                                  












                                                       
                   

                                                  




                                                                   











                                                                  









                                                                  

                                              
 





                        
 


                                                                             

                        
/* SPDX-License-Identifier: GPL-2.0-only */
/* FSI device & driver interfaces
 *
 * Copyright (C) IBM Corporation 2016
 */

#ifndef LINUX_FSI_H
#define LINUX_FSI_H

#include <linux/device.h>

struct fsi_device {
	struct device		dev;
	u8			engine_type;
	u8			version;
	u8			unit;
	struct fsi_slave	*slave;
	uint32_t		addr;
	uint32_t		size;
};

extern int fsi_device_read(struct fsi_device *dev, uint32_t addr,
		void *val, size_t size);
extern int fsi_device_write(struct fsi_device *dev, uint32_t addr,
		const void *val, size_t size);
extern int fsi_device_peek(struct fsi_device *dev, void *val);

struct fsi_device_id {
	u8	engine_type;
	u8	version;
};

#define FSI_VERSION_ANY		0

#define FSI_DEVICE(t) \
	.engine_type = (t), .version = FSI_VERSION_ANY,

#define FSI_DEVICE_VERSIONED(t, v) \
	.engine_type = (t), .version = (v),

struct fsi_driver {
	struct device_driver		drv;
	const struct fsi_device_id	*id_table;
};

#define to_fsi_dev(devp) container_of(devp, struct fsi_device, dev)
#define to_fsi_drv(drvp) container_of(drvp, struct fsi_driver, drv)

extern int fsi_driver_register(struct fsi_driver *fsi_drv);
extern void fsi_driver_unregister(struct fsi_driver *fsi_drv);

/* module_fsi_driver() - Helper macro for drivers that don't do
 * anything special in module init/exit.  This eliminates a lot of
 * boilerplate.  Each module may only use this macro once, and
 * calling it replaces module_init() and module_exit()
 */
#define module_fsi_driver(__fsi_driver) \
		module_driver(__fsi_driver, fsi_driver_register, \
				fsi_driver_unregister)

/* direct slave API */
extern int fsi_slave_claim_range(struct fsi_slave *slave,
		uint32_t addr, uint32_t size);
extern void fsi_slave_release_range(struct fsi_slave *slave,
		uint32_t addr, uint32_t size);
extern int fsi_slave_read(struct fsi_slave *slave, uint32_t addr,
		void *val, size_t size);
extern int fsi_slave_write(struct fsi_slave *slave, uint32_t addr,
		const void *val, size_t size);

extern struct bus_type fsi_bus_type;
extern const struct device_type fsi_cdev_type;

enum fsi_dev_type {
	fsi_dev_cfam,
	fsi_dev_sbefifo,
	fsi_dev_scom,
	fsi_dev_occ
};

extern int fsi_get_new_minor(struct fsi_device *fdev, enum fsi_dev_type type,
			     dev_t *out_dev, int *out_index);
extern void fsi_free_minor(dev_t dev);

#endif /* LINUX_FSI_H */