xref: /OK3568_Linux_fs/kernel/drivers/bluetooth/btmrvl_drv.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  * Marvell Bluetooth driver: global definitions & declarations
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * Copyright (C) 2009, Marvell International Ltd.
5*4882a593Smuzhiyun  *
6*4882a593Smuzhiyun  * This software file (the "File") is distributed by Marvell International
7*4882a593Smuzhiyun  * Ltd. under the terms of the GNU General Public License Version 2, June 1991
8*4882a593Smuzhiyun  * (the "License").  You may use, redistribute and/or modify this File in
9*4882a593Smuzhiyun  * accordance with the terms and conditions of the License, a copy of which
10*4882a593Smuzhiyun  * is available by writing to the Free Software Foundation, Inc.,
11*4882a593Smuzhiyun  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or on the
12*4882a593Smuzhiyun  * worldwide web at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.
13*4882a593Smuzhiyun  *
14*4882a593Smuzhiyun  *
15*4882a593Smuzhiyun  * THE FILE IS DISTRIBUTED AS-IS, WITHOUT WARRANTY OF ANY KIND, AND THE
16*4882a593Smuzhiyun  * IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
17*4882a593Smuzhiyun  * ARE EXPRESSLY DISCLAIMED.  The License provides additional details about
18*4882a593Smuzhiyun  * this warranty disclaimer.
19*4882a593Smuzhiyun  *
20*4882a593Smuzhiyun  */
21*4882a593Smuzhiyun 
22*4882a593Smuzhiyun #include <linux/kthread.h>
23*4882a593Smuzhiyun #include <linux/bitops.h>
24*4882a593Smuzhiyun #include <linux/slab.h>
25*4882a593Smuzhiyun #include <net/bluetooth/bluetooth.h>
26*4882a593Smuzhiyun #include <linux/err.h>
27*4882a593Smuzhiyun #include <linux/gfp.h>
28*4882a593Smuzhiyun #include <linux/interrupt.h>
29*4882a593Smuzhiyun #include <linux/io.h>
30*4882a593Smuzhiyun #include <linux/of_platform.h>
31*4882a593Smuzhiyun #include <linux/platform_device.h>
32*4882a593Smuzhiyun #include <linux/pm_runtime.h>
33*4882a593Smuzhiyun #include <linux/of_irq.h>
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun #define BTM_HEADER_LEN			4
36*4882a593Smuzhiyun #define BTM_UPLD_SIZE			2312
37*4882a593Smuzhiyun 
38*4882a593Smuzhiyun /* Time to wait until Host Sleep state change in millisecond */
39*4882a593Smuzhiyun #define WAIT_UNTIL_HS_STATE_CHANGED	msecs_to_jiffies(5000)
40*4882a593Smuzhiyun /* Time to wait for command response in millisecond */
41*4882a593Smuzhiyun #define WAIT_UNTIL_CMD_RESP		msecs_to_jiffies(5000)
42*4882a593Smuzhiyun 
43*4882a593Smuzhiyun enum rdwr_status {
44*4882a593Smuzhiyun 	RDWR_STATUS_SUCCESS = 0,
45*4882a593Smuzhiyun 	RDWR_STATUS_FAILURE = 1,
46*4882a593Smuzhiyun 	RDWR_STATUS_DONE = 2
47*4882a593Smuzhiyun };
48*4882a593Smuzhiyun 
49*4882a593Smuzhiyun #define FW_DUMP_MAX_NAME_LEN    8
50*4882a593Smuzhiyun #define FW_DUMP_HOST_READY      0xEE
51*4882a593Smuzhiyun #define FW_DUMP_DONE            0xFF
52*4882a593Smuzhiyun #define FW_DUMP_READ_DONE       0xFE
53*4882a593Smuzhiyun 
54*4882a593Smuzhiyun struct memory_type_mapping {
55*4882a593Smuzhiyun 	u8 mem_name[FW_DUMP_MAX_NAME_LEN];
56*4882a593Smuzhiyun 	u8 *mem_ptr;
57*4882a593Smuzhiyun 	u32 mem_size;
58*4882a593Smuzhiyun 	u8 done_flag;
59*4882a593Smuzhiyun };
60*4882a593Smuzhiyun 
61*4882a593Smuzhiyun struct btmrvl_thread {
62*4882a593Smuzhiyun 	struct task_struct *task;
63*4882a593Smuzhiyun 	wait_queue_head_t wait_q;
64*4882a593Smuzhiyun 	void *priv;
65*4882a593Smuzhiyun };
66*4882a593Smuzhiyun 
67*4882a593Smuzhiyun struct btmrvl_device {
68*4882a593Smuzhiyun 	void *card;
69*4882a593Smuzhiyun 	struct hci_dev *hcidev;
70*4882a593Smuzhiyun 
71*4882a593Smuzhiyun 	u8 dev_type;
72*4882a593Smuzhiyun 
73*4882a593Smuzhiyun 	u8 tx_dnld_rdy;
74*4882a593Smuzhiyun 
75*4882a593Smuzhiyun 	u8 psmode;
76*4882a593Smuzhiyun 	u8 pscmd;
77*4882a593Smuzhiyun 	u8 hsmode;
78*4882a593Smuzhiyun 	u8 hscmd;
79*4882a593Smuzhiyun 
80*4882a593Smuzhiyun 	/* Low byte is gap, high byte is GPIO */
81*4882a593Smuzhiyun 	u16 gpio_gap;
82*4882a593Smuzhiyun 
83*4882a593Smuzhiyun 	u8 hscfgcmd;
84*4882a593Smuzhiyun 	u8 sendcmdflag;
85*4882a593Smuzhiyun };
86*4882a593Smuzhiyun 
87*4882a593Smuzhiyun struct btmrvl_adapter {
88*4882a593Smuzhiyun 	void *hw_regs_buf;
89*4882a593Smuzhiyun 	u8 *hw_regs;
90*4882a593Smuzhiyun 	u32 int_count;
91*4882a593Smuzhiyun 	struct sk_buff_head tx_queue;
92*4882a593Smuzhiyun 	u8 psmode;
93*4882a593Smuzhiyun 	u8 ps_state;
94*4882a593Smuzhiyun 	u8 hs_state;
95*4882a593Smuzhiyun 	u8 wakeup_tries;
96*4882a593Smuzhiyun 	wait_queue_head_t cmd_wait_q;
97*4882a593Smuzhiyun 	wait_queue_head_t event_hs_wait_q;
98*4882a593Smuzhiyun 	u8 cmd_complete;
99*4882a593Smuzhiyun 	bool is_suspended;
100*4882a593Smuzhiyun 	bool is_suspending;
101*4882a593Smuzhiyun };
102*4882a593Smuzhiyun 
103*4882a593Smuzhiyun struct btmrvl_private {
104*4882a593Smuzhiyun 	struct btmrvl_device btmrvl_dev;
105*4882a593Smuzhiyun 	struct btmrvl_adapter *adapter;
106*4882a593Smuzhiyun 	struct btmrvl_thread main_thread;
107*4882a593Smuzhiyun 	int (*hw_host_to_card)(struct btmrvl_private *priv,
108*4882a593Smuzhiyun 				u8 *payload, u16 nb);
109*4882a593Smuzhiyun 	int (*hw_wakeup_firmware)(struct btmrvl_private *priv);
110*4882a593Smuzhiyun 	int (*hw_process_int_status)(struct btmrvl_private *priv);
111*4882a593Smuzhiyun 	spinlock_t driver_lock;		/* spinlock used by driver */
112*4882a593Smuzhiyun #ifdef CONFIG_DEBUG_FS
113*4882a593Smuzhiyun 	void *debugfs_data;
114*4882a593Smuzhiyun #endif
115*4882a593Smuzhiyun 	bool surprise_removed;
116*4882a593Smuzhiyun };
117*4882a593Smuzhiyun 
118*4882a593Smuzhiyun #define MRVL_VENDOR_PKT			0xFE
119*4882a593Smuzhiyun 
120*4882a593Smuzhiyun /* Vendor specific Bluetooth commands */
121*4882a593Smuzhiyun #define BT_CMD_PSCAN_WIN_REPORT_ENABLE	0xFC03
122*4882a593Smuzhiyun #define BT_CMD_ROUTE_SCO_TO_HOST	0xFC1D
123*4882a593Smuzhiyun #define BT_CMD_SET_BDADDR		0xFC22
124*4882a593Smuzhiyun #define BT_CMD_AUTO_SLEEP_MODE		0xFC23
125*4882a593Smuzhiyun #define BT_CMD_HOST_SLEEP_CONFIG	0xFC59
126*4882a593Smuzhiyun #define BT_CMD_HOST_SLEEP_ENABLE	0xFC5A
127*4882a593Smuzhiyun #define BT_CMD_MODULE_CFG_REQ		0xFC5B
128*4882a593Smuzhiyun #define BT_CMD_LOAD_CONFIG_DATA		0xFC61
129*4882a593Smuzhiyun 
130*4882a593Smuzhiyun /* Sub-commands: Module Bringup/Shutdown Request/Response */
131*4882a593Smuzhiyun #define MODULE_BRINGUP_REQ		0xF1
132*4882a593Smuzhiyun #define MODULE_BROUGHT_UP		0x00
133*4882a593Smuzhiyun #define MODULE_ALREADY_UP		0x0C
134*4882a593Smuzhiyun 
135*4882a593Smuzhiyun #define MODULE_SHUTDOWN_REQ		0xF2
136*4882a593Smuzhiyun 
137*4882a593Smuzhiyun /* Vendor specific Bluetooth events */
138*4882a593Smuzhiyun #define BT_EVENT_AUTO_SLEEP_MODE	0x23
139*4882a593Smuzhiyun #define BT_EVENT_HOST_SLEEP_CONFIG	0x59
140*4882a593Smuzhiyun #define BT_EVENT_HOST_SLEEP_ENABLE	0x5A
141*4882a593Smuzhiyun #define BT_EVENT_MODULE_CFG_REQ		0x5B
142*4882a593Smuzhiyun #define BT_EVENT_POWER_STATE		0x20
143*4882a593Smuzhiyun 
144*4882a593Smuzhiyun /* Bluetooth Power States */
145*4882a593Smuzhiyun #define BT_PS_ENABLE			0x02
146*4882a593Smuzhiyun #define BT_PS_DISABLE			0x03
147*4882a593Smuzhiyun #define BT_PS_SLEEP			0x01
148*4882a593Smuzhiyun 
149*4882a593Smuzhiyun /* Host Sleep states */
150*4882a593Smuzhiyun #define HS_ACTIVATED			0x01
151*4882a593Smuzhiyun #define HS_DEACTIVATED			0x00
152*4882a593Smuzhiyun 
153*4882a593Smuzhiyun /* Power Save modes */
154*4882a593Smuzhiyun #define PS_SLEEP			0x01
155*4882a593Smuzhiyun #define PS_AWAKE			0x00
156*4882a593Smuzhiyun 
157*4882a593Smuzhiyun #define BT_CAL_HDR_LEN			4
158*4882a593Smuzhiyun #define BT_CAL_DATA_SIZE		28
159*4882a593Smuzhiyun 
160*4882a593Smuzhiyun struct btmrvl_event {
161*4882a593Smuzhiyun 	u8 ec;		/* event counter */
162*4882a593Smuzhiyun 	u8 length;
163*4882a593Smuzhiyun 	u8 data[4];
164*4882a593Smuzhiyun } __packed;
165*4882a593Smuzhiyun 
166*4882a593Smuzhiyun /* Prototype of global function */
167*4882a593Smuzhiyun 
168*4882a593Smuzhiyun int btmrvl_register_hdev(struct btmrvl_private *priv);
169*4882a593Smuzhiyun struct btmrvl_private *btmrvl_add_card(void *card);
170*4882a593Smuzhiyun int btmrvl_remove_card(struct btmrvl_private *priv);
171*4882a593Smuzhiyun 
172*4882a593Smuzhiyun void btmrvl_interrupt(struct btmrvl_private *priv);
173*4882a593Smuzhiyun 
174*4882a593Smuzhiyun bool btmrvl_check_evtpkt(struct btmrvl_private *priv, struct sk_buff *skb);
175*4882a593Smuzhiyun int btmrvl_process_event(struct btmrvl_private *priv, struct sk_buff *skb);
176*4882a593Smuzhiyun 
177*4882a593Smuzhiyun int btmrvl_send_module_cfg_cmd(struct btmrvl_private *priv, u8 subcmd);
178*4882a593Smuzhiyun int btmrvl_pscan_window_reporting(struct btmrvl_private *priv, u8 subcmd);
179*4882a593Smuzhiyun int btmrvl_send_hscfg_cmd(struct btmrvl_private *priv);
180*4882a593Smuzhiyun int btmrvl_enable_ps(struct btmrvl_private *priv);
181*4882a593Smuzhiyun int btmrvl_prepare_command(struct btmrvl_private *priv);
182*4882a593Smuzhiyun int btmrvl_enable_hs(struct btmrvl_private *priv);
183*4882a593Smuzhiyun 
184*4882a593Smuzhiyun #ifdef CONFIG_DEBUG_FS
185*4882a593Smuzhiyun void btmrvl_debugfs_init(struct hci_dev *hdev);
186*4882a593Smuzhiyun void btmrvl_debugfs_remove(struct hci_dev *hdev);
187*4882a593Smuzhiyun #endif
188