Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  1 /*
  2  * cpcihp_generic.c
  3  *
  4  * Generic port I/O CompactPCI driver
  5  *
  6  * Copyright 2002 SOMA Networks, Inc.
  7  * Copyright 2001 Intel San Luis Obispo
  8  * Copyright 2000,2001 MontaVista Software Inc.
  9  *
 10  * This program is free software; you can redistribute it and/or modify it
 11  * under the terms of the GNU General Public License as published by the
 12  * Free Software Foundation; either version 2 of the License, or (at your
 13  * option) any later version.
 14  *
 15  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
 16  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY 
 17  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL 
 18  * THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
 19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
 20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
 21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
 22  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
 23  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
 24  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 25  *
 26  * You should have received a copy of the GNU General Public License along
 27  * with this program; if not, write to the Free Software Foundation, Inc.,
 28  * 675 Mass Ave, Cambridge, MA 02139, USA.
 29  *
 30  * This generic CompactPCI hotplug driver should allow using the PCI hotplug
 31  * mechanism on any CompactPCI board that exposes the #ENUM signal as a bit
 32  * in a system register that can be read through standard port I/O.
 33  *
 34  * Send feedback to <scottm@somanetworks.com>
 35  */
 36 
 37 #include <linux/module.h>
 38 #include <linux/init.h>
 39 #include <linux/errno.h>
 40 #include <linux/pci.h>
 41 #include <linux/string.h>
 42 #include "cpci_hotplug.h"
 43 
 44 #define DRIVER_VERSION  "0.1"
 45 #define DRIVER_AUTHOR   "Scott Murray <scottm@somanetworks.com>"
 46 #define DRIVER_DESC     "Generic port I/O CompactPCI Hot Plug Driver"
 47 
 48 #if !defined(MODULE)
 49 #define MY_NAME "cpcihp_generic"
 50 #else
 51 #define MY_NAME THIS_MODULE->name
 52 #endif
 53 
 54 #define dbg(format, arg...)                                     \
 55         do {                                                    \
 56                 if(debug)                                       \
 57                         printk (KERN_DEBUG "%s: " format "\n",  \
 58                                 MY_NAME , ## arg);              \
 59         } while(0)
 60 #define err(format, arg...) printk(KERN_ERR "%s: " format "\n", MY_NAME , ## arg)
 61 #define info(format, arg...) printk(KERN_INFO "%s: " format "\n", MY_NAME , ## arg)
 62 #define warn(format, arg...) printk(KERN_WARNING "%s: " format "\n", MY_NAME , ## arg)
 63 
 64 /* local variables */
 65 static int debug;
 66 static char *bridge;
 67 static u8 bridge_busnr;
 68 static u8 bridge_slot;
 69 static struct pci_bus *bus;
 70 static u8 first_slot;
 71 static u8 last_slot;
 72 static u16 port;
 73 static unsigned int enum_bit;
 74 static u8 enum_mask;
 75 
 76 static struct cpci_hp_controller_ops generic_hpc_ops;
 77 static struct cpci_hp_controller generic_hpc;
 78 
 79 static int __init validate_parameters(void)
 80 {
 81         char* str;
 82         char* p;
 83         unsigned long tmp;
 84 
 85         if(!bridge) {
 86                 info("not configured, disabling.");
 87                 return -EINVAL;
 88         }
 89         str = bridge;
 90         if(!*str)
 91                 return -EINVAL;
 92 
 93         tmp = simple_strtoul(str, &p, 16);
 94         if(p == str || tmp > 0xff) {
 95                 err("Invalid hotplug bus bridge device bus number");
 96                 return -EINVAL;
 97         }
 98         bridge_busnr = (u8) tmp;
 99         dbg("bridge_busnr = 0x%02x", bridge_busnr);
100         if(*p != ':') {
101                 err("Invalid hotplug bus bridge device");
102                 return -EINVAL;
103         }
104         str = p + 1;
105         tmp = simple_strtoul(str, &p, 16);
106         if(p == str || tmp > 0x1f) {
107                 err("Invalid hotplug bus bridge device slot number");
108                 return -EINVAL;
109         }
110         bridge_slot = (u8) tmp;
111         dbg("bridge_slot = 0x%02x", bridge_slot);
112 
113         dbg("first_slot = 0x%02x", first_slot);
114         dbg("last_slot = 0x%02x", last_slot);
115         if(!(first_slot && last_slot)) {
116                 err("Need to specify first_slot and last_slot");
117                 return -EINVAL;
118         }
119         if(last_slot < first_slot) {
120                 err("first_slot must be less than last_slot");
121                 return -EINVAL;
122         }
123 
124         dbg("port = 0x%04x", port);
125         dbg("enum_bit = 0x%02x", enum_bit);
126         if(enum_bit > 7) {
127                 err("Invalid #ENUM bit");
128                 return -EINVAL;
129         }
130         enum_mask = 1 << enum_bit;
131         return 0;
132 }
133 
134 static int query_enum(void)
135 {
136         u8 value;
137 
138         value = inb_p(port);
139         return ((value & enum_mask) == enum_mask);
140 }
141 
142 static int __init cpcihp_generic_init(void)
143 {
144         int status;
145         struct resource* r;
146         struct pci_dev* dev;
147 
148         info(DRIVER_DESC " version: " DRIVER_VERSION);
149         status = validate_parameters();
150         if (status)
151                 return status;
152 
153         r = request_region(port, 1, "#ENUM hotswap signal register");
154         if(!r)
155                 return -EBUSY;
156 
157         dev = pci_find_slot(bridge_busnr, PCI_DEVFN(bridge_slot, 0));
158         if(!dev || dev->hdr_type != PCI_HEADER_TYPE_BRIDGE) {
159                 err("Invalid bridge device %s", bridge);
160                 return -EINVAL;
161         }
162         bus = dev->subordinate;
163 
164         memset(&generic_hpc, 0, sizeof (struct cpci_hp_controller));
165         generic_hpc_ops.query_enum = query_enum;
166         generic_hpc.ops = &generic_hpc_ops;
167 
168         status = cpci_hp_register_controller(&generic_hpc);
169         if(status != 0) {
170                 err("Could not register cPCI hotplug controller");
171                 return -ENODEV;
172         }
173         dbg("registered controller");
174 
175         status = cpci_hp_register_bus(bus, first_slot, last_slot);
176         if(status != 0) {
177                 err("Could not register cPCI hotplug bus");
178                 goto init_bus_register_error;
179         }
180         dbg("registered bus");
181 
182         status = cpci_hp_start();
183         if(status != 0) {
184                 err("Could not started cPCI hotplug system");
185                 goto init_start_error;
186         }
187         dbg("started cpci hp system");
188         return 0;
189 init_start_error:
190         cpci_hp_unregister_bus(bus);
191 init_bus_register_error:
192         cpci_hp_unregister_controller(&generic_hpc);
193         err("status = %d", status);
194         return status;
195 
196 }
197 
198 static void __exit cpcihp_generic_exit(void)
199 {
200         cpci_hp_stop();
201         cpci_hp_unregister_bus(bus);
202         cpci_hp_unregister_controller(&generic_hpc);
203         release_region(port, 1);
204 }
205 
206 module_init(cpcihp_generic_init);
207 module_exit(cpcihp_generic_exit);
208 
209 MODULE_AUTHOR(DRIVER_AUTHOR);
210 MODULE_DESCRIPTION(DRIVER_DESC);
211 MODULE_LICENSE("GPL");
212 module_param(debug, bool, S_IRUGO | S_IWUSR);
213 MODULE_PARM_DESC(debug, "Debugging mode enabled or not");
214 module_param(bridge, charp, 0);
215 MODULE_PARM_DESC(bridge, "Hotswap bus bridge device, <bus>:<slot> (bus and slot are in hexadecimal)");
216 module_param(first_slot, byte, 0);
217 MODULE_PARM_DESC(first_slot, "Hotswap bus first slot number");
218 module_param(last_slot, byte, 0);
219 MODULE_PARM_DESC(last_slot, "Hotswap bus last slot number");
220 module_param(port, ushort, 0);
221 MODULE_PARM_DESC(port, "#ENUM signal I/O port");
222 module_param(enum_bit, uint, 0);
223 MODULE_PARM_DESC(enum_bit, "#ENUM signal bit (0-7)");
224 
  This page was automatically generated by the LXR engine.