1/****************************************************************************** 2 * 3 * This file is provided under a dual BSD/GPLv2 license. When using or 4 * redistributing this file, you may do so under either license. 5 * 6 * GPL LICENSE SUMMARY 7 * 8 * Copyright(c) 2007 - 2011 Intel Corporation. All rights reserved. 9 * 10 * This program is free software; you can redistribute it and/or modify 11 * it under the terms of version 2 of the GNU General Public License as 12 * published by the Free Software Foundation. 13 * 14 * This program is distributed in the hope that it will be useful, but 15 * WITHOUT ANY WARRANTY; without even the implied warranty of 16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 17 * General Public License for more details. 18 * 19 * You should have received a copy of the GNU General Public License 20 * along with this program; if not, write to the Free Software 21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, 22 * USA 23 * 24 * The full GNU General Public License is included in this distribution 25 * in the file called LICENSE.GPL. 26 * 27 * Contact Information: 28 * Intel Linux Wireless <ilw@linux.intel.com> 29 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 30 * 31 * BSD LICENSE 32 * 33 * Copyright(c) 2005 - 2011 Intel Corporation. All rights reserved. 34 * All rights reserved. 35 * 36 * Redistribution and use in source and binary forms, with or without 37 * modification, are permitted provided that the following conditions 38 * are met: 39 * 40 * * Redistributions of source code must retain the above copyright 41 * notice, this list of conditions and the following disclaimer. 42 * * Redistributions in binary form must reproduce the above copyright 43 * notice, this list of conditions and the following disclaimer in 44 * the documentation and/or other materials provided with the 45 * distribution. 46 * * Neither the name Intel Corporation nor the names of its 47 * contributors may be used to endorse or promote products derived 48 * from this software without specific prior written permission. 49 * 50 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 51 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 52 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 53 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 54 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 55 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 56 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 57 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 58 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 59 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 60 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 61 * 62 *****************************************************************************/ 63#ifndef __iwl_pci_h__ 64#define __iwl_pci_h__ 65 66struct iwl_bus; 67 68/** 69 * struct iwl_bus_ops - bus specific operations 70 * @get_pm_support: must returns true if the bus can go to sleep 71 * @apm_config: will be called during the config of the APM configuration 72 * @set_drv_data: set the drv_data pointer to the bus layer 73 * @get_hw_id: prints the hw_id in the provided buffer 74 * @write8: write a byte to register at offset ofs 75 * @write32: write a dword to register at offset ofs 76 * @wread32: read a dword at register at offset ofs 77 */ 78struct iwl_bus_ops { 79 bool (*get_pm_support)(struct iwl_bus *bus); 80 void (*apm_config)(struct iwl_bus *bus); 81 void (*set_drv_data)(struct iwl_bus *bus, void *drv_data); 82 void (*get_hw_id)(struct iwl_bus *bus, char buf[], int buf_len); 83 void (*write8)(struct iwl_bus *bus, u32 ofs, u8 val); 84 void (*write32)(struct iwl_bus *bus, u32 ofs, u32 val); 85 u32 (*read32)(struct iwl_bus *bus, u32 ofs); 86}; 87 88struct iwl_bus { 89 /* Common data to all buses */ 90 void *drv_data; /* driver's context */ 91 struct device *dev; 92 struct iwl_bus_ops *ops; 93 94 unsigned int irq; 95 96 /* pointer to bus specific struct */ 97 /*Ensure that this pointer will always be aligned to sizeof pointer */ 98 char bus_specific[0] __attribute__((__aligned__(sizeof(void *)))); 99}; 100 101static inline bool bus_get_pm_support(struct iwl_bus *bus) 102{ 103 return bus->ops->get_pm_support(bus); 104} 105 106static inline void bus_apm_config(struct iwl_bus *bus) 107{ 108 bus->ops->apm_config(bus); 109} 110 111static inline void bus_set_drv_data(struct iwl_bus *bus, void *drv_data) 112{ 113 bus->ops->set_drv_data(bus, drv_data); 114} 115 116static inline void bus_get_hw_id(struct iwl_bus *bus, char buf[], int buf_len) 117{ 118 bus->ops->get_hw_id(bus, buf, buf_len); 119} 120 121static inline void bus_write8(struct iwl_bus *bus, u32 ofs, u8 val) 122{ 123 bus->ops->write8(bus, ofs, val); 124} 125 126static inline void bus_write32(struct iwl_bus *bus, u32 ofs, u32 val) 127{ 128 bus->ops->write32(bus, ofs, val); 129} 130 131static inline u32 bus_read32(struct iwl_bus *bus, u32 ofs) 132{ 133 return bus->ops->read32(bus, ofs); 134} 135 136int __must_check iwl_pci_register_driver(void); 137void iwl_pci_unregister_driver(void); 138 139#endif 140