Commit | Line | Data |
---|---|---|
c781c06d | 1 | /* |
19a15b93 KH |
2 | * Copyright (C) 2005-2006 Kristian Hoegsberg <krh@bitplanet.net> |
3 | * | |
4 | * This program is free software; you can redistribute it and/or modify | |
5 | * it under the terms of the GNU General Public License as published by | |
6 | * the Free Software Foundation; either version 2 of the License, or | |
7 | * (at your option) any later version. | |
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 | * You should have received a copy of the GNU General Public License | |
15 | * along with this program; if not, write to the Free Software Foundation, | |
16 | * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. | |
17 | */ | |
18 | ||
19 | #ifndef __fw_device_h | |
20 | #define __fw_device_h | |
21 | ||
22 | #include <linux/fs.h> | |
23 | #include <linux/cdev.h> | |
c9755e14 | 24 | #include <linux/rwsem.h> |
641f8791 | 25 | #include <asm/atomic.h> |
19a15b93 KH |
26 | |
27 | enum fw_device_state { | |
28 | FW_DEVICE_INITIALIZING, | |
29 | FW_DEVICE_RUNNING, | |
5af4e5ea | 30 | FW_DEVICE_SHUTDOWN, |
19a15b93 KH |
31 | }; |
32 | ||
6f2e53d5 KH |
33 | struct fw_attribute_group { |
34 | struct attribute_group *groups[2]; | |
35 | struct attribute_group group; | |
36 | struct attribute *attrs[11]; | |
37 | }; | |
38 | ||
b5d2a5e0 SR |
39 | /* |
40 | * Note, fw_device.generation always has to be read before fw_device.node_id. | |
41 | * Use SMP memory barriers to ensure this. Otherwise requests will be sent | |
42 | * to an outdated node_id if the generation was updated in the meantime due | |
43 | * to a bus reset. | |
44 | * | |
45 | * Likewise, fw-core will take care to update .node_id before .generation so | |
46 | * that whenever fw_device.generation is current WRT the actual bus generation, | |
47 | * fw_device.node_id is guaranteed to be current too. | |
48 | * | |
49 | * The same applies to fw_device.card->node_id vs. fw_device.generation. | |
c9755e14 SR |
50 | * |
51 | * fw_device.config_rom and fw_device.config_rom_length may be accessed during | |
52 | * the lifetime of any fw_unit belonging to the fw_device, before device_del() | |
53 | * was called on the last fw_unit. Alternatively, they may be accessed while | |
54 | * holding fw_device_rwsem. | |
b5d2a5e0 | 55 | */ |
19a15b93 | 56 | struct fw_device { |
641f8791 | 57 | atomic_t state; |
19a15b93 KH |
58 | struct fw_node *node; |
59 | int node_id; | |
60 | int generation; | |
f1397490 | 61 | unsigned max_speed; |
c9755e14 | 62 | bool cmc; |
19a15b93 KH |
63 | struct fw_card *card; |
64 | struct device device; | |
97bd9efa | 65 | struct list_head client_list; |
945ac222 | 66 | u32 *config_rom; |
19a15b93 KH |
67 | size_t config_rom_length; |
68 | int config_rom_retries; | |
69 | struct delayed_work work; | |
6f2e53d5 | 70 | struct fw_attribute_group attribute_group; |
19a15b93 KH |
71 | }; |
72 | ||
1dc3bea7 | 73 | static inline struct fw_device *fw_device(struct device *dev) |
19a15b93 | 74 | { |
5e20c282 | 75 | return container_of(dev, struct fw_device, device); |
19a15b93 KH |
76 | } |
77 | ||
1dc3bea7 | 78 | static inline int fw_device_is_shutdown(struct fw_device *device) |
2603bf21 KH |
79 | { |
80 | return atomic_read(&device->state) == FW_DEVICE_SHUTDOWN; | |
81 | } | |
82 | ||
1dc3bea7 | 83 | static inline struct fw_device *fw_device_get(struct fw_device *device) |
855c603d SR |
84 | { |
85 | get_device(&device->device); | |
86 | ||
87 | return device; | |
88 | } | |
89 | ||
1dc3bea7 | 90 | static inline void fw_device_put(struct fw_device *device) |
855c603d SR |
91 | { |
92 | put_device(&device->device); | |
93 | } | |
94 | ||
96b19062 | 95 | struct fw_device *fw_device_get_by_devt(dev_t devt); |
19a15b93 KH |
96 | int fw_device_enable_phys_dma(struct fw_device *device); |
97 | ||
97bd9efa | 98 | void fw_device_cdev_update(struct fw_device *device); |
2603bf21 | 99 | void fw_device_cdev_remove(struct fw_device *device); |
97bd9efa | 100 | |
c9755e14 | 101 | extern struct rw_semaphore fw_device_rwsem; |
a3aca3da KH |
102 | extern int fw_cdev_major; |
103 | ||
c9755e14 SR |
104 | /* |
105 | * fw_unit.directory must not be accessed after device_del(&fw_unit.device). | |
106 | */ | |
19a15b93 KH |
107 | struct fw_unit { |
108 | struct device device; | |
109 | u32 *directory; | |
6f2e53d5 | 110 | struct fw_attribute_group attribute_group; |
19a15b93 KH |
111 | }; |
112 | ||
1dc3bea7 | 113 | static inline struct fw_unit *fw_unit(struct device *dev) |
19a15b93 | 114 | { |
5e20c282 | 115 | return container_of(dev, struct fw_unit, device); |
19a15b93 KH |
116 | } |
117 | ||
1dc3bea7 SR |
118 | static inline struct fw_unit *fw_unit_get(struct fw_unit *unit) |
119 | { | |
120 | get_device(&unit->device); | |
121 | ||
122 | return unit; | |
123 | } | |
124 | ||
125 | static inline void fw_unit_put(struct fw_unit *unit) | |
126 | { | |
127 | put_device(&unit->device); | |
128 | } | |
129 | ||
19a15b93 KH |
130 | #define CSR_OFFSET 0x40 |
131 | #define CSR_LEAF 0x80 | |
132 | #define CSR_DIRECTORY 0xc0 | |
133 | ||
134 | #define CSR_DESCRIPTOR 0x01 | |
135 | #define CSR_VENDOR 0x03 | |
136 | #define CSR_HARDWARE_VERSION 0x04 | |
137 | #define CSR_NODE_CAPABILITIES 0x0c | |
138 | #define CSR_UNIT 0x11 | |
139 | #define CSR_SPECIFIER_ID 0x12 | |
140 | #define CSR_VERSION 0x13 | |
141 | #define CSR_DEPENDENT_INFO 0x14 | |
142 | #define CSR_MODEL 0x17 | |
143 | #define CSR_INSTANCE 0x18 | |
14e21986 | 144 | #define CSR_DIRECTORY_ID 0x20 |
19a15b93 | 145 | |
19a15b93 KH |
146 | struct fw_csr_iterator { |
147 | u32 *p; | |
148 | u32 *end; | |
149 | }; | |
150 | ||
151 | void fw_csr_iterator_init(struct fw_csr_iterator *ci, u32 *p); | |
152 | int fw_csr_iterator_next(struct fw_csr_iterator *ci, | |
153 | int *key, int *value); | |
154 | ||
155 | #define FW_MATCH_VENDOR 0x0001 | |
156 | #define FW_MATCH_MODEL 0x0002 | |
157 | #define FW_MATCH_SPECIFIER_ID 0x0004 | |
158 | #define FW_MATCH_VERSION 0x0008 | |
159 | ||
160 | struct fw_device_id { | |
161 | u32 match_flags; | |
162 | u32 vendor; | |
163 | u32 model; | |
164 | u32 specifier_id; | |
165 | u32 version; | |
166 | void *driver_data; | |
167 | }; | |
168 | ||
169 | struct fw_driver { | |
170 | struct device_driver driver; | |
171 | /* Called when the parent device sits through a bus reset. */ | |
172 | void (*update) (struct fw_unit *unit); | |
21ebcd12 | 173 | const struct fw_device_id *id_table; |
19a15b93 KH |
174 | }; |
175 | ||
176 | static inline struct fw_driver * | |
177 | fw_driver(struct device_driver *drv) | |
178 | { | |
5e20c282 | 179 | return container_of(drv, struct fw_driver, driver); |
19a15b93 KH |
180 | } |
181 | ||
21ebcd12 | 182 | extern const struct file_operations fw_device_ops; |
19a15b93 | 183 | |
687198bb | 184 | #endif /* __fw_device_h */ |