xref: /linux/drivers/usb/serial/visor.h (revision 4b4193256c8d3bc3a5397b5cd9494c2ad386317d)
1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3  * USB HandSpring Visor driver
4  *
5  *	Copyright (C) 1999 - 2003
6  *	    Greg Kroah-Hartman (greg@kroah.com)
7  *
8  * See Documentation/usb/usb-serial.rst for more information on using this
9  * driver.
10  *
11  */
12 
13 #ifndef __LINUX_USB_SERIAL_VISOR_H
14 #define __LINUX_USB_SERIAL_VISOR_H
15 
16 
17 #define HANDSPRING_VENDOR_ID		0x082d
18 #define HANDSPRING_VISOR_ID		0x0100
19 #define HANDSPRING_TREO_ID		0x0200
20 #define HANDSPRING_TREO600_ID		0x0300
21 
22 #define PALM_VENDOR_ID			0x0830
23 #define PALM_M500_ID			0x0001
24 #define PALM_M505_ID			0x0002
25 #define PALM_M515_ID			0x0003
26 #define PALM_I705_ID			0x0020
27 #define PALM_M125_ID			0x0040
28 #define PALM_M130_ID			0x0050
29 #define PALM_TUNGSTEN_T_ID		0x0060
30 #define PALM_TREO_650			0x0061
31 #define PALM_TUNGSTEN_Z_ID		0x0031
32 #define PALM_ZIRE_ID			0x0070
33 #define PALM_M100_ID			0x0080
34 
35 #define GSPDA_VENDOR_ID		0x115e
36 #define GSPDA_XPLORE_M68_ID		0xf100
37 
38 #define SONY_VENDOR_ID			0x054C
39 #define SONY_CLIE_3_5_ID		0x0038
40 #define SONY_CLIE_4_0_ID		0x0066
41 #define SONY_CLIE_S360_ID		0x0095
42 #define SONY_CLIE_4_1_ID		0x009A
43 #define SONY_CLIE_NX60_ID		0x00DA
44 #define SONY_CLIE_NZ90V_ID		0x00E9
45 #define SONY_CLIE_UX50_ID		0x0144
46 #define SONY_CLIE_TJ25_ID		0x0169
47 
48 #define ACER_VENDOR_ID			0x0502
49 #define ACER_S10_ID			0x0001
50 
51 #define SAMSUNG_VENDOR_ID		0x04E8
52 #define SAMSUNG_SCH_I330_ID		0x8001
53 #define SAMSUNG_SPH_I500_ID		0x6601
54 
55 #define TAPWAVE_VENDOR_ID		0x12EF
56 #define TAPWAVE_ZODIAC_ID		0x0100
57 
58 #define GARMIN_VENDOR_ID		0x091E
59 #define GARMIN_IQUE_3600_ID		0x0004
60 
61 #define ACEECA_VENDOR_ID		0x4766
62 #define ACEECA_MEZ1000_ID		0x0001
63 
64 #define KYOCERA_VENDOR_ID		0x0C88
65 #define KYOCERA_7135_ID			0x0021
66 
67 #define FOSSIL_VENDOR_ID		0x0E67
68 #define FOSSIL_ABACUS_ID		0x0002
69 
70 /****************************************************************************
71  * Handspring Visor Vendor specific request codes (bRequest values)
72  * A big thank you to Handspring for providing the following information.
73  * If anyone wants the original file where these values and structures came
74  * from, send email to <greg@kroah.com>.
75  ****************************************************************************/
76 
77 /****************************************************************************
78  * VISOR_REQUEST_BYTES_AVAILABLE asks the visor for the number of bytes that
79  * are available to be transferred to the host for the specified endpoint.
80  * Currently this is not used, and always returns 0x0001
81  ****************************************************************************/
82 #define VISOR_REQUEST_BYTES_AVAILABLE		0x01
83 
84 /****************************************************************************
85  * VISOR_CLOSE_NOTIFICATION is set to the device to notify it that the host
86  * is now closing the pipe. An empty packet is sent in response.
87  ****************************************************************************/
88 #define VISOR_CLOSE_NOTIFICATION		0x02
89 
90 /****************************************************************************
91  * VISOR_GET_CONNECTION_INFORMATION is sent by the host during enumeration to
92  * get the endpoints used by the connection.
93  ****************************************************************************/
94 #define VISOR_GET_CONNECTION_INFORMATION	0x03
95 
96 
97 /****************************************************************************
98  * VISOR_GET_CONNECTION_INFORMATION returns data in the following format
99  ****************************************************************************/
100 struct visor_connection_info {
101 	__le16	num_ports;
102 	struct {
103 		__u8	port_function_id;
104 		__u8	port;
105 	} connections[2];
106 };
107 
108 
109 /* struct visor_connection_info.connection[x].port defines: */
110 #define VISOR_ENDPOINT_1		0x01
111 #define VISOR_ENDPOINT_2		0x02
112 
113 /* struct visor_connection_info.connection[x].port_function_id defines: */
114 #define VISOR_FUNCTION_GENERIC		0x00
115 #define VISOR_FUNCTION_DEBUGGER		0x01
116 #define VISOR_FUNCTION_HOTSYNC		0x02
117 #define VISOR_FUNCTION_CONSOLE		0x03
118 #define VISOR_FUNCTION_REMOTE_FILE_SYS	0x04
119 
120 
121 /****************************************************************************
122  * PALM_GET_SOME_UNKNOWN_INFORMATION is sent by the host during enumeration to
123  * get some information from the M series devices, that is currently unknown.
124  ****************************************************************************/
125 #define PALM_GET_EXT_CONNECTION_INFORMATION	0x04
126 
127 /**
128  * struct palm_ext_connection_info - return data from a PALM_GET_EXT_CONNECTION_INFORMATION request
129  * @num_ports: maximum number of functions/connections in use
130  * @endpoint_numbers_different: will be 1 if in and out endpoints numbers are
131  *	different, otherwise it is 0.  If value is 1, then
132  *	connections.end_point_info is non-zero.  If value is 0, then
133  *	connections.port contains the endpoint number, which is the same for in
134  *	and out.
135  * @port_function_id: contains the creator id of the application that opened
136  *	this connection.
137  * @port: contains the in/out endpoint number.  Is 0 if in and out endpoint
138  *	numbers are different.
139  * @end_point_info: high nubbe is in endpoint and low nibble will indicate out
140  *	endpoint.  Is 0 if in and out endpoints are the same.
141  *
142  * The maximum number of connections currently supported is 2
143  */
144 struct palm_ext_connection_info {
145 	__u8 num_ports;
146 	__u8 endpoint_numbers_different;
147 	__le16 reserved1;
148 	struct {
149 		__u32 port_function_id;
150 		__u8 port;
151 		__u8 end_point_info;
152 		__le16 reserved;
153 	} connections[2];
154 };
155 
156 #endif
157 
158