Linux Audio

Check our new training course

Loading...
v5.4
  1/*
  2   HIDP implementation for Linux Bluetooth stack (BlueZ).
  3   Copyright (C) 2003-2004 Marcel Holtmann <marcel@holtmann.org>
  4
  5   This program is free software; you can redistribute it and/or modify
  6   it under the terms of the GNU General Public License version 2 as
  7   published by the Free Software Foundation;
  8
  9   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 10   OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 11   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
 12   IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
 13   CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
 14   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 15   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 16   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 17
 18   ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
 19   COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
 20   SOFTWARE IS DISCLAIMED.
 21*/
 22
 23#ifndef __HIDP_H
 24#define __HIDP_H
 25
 26#include <linux/types.h>
 27#include <linux/hid.h>
 28#include <linux/kref.h>
 29#include <net/bluetooth/bluetooth.h>
 30#include <net/bluetooth/l2cap.h>
 31
 32/* HIDP header masks */
 33#define HIDP_HEADER_TRANS_MASK			0xf0
 34#define HIDP_HEADER_PARAM_MASK			0x0f
 35
 36/* HIDP transaction types */
 37#define HIDP_TRANS_HANDSHAKE			0x00
 38#define HIDP_TRANS_HID_CONTROL			0x10
 39#define HIDP_TRANS_GET_REPORT			0x40
 40#define HIDP_TRANS_SET_REPORT			0x50
 41#define HIDP_TRANS_GET_PROTOCOL			0x60
 42#define HIDP_TRANS_SET_PROTOCOL			0x70
 43#define HIDP_TRANS_GET_IDLE			0x80
 44#define HIDP_TRANS_SET_IDLE			0x90
 45#define HIDP_TRANS_DATA				0xa0
 46#define HIDP_TRANS_DATC				0xb0
 47
 48/* HIDP handshake results */
 49#define HIDP_HSHK_SUCCESSFUL			0x00
 50#define HIDP_HSHK_NOT_READY			0x01
 51#define HIDP_HSHK_ERR_INVALID_REPORT_ID		0x02
 52#define HIDP_HSHK_ERR_UNSUPPORTED_REQUEST	0x03
 53#define HIDP_HSHK_ERR_INVALID_PARAMETER		0x04
 54#define HIDP_HSHK_ERR_UNKNOWN			0x0e
 55#define HIDP_HSHK_ERR_FATAL			0x0f
 56
 57/* HIDP control operation parameters */
 58#define HIDP_CTRL_NOP				0x00
 59#define HIDP_CTRL_HARD_RESET			0x01
 60#define HIDP_CTRL_SOFT_RESET			0x02
 61#define HIDP_CTRL_SUSPEND			0x03
 62#define HIDP_CTRL_EXIT_SUSPEND			0x04
 63#define HIDP_CTRL_VIRTUAL_CABLE_UNPLUG		0x05
 64
 65/* HIDP data transaction headers */
 66#define HIDP_DATA_RTYPE_MASK			0x03
 67#define HIDP_DATA_RSRVD_MASK			0x0c
 68#define HIDP_DATA_RTYPE_OTHER			0x00
 69#define HIDP_DATA_RTYPE_INPUT			0x01
 70#define HIDP_DATA_RTYPE_OUPUT			0x02
 71#define HIDP_DATA_RTYPE_FEATURE			0x03
 72
 73/* HIDP protocol header parameters */
 74#define HIDP_PROTO_BOOT				0x00
 75#define HIDP_PROTO_REPORT			0x01
 76
 77/* HIDP ioctl defines */
 78#define HIDPCONNADD	_IOW('H', 200, int)
 79#define HIDPCONNDEL	_IOW('H', 201, int)
 80#define HIDPGETCONNLIST	_IOR('H', 210, int)
 81#define HIDPGETCONNINFO	_IOR('H', 211, int)
 82
 83#define HIDP_VIRTUAL_CABLE_UNPLUG	0
 84#define HIDP_BOOT_PROTOCOL_MODE		1
 85#define HIDP_BLUETOOTH_VENDOR_ID	9
 86#define HIDP_WAITING_FOR_RETURN		10
 87#define HIDP_WAITING_FOR_SEND_ACK	11
 88
 89struct hidp_connadd_req {
 90	int   ctrl_sock;	/* Connected control socket */
 91	int   intr_sock;	/* Connected interrupt socket */
 92	__u16 parser;
 93	__u16 rd_size;
 94	__u8 __user *rd_data;
 95	__u8  country;
 96	__u8  subclass;
 97	__u16 vendor;
 98	__u16 product;
 99	__u16 version;
100	__u32 flags;
101	__u32 idle_to;
102	char  name[128];
103};
104
105struct hidp_conndel_req {
106	bdaddr_t bdaddr;
107	__u32    flags;
108};
109
110struct hidp_conninfo {
111	bdaddr_t bdaddr;
112	__u32    flags;
113	__u16    state;
114	__u16    vendor;
115	__u16    product;
116	__u16    version;
117	char     name[128];
118};
119
120struct hidp_connlist_req {
121	__u32  cnum;
122	struct hidp_conninfo __user *ci;
123};
124
125int hidp_connection_add(const struct hidp_connadd_req *req, struct socket *ctrl_sock, struct socket *intr_sock);
126int hidp_connection_del(struct hidp_conndel_req *req);
127int hidp_get_connlist(struct hidp_connlist_req *req);
128int hidp_get_conninfo(struct hidp_conninfo *ci);
129
130enum hidp_session_state {
131	HIDP_SESSION_IDLING,
132	HIDP_SESSION_PREPARING,
133	HIDP_SESSION_RUNNING,
134};
135
136/* HIDP session defines */
137struct hidp_session {
138	struct list_head list;
139	struct kref ref;
140
141	/* runtime management */
142	atomic_t state;
143	wait_queue_head_t state_queue;
144	atomic_t terminate;
145	struct task_struct *task;
146	unsigned long flags;
147
148	/* connection management */
149	bdaddr_t bdaddr;
150	struct l2cap_conn *conn;
151	struct l2cap_user user;
152	struct socket *ctrl_sock;
153	struct socket *intr_sock;
154	struct sk_buff_head ctrl_transmit;
155	struct sk_buff_head intr_transmit;
 
 
 
 
 
156	uint ctrl_mtu;
157	uint intr_mtu;
158	unsigned long idle_to;
159
160	/* device management */
161	struct work_struct dev_init;
 
 
 
 
162	struct input_dev *input;
 
163	struct hid_device *hid;
164	struct timer_list timer;
165
166	/* Report descriptor */
167	__u8 *rd_data;
168	uint rd_size;
169
170	/* session data */
171	unsigned char keys[8];
172	unsigned char leds;
173
174	/* Used in hidp_get_raw_report() */
175	int waiting_report_type; /* HIDP_DATA_RTYPE_* */
176	int waiting_report_number; /* -1 for not numbered */
177	struct mutex report_mutex;
178	struct sk_buff *report_return;
179	wait_queue_head_t report_queue;
180
181	/* Used in hidp_output_raw_report() */
182	int output_report_success; /* boolean */
183
184	/* temporary input buffer */
185	u8 input_buf[HID_MAX_BUFFER_SIZE];
 
 
 
 
186};
187
 
 
 
 
 
 
 
 
 
188/* HIDP init defines */
189int __init hidp_init_sockets(void);
190void __exit hidp_cleanup_sockets(void);
191
192#endif /* __HIDP_H */
v3.1
  1/*
  2   HIDP implementation for Linux Bluetooth stack (BlueZ).
  3   Copyright (C) 2003-2004 Marcel Holtmann <marcel@holtmann.org>
  4
  5   This program is free software; you can redistribute it and/or modify
  6   it under the terms of the GNU General Public License version 2 as
  7   published by the Free Software Foundation;
  8
  9   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 10   OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 11   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
 12   IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
 13   CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
 14   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 15   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 16   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 17
 18   ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
 19   COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
 20   SOFTWARE IS DISCLAIMED.
 21*/
 22
 23#ifndef __HIDP_H
 24#define __HIDP_H
 25
 26#include <linux/types.h>
 
 
 27#include <net/bluetooth/bluetooth.h>
 
 28
 29/* HIDP header masks */
 30#define HIDP_HEADER_TRANS_MASK			0xf0
 31#define HIDP_HEADER_PARAM_MASK			0x0f
 32
 33/* HIDP transaction types */
 34#define HIDP_TRANS_HANDSHAKE			0x00
 35#define HIDP_TRANS_HID_CONTROL			0x10
 36#define HIDP_TRANS_GET_REPORT			0x40
 37#define HIDP_TRANS_SET_REPORT			0x50
 38#define HIDP_TRANS_GET_PROTOCOL			0x60
 39#define HIDP_TRANS_SET_PROTOCOL			0x70
 40#define HIDP_TRANS_GET_IDLE			0x80
 41#define HIDP_TRANS_SET_IDLE			0x90
 42#define HIDP_TRANS_DATA				0xa0
 43#define HIDP_TRANS_DATC				0xb0
 44
 45/* HIDP handshake results */
 46#define HIDP_HSHK_SUCCESSFUL			0x00
 47#define HIDP_HSHK_NOT_READY			0x01
 48#define HIDP_HSHK_ERR_INVALID_REPORT_ID		0x02
 49#define HIDP_HSHK_ERR_UNSUPPORTED_REQUEST	0x03
 50#define HIDP_HSHK_ERR_INVALID_PARAMETER		0x04
 51#define HIDP_HSHK_ERR_UNKNOWN			0x0e
 52#define HIDP_HSHK_ERR_FATAL			0x0f
 53
 54/* HIDP control operation parameters */
 55#define HIDP_CTRL_NOP				0x00
 56#define HIDP_CTRL_HARD_RESET			0x01
 57#define HIDP_CTRL_SOFT_RESET			0x02
 58#define HIDP_CTRL_SUSPEND			0x03
 59#define HIDP_CTRL_EXIT_SUSPEND			0x04
 60#define HIDP_CTRL_VIRTUAL_CABLE_UNPLUG		0x05
 61
 62/* HIDP data transaction headers */
 63#define HIDP_DATA_RTYPE_MASK			0x03
 64#define HIDP_DATA_RSRVD_MASK			0x0c
 65#define HIDP_DATA_RTYPE_OTHER			0x00
 66#define HIDP_DATA_RTYPE_INPUT			0x01
 67#define HIDP_DATA_RTYPE_OUPUT			0x02
 68#define HIDP_DATA_RTYPE_FEATURE			0x03
 69
 70/* HIDP protocol header parameters */
 71#define HIDP_PROTO_BOOT				0x00
 72#define HIDP_PROTO_REPORT			0x01
 73
 74/* HIDP ioctl defines */
 75#define HIDPCONNADD	_IOW('H', 200, int)
 76#define HIDPCONNDEL	_IOW('H', 201, int)
 77#define HIDPGETCONNLIST	_IOR('H', 210, int)
 78#define HIDPGETCONNINFO	_IOR('H', 211, int)
 79
 80#define HIDP_VIRTUAL_CABLE_UNPLUG	0
 81#define HIDP_BOOT_PROTOCOL_MODE		1
 82#define HIDP_BLUETOOTH_VENDOR_ID	9
 83#define HIDP_WAITING_FOR_RETURN		10
 84#define HIDP_WAITING_FOR_SEND_ACK	11
 85
 86struct hidp_connadd_req {
 87	int   ctrl_sock;	/* Connected control socket */
 88	int   intr_sock;	/* Connected interrupt socket */
 89	__u16 parser;
 90	__u16 rd_size;
 91	__u8 __user *rd_data;
 92	__u8  country;
 93	__u8  subclass;
 94	__u16 vendor;
 95	__u16 product;
 96	__u16 version;
 97	__u32 flags;
 98	__u32 idle_to;
 99	char  name[128];
100};
101
102struct hidp_conndel_req {
103	bdaddr_t bdaddr;
104	__u32    flags;
105};
106
107struct hidp_conninfo {
108	bdaddr_t bdaddr;
109	__u32    flags;
110	__u16    state;
111	__u16    vendor;
112	__u16    product;
113	__u16    version;
114	char     name[128];
115};
116
117struct hidp_connlist_req {
118	__u32  cnum;
119	struct hidp_conninfo __user *ci;
120};
121
122int hidp_add_connection(struct hidp_connadd_req *req, struct socket *ctrl_sock, struct socket *intr_sock);
123int hidp_del_connection(struct hidp_conndel_req *req);
124int hidp_get_connlist(struct hidp_connlist_req *req);
125int hidp_get_conninfo(struct hidp_conninfo *ci);
126
 
 
 
 
 
 
127/* HIDP session defines */
128struct hidp_session {
129	struct list_head list;
 
130
131	struct hci_conn *conn;
 
 
 
 
 
132
 
 
 
 
133	struct socket *ctrl_sock;
134	struct socket *intr_sock;
135
136	bdaddr_t bdaddr;
137
138	unsigned long state;
139	unsigned long flags;
140	unsigned long idle_to;
141
142	uint ctrl_mtu;
143	uint intr_mtu;
 
144
145	atomic_t terminate;
146	struct task_struct *task;
147
148	unsigned char keys[8];
149	unsigned char leds;
150
151	struct input_dev *input;
152
153	struct hid_device *hid;
 
154
155	struct timer_list timer;
 
 
156
157	struct sk_buff_head ctrl_transmit;
158	struct sk_buff_head intr_transmit;
 
159
160	/* Used in hidp_get_raw_report() */
161	int waiting_report_type; /* HIDP_DATA_RTYPE_* */
162	int waiting_report_number; /* -1 for not numbered */
163	struct mutex report_mutex;
164	struct sk_buff *report_return;
165	wait_queue_head_t report_queue;
166
167	/* Used in hidp_output_raw_report() */
168	int output_report_success; /* boolean */
169
170	/* Report descriptor */
171	__u8 *rd_data;
172	uint rd_size;
173
174	wait_queue_head_t startup_queue;
175	int waiting_for_startup;
176};
177
178static inline void hidp_schedule(struct hidp_session *session)
179{
180	struct sock *ctrl_sk = session->ctrl_sock->sk;
181	struct sock *intr_sk = session->intr_sock->sk;
182
183	wake_up_interruptible(sk_sleep(ctrl_sk));
184	wake_up_interruptible(sk_sleep(intr_sk));
185}
186
187/* HIDP init defines */
188extern int __init hidp_init_sockets(void);
189extern void __exit hidp_cleanup_sockets(void);
190
191#endif /* __HIDP_H */