rapidio: add IDT CPS/TSI switches
[linux-2.6.git] / include / linux / rio.h
1 /*
2  * RapidIO interconnect services
3  * (RapidIO Interconnect Specification, http://www.rapidio.org)
4  *
5  * Copyright 2005 MontaVista Software, Inc.
6  * Matt Porter <mporter@kernel.crashing.org>
7  *
8  * This program is free software; you can redistribute  it and/or modify it
9  * under  the terms of  the GNU General  Public License as published by the
10  * Free Software Foundation;  either version 2 of the  License, or (at your
11  * option) any later version.
12  */
13
14 #ifndef LINUX_RIO_H
15 #define LINUX_RIO_H
16
17 #include <linux/types.h>
18 #include <linux/ioport.h>
19 #include <linux/list.h>
20 #include <linux/errno.h>
21 #include <linux/device.h>
22 #include <linux/rio_regs.h>
23
24 #define RIO_NO_HOPCOUNT         -1
25 #define RIO_INVALID_DESTID      0xffff
26
27 #define RIO_MAX_MPORT_RESOURCES 16
28 #define RIO_MAX_DEV_RESOURCES   16
29
30 #define RIO_GLOBAL_TABLE        0xff    /* Indicates access of a switch's
31                                            global routing table if it
32                                            has multiple (or per port)
33                                            tables */
34
35 #define RIO_INVALID_ROUTE       0xff    /* Indicates that a route table
36                                            entry is invalid (no route
37                                            exists for the device ID) */
38
39 #define RIO_MAX_ROUTE_ENTRIES(size)     (size ? (1 << 16) : (1 << 8))
40 #define RIO_ANY_DESTID(size)            (size ? 0xffff : 0xff)
41
42 #define RIO_MAX_MBOX            4
43 #define RIO_MAX_MSG_SIZE        0x1000
44
45 /*
46  * Error values that may be returned by RIO functions.
47  */
48 #define RIO_SUCCESSFUL                  0x00
49 #define RIO_BAD_SIZE                    0x81
50
51 /*
52  * For RIO devices, the region numbers are assigned this way:
53  *
54  *      0       RapidIO outbound doorbells
55  *      1-15    RapidIO memory regions
56  *
57  * For RIO master ports, the region number are assigned this way:
58  *
59  *      0       RapidIO inbound doorbells
60  *      1       RapidIO inbound mailboxes
61  *      1       RapidIO outbound mailboxes
62  */
63 #define RIO_DOORBELL_RESOURCE   0
64 #define RIO_INB_MBOX_RESOURCE   1
65 #define RIO_OUTB_MBOX_RESOURCE  2
66
67 extern struct bus_type rio_bus_type;
68 extern struct list_head rio_devices;    /* list of all devices */
69
70 struct rio_mport;
71
72 /**
73  * struct rio_dev - RIO device info
74  * @global_list: Node in list of all RIO devices
75  * @net_list: Node in list of RIO devices in a network
76  * @net: Network this device is a part of
77  * @did: Device ID
78  * @vid: Vendor ID
79  * @device_rev: Device revision
80  * @asm_did: Assembly device ID
81  * @asm_vid: Assembly vendor ID
82  * @asm_rev: Assembly revision
83  * @efptr: Extended feature pointer
84  * @pef: Processing element features
85  * @swpinfo: Switch port info
86  * @src_ops: Source operation capabilities
87  * @dst_ops: Destination operation capabilities
88  * @dma_mask: Mask of bits of RIO address this device implements
89  * @rswitch: Pointer to &struct rio_switch if valid for this device
90  * @driver: Driver claiming this device
91  * @dev: Device model device
92  * @riores: RIO resources this device owns
93  * @destid: Network destination ID
94  */
95 struct rio_dev {
96         struct list_head global_list;   /* node in list of all RIO devices */
97         struct list_head net_list;      /* node in per net list */
98         struct rio_net *net;    /* RIO net this device resides in */
99         u16 did;
100         u16 vid;
101         u32 device_rev;
102         u16 asm_did;
103         u16 asm_vid;
104         u16 asm_rev;
105         u16 efptr;
106         u32 pef;
107         u32 swpinfo;            /* Only used for switches */
108         u32 src_ops;
109         u32 dst_ops;
110         u64 dma_mask;
111         struct rio_switch *rswitch;     /* RIO switch info */
112         struct rio_driver *driver;      /* RIO driver claiming this device */
113         struct device dev;      /* LDM device structure */
114         struct resource riores[RIO_MAX_DEV_RESOURCES];
115         u16 destid;
116 };
117
118 #define rio_dev_g(n) list_entry(n, struct rio_dev, global_list)
119 #define rio_dev_f(n) list_entry(n, struct rio_dev, net_list)
120 #define to_rio_dev(n) container_of(n, struct rio_dev, dev)
121
122 /**
123  * struct rio_msg - RIO message event
124  * @res: Mailbox resource
125  * @mcback: Message event callback
126  */
127 struct rio_msg {
128         struct resource *res;
129         void (*mcback) (struct rio_mport * mport, void *dev_id, int mbox, int slot);
130 };
131
132 /**
133  * struct rio_dbell - RIO doorbell event
134  * @node: Node in list of doorbell events
135  * @res: Doorbell resource
136  * @dinb: Doorbell event callback
137  * @dev_id: Device specific pointer to pass on event
138  */
139 struct rio_dbell {
140         struct list_head node;
141         struct resource *res;
142         void (*dinb) (struct rio_mport *mport, void *dev_id, u16 src, u16 dst, u16 info);
143         void *dev_id;
144 };
145
146 enum rio_phy_type {
147         RIO_PHY_PARALLEL,
148         RIO_PHY_SERIAL,
149 };
150
151 /**
152  * struct rio_mport - RIO master port info
153  * @dbells: List of doorbell events
154  * @node: Node in global list of master ports
155  * @nnode: Node in network list of master ports
156  * @iores: I/O mem resource that this master port interface owns
157  * @riores: RIO resources that this master port interfaces owns
158  * @inb_msg: RIO inbound message event descriptors
159  * @outb_msg: RIO outbound message event descriptors
160  * @host_deviceid: Host device ID associated with this master port
161  * @ops: configuration space functions
162  * @id: Port ID, unique among all ports
163  * @index: Port index, unique among all port interfaces of the same type
164  * @sys_size: RapidIO common transport system size
165  * @phy_type: RapidIO phy type
166  * @name: Port name string
167  * @priv: Master port private data
168  */
169 struct rio_mport {
170         struct list_head dbells;        /* list of doorbell events */
171         struct list_head node;  /* node in global list of ports */
172         struct list_head nnode; /* node in net list of ports */
173         struct resource iores;
174         struct resource riores[RIO_MAX_MPORT_RESOURCES];
175         struct rio_msg inb_msg[RIO_MAX_MBOX];
176         struct rio_msg outb_msg[RIO_MAX_MBOX];
177         int host_deviceid;      /* Host device ID */
178         struct rio_ops *ops;    /* maintenance transaction functions */
179         unsigned char id;       /* port ID, unique among all ports */
180         unsigned char index;    /* port index, unique among all port
181                                    interfaces of the same type */
182         unsigned int sys_size;  /* RapidIO common transport system size.
183                                  * 0 - Small size. 256 devices.
184                                  * 1 - Large size, 65536 devices.
185                                  */
186         enum rio_phy_type phy_type;     /* RapidIO phy type */
187         unsigned char name[40];
188         void *priv;             /* Master port private data */
189 };
190
191 /**
192  * struct rio_net - RIO network info
193  * @node: Node in global list of RIO networks
194  * @devices: List of devices in this network
195  * @mports: List of master ports accessing this network
196  * @hport: Default port for accessing this network
197  * @id: RIO network ID
198  */
199 struct rio_net {
200         struct list_head node;  /* node in list of networks */
201         struct list_head devices;       /* list of devices in this net */
202         struct list_head mports;        /* list of ports accessing net */
203         struct rio_mport *hport;        /* primary port for accessing net */
204         unsigned char id;       /* RIO network ID */
205 };
206
207 /**
208  * struct rio_switch - RIO switch info
209  * @node: Node in global list of switches
210  * @switchid: Switch ID that is unique across a network
211  * @hopcount: Hopcount to this switch
212  * @destid: Associated destid in the path
213  * @route_table: Copy of switch routing table
214  * @add_entry: Callback for switch-specific route add function
215  * @get_entry: Callback for switch-specific route get function
216  * @clr_table: Callback for switch-specific clear route table function
217  */
218 struct rio_switch {
219         struct list_head node;
220         u16 switchid;
221         u16 hopcount;
222         u16 destid;
223         u8 *route_table;
224         int (*add_entry) (struct rio_mport * mport, u16 destid, u8 hopcount,
225                           u16 table, u16 route_destid, u8 route_port);
226         int (*get_entry) (struct rio_mport * mport, u16 destid, u8 hopcount,
227                           u16 table, u16 route_destid, u8 * route_port);
228         int (*clr_table) (struct rio_mport *mport, u16 destid, u8 hopcount,
229                           u16 table);
230 };
231
232 /* Low-level architecture-dependent routines */
233
234 /**
235  * struct rio_ops - Low-level RIO configuration space operations
236  * @lcread: Callback to perform local (master port) read of config space.
237  * @lcwrite: Callback to perform local (master port) write of config space.
238  * @cread: Callback to perform network read of config space.
239  * @cwrite: Callback to perform network write of config space.
240  * @dsend: Callback to send a doorbell message.
241  */
242 struct rio_ops {
243         int (*lcread) (struct rio_mport *mport, int index, u32 offset, int len,
244                         u32 *data);
245         int (*lcwrite) (struct rio_mport *mport, int index, u32 offset, int len,
246                         u32 data);
247         int (*cread) (struct rio_mport *mport, int index, u16 destid,
248                         u8 hopcount, u32 offset, int len, u32 *data);
249         int (*cwrite) (struct rio_mport *mport, int index, u16 destid,
250                         u8 hopcount, u32 offset, int len, u32 data);
251         int (*dsend) (struct rio_mport *mport, int index, u16 destid, u16 data);
252 };
253
254 #define RIO_RESOURCE_MEM        0x00000100
255 #define RIO_RESOURCE_DOORBELL   0x00000200
256 #define RIO_RESOURCE_MAILBOX    0x00000400
257
258 #define RIO_RESOURCE_CACHEABLE  0x00010000
259 #define RIO_RESOURCE_PCI        0x00020000
260
261 #define RIO_RESOURCE_BUSY       0x80000000
262
263 /**
264  * struct rio_driver - RIO driver info
265  * @node: Node in list of drivers
266  * @name: RIO driver name
267  * @id_table: RIO device ids to be associated with this driver
268  * @probe: RIO device inserted
269  * @remove: RIO device removed
270  * @suspend: RIO device suspended
271  * @resume: RIO device awakened
272  * @enable_wake: RIO device enable wake event
273  * @driver: LDM driver struct
274  *
275  * Provides info on a RIO device driver for insertion/removal and
276  * power management purposes.
277  */
278 struct rio_driver {
279         struct list_head node;
280         char *name;
281         const struct rio_device_id *id_table;
282         int (*probe) (struct rio_dev * dev, const struct rio_device_id * id);
283         void (*remove) (struct rio_dev * dev);
284         int (*suspend) (struct rio_dev * dev, u32 state);
285         int (*resume) (struct rio_dev * dev);
286         int (*enable_wake) (struct rio_dev * dev, u32 state, int enable);
287         struct device_driver driver;
288 };
289
290 #define to_rio_driver(drv) container_of(drv,struct rio_driver, driver)
291
292 /**
293  * struct rio_device_id - RIO device identifier
294  * @did: RIO device ID
295  * @vid: RIO vendor ID
296  * @asm_did: RIO assembly device ID
297  * @asm_vid: RIO assembly vendor ID
298  *
299  * Identifies a RIO device based on both the device/vendor IDs and
300  * the assembly device/vendor IDs.
301  */
302 struct rio_device_id {
303         u16 did, vid;
304         u16 asm_did, asm_vid;
305 };
306
307 /**
308  * struct rio_route_ops - Per-switch route operations
309  * @vid: RIO vendor ID
310  * @did: RIO device ID
311  * @add_hook: Callback that adds a route entry
312  * @get_hook: Callback that gets a route entry
313  * @clr_hook: Callback that clears a switch route table (may be NULL)
314  *
315  * Defines the operations that are necessary to manipulate the route
316  * tables for a particular RIO switch device.
317  */
318 struct rio_route_ops {
319         u16 vid, did;
320         int (*add_hook) (struct rio_mport * mport, u16 destid, u8 hopcount,
321                          u16 table, u16 route_destid, u8 route_port);
322         int (*get_hook) (struct rio_mport * mport, u16 destid, u8 hopcount,
323                          u16 table, u16 route_destid, u8 * route_port);
324         int (*clr_hook) (struct rio_mport *mport, u16 destid, u8 hopcount,
325                          u16 table);
326 };
327
328 /* Architecture and hardware-specific functions */
329 extern int rio_init_mports(void);
330 extern void rio_register_mport(struct rio_mport *);
331 extern int rio_hw_add_outb_message(struct rio_mport *, struct rio_dev *, int,
332                                    void *, size_t);
333 extern int rio_hw_add_inb_buffer(struct rio_mport *, int, void *);
334 extern void *rio_hw_get_inb_message(struct rio_mport *, int);
335 extern int rio_open_inb_mbox(struct rio_mport *, void *, int, int);
336 extern void rio_close_inb_mbox(struct rio_mport *, int);
337 extern int rio_open_outb_mbox(struct rio_mport *, void *, int, int);
338 extern void rio_close_outb_mbox(struct rio_mport *, int);
339
340 #endif                          /* LINUX_RIO_H */