[deliverable/linux.git] / drivers / net / wireless / iwlwifi / iwl-testmode.h

/******************************************************************************
 *
 * This file is provided under a dual BSD/GPLv2 license.  When using or
 * redistributing this file, you may do so under either license.
 *
 * GPL LICENSE SUMMARY
 *
 * Copyright(c) 2010 - 2012 Intel Corporation. All rights reserved.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
 * USA
 *
 * The full GNU General Public License is included in this distribution
 * in the file called LICENSE.GPL.
 *
 * Contact Information:
 *  Intel Linux Wireless <ilw@linux.intel.com>
 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
 *
 * BSD LICENSE
 *
 * Copyright(c) 2010 - 2012 Intel Corporation. All rights reserved.
 * 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 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.
 *
 *****************************************************************************/
#ifndef __IWL_TESTMODE_H__
#define __IWL_TESTMODE_H__

#include <linux/types.h>


/*
 * Commands from user space to kernel space(IWL_TM_CMD_ID_APP2DEV_XX) and
 * from and kernel space to user space(IWL_TM_CMD_ID_DEV2APP_XX).
 * The command ID is carried with IWL_TM_ATTR_COMMAND.
 *
 * @IWL_TM_CMD_APP2DEV_UCODE:
 *	commands from user application to the uCode,
 *	the actual uCode host command ID is carried with
 *	IWL_TM_ATTR_UCODE_CMD_ID
 *
 * @IWL_TM_CMD_APP2DEV_DIRECT_REG_READ32:
 * @IWL_TM_CMD_APP2DEV_DIRECT_REG_WRITE32:
 * @IWL_TM_CMD_APP2DEV_DIRECT_REG_WRITE8:
 *	commands from user applicaiton to access register
 *
 * @IWL_TM_CMD_APP2DEV_GET_DEVICENAME: retrieve device name
 * @IWL_TM_CMD_APP2DEV_LOAD_INIT_FW: load initial uCode image
 * @IWL_TM_CMD_APP2DEV_CFG_INIT_CALIB: perform calibration
 * @IWL_TM_CMD_APP2DEV_LOAD_RUNTIME_FW: load runtime uCode image
 * @IWL_TM_CMD_APP2DEV_GET_EEPROM: request EEPROM data
 * @IWL_TM_CMD_APP2DEV_FIXRATE_REQ: set fix MCS
 *	commands fom user space for pure driver level operations
 *
 * @IWL_TM_CMD_APP2DEV_BEGIN_TRACE:
 * @IWL_TM_CMD_APP2DEV_END_TRACE:
 * @IWL_TM_CMD_APP2DEV_READ_TRACE:
 *	commands fom user space for uCode trace operations
 *
 * @IWL_TM_CMD_DEV2APP_SYNC_RSP:
 *	commands from kernel space to carry the synchronous response
 *	to user application
 * @IWL_TM_CMD_DEV2APP_UCODE_RX_PKT:
 *	commands from kernel space to multicast the spontaneous messages
 *	to user application
 * @IWL_TM_CMD_DEV2APP_EEPROM_RSP:
 *	commands from kernel space to carry the eeprom response
 *	to user application
 *
 * @IWL_TM_CMD_APP2DEV_OWNERSHIP:
 *	commands from user application to own change the ownership of the uCode
 *	if application has the ownership, the only host command from
 *	testmode will deliver to uCode. Default owner is driver
 *
 * @IWL_TM_CMD_APP2DEV_LOAD_WOWLAN_FW: load Wake On Wireless LAN uCode image
 * @IWL_TM_CMD_APP2DEV_GET_FW_VERSION: retrieve uCode version
 * @IWL_TM_CMD_APP2DEV_GET_DEVICE_ID: retrieve ID information in device
 * @IWL_TM_CMD_APP2DEV_GET_FW_INFO:
 *	retrieve information of existing loaded uCode image
 *
 * @IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_READ:
 * @IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_DUMP:
 * @IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_WRITE:
 *	Commands to read/write data from periphery or SRAM memory ranges.
 *	Fore reading, a READ command is sent from the userspace and the data
 *	is returned when the user calls a DUMP command.
 *	For writing, only a WRITE command is used.
 */
enum iwl_tm_cmd_t {
	IWL_TM_CMD_APP2DEV_UCODE		= 1,
	IWL_TM_CMD_APP2DEV_DIRECT_REG_READ32	= 2,
	IWL_TM_CMD_APP2DEV_DIRECT_REG_WRITE32	= 3,
	IWL_TM_CMD_APP2DEV_DIRECT_REG_WRITE8	= 4,
	IWL_TM_CMD_APP2DEV_GET_DEVICENAME	= 5,
	IWL_TM_CMD_APP2DEV_LOAD_INIT_FW		= 6,
	IWL_TM_CMD_APP2DEV_CFG_INIT_CALIB	= 7,
	IWL_TM_CMD_APP2DEV_LOAD_RUNTIME_FW	= 8,
	IWL_TM_CMD_APP2DEV_GET_EEPROM		= 9,
	IWL_TM_CMD_APP2DEV_FIXRATE_REQ		= 10,
	IWL_TM_CMD_APP2DEV_BEGIN_TRACE		= 11,
	IWL_TM_CMD_APP2DEV_END_TRACE		= 12,
	IWL_TM_CMD_APP2DEV_READ_TRACE		= 13,
	IWL_TM_CMD_DEV2APP_SYNC_RSP		= 14,
	IWL_TM_CMD_DEV2APP_UCODE_RX_PKT		= 15,
	IWL_TM_CMD_DEV2APP_EEPROM_RSP		= 16,
	IWL_TM_CMD_APP2DEV_OWNERSHIP		= 17,
	RESERVED_18				= 18,
	RESERVED_19				= 19,
	RESERVED_20				= 20,
	RESERVED_21				= 21,
	IWL_TM_CMD_APP2DEV_LOAD_WOWLAN_FW	= 22,
	IWL_TM_CMD_APP2DEV_GET_FW_VERSION	= 23,
	IWL_TM_CMD_APP2DEV_GET_DEVICE_ID	= 24,
	IWL_TM_CMD_APP2DEV_GET_FW_INFO		= 25,
	IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_READ = 26,
	IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_DUMP = 27,
	IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_WRITE = 28,
	IWL_TM_CMD_MAX				= 29,
};

/*
 * Atrribute filed in testmode command
 * See enum iwl_tm_cmd_t.
 *
 * @IWL_TM_ATTR_NOT_APPLICABLE:
 *	The attribute is not applicable or invalid
 * @IWL_TM_ATTR_COMMAND:
 *	From user space to kernel space:
 *	the command either destines to ucode, driver, or register;
 *	From kernel space to user space:
 *	the command either carries synchronous response,
 *	or the spontaneous message multicast from the device;
 *
 * @IWL_TM_ATTR_UCODE_CMD_ID:
 * @IWL_TM_ATTR_UCODE_CMD_DATA:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_UCODE,
 *	The mandatory fields are :
 *	IWL_TM_ATTR_UCODE_CMD_ID for recognizable command ID;
 *	IWL_TM_ATTR_COMMAND_FLAG for the flags of the commands;
 *	The optional fields are:
 *	IWL_TM_ATTR_UCODE_CMD_DATA for the actual command payload
 *	to the ucode
 *
 * @IWL_TM_ATTR_REG_OFFSET:
 * @IWL_TM_ATTR_REG_VALUE8:
 * @IWL_TM_ATTR_REG_VALUE32:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_REG_XXX,
 *	The mandatory fields are:
 *	IWL_TM_ATTR_REG_OFFSET for the offset of the target register;
 *	IWL_TM_ATTR_REG_VALUE8 or IWL_TM_ATTR_REG_VALUE32 for value
 *
 * @IWL_TM_ATTR_SYNC_RSP:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_DEV2APP_SYNC_RSP,
 *	The mandatory fields are:
 *	IWL_TM_ATTR_SYNC_RSP for the data content responding to the user
 *	application command
 *
 * @IWL_TM_ATTR_UCODE_RX_PKT:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_DEV2APP_UCODE_RX_PKT,
 *	The mandatory fields are:
 *	IWL_TM_ATTR_UCODE_RX_PKT for the data content multicast to the user
 *	application
 *
 * @IWL_TM_ATTR_EEPROM:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_DEV2APP_EEPROM,
 *	The mandatory fields are:
 *	IWL_TM_ATTR_EEPROM for the data content responging to the user
 *	application
 *
 * @IWL_TM_ATTR_TRACE_ADDR:
 * @IWL_TM_ATTR_TRACE_SIZE:
 * @IWL_TM_ATTR_TRACE_DUMP:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_XXX_TRACE,
 *	The mandatory fields are:
 *	IWL_TM_ATTR_MEM_TRACE_ADDR for the trace address
 *	IWL_TM_ATTR_MEM_TRACE_SIZE for the trace buffer size
 *	IWL_TM_ATTR_MEM_TRACE_DUMP for the trace dump
 *
 * @IWL_TM_ATTR_FIXRATE:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_FIXRATE_REQ,
 *	The mandatory fields are:
 *	IWL_TM_ATTR_FIXRATE for the fixed rate
 *
 * @IWL_TM_ATTR_UCODE_OWNER:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_OWNERSHIP,
 *	The mandatory fields are:
 *	IWL_TM_ATTR_UCODE_OWNER for the new owner
 *
 * @IWL_TM_ATTR_MEM_ADDR:
 * @IWL_TM_ATTR_BUFFER_SIZE:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_READ
 *	or IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_WRITE.
 *	The mandatory fields are:
 *	IWL_TM_ATTR_MEM_ADDR for the address in SRAM/periphery to read/write
 *	IWL_TM_ATTR_BUFFER_SIZE for the buffer size of data to read/write.
 *
 * @IWL_TM_ATTR_BUFFER_DUMP:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_DUMP,
 *	IWL_TM_ATTR_BUFFER_DUMP is used for the data that was read.
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_WRITE,
 *	this attribute contains the data to write.
 *
 * @IWL_TM_ATTR_FW_VERSION:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_GET_FW_VERSION,
 *	IWL_TM_ATTR_FW_VERSION for the uCode version
 *
 * @IWL_TM_ATTR_DEVICE_ID:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_GET_DEVICE_ID,
 *	IWL_TM_ATTR_DEVICE_ID for the device ID information
 *
 * @IWL_TM_ATTR_FW_TYPE:
 * @IWL_TM_ATTR_FW_INST_SIZE:
 * @IWL_TM_ATTR_FW_DATA_SIZE:
 *	When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_GET_FW_INFO,
 *	The mandatory fields are:
 *	IWL_TM_ATTR_FW_TYPE for the uCode type (INIT/RUNTIME/...)
 *	IWL_TM_ATTR_FW_INST_SIZE for the size of instruction section
 *	IWL_TM_ATTR_FW_DATA_SIZE for the size of data section
 *
 */
enum iwl_tm_attr_t {
	IWL_TM_ATTR_NOT_APPLICABLE		= 0,
	IWL_TM_ATTR_COMMAND			= 1,
	IWL_TM_ATTR_UCODE_CMD_ID		= 2,
	IWL_TM_ATTR_UCODE_CMD_DATA		= 3,
	IWL_TM_ATTR_REG_OFFSET			= 4,
	IWL_TM_ATTR_REG_VALUE8			= 5,
	IWL_TM_ATTR_REG_VALUE32			= 6,
	IWL_TM_ATTR_SYNC_RSP			= 7,
	IWL_TM_ATTR_UCODE_RX_PKT		= 8,
	IWL_TM_ATTR_EEPROM			= 9,
	IWL_TM_ATTR_TRACE_ADDR			= 10,
	IWL_TM_ATTR_TRACE_SIZE			= 11,
	IWL_TM_ATTR_TRACE_DUMP			= 12,
	IWL_TM_ATTR_FIXRATE			= 13,
	IWL_TM_ATTR_UCODE_OWNER			= 14,
	IWL_TM_ATTR_MEM_ADDR			= 15,
	IWL_TM_ATTR_BUFFER_SIZE			= 16,
	IWL_TM_ATTR_BUFFER_DUMP			= 17,
	IWL_TM_ATTR_FW_VERSION			= 18,
	IWL_TM_ATTR_DEVICE_ID			= 19,
	IWL_TM_ATTR_FW_TYPE			= 20,
	IWL_TM_ATTR_FW_INST_SIZE		= 21,
	IWL_TM_ATTR_FW_DATA_SIZE		= 22,
	IWL_TM_ATTR_MAX				= 23,
};

/* uCode trace buffer */
#define TRACE_BUFF_SIZE_MAX	0x200000
#define TRACE_BUFF_SIZE_MIN	0x20000
#define TRACE_BUFF_SIZE_DEF	TRACE_BUFF_SIZE_MIN
#define TRACE_BUFF_PADD		0x2000

/* Maximum data size of each dump it packet */
#define DUMP_CHUNK_SIZE		(PAGE_SIZE - 1024)

/* Address offset of data segment in SRAM */
#define SRAM_DATA_SEG_OFFSET   0x800000

#endif
Commit	Line	Data
4613e72d CK	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	*
fb4961db	8	* Copyright(c) 2010 - 2012 Intel Corporation. All rights reserved.
4613e72d CK	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	*
fb4961db	33	* Copyright(c) 2010 - 2012 Intel Corporation. All rights reserved.
4613e72d CK	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_TESTMODE_H__
	64	#define __IWL_TESTMODE_H__
	65
	66	#include <linux/types.h>
	67
	68
4466320f WYG	69	/*
4466320f WYG	70	* Commands from user space to kernel space(IWL_TM_CMD_ID_APP2DEV_XX) and
4613e72d	71	* from and kernel space to user space(IWL_TM_CMD_ID_DEV2APP_XX).
4466320f WYG	72	* The command ID is carried with IWL_TM_ATTR_COMMAND.
	73	*
	74	* @IWL_TM_CMD_APP2DEV_UCODE:
	75	* commands from user application to the uCode,
	76	* the actual uCode host command ID is carried with
	77	* IWL_TM_ATTR_UCODE_CMD_ID
	78	*
72bcacc2 HK	79	* @IWL_TM_CMD_APP2DEV_DIRECT_REG_READ32:
	80	* @IWL_TM_CMD_APP2DEV_DIRECT_REG_WRITE32:
	81	* @IWL_TM_CMD_APP2DEV_DIRECT_REG_WRITE8:
4466320f WYG	82	* commands from user applicaiton to access register
	83	*
	84	* @IWL_TM_CMD_APP2DEV_GET_DEVICENAME: retrieve device name
	85	* @IWL_TM_CMD_APP2DEV_LOAD_INIT_FW: load initial uCode image
	86	* @IWL_TM_CMD_APP2DEV_CFG_INIT_CALIB: perform calibration
	87	* @IWL_TM_CMD_APP2DEV_LOAD_RUNTIME_FW: load runtime uCode image
	88	* @IWL_TM_CMD_APP2DEV_GET_EEPROM: request EEPROM data
	89	* @IWL_TM_CMD_APP2DEV_FIXRATE_REQ: set fix MCS
	90	* commands fom user space for pure driver level operations
	91	*
	92	* @IWL_TM_CMD_APP2DEV_BEGIN_TRACE:
	93	* @IWL_TM_CMD_APP2DEV_END_TRACE:
	94	* @IWL_TM_CMD_APP2DEV_READ_TRACE:
	95	* commands fom user space for uCode trace operations
	96	*
	97	* @IWL_TM_CMD_DEV2APP_SYNC_RSP:
	98	* commands from kernel space to carry the synchronous response
	99	* to user application
	100	* @IWL_TM_CMD_DEV2APP_UCODE_RX_PKT:
	101	* commands from kernel space to multicast the spontaneous messages
	102	* to user application
	103	* @IWL_TM_CMD_DEV2APP_EEPROM_RSP:
	104	* commands from kernel space to carry the eeprom response
	105	* to user application
306713fd	106	*
e98a1939 WYG	107	* @IWL_TM_CMD_APP2DEV_OWNERSHIP:
	108	* commands from user application to own change the ownership of the uCode
	109	* if application has the ownership, the only host command from
	110	* testmode will deliver to uCode. Default owner is driver
306713fd	111	*
0a79bb57	112	* @IWL_TM_CMD_APP2DEV_LOAD_WOWLAN_FW: load Wake On Wireless LAN uCode image
e1a38fe1	113	* @IWL_TM_CMD_APP2DEV_GET_FW_VERSION: retrieve uCode version
0bec12b8	114	* @IWL_TM_CMD_APP2DEV_GET_DEVICE_ID: retrieve ID information in device
668bd6a8	115	* @IWL_TM_CMD_APP2DEV_GET_FW_INFO:
0a79bb57	116	* retrieve information of existing loaded uCode image
d4af19fe	117	*
6c55f5ed AB	118	* @IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_READ:
	119	* @IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_DUMP:
	120	* @IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_WRITE:
	121	* Commands to read/write data from periphery or SRAM memory ranges.
	122	* Fore reading, a READ command is sent from the userspace and the data
	123	* is returned when the user calls a DUMP command.
	124	* For writing, only a WRITE command is used.
4613e72d CK	125	*/
4613e72d CK	126	enum iwl_tm_cmd_t {
4466320f	127	IWL_TM_CMD_APP2DEV_UCODE = 1,
72bcacc2 HK	128	IWL_TM_CMD_APP2DEV_DIRECT_REG_READ32 = 2,
	129	IWL_TM_CMD_APP2DEV_DIRECT_REG_WRITE32 = 3,
	130	IWL_TM_CMD_APP2DEV_DIRECT_REG_WRITE8 = 4,
4466320f WYG	131	IWL_TM_CMD_APP2DEV_GET_DEVICENAME = 5,
	132	IWL_TM_CMD_APP2DEV_LOAD_INIT_FW = 6,
	133	IWL_TM_CMD_APP2DEV_CFG_INIT_CALIB = 7,
	134	IWL_TM_CMD_APP2DEV_LOAD_RUNTIME_FW = 8,
	135	IWL_TM_CMD_APP2DEV_GET_EEPROM = 9,
	136	IWL_TM_CMD_APP2DEV_FIXRATE_REQ = 10,
	137	IWL_TM_CMD_APP2DEV_BEGIN_TRACE = 11,
	138	IWL_TM_CMD_APP2DEV_END_TRACE = 12,
	139	IWL_TM_CMD_APP2DEV_READ_TRACE = 13,
	140	IWL_TM_CMD_DEV2APP_SYNC_RSP = 14,
	141	IWL_TM_CMD_DEV2APP_UCODE_RX_PKT = 15,
	142	IWL_TM_CMD_DEV2APP_EEPROM_RSP = 16,
e98a1939	143	IWL_TM_CMD_APP2DEV_OWNERSHIP = 17,
6c55f5ed AB	144	RESERVED_18 = 18,
	145	RESERVED_19 = 19,
	146	RESERVED_20 = 20,
	147	RESERVED_21 = 21,
d4af19fe	148	IWL_TM_CMD_APP2DEV_LOAD_WOWLAN_FW = 22,
e1a38fe1	149	IWL_TM_CMD_APP2DEV_GET_FW_VERSION = 23,
0bec12b8	150	IWL_TM_CMD_APP2DEV_GET_DEVICE_ID = 24,
668bd6a8	151	IWL_TM_CMD_APP2DEV_GET_FW_INFO = 25,
6c55f5ed AB	152	IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_READ = 26,
	153	IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_DUMP = 27,
	154	IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_WRITE = 28,
	155	IWL_TM_CMD_MAX = 29,
4613e72d CK	156	};
4613e72d CK	157
4466320f WYG	158	/*
	159	* Atrribute filed in testmode command
	160	* See enum iwl_tm_cmd_t.
	161	*
	162	* @IWL_TM_ATTR_NOT_APPLICABLE:
	163	* The attribute is not applicable or invalid
	164	* @IWL_TM_ATTR_COMMAND:
	165	* From user space to kernel space:
	166	* the command either destines to ucode, driver, or register;
	167	* From kernel space to user space:
	168	* the command either carries synchronous response,
	169	* or the spontaneous message multicast from the device;
	170	*
	171	* @IWL_TM_ATTR_UCODE_CMD_ID:
	172	* @IWL_TM_ATTR_UCODE_CMD_DATA:
	173	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_UCODE,
	174	* The mandatory fields are :
	175	* IWL_TM_ATTR_UCODE_CMD_ID for recognizable command ID;
	176	* IWL_TM_ATTR_COMMAND_FLAG for the flags of the commands;
	177	* The optional fields are:
	178	* IWL_TM_ATTR_UCODE_CMD_DATA for the actual command payload
	179	* to the ucode
	180	*
	181	* @IWL_TM_ATTR_REG_OFFSET:
	182	* @IWL_TM_ATTR_REG_VALUE8:
	183	* @IWL_TM_ATTR_REG_VALUE32:
	184	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_REG_XXX,
	185	* The mandatory fields are:
	186	* IWL_TM_ATTR_REG_OFFSET for the offset of the target register;
	187	* IWL_TM_ATTR_REG_VALUE8 or IWL_TM_ATTR_REG_VALUE32 for value
	188	*
	189	* @IWL_TM_ATTR_SYNC_RSP:
	190	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_DEV2APP_SYNC_RSP,
	191	* The mandatory fields are:
	192	* IWL_TM_ATTR_SYNC_RSP for the data content responding to the user
	193	* application command
	194	*
	195	* @IWL_TM_ATTR_UCODE_RX_PKT:
	196	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_DEV2APP_UCODE_RX_PKT,
	197	* The mandatory fields are:
	198	* IWL_TM_ATTR_UCODE_RX_PKT for the data content multicast to the user
	199	* application
	200	*
	201	* @IWL_TM_ATTR_EEPROM:
	202	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_DEV2APP_EEPROM,
	203	* The mandatory fields are:
	204	* IWL_TM_ATTR_EEPROM for the data content responging to the user
	205	* application
	206	*
	207	* @IWL_TM_ATTR_TRACE_ADDR:
	208	* @IWL_TM_ATTR_TRACE_SIZE:
	209	* @IWL_TM_ATTR_TRACE_DUMP:
	210	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_XXX_TRACE,
	211	* The mandatory fields are:
	212	* IWL_TM_ATTR_MEM_TRACE_ADDR for the trace address
	213	* IWL_TM_ATTR_MEM_TRACE_SIZE for the trace buffer size
	214	* IWL_TM_ATTR_MEM_TRACE_DUMP for the trace dump
	215	*
	216	* @IWL_TM_ATTR_FIXRATE:
	217	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_FIXRATE_REQ,
	218	* The mandatory fields are:
	219	* IWL_TM_ATTR_FIXRATE for the fixed rate
	220	*
e98a1939 WYG	221	* @IWL_TM_ATTR_UCODE_OWNER:
	222	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_OWNERSHIP,
	223	* The mandatory fields are:
	224	* IWL_TM_ATTR_UCODE_OWNER for the new owner
306713fd	225	*
6c55f5ed AB	226	* @IWL_TM_ATTR_MEM_ADDR:
	227	* @IWL_TM_ATTR_BUFFER_SIZE:
	228	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_READ
	229	* or IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_WRITE.
306713fd	230	* The mandatory fields are:
6c55f5ed AB	231	* IWL_TM_ATTR_MEM_ADDR for the address in SRAM/periphery to read/write
6c55f5ed AB	232	* IWL_TM_ATTR_BUFFER_SIZE for the buffer size of data to read/write.
306713fd	233	*
6c55f5ed AB	234	* @IWL_TM_ATTR_BUFFER_DUMP:
	235	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_DUMP,
	236	* IWL_TM_ATTR_BUFFER_DUMP is used for the data that was read.
	237	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_INDIRECT_BUFFER_WRITE,
	238	* this attribute contains the data to write.
306713fd	239	*
e1a38fe1 HK	240	* @IWL_TM_ATTR_FW_VERSION:
	241	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_GET_FW_VERSION,
	242	* IWL_TM_ATTR_FW_VERSION for the uCode version
	243	*
0bec12b8 HK	244	* @IWL_TM_ATTR_DEVICE_ID:
	245	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_GET_DEVICE_ID,
	246	* IWL_TM_ATTR_DEVICE_ID for the device ID information
	247	*
668bd6a8 KH	248	* @IWL_TM_ATTR_FW_TYPE:
	249	* @IWL_TM_ATTR_FW_INST_SIZE:
	250	* @IWL_TM_ATTR_FW_DATA_SIZE:
	251	* When IWL_TM_ATTR_COMMAND is IWL_TM_CMD_APP2DEV_GET_FW_INFO,
	252	* The mandatory fields are:
	253	* IWL_TM_ATTR_FW_TYPE for the uCode type (INIT/RUNTIME/...)
	254	* IWL_TM_ATTR_FW_INST_SIZE for the size of instruction section
	255	* IWL_TM_ATTR_FW_DATA_SIZE for the size of data section
	256	*
4466320f	257	*/
4613e72d	258	enum iwl_tm_attr_t {
4466320f WYG	259	IWL_TM_ATTR_NOT_APPLICABLE = 0,
	260	IWL_TM_ATTR_COMMAND = 1,
	261	IWL_TM_ATTR_UCODE_CMD_ID = 2,
	262	IWL_TM_ATTR_UCODE_CMD_DATA = 3,
	263	IWL_TM_ATTR_REG_OFFSET = 4,
	264	IWL_TM_ATTR_REG_VALUE8 = 5,
	265	IWL_TM_ATTR_REG_VALUE32 = 6,
	266	IWL_TM_ATTR_SYNC_RSP = 7,
	267	IWL_TM_ATTR_UCODE_RX_PKT = 8,
	268	IWL_TM_ATTR_EEPROM = 9,
	269	IWL_TM_ATTR_TRACE_ADDR = 10,
	270	IWL_TM_ATTR_TRACE_SIZE = 11,
	271	IWL_TM_ATTR_TRACE_DUMP = 12,
	272	IWL_TM_ATTR_FIXRATE = 13,
e98a1939	273	IWL_TM_ATTR_UCODE_OWNER = 14,
6c55f5ed AB	274	IWL_TM_ATTR_MEM_ADDR = 15,
	275	IWL_TM_ATTR_BUFFER_SIZE = 16,
	276	IWL_TM_ATTR_BUFFER_DUMP = 17,
e1a38fe1	277	IWL_TM_ATTR_FW_VERSION = 18,
0bec12b8	278	IWL_TM_ATTR_DEVICE_ID = 19,
668bd6a8 KH	279	IWL_TM_ATTR_FW_TYPE = 20,
	280	IWL_TM_ATTR_FW_INST_SIZE = 21,
	281	IWL_TM_ATTR_FW_DATA_SIZE = 22,
	282	IWL_TM_ATTR_MAX = 23,
4613e72d CK	283	};
4613e72d CK	284
7a4e5281	285	/* uCode trace buffer */
49b72100 WYG	286	#define TRACE_BUFF_SIZE_MAX 0x200000
	287	#define TRACE_BUFF_SIZE_MIN 0x20000
	288	#define TRACE_BUFF_SIZE_DEF TRACE_BUFF_SIZE_MIN
7a4e5281	289	#define TRACE_BUFF_PADD 0x2000
e056a653 HK	290
	291	/* Maximum data size of each dump it packet */
	292	#define DUMP_CHUNK_SIZE (PAGE_SIZE - 1024)
4613e72d	293
b07f08a5 KH	294	/* Address offset of data segment in SRAM */
	295	#define SRAM_DATA_SEG_OFFSET 0x800000
	296
4613e72d	297	#endif