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