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