Merge branch 'for-2.6.24' of master.kernel.org:/pub/scm/linux/kernel/git/jwboyer...
[linux-2.6] / drivers / usb / gadget / rndis.h
1 /*
2  * RNDIS        Definitions for Remote NDIS
3  *
4  * Version:     $Id: rndis.h,v 1.15 2004/03/25 21:33:46 robert Exp $
5  *
6  * Authors:     Benedikt Spranger, Pengutronix
7  *              Robert Schwebel, Pengutronix
8  *
9  *              This program is free software; you can redistribute it and/or
10  *              modify it under the terms of the GNU General Public License
11  *              version 2, as published by the Free Software Foundation.
12  *
13  *              This software was originally developed in conformance with
14  *              Microsoft's Remote NDIS Specification License Agreement.
15  */
16
17 #ifndef _LINUX_RNDIS_H
18 #define _LINUX_RNDIS_H
19
20 #include "ndis.h"
21
22 #define RNDIS_MAXIMUM_FRAME_SIZE        1518
23 #define RNDIS_MAX_TOTAL_SIZE            1558
24
25 /* Remote NDIS Versions */
26 #define RNDIS_MAJOR_VERSION             1
27 #define RNDIS_MINOR_VERSION             0
28
29 /* Status Values */
30 #define RNDIS_STATUS_SUCCESS            0x00000000U     /* Success           */
31 #define RNDIS_STATUS_FAILURE            0xC0000001U     /* Unspecified error */
32 #define RNDIS_STATUS_INVALID_DATA       0xC0010015U     /* Invalid data      */
33 #define RNDIS_STATUS_NOT_SUPPORTED      0xC00000BBU     /* Unsupported request */
34 #define RNDIS_STATUS_MEDIA_CONNECT      0x4001000BU     /* Device connected  */
35 #define RNDIS_STATUS_MEDIA_DISCONNECT   0x4001000CU     /* Device disconnected */
36 /* For all not specified status messages:
37  * RNDIS_STATUS_Xxx -> NDIS_STATUS_Xxx
38  */
39
40 /* Message Set for Connectionless (802.3) Devices */
41 #define REMOTE_NDIS_PACKET_MSG          0x00000001U
42 #define REMOTE_NDIS_INITIALIZE_MSG      0x00000002U     /* Initialize device */
43 #define REMOTE_NDIS_HALT_MSG            0x00000003U
44 #define REMOTE_NDIS_QUERY_MSG           0x00000004U
45 #define REMOTE_NDIS_SET_MSG             0x00000005U
46 #define REMOTE_NDIS_RESET_MSG           0x00000006U
47 #define REMOTE_NDIS_INDICATE_STATUS_MSG 0x00000007U
48 #define REMOTE_NDIS_KEEPALIVE_MSG       0x00000008U
49
50 /* Message completion */
51 #define REMOTE_NDIS_INITIALIZE_CMPLT    0x80000002U
52 #define REMOTE_NDIS_QUERY_CMPLT         0x80000004U
53 #define REMOTE_NDIS_SET_CMPLT           0x80000005U
54 #define REMOTE_NDIS_RESET_CMPLT         0x80000006U
55 #define REMOTE_NDIS_KEEPALIVE_CMPLT     0x80000008U
56
57 /* Device Flags */
58 #define RNDIS_DF_CONNECTIONLESS         0x00000001U
59 #define RNDIS_DF_CONNECTION_ORIENTED    0x00000002U
60
61 #define RNDIS_MEDIUM_802_3              0x00000000U
62
63 /* from drivers/net/sk98lin/h/skgepnmi.h */
64 #define OID_PNP_CAPABILITIES                    0xFD010100
65 #define OID_PNP_SET_POWER                       0xFD010101
66 #define OID_PNP_QUERY_POWER                     0xFD010102
67 #define OID_PNP_ADD_WAKE_UP_PATTERN             0xFD010103
68 #define OID_PNP_REMOVE_WAKE_UP_PATTERN          0xFD010104
69 #define OID_PNP_ENABLE_WAKE_UP                  0xFD010106
70
71
72 typedef struct rndis_init_msg_type
73 {
74         __le32  MessageType;
75         __le32  MessageLength;
76         __le32  RequestID;
77         __le32  MajorVersion;
78         __le32  MinorVersion;
79         __le32  MaxTransferSize;
80 } rndis_init_msg_type;
81
82 typedef struct rndis_init_cmplt_type
83 {
84         __le32  MessageType;
85         __le32  MessageLength;
86         __le32  RequestID;
87         __le32  Status;
88         __le32  MajorVersion;
89         __le32  MinorVersion;
90         __le32  DeviceFlags;
91         __le32  Medium;
92         __le32  MaxPacketsPerTransfer;
93         __le32  MaxTransferSize;
94         __le32  PacketAlignmentFactor;
95         __le32  AFListOffset;
96         __le32  AFListSize;
97 } rndis_init_cmplt_type;
98
99 typedef struct rndis_halt_msg_type
100 {
101         __le32  MessageType;
102         __le32  MessageLength;
103         __le32  RequestID;
104 } rndis_halt_msg_type;
105
106 typedef struct rndis_query_msg_type
107 {
108         __le32  MessageType;
109         __le32  MessageLength;
110         __le32  RequestID;
111         __le32  OID;
112         __le32  InformationBufferLength;
113         __le32  InformationBufferOffset;
114         __le32  DeviceVcHandle;
115 } rndis_query_msg_type;
116
117 typedef struct rndis_query_cmplt_type
118 {
119         __le32  MessageType;
120         __le32  MessageLength;
121         __le32  RequestID;
122         __le32  Status;
123         __le32  InformationBufferLength;
124         __le32  InformationBufferOffset;
125 } rndis_query_cmplt_type;
126
127 typedef struct rndis_set_msg_type
128 {
129         __le32  MessageType;
130         __le32  MessageLength;
131         __le32  RequestID;
132         __le32  OID;
133         __le32  InformationBufferLength;
134         __le32  InformationBufferOffset;
135         __le32  DeviceVcHandle;
136 } rndis_set_msg_type;
137
138 typedef struct rndis_set_cmplt_type
139 {
140         __le32  MessageType;
141         __le32  MessageLength;
142         __le32  RequestID;
143         __le32  Status;
144 } rndis_set_cmplt_type;
145
146 typedef struct rndis_reset_msg_type
147 {
148         __le32  MessageType;
149         __le32  MessageLength;
150         __le32  Reserved;
151 } rndis_reset_msg_type;
152
153 typedef struct rndis_reset_cmplt_type
154 {
155         __le32  MessageType;
156         __le32  MessageLength;
157         __le32  Status;
158         __le32  AddressingReset;
159 } rndis_reset_cmplt_type;
160
161 typedef struct rndis_indicate_status_msg_type
162 {
163         __le32  MessageType;
164         __le32  MessageLength;
165         __le32  Status;
166         __le32  StatusBufferLength;
167         __le32  StatusBufferOffset;
168 } rndis_indicate_status_msg_type;
169
170 typedef struct rndis_keepalive_msg_type
171 {
172         __le32  MessageType;
173         __le32  MessageLength;
174         __le32  RequestID;
175 } rndis_keepalive_msg_type;
176
177 typedef struct rndis_keepalive_cmplt_type
178 {
179         __le32  MessageType;
180         __le32  MessageLength;
181         __le32  RequestID;
182         __le32  Status;
183 } rndis_keepalive_cmplt_type;
184
185 struct rndis_packet_msg_type
186 {
187         __le32  MessageType;
188         __le32  MessageLength;
189         __le32  DataOffset;
190         __le32  DataLength;
191         __le32  OOBDataOffset;
192         __le32  OOBDataLength;
193         __le32  NumOOBDataElements;
194         __le32  PerPacketInfoOffset;
195         __le32  PerPacketInfoLength;
196         __le32  VcHandle;
197         __le32  Reserved;
198 } __attribute__ ((packed));
199
200 struct rndis_config_parameter
201 {
202         __le32  ParameterNameOffset;
203         __le32  ParameterNameLength;
204         __le32  ParameterType;
205         __le32  ParameterValueOffset;
206         __le32  ParameterValueLength;
207 };
208
209 /* implementation specific */
210 enum rndis_state
211 {
212         RNDIS_UNINITIALIZED,
213         RNDIS_INITIALIZED,
214         RNDIS_DATA_INITIALIZED,
215 };
216
217 typedef struct rndis_resp_t
218 {
219         struct list_head        list;
220         u8                      *buf;
221         u32                     length;
222         int                     send;
223 } rndis_resp_t;
224
225 typedef struct rndis_params
226 {
227         u8                      confignr;
228         u8                      used;
229         u16                     saved_filter;
230         enum rndis_state        state;
231         u32                     medium;
232         u32                     speed;
233         u32                     media_state;
234
235         const u8                *host_mac;
236         u16                     *filter;
237         struct net_device       *dev;
238         struct net_device_stats *stats;
239
240         u32                     vendorID;
241         const char              *vendorDescr;
242         int                     (*ack) (struct net_device *);
243         struct list_head        resp_queue;
244 } rndis_params;
245
246 /* RNDIS Message parser and other useless functions */
247 int  rndis_msg_parser (u8 configNr, u8 *buf);
248 int  rndis_register (int (*rndis_control_ack) (struct net_device *));
249 void rndis_deregister (int configNr);
250 int  rndis_set_param_dev (u8 configNr, struct net_device *dev,
251                          struct net_device_stats *stats,
252                          u16 *cdc_filter);
253 int  rndis_set_param_vendor (u8 configNr, u32 vendorID,
254                             const char *vendorDescr);
255 int  rndis_set_param_medium (u8 configNr, u32 medium, u32 speed);
256 void rndis_add_hdr (struct sk_buff *skb);
257 int rndis_rm_hdr (struct sk_buff *skb);
258 u8   *rndis_get_next_response (int configNr, u32 *length);
259 void rndis_free_response (int configNr, u8 *buf);
260
261 void rndis_uninit (int configNr);
262 int  rndis_signal_connect (int configNr);
263 int  rndis_signal_disconnect (int configNr);
264 int  rndis_state (int configNr);
265 extern void rndis_set_host_mac (int configNr, const u8 *addr);
266
267 int __devinit rndis_init (void);
268 void rndis_exit (void);
269
270 #endif  /* _LINUX_RNDIS_H */