1 | /* |
2 | * Allwinner Reduced Serial Bus Driver |
3 | * |
4 | * Copyright (c) 2015 Chen-Yu Tsai |
5 | * |
6 | * Author: Chen-Yu Tsai <wens@csie.org> |
7 | * |
8 | * This file is licensed under the terms of the GNU General Public |
9 | * License version 2. This program is licensed "as is" without any |
10 | * warranty of any kind, whether express or implied. |
11 | */ |
12 | #ifndef _SUNXI_RSB_H |
13 | #define _SUNXI_RSB_H |
14 | |
15 | #include <linux/device.h> |
16 | #include <linux/regmap.h> |
17 | #include <linux/types.h> |
18 | |
19 | struct sunxi_rsb; |
20 | |
21 | /** |
22 | * struct sunxi_rsb_device - Basic representation of an RSB device |
23 | * @dev: Driver model representation of the device. |
24 | * @ctrl: RSB controller managing the bus hosting this device. |
25 | * @rtaddr: This device's runtime address |
26 | * @hwaddr: This device's hardware address |
27 | */ |
28 | struct sunxi_rsb_device { |
29 | struct device dev; |
30 | struct sunxi_rsb *rsb; |
31 | int irq; |
32 | u8 rtaddr; |
33 | u16 hwaddr; |
34 | }; |
35 | |
36 | static inline struct sunxi_rsb_device *to_sunxi_rsb_device(struct device *d) |
37 | { |
38 | return container_of(d, struct sunxi_rsb_device, dev); |
39 | } |
40 | |
41 | static inline void *sunxi_rsb_device_get_drvdata(const struct sunxi_rsb_device *rdev) |
42 | { |
43 | return dev_get_drvdata(dev: &rdev->dev); |
44 | } |
45 | |
46 | static inline void sunxi_rsb_device_set_drvdata(struct sunxi_rsb_device *rdev, |
47 | void *data) |
48 | { |
49 | dev_set_drvdata(dev: &rdev->dev, data); |
50 | } |
51 | |
52 | /** |
53 | * struct sunxi_rsb_driver - RSB slave device driver |
54 | * @driver: RSB device drivers should initialize name and owner field of |
55 | * this structure. |
56 | * @probe: binds this driver to a RSB device. |
57 | * @remove: unbinds this driver from the RSB device. |
58 | */ |
59 | struct sunxi_rsb_driver { |
60 | struct device_driver driver; |
61 | int (*probe)(struct sunxi_rsb_device *rdev); |
62 | void (*remove)(struct sunxi_rsb_device *rdev); |
63 | }; |
64 | |
65 | static inline struct sunxi_rsb_driver *to_sunxi_rsb_driver(struct device_driver *d) |
66 | { |
67 | return container_of(d, struct sunxi_rsb_driver, driver); |
68 | } |
69 | |
70 | int sunxi_rsb_driver_register(struct sunxi_rsb_driver *rdrv); |
71 | |
72 | /** |
73 | * sunxi_rsb_driver_unregister() - unregister an RSB client driver |
74 | * @rdrv: the driver to unregister |
75 | */ |
76 | static inline void sunxi_rsb_driver_unregister(struct sunxi_rsb_driver *rdrv) |
77 | { |
78 | if (rdrv) |
79 | driver_unregister(drv: &rdrv->driver); |
80 | } |
81 | |
82 | #define module_sunxi_rsb_driver(__sunxi_rsb_driver) \ |
83 | module_driver(__sunxi_rsb_driver, sunxi_rsb_driver_register, \ |
84 | sunxi_rsb_driver_unregister) |
85 | |
86 | struct regmap *__devm_regmap_init_sunxi_rsb(struct sunxi_rsb_device *rdev, |
87 | const struct regmap_config *config, |
88 | struct lock_class_key *lock_key, |
89 | const char *lock_name); |
90 | |
91 | /** |
92 | * devm_regmap_init_sunxi_rsb(): Initialise managed register map |
93 | * |
94 | * @rdev: Device that will be interacted with |
95 | * @config: Configuration for register map |
96 | * |
97 | * The return value will be an ERR_PTR() on error or a valid pointer |
98 | * to a struct regmap. The regmap will be automatically freed by the |
99 | * device management code. |
100 | */ |
101 | #define devm_regmap_init_sunxi_rsb(rdev, config) \ |
102 | __regmap_lockdep_wrapper(__devm_regmap_init_sunxi_rsb, #config, \ |
103 | rdev, config) |
104 | |
105 | #endif /* _SUNXI_RSB_H */ |
106 | |