142 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			142 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*
 | 
						|
 * Intel Wireless WiMAX Connection 2400m
 | 
						|
 * SDIO-specific i2400m driver definitions
 | 
						|
 *
 | 
						|
 *
 | 
						|
 * Copyright (C) 2007-2008 Intel Corporation. All rights reserved.
 | 
						|
 *
 | 
						|
 * Redistribution and use in source and binary forms, with or without
 | 
						|
 * modification, are permitted provided that the following conditions
 | 
						|
 * are met:
 | 
						|
 *
 | 
						|
 *   * Redistributions of source code must retain the above copyright
 | 
						|
 *     notice, this list of conditions and the following disclaimer.
 | 
						|
 *   * Redistributions in binary form must reproduce the above copyright
 | 
						|
 *     notice, this list of conditions and the following disclaimer in
 | 
						|
 *     the documentation and/or other materials provided with the
 | 
						|
 *     distribution.
 | 
						|
 *   * Neither the name of Intel Corporation nor the names of its
 | 
						|
 *     contributors may be used to endorse or promote products derived
 | 
						|
 *     from this software without specific prior written permission.
 | 
						|
 *
 | 
						|
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 | 
						|
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 | 
						|
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 | 
						|
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 | 
						|
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 | 
						|
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 | 
						|
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 | 
						|
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 | 
						|
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 | 
						|
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 | 
						|
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 | 
						|
 *
 | 
						|
 *
 | 
						|
 * Intel Corporation <linux-wimax@intel.com>
 | 
						|
 * Brian Bian <brian.bian@intel.com>
 | 
						|
 * Dirk Brandewie <dirk.j.brandewie@intel.com>
 | 
						|
 * Inaky Perez-Gonzalez <inaky.perez-gonzalez@intel.com>
 | 
						|
 * Yanir Lubetkin <yanirx.lubetkin@intel.com>
 | 
						|
 *  - Initial implementation
 | 
						|
 *
 | 
						|
 *
 | 
						|
 * This driver implements the bus-specific part of the i2400m for
 | 
						|
 * SDIO. Check i2400m.h for a generic driver description.
 | 
						|
 *
 | 
						|
 * ARCHITECTURE
 | 
						|
 *
 | 
						|
 * This driver sits under the bus-generic i2400m driver, providing the
 | 
						|
 * connection to the device.
 | 
						|
 *
 | 
						|
 * When probed, all the function pointers are setup and then the
 | 
						|
 * bus-generic code called. The generic driver will then use the
 | 
						|
 * provided pointers for uploading firmware (i2400ms_bus_bm*() in
 | 
						|
 * sdio-fw.c) and then setting up the device (i2400ms_dev_*() in
 | 
						|
 * sdio.c).
 | 
						|
 *
 | 
						|
 * Once firmware is uploaded, TX functions (sdio-tx.c) are called when
 | 
						|
 * data is ready for transmission in the TX fifo; then the SDIO IRQ is
 | 
						|
 * fired and data is available (sdio-rx.c), it is sent to the generic
 | 
						|
 * driver for processing with i2400m_rx.
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef __I2400M_SDIO_H__
 | 
						|
#define __I2400M_SDIO_H__
 | 
						|
 | 
						|
#include "i2400m.h"
 | 
						|
 | 
						|
/* Host-Device interface for SDIO */
 | 
						|
enum {
 | 
						|
	I2400MS_BLK_SIZE = 256,
 | 
						|
	I2400MS_PL_SIZE_MAX = 0x3E00,
 | 
						|
 | 
						|
	I2400MS_DATA_ADDR = 0x0,
 | 
						|
	I2400MS_INTR_STATUS_ADDR = 0x13,
 | 
						|
	I2400MS_INTR_CLEAR_ADDR = 0x13,
 | 
						|
	I2400MS_INTR_ENABLE_ADDR = 0x14,
 | 
						|
	I2400MS_INTR_GET_SIZE_ADDR = 0x2C,
 | 
						|
	/* The number of ticks to wait for the device to signal that
 | 
						|
	 * it is ready */
 | 
						|
	I2400MS_INIT_SLEEP_INTERVAL = 10,
 | 
						|
	/* How long to wait for the device to settle after reset */
 | 
						|
	I2400MS_SETTLE_TIME = 40,
 | 
						|
};
 | 
						|
 | 
						|
 | 
						|
/**
 | 
						|
 * struct i2400ms - descriptor for a SDIO connected i2400m
 | 
						|
 *
 | 
						|
 * @i2400m: bus-generic i2400m implementation; has to be first (see
 | 
						|
 *     it's documentation in i2400m.h).
 | 
						|
 *
 | 
						|
 * @func: pointer to our SDIO function
 | 
						|
 *
 | 
						|
 * @tx_worker: workqueue struct used to TX data when the bus-generic
 | 
						|
 *     code signals packets are pending for transmission to the device.
 | 
						|
 *
 | 
						|
 * @tx_workqueue: workqeueue used for data TX; we don't use the
 | 
						|
 *     system's workqueue as that might cause deadlocks with code in
 | 
						|
 *     the bus-generic driver.
 | 
						|
 */
 | 
						|
struct i2400ms {
 | 
						|
	struct i2400m i2400m;		/* FIRST! See doc */
 | 
						|
	struct sdio_func *func;
 | 
						|
 | 
						|
	struct work_struct tx_worker;
 | 
						|
	struct workqueue_struct *tx_workqueue;
 | 
						|
	char tx_wq_name[32];
 | 
						|
 | 
						|
	struct dentry *debugfs_dentry;
 | 
						|
 | 
						|
	wait_queue_head_t bm_wfa_wq;
 | 
						|
	int bm_wait_result;
 | 
						|
	size_t bm_ack_size;
 | 
						|
};
 | 
						|
 | 
						|
 | 
						|
static inline
 | 
						|
void i2400ms_init(struct i2400ms *i2400ms)
 | 
						|
{
 | 
						|
	i2400m_init(&i2400ms->i2400m);
 | 
						|
}
 | 
						|
 | 
						|
 | 
						|
extern int i2400ms_rx_setup(struct i2400ms *);
 | 
						|
extern void i2400ms_rx_release(struct i2400ms *);
 | 
						|
extern ssize_t __i2400ms_rx_get_size(struct i2400ms *);
 | 
						|
 | 
						|
extern int i2400ms_tx_setup(struct i2400ms *);
 | 
						|
extern void i2400ms_tx_release(struct i2400ms *);
 | 
						|
extern void i2400ms_bus_tx_kick(struct i2400m *);
 | 
						|
 | 
						|
extern ssize_t i2400ms_bus_bm_cmd_send(struct i2400m *,
 | 
						|
				       const struct i2400m_bootrom_header *,
 | 
						|
				       size_t, int);
 | 
						|
extern ssize_t i2400ms_bus_bm_wait_for_ack(struct i2400m *,
 | 
						|
					   struct i2400m_bootrom_header *,
 | 
						|
					   size_t);
 | 
						|
extern void i2400ms_bus_bm_release(struct i2400m *);
 | 
						|
extern int i2400ms_bus_bm_setup(struct i2400m *);
 | 
						|
 | 
						|
#endif /* #ifndef __I2400M_SDIO_H__ */
 |