Linux Audio

Check our new training course

Linux kernel drivers training

May 6-19, 2025
Register
Loading...
v6.2
  1/* SPDX-License-Identifier: GPL-2.0-only */
  2/*
  3 * Marvell Bluetooth driver: global definitions & declarations
  4 *
  5 * Copyright (C) 2009, Marvell International Ltd.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  6 */
  7
  8#include <linux/kthread.h>
  9#include <linux/bitops.h>
 10#include <linux/slab.h>
 11#include <net/bluetooth/bluetooth.h>
 12#include <linux/err.h>
 13#include <linux/gfp.h>
 14#include <linux/interrupt.h>
 15#include <linux/io.h>
 16#include <linux/of_platform.h>
 17#include <linux/platform_device.h>
 18#include <linux/pm_runtime.h>
 19#include <linux/of_irq.h>
 20
 21#define BTM_HEADER_LEN			4
 22#define BTM_UPLD_SIZE			2312
 23
 24/* Time to wait until Host Sleep state change in millisecond */
 25#define WAIT_UNTIL_HS_STATE_CHANGED	msecs_to_jiffies(5000)
 26/* Time to wait for command response in millisecond */
 27#define WAIT_UNTIL_CMD_RESP		msecs_to_jiffies(5000)
 28
 29enum rdwr_status {
 30	RDWR_STATUS_SUCCESS = 0,
 31	RDWR_STATUS_FAILURE = 1,
 32	RDWR_STATUS_DONE = 2
 33};
 34
 35#define FW_DUMP_MAX_NAME_LEN    8
 36#define FW_DUMP_HOST_READY      0xEE
 37#define FW_DUMP_DONE            0xFF
 38#define FW_DUMP_READ_DONE       0xFE
 39
 40struct memory_type_mapping {
 41	u8 mem_name[FW_DUMP_MAX_NAME_LEN];
 42	u8 *mem_ptr;
 43	u32 mem_size;
 44	u8 done_flag;
 45};
 46
 47struct btmrvl_thread {
 48	struct task_struct *task;
 49	wait_queue_head_t wait_q;
 50	void *priv;
 51};
 52
 53struct btmrvl_device {
 54	void *card;
 55	struct hci_dev *hcidev;
 56
 57	u8 dev_type;
 58
 59	u8 tx_dnld_rdy;
 60
 61	u8 psmode;
 62	u8 pscmd;
 63	u8 hsmode;
 64	u8 hscmd;
 65
 66	/* Low byte is gap, high byte is GPIO */
 67	u16 gpio_gap;
 68
 69	u8 hscfgcmd;
 70	u8 sendcmdflag;
 71};
 72
 73struct btmrvl_adapter {
 74	void *hw_regs_buf;
 75	u8 *hw_regs;
 76	u32 int_count;
 77	struct sk_buff_head tx_queue;
 78	u8 psmode;
 79	u8 ps_state;
 80	u8 hs_state;
 81	u8 wakeup_tries;
 82	wait_queue_head_t cmd_wait_q;
 83	wait_queue_head_t event_hs_wait_q;
 84	u8 cmd_complete;
 85	bool is_suspended;
 86	bool is_suspending;
 87};
 88
 89struct btmrvl_private {
 90	struct btmrvl_device btmrvl_dev;
 91	struct btmrvl_adapter *adapter;
 92	struct btmrvl_thread main_thread;
 93	int (*hw_host_to_card)(struct btmrvl_private *priv,
 94				u8 *payload, u16 nb);
 95	int (*hw_wakeup_firmware)(struct btmrvl_private *priv);
 96	int (*hw_process_int_status)(struct btmrvl_private *priv);
 97	spinlock_t driver_lock;		/* spinlock used by driver */
 98#ifdef CONFIG_DEBUG_FS
 99	void *debugfs_data;
100#endif
101	bool surprise_removed;
102};
103
104#define MRVL_VENDOR_PKT			0xFE
105
106/* Vendor specific Bluetooth commands */
107#define BT_CMD_PSCAN_WIN_REPORT_ENABLE	0xFC03
108#define BT_CMD_ROUTE_SCO_TO_HOST	0xFC1D
109#define BT_CMD_SET_BDADDR		0xFC22
110#define BT_CMD_AUTO_SLEEP_MODE		0xFC23
111#define BT_CMD_HOST_SLEEP_CONFIG	0xFC59
112#define BT_CMD_HOST_SLEEP_ENABLE	0xFC5A
113#define BT_CMD_MODULE_CFG_REQ		0xFC5B
114#define BT_CMD_LOAD_CONFIG_DATA		0xFC61
115
116/* Sub-commands: Module Bringup/Shutdown Request/Response */
117#define MODULE_BRINGUP_REQ		0xF1
118#define MODULE_BROUGHT_UP		0x00
119#define MODULE_ALREADY_UP		0x0C
120
121#define MODULE_SHUTDOWN_REQ		0xF2
122
123/* Vendor specific Bluetooth events */
124#define BT_EVENT_AUTO_SLEEP_MODE	0x23
125#define BT_EVENT_HOST_SLEEP_CONFIG	0x59
126#define BT_EVENT_HOST_SLEEP_ENABLE	0x5A
127#define BT_EVENT_MODULE_CFG_REQ		0x5B
128#define BT_EVENT_POWER_STATE		0x20
129
130/* Bluetooth Power States */
131#define BT_PS_ENABLE			0x02
132#define BT_PS_DISABLE			0x03
133#define BT_PS_SLEEP			0x01
134
 
 
135/* Host Sleep states */
136#define HS_ACTIVATED			0x01
137#define HS_DEACTIVATED			0x00
138
139/* Power Save modes */
140#define PS_SLEEP			0x01
141#define PS_AWAKE			0x00
142
143#define BT_CAL_HDR_LEN			4
144#define BT_CAL_DATA_SIZE		28
 
 
 
145
146struct btmrvl_event {
147	u8 ec;		/* event counter */
148	u8 length;
149	u8 data[4];
150} __packed;
151
152/* Prototype of global function */
153
154int btmrvl_register_hdev(struct btmrvl_private *priv);
155struct btmrvl_private *btmrvl_add_card(void *card);
156int btmrvl_remove_card(struct btmrvl_private *priv);
157
158void btmrvl_interrupt(struct btmrvl_private *priv);
159
160bool btmrvl_check_evtpkt(struct btmrvl_private *priv, struct sk_buff *skb);
161int btmrvl_process_event(struct btmrvl_private *priv, struct sk_buff *skb);
162
163int btmrvl_send_module_cfg_cmd(struct btmrvl_private *priv, u8 subcmd);
164int btmrvl_pscan_window_reporting(struct btmrvl_private *priv, u8 subcmd);
165int btmrvl_send_hscfg_cmd(struct btmrvl_private *priv);
166int btmrvl_enable_ps(struct btmrvl_private *priv);
167int btmrvl_prepare_command(struct btmrvl_private *priv);
168int btmrvl_enable_hs(struct btmrvl_private *priv);
169
170#ifdef CONFIG_DEBUG_FS
171void btmrvl_debugfs_init(struct hci_dev *hdev);
172void btmrvl_debugfs_remove(struct hci_dev *hdev);
173#endif
v3.5.6
 
  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
 27#define BTM_HEADER_LEN			4
 28#define BTM_UPLD_SIZE			2312
 29
 30/* Time to wait until Host Sleep state change in millisecond */
 31#define WAIT_UNTIL_HS_STATE_CHANGED	5000
 32/* Time to wait for command response in millisecond */
 33#define WAIT_UNTIL_CMD_RESP		5000
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 34
 35struct btmrvl_thread {
 36	struct task_struct *task;
 37	wait_queue_head_t wait_q;
 38	void *priv;
 39};
 40
 41struct btmrvl_device {
 42	void *card;
 43	struct hci_dev *hcidev;
 44
 45	u8 dev_type;
 46
 47	u8 tx_dnld_rdy;
 48
 49	u8 psmode;
 50	u8 pscmd;
 51	u8 hsmode;
 52	u8 hscmd;
 53
 54	/* Low byte is gap, high byte is GPIO */
 55	u16 gpio_gap;
 56
 57	u8 hscfgcmd;
 58	u8 sendcmdflag;
 59};
 60
 61struct btmrvl_adapter {
 
 
 62	u32 int_count;
 63	struct sk_buff_head tx_queue;
 64	u8 psmode;
 65	u8 ps_state;
 66	u8 hs_state;
 67	u8 wakeup_tries;
 68	wait_queue_head_t cmd_wait_q;
 
 69	u8 cmd_complete;
 70	bool is_suspended;
 
 71};
 72
 73struct btmrvl_private {
 74	struct btmrvl_device btmrvl_dev;
 75	struct btmrvl_adapter *adapter;
 76	struct btmrvl_thread main_thread;
 77	int (*hw_host_to_card) (struct btmrvl_private *priv,
 78				u8 *payload, u16 nb);
 79	int (*hw_wakeup_firmware) (struct btmrvl_private *priv);
 80	int (*hw_process_int_status) (struct btmrvl_private *priv);
 81	spinlock_t driver_lock;		/* spinlock used by driver */
 82#ifdef CONFIG_DEBUG_FS
 83	void *debugfs_data;
 84#endif
 
 85};
 86
 87#define MRVL_VENDOR_PKT			0xFE
 88
 89/* Bluetooth commands  */
 90#define BT_CMD_AUTO_SLEEP_MODE		0x23
 91#define BT_CMD_HOST_SLEEP_CONFIG	0x59
 92#define BT_CMD_HOST_SLEEP_ENABLE	0x5A
 93#define BT_CMD_MODULE_CFG_REQ		0x5B
 
 
 
 
 94
 95/* Sub-commands: Module Bringup/Shutdown Request/Response */
 96#define MODULE_BRINGUP_REQ		0xF1
 97#define MODULE_BROUGHT_UP		0x00
 98#define MODULE_ALREADY_UP		0x0C
 99
100#define MODULE_SHUTDOWN_REQ		0xF2
101
 
 
 
 
 
102#define BT_EVENT_POWER_STATE		0x20
103
104/* Bluetooth Power States */
105#define BT_PS_ENABLE			0x02
106#define BT_PS_DISABLE			0x03
107#define BT_PS_SLEEP			0x01
108
109#define OGF				0x3F
110
111/* Host Sleep states */
112#define HS_ACTIVATED			0x01
113#define HS_DEACTIVATED			0x00
114
115/* Power Save modes */
116#define PS_SLEEP			0x01
117#define PS_AWAKE			0x00
118
119struct btmrvl_cmd {
120	__le16 ocf_ogf;
121	u8 length;
122	u8 data[4];
123} __packed;
124
125struct btmrvl_event {
126	u8 ec;		/* event counter */
127	u8 length;
128	u8 data[4];
129} __packed;
130
131/* Prototype of global function */
132
133int btmrvl_register_hdev(struct btmrvl_private *priv);
134struct btmrvl_private *btmrvl_add_card(void *card);
135int btmrvl_remove_card(struct btmrvl_private *priv);
136
137void btmrvl_interrupt(struct btmrvl_private *priv);
138
139bool btmrvl_check_evtpkt(struct btmrvl_private *priv, struct sk_buff *skb);
140int btmrvl_process_event(struct btmrvl_private *priv, struct sk_buff *skb);
141
142int btmrvl_send_module_cfg_cmd(struct btmrvl_private *priv, int subcmd);
 
143int btmrvl_send_hscfg_cmd(struct btmrvl_private *priv);
144int btmrvl_enable_ps(struct btmrvl_private *priv);
145int btmrvl_prepare_command(struct btmrvl_private *priv);
146int btmrvl_enable_hs(struct btmrvl_private *priv);
147
148#ifdef CONFIG_DEBUG_FS
149void btmrvl_debugfs_init(struct hci_dev *hdev);
150void btmrvl_debugfs_remove(struct hci_dev *hdev);
151#endif