WIP FPC-III support
[linux/fpc-iii.git] / drivers / usb / gadget / function / rndis.c
blob64de9f1b874c55a3fdb4dddb49ecbdc4eec0aa1b
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * RNDIS MSG parser
5 * Authors: Benedikt Spranger, Pengutronix
6 * Robert Schwebel, Pengutronix
8 * This software was originally developed in conformance with
9 * Microsoft's Remote NDIS Specification License Agreement.
11 * 03/12/2004 Kai-Uwe Bloem <linux-development@auerswald.de>
12 * Fixed message length bug in init_response
14 * 03/25/2004 Kai-Uwe Bloem <linux-development@auerswald.de>
15 * Fixed rndis_rm_hdr length bug.
17 * Copyright (C) 2004 by David Brownell
18 * updates to merge with Linux 2.6, better match RNDIS spec
21 #include <linux/module.h>
22 #include <linux/moduleparam.h>
23 #include <linux/kernel.h>
24 #include <linux/errno.h>
25 #include <linux/idr.h>
26 #include <linux/list.h>
27 #include <linux/proc_fs.h>
28 #include <linux/slab.h>
29 #include <linux/seq_file.h>
30 #include <linux/netdevice.h>
32 #include <asm/io.h>
33 #include <asm/byteorder.h>
34 #include <asm/unaligned.h>
36 #include "u_rndis.h"
38 #undef VERBOSE_DEBUG
40 #include "rndis.h"
43 /* The driver for your USB chip needs to support ep0 OUT to work with
44 * RNDIS, plus all three CDC Ethernet endpoints (interrupt not optional).
46 * Windows hosts need an INF file like Documentation/usb/linux.inf
47 * and will be happier if you provide the host_addr module parameter.
50 #if 0
51 static int rndis_debug = 0;
52 module_param (rndis_debug, int, 0);
53 MODULE_PARM_DESC (rndis_debug, "enable debugging");
54 #else
55 #define rndis_debug 0
56 #endif
58 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
60 #define NAME_TEMPLATE "driver/rndis-%03d"
62 #endif /* CONFIG_USB_GADGET_DEBUG_FILES */
64 static DEFINE_IDA(rndis_ida);
66 /* Driver Version */
67 static const __le32 rndis_driver_version = cpu_to_le32(1);
69 /* Function Prototypes */
70 static rndis_resp_t *rndis_add_response(struct rndis_params *params,
71 u32 length);
73 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
75 static const struct proc_ops rndis_proc_ops;
77 #endif /* CONFIG_USB_GADGET_DEBUG_FILES */
79 /* supported OIDs */
80 static const u32 oid_supported_list[] = {
81 /* the general stuff */
82 RNDIS_OID_GEN_SUPPORTED_LIST,
83 RNDIS_OID_GEN_HARDWARE_STATUS,
84 RNDIS_OID_GEN_MEDIA_SUPPORTED,
85 RNDIS_OID_GEN_MEDIA_IN_USE,
86 RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE,
87 RNDIS_OID_GEN_LINK_SPEED,
88 RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE,
89 RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE,
90 RNDIS_OID_GEN_VENDOR_ID,
91 RNDIS_OID_GEN_VENDOR_DESCRIPTION,
92 RNDIS_OID_GEN_VENDOR_DRIVER_VERSION,
93 RNDIS_OID_GEN_CURRENT_PACKET_FILTER,
94 RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE,
95 RNDIS_OID_GEN_MEDIA_CONNECT_STATUS,
96 RNDIS_OID_GEN_PHYSICAL_MEDIUM,
98 /* the statistical stuff */
99 RNDIS_OID_GEN_XMIT_OK,
100 RNDIS_OID_GEN_RCV_OK,
101 RNDIS_OID_GEN_XMIT_ERROR,
102 RNDIS_OID_GEN_RCV_ERROR,
103 RNDIS_OID_GEN_RCV_NO_BUFFER,
104 #ifdef RNDIS_OPTIONAL_STATS
105 RNDIS_OID_GEN_DIRECTED_BYTES_XMIT,
106 RNDIS_OID_GEN_DIRECTED_FRAMES_XMIT,
107 RNDIS_OID_GEN_MULTICAST_BYTES_XMIT,
108 RNDIS_OID_GEN_MULTICAST_FRAMES_XMIT,
109 RNDIS_OID_GEN_BROADCAST_BYTES_XMIT,
110 RNDIS_OID_GEN_BROADCAST_FRAMES_XMIT,
111 RNDIS_OID_GEN_DIRECTED_BYTES_RCV,
112 RNDIS_OID_GEN_DIRECTED_FRAMES_RCV,
113 RNDIS_OID_GEN_MULTICAST_BYTES_RCV,
114 RNDIS_OID_GEN_MULTICAST_FRAMES_RCV,
115 RNDIS_OID_GEN_BROADCAST_BYTES_RCV,
116 RNDIS_OID_GEN_BROADCAST_FRAMES_RCV,
117 RNDIS_OID_GEN_RCV_CRC_ERROR,
118 RNDIS_OID_GEN_TRANSMIT_QUEUE_LENGTH,
119 #endif /* RNDIS_OPTIONAL_STATS */
121 /* mandatory 802.3 */
122 /* the general stuff */
123 RNDIS_OID_802_3_PERMANENT_ADDRESS,
124 RNDIS_OID_802_3_CURRENT_ADDRESS,
125 RNDIS_OID_802_3_MULTICAST_LIST,
126 RNDIS_OID_802_3_MAC_OPTIONS,
127 RNDIS_OID_802_3_MAXIMUM_LIST_SIZE,
129 /* the statistical stuff */
130 RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT,
131 RNDIS_OID_802_3_XMIT_ONE_COLLISION,
132 RNDIS_OID_802_3_XMIT_MORE_COLLISIONS,
133 #ifdef RNDIS_OPTIONAL_STATS
134 RNDIS_OID_802_3_XMIT_DEFERRED,
135 RNDIS_OID_802_3_XMIT_MAX_COLLISIONS,
136 RNDIS_OID_802_3_RCV_OVERRUN,
137 RNDIS_OID_802_3_XMIT_UNDERRUN,
138 RNDIS_OID_802_3_XMIT_HEARTBEAT_FAILURE,
139 RNDIS_OID_802_3_XMIT_TIMES_CRS_LOST,
140 RNDIS_OID_802_3_XMIT_LATE_COLLISIONS,
141 #endif /* RNDIS_OPTIONAL_STATS */
143 #ifdef RNDIS_PM
144 /* PM and wakeup are "mandatory" for USB, but the RNDIS specs
145 * don't say what they mean ... and the NDIS specs are often
146 * confusing and/or ambiguous in this context. (That is, more
147 * so than their specs for the other OIDs.)
149 * FIXME someone who knows what these should do, please
150 * implement them!
153 /* power management */
154 OID_PNP_CAPABILITIES,
155 OID_PNP_QUERY_POWER,
156 OID_PNP_SET_POWER,
158 #ifdef RNDIS_WAKEUP
159 /* wake up host */
160 OID_PNP_ENABLE_WAKE_UP,
161 OID_PNP_ADD_WAKE_UP_PATTERN,
162 OID_PNP_REMOVE_WAKE_UP_PATTERN,
163 #endif /* RNDIS_WAKEUP */
164 #endif /* RNDIS_PM */
168 /* NDIS Functions */
169 static int gen_ndis_query_resp(struct rndis_params *params, u32 OID, u8 *buf,
170 unsigned buf_len, rndis_resp_t *r)
172 int retval = -ENOTSUPP;
173 u32 length = 4; /* usually */
174 __le32 *outbuf;
175 int i, count;
176 rndis_query_cmplt_type *resp;
177 struct net_device *net;
178 struct rtnl_link_stats64 temp;
179 const struct rtnl_link_stats64 *stats;
181 if (!r) return -ENOMEM;
182 resp = (rndis_query_cmplt_type *)r->buf;
184 if (!resp) return -ENOMEM;
186 if (buf_len && rndis_debug > 1) {
187 pr_debug("query OID %08x value, len %d:\n", OID, buf_len);
188 for (i = 0; i < buf_len; i += 16) {
189 pr_debug("%03d: %08x %08x %08x %08x\n", i,
190 get_unaligned_le32(&buf[i]),
191 get_unaligned_le32(&buf[i + 4]),
192 get_unaligned_le32(&buf[i + 8]),
193 get_unaligned_le32(&buf[i + 12]));
197 /* response goes here, right after the header */
198 outbuf = (__le32 *)&resp[1];
199 resp->InformationBufferOffset = cpu_to_le32(16);
201 net = params->dev;
202 stats = dev_get_stats(net, &temp);
204 switch (OID) {
206 /* general oids (table 4-1) */
208 /* mandatory */
209 case RNDIS_OID_GEN_SUPPORTED_LIST:
210 pr_debug("%s: RNDIS_OID_GEN_SUPPORTED_LIST\n", __func__);
211 length = sizeof(oid_supported_list);
212 count = length / sizeof(u32);
213 for (i = 0; i < count; i++)
214 outbuf[i] = cpu_to_le32(oid_supported_list[i]);
215 retval = 0;
216 break;
218 /* mandatory */
219 case RNDIS_OID_GEN_HARDWARE_STATUS:
220 pr_debug("%s: RNDIS_OID_GEN_HARDWARE_STATUS\n", __func__);
221 /* Bogus question!
222 * Hardware must be ready to receive high level protocols.
223 * BTW:
224 * reddite ergo quae sunt Caesaris Caesari
225 * et quae sunt Dei Deo!
227 *outbuf = cpu_to_le32(0);
228 retval = 0;
229 break;
231 /* mandatory */
232 case RNDIS_OID_GEN_MEDIA_SUPPORTED:
233 pr_debug("%s: RNDIS_OID_GEN_MEDIA_SUPPORTED\n", __func__);
234 *outbuf = cpu_to_le32(params->medium);
235 retval = 0;
236 break;
238 /* mandatory */
239 case RNDIS_OID_GEN_MEDIA_IN_USE:
240 pr_debug("%s: RNDIS_OID_GEN_MEDIA_IN_USE\n", __func__);
241 /* one medium, one transport... (maybe you do it better) */
242 *outbuf = cpu_to_le32(params->medium);
243 retval = 0;
244 break;
246 /* mandatory */
247 case RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE:
248 pr_debug("%s: RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE\n", __func__);
249 if (params->dev) {
250 *outbuf = cpu_to_le32(params->dev->mtu);
251 retval = 0;
253 break;
255 /* mandatory */
256 case RNDIS_OID_GEN_LINK_SPEED:
257 if (rndis_debug > 1)
258 pr_debug("%s: RNDIS_OID_GEN_LINK_SPEED\n", __func__);
259 if (params->media_state == RNDIS_MEDIA_STATE_DISCONNECTED)
260 *outbuf = cpu_to_le32(0);
261 else
262 *outbuf = cpu_to_le32(params->speed);
263 retval = 0;
264 break;
266 /* mandatory */
267 case RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE:
268 pr_debug("%s: RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE\n", __func__);
269 if (params->dev) {
270 *outbuf = cpu_to_le32(params->dev->mtu);
271 retval = 0;
273 break;
275 /* mandatory */
276 case RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE:
277 pr_debug("%s: RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE\n", __func__);
278 if (params->dev) {
279 *outbuf = cpu_to_le32(params->dev->mtu);
280 retval = 0;
282 break;
284 /* mandatory */
285 case RNDIS_OID_GEN_VENDOR_ID:
286 pr_debug("%s: RNDIS_OID_GEN_VENDOR_ID\n", __func__);
287 *outbuf = cpu_to_le32(params->vendorID);
288 retval = 0;
289 break;
291 /* mandatory */
292 case RNDIS_OID_GEN_VENDOR_DESCRIPTION:
293 pr_debug("%s: RNDIS_OID_GEN_VENDOR_DESCRIPTION\n", __func__);
294 if (params->vendorDescr) {
295 length = strlen(params->vendorDescr);
296 memcpy(outbuf, params->vendorDescr, length);
297 } else {
298 outbuf[0] = 0;
300 retval = 0;
301 break;
303 case RNDIS_OID_GEN_VENDOR_DRIVER_VERSION:
304 pr_debug("%s: RNDIS_OID_GEN_VENDOR_DRIVER_VERSION\n", __func__);
305 /* Created as LE */
306 *outbuf = rndis_driver_version;
307 retval = 0;
308 break;
310 /* mandatory */
311 case RNDIS_OID_GEN_CURRENT_PACKET_FILTER:
312 pr_debug("%s: RNDIS_OID_GEN_CURRENT_PACKET_FILTER\n", __func__);
313 *outbuf = cpu_to_le32(*params->filter);
314 retval = 0;
315 break;
317 /* mandatory */
318 case RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE:
319 pr_debug("%s: RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE\n", __func__);
320 *outbuf = cpu_to_le32(RNDIS_MAX_TOTAL_SIZE);
321 retval = 0;
322 break;
324 /* mandatory */
325 case RNDIS_OID_GEN_MEDIA_CONNECT_STATUS:
326 if (rndis_debug > 1)
327 pr_debug("%s: RNDIS_OID_GEN_MEDIA_CONNECT_STATUS\n", __func__);
328 *outbuf = cpu_to_le32(params->media_state);
329 retval = 0;
330 break;
332 case RNDIS_OID_GEN_PHYSICAL_MEDIUM:
333 pr_debug("%s: RNDIS_OID_GEN_PHYSICAL_MEDIUM\n", __func__);
334 *outbuf = cpu_to_le32(0);
335 retval = 0;
336 break;
338 /* The RNDIS specification is incomplete/wrong. Some versions
339 * of MS-Windows expect OIDs that aren't specified there. Other
340 * versions emit undefined RNDIS messages. DOCUMENT ALL THESE!
342 case RNDIS_OID_GEN_MAC_OPTIONS: /* from WinME */
343 pr_debug("%s: RNDIS_OID_GEN_MAC_OPTIONS\n", __func__);
344 *outbuf = cpu_to_le32(
345 RNDIS_MAC_OPTION_RECEIVE_SERIALIZED
346 | RNDIS_MAC_OPTION_FULL_DUPLEX);
347 retval = 0;
348 break;
350 /* statistics OIDs (table 4-2) */
352 /* mandatory */
353 case RNDIS_OID_GEN_XMIT_OK:
354 if (rndis_debug > 1)
355 pr_debug("%s: RNDIS_OID_GEN_XMIT_OK\n", __func__);
356 if (stats) {
357 *outbuf = cpu_to_le32(stats->tx_packets
358 - stats->tx_errors - stats->tx_dropped);
359 retval = 0;
361 break;
363 /* mandatory */
364 case RNDIS_OID_GEN_RCV_OK:
365 if (rndis_debug > 1)
366 pr_debug("%s: RNDIS_OID_GEN_RCV_OK\n", __func__);
367 if (stats) {
368 *outbuf = cpu_to_le32(stats->rx_packets
369 - stats->rx_errors - stats->rx_dropped);
370 retval = 0;
372 break;
374 /* mandatory */
375 case RNDIS_OID_GEN_XMIT_ERROR:
376 if (rndis_debug > 1)
377 pr_debug("%s: RNDIS_OID_GEN_XMIT_ERROR\n", __func__);
378 if (stats) {
379 *outbuf = cpu_to_le32(stats->tx_errors);
380 retval = 0;
382 break;
384 /* mandatory */
385 case RNDIS_OID_GEN_RCV_ERROR:
386 if (rndis_debug > 1)
387 pr_debug("%s: RNDIS_OID_GEN_RCV_ERROR\n", __func__);
388 if (stats) {
389 *outbuf = cpu_to_le32(stats->rx_errors);
390 retval = 0;
392 break;
394 /* mandatory */
395 case RNDIS_OID_GEN_RCV_NO_BUFFER:
396 pr_debug("%s: RNDIS_OID_GEN_RCV_NO_BUFFER\n", __func__);
397 if (stats) {
398 *outbuf = cpu_to_le32(stats->rx_dropped);
399 retval = 0;
401 break;
403 /* ieee802.3 OIDs (table 4-3) */
405 /* mandatory */
406 case RNDIS_OID_802_3_PERMANENT_ADDRESS:
407 pr_debug("%s: RNDIS_OID_802_3_PERMANENT_ADDRESS\n", __func__);
408 if (params->dev) {
409 length = ETH_ALEN;
410 memcpy(outbuf, params->host_mac, length);
411 retval = 0;
413 break;
415 /* mandatory */
416 case RNDIS_OID_802_3_CURRENT_ADDRESS:
417 pr_debug("%s: RNDIS_OID_802_3_CURRENT_ADDRESS\n", __func__);
418 if (params->dev) {
419 length = ETH_ALEN;
420 memcpy(outbuf, params->host_mac, length);
421 retval = 0;
423 break;
425 /* mandatory */
426 case RNDIS_OID_802_3_MULTICAST_LIST:
427 pr_debug("%s: RNDIS_OID_802_3_MULTICAST_LIST\n", __func__);
428 /* Multicast base address only */
429 *outbuf = cpu_to_le32(0xE0000000);
430 retval = 0;
431 break;
433 /* mandatory */
434 case RNDIS_OID_802_3_MAXIMUM_LIST_SIZE:
435 pr_debug("%s: RNDIS_OID_802_3_MAXIMUM_LIST_SIZE\n", __func__);
436 /* Multicast base address only */
437 *outbuf = cpu_to_le32(1);
438 retval = 0;
439 break;
441 case RNDIS_OID_802_3_MAC_OPTIONS:
442 pr_debug("%s: RNDIS_OID_802_3_MAC_OPTIONS\n", __func__);
443 *outbuf = cpu_to_le32(0);
444 retval = 0;
445 break;
447 /* ieee802.3 statistics OIDs (table 4-4) */
449 /* mandatory */
450 case RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT:
451 pr_debug("%s: RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT\n", __func__);
452 if (stats) {
453 *outbuf = cpu_to_le32(stats->rx_frame_errors);
454 retval = 0;
456 break;
458 /* mandatory */
459 case RNDIS_OID_802_3_XMIT_ONE_COLLISION:
460 pr_debug("%s: RNDIS_OID_802_3_XMIT_ONE_COLLISION\n", __func__);
461 *outbuf = cpu_to_le32(0);
462 retval = 0;
463 break;
465 /* mandatory */
466 case RNDIS_OID_802_3_XMIT_MORE_COLLISIONS:
467 pr_debug("%s: RNDIS_OID_802_3_XMIT_MORE_COLLISIONS\n", __func__);
468 *outbuf = cpu_to_le32(0);
469 retval = 0;
470 break;
472 default:
473 pr_warn("%s: query unknown OID 0x%08X\n", __func__, OID);
475 if (retval < 0)
476 length = 0;
478 resp->InformationBufferLength = cpu_to_le32(length);
479 r->length = length + sizeof(*resp);
480 resp->MessageLength = cpu_to_le32(r->length);
481 return retval;
484 static int gen_ndis_set_resp(struct rndis_params *params, u32 OID,
485 u8 *buf, u32 buf_len, rndis_resp_t *r)
487 rndis_set_cmplt_type *resp;
488 int i, retval = -ENOTSUPP;
490 if (!r)
491 return -ENOMEM;
492 resp = (rndis_set_cmplt_type *)r->buf;
493 if (!resp)
494 return -ENOMEM;
496 if (buf_len && rndis_debug > 1) {
497 pr_debug("set OID %08x value, len %d:\n", OID, buf_len);
498 for (i = 0; i < buf_len; i += 16) {
499 pr_debug("%03d: %08x %08x %08x %08x\n", i,
500 get_unaligned_le32(&buf[i]),
501 get_unaligned_le32(&buf[i + 4]),
502 get_unaligned_le32(&buf[i + 8]),
503 get_unaligned_le32(&buf[i + 12]));
507 switch (OID) {
508 case RNDIS_OID_GEN_CURRENT_PACKET_FILTER:
510 /* these NDIS_PACKET_TYPE_* bitflags are shared with
511 * cdc_filter; it's not RNDIS-specific
512 * NDIS_PACKET_TYPE_x == USB_CDC_PACKET_TYPE_x for x in:
513 * PROMISCUOUS, DIRECTED,
514 * MULTICAST, ALL_MULTICAST, BROADCAST
516 *params->filter = (u16)get_unaligned_le32(buf);
517 pr_debug("%s: RNDIS_OID_GEN_CURRENT_PACKET_FILTER %08x\n",
518 __func__, *params->filter);
520 /* this call has a significant side effect: it's
521 * what makes the packet flow start and stop, like
522 * activating the CDC Ethernet altsetting.
524 retval = 0;
525 if (*params->filter) {
526 params->state = RNDIS_DATA_INITIALIZED;
527 netif_carrier_on(params->dev);
528 if (netif_running(params->dev))
529 netif_wake_queue(params->dev);
530 } else {
531 params->state = RNDIS_INITIALIZED;
532 netif_carrier_off(params->dev);
533 netif_stop_queue(params->dev);
535 break;
537 case RNDIS_OID_802_3_MULTICAST_LIST:
538 /* I think we can ignore this */
539 pr_debug("%s: RNDIS_OID_802_3_MULTICAST_LIST\n", __func__);
540 retval = 0;
541 break;
543 default:
544 pr_warn("%s: set unknown OID 0x%08X, size %d\n",
545 __func__, OID, buf_len);
548 return retval;
552 * Response Functions
555 static int rndis_init_response(struct rndis_params *params,
556 rndis_init_msg_type *buf)
558 rndis_init_cmplt_type *resp;
559 rndis_resp_t *r;
561 if (!params->dev)
562 return -ENOTSUPP;
564 r = rndis_add_response(params, sizeof(rndis_init_cmplt_type));
565 if (!r)
566 return -ENOMEM;
567 resp = (rndis_init_cmplt_type *)r->buf;
569 resp->MessageType = cpu_to_le32(RNDIS_MSG_INIT_C);
570 resp->MessageLength = cpu_to_le32(52);
571 resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
572 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
573 resp->MajorVersion = cpu_to_le32(RNDIS_MAJOR_VERSION);
574 resp->MinorVersion = cpu_to_le32(RNDIS_MINOR_VERSION);
575 resp->DeviceFlags = cpu_to_le32(RNDIS_DF_CONNECTIONLESS);
576 resp->Medium = cpu_to_le32(RNDIS_MEDIUM_802_3);
577 resp->MaxPacketsPerTransfer = cpu_to_le32(1);
578 resp->MaxTransferSize = cpu_to_le32(
579 params->dev->mtu
580 + sizeof(struct ethhdr)
581 + sizeof(struct rndis_packet_msg_type)
582 + 22);
583 resp->PacketAlignmentFactor = cpu_to_le32(0);
584 resp->AFListOffset = cpu_to_le32(0);
585 resp->AFListSize = cpu_to_le32(0);
587 params->resp_avail(params->v);
588 return 0;
591 static int rndis_query_response(struct rndis_params *params,
592 rndis_query_msg_type *buf)
594 rndis_query_cmplt_type *resp;
595 rndis_resp_t *r;
597 /* pr_debug("%s: OID = %08X\n", __func__, cpu_to_le32(buf->OID)); */
598 if (!params->dev)
599 return -ENOTSUPP;
602 * we need more memory:
603 * gen_ndis_query_resp expects enough space for
604 * rndis_query_cmplt_type followed by data.
605 * oid_supported_list is the largest data reply
607 r = rndis_add_response(params,
608 sizeof(oid_supported_list) + sizeof(rndis_query_cmplt_type));
609 if (!r)
610 return -ENOMEM;
611 resp = (rndis_query_cmplt_type *)r->buf;
613 resp->MessageType = cpu_to_le32(RNDIS_MSG_QUERY_C);
614 resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
616 if (gen_ndis_query_resp(params, le32_to_cpu(buf->OID),
617 le32_to_cpu(buf->InformationBufferOffset)
618 + 8 + (u8 *)buf,
619 le32_to_cpu(buf->InformationBufferLength),
620 r)) {
621 /* OID not supported */
622 resp->Status = cpu_to_le32(RNDIS_STATUS_NOT_SUPPORTED);
623 resp->MessageLength = cpu_to_le32(sizeof *resp);
624 resp->InformationBufferLength = cpu_to_le32(0);
625 resp->InformationBufferOffset = cpu_to_le32(0);
626 } else
627 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
629 params->resp_avail(params->v);
630 return 0;
633 static int rndis_set_response(struct rndis_params *params,
634 rndis_set_msg_type *buf)
636 u32 BufLength, BufOffset;
637 rndis_set_cmplt_type *resp;
638 rndis_resp_t *r;
640 r = rndis_add_response(params, sizeof(rndis_set_cmplt_type));
641 if (!r)
642 return -ENOMEM;
643 resp = (rndis_set_cmplt_type *)r->buf;
645 BufLength = le32_to_cpu(buf->InformationBufferLength);
646 BufOffset = le32_to_cpu(buf->InformationBufferOffset);
648 #ifdef VERBOSE_DEBUG
649 pr_debug("%s: Length: %d\n", __func__, BufLength);
650 pr_debug("%s: Offset: %d\n", __func__, BufOffset);
651 pr_debug("%s: InfoBuffer: ", __func__);
653 for (i = 0; i < BufLength; i++) {
654 pr_debug("%02x ", *(((u8 *) buf) + i + 8 + BufOffset));
657 pr_debug("\n");
658 #endif
660 resp->MessageType = cpu_to_le32(RNDIS_MSG_SET_C);
661 resp->MessageLength = cpu_to_le32(16);
662 resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
663 if (gen_ndis_set_resp(params, le32_to_cpu(buf->OID),
664 ((u8 *)buf) + 8 + BufOffset, BufLength, r))
665 resp->Status = cpu_to_le32(RNDIS_STATUS_NOT_SUPPORTED);
666 else
667 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
669 params->resp_avail(params->v);
670 return 0;
673 static int rndis_reset_response(struct rndis_params *params,
674 rndis_reset_msg_type *buf)
676 rndis_reset_cmplt_type *resp;
677 rndis_resp_t *r;
678 u8 *xbuf;
679 u32 length;
681 /* drain the response queue */
682 while ((xbuf = rndis_get_next_response(params, &length)))
683 rndis_free_response(params, xbuf);
685 r = rndis_add_response(params, sizeof(rndis_reset_cmplt_type));
686 if (!r)
687 return -ENOMEM;
688 resp = (rndis_reset_cmplt_type *)r->buf;
690 resp->MessageType = cpu_to_le32(RNDIS_MSG_RESET_C);
691 resp->MessageLength = cpu_to_le32(16);
692 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
693 /* resent information */
694 resp->AddressingReset = cpu_to_le32(1);
696 params->resp_avail(params->v);
697 return 0;
700 static int rndis_keepalive_response(struct rndis_params *params,
701 rndis_keepalive_msg_type *buf)
703 rndis_keepalive_cmplt_type *resp;
704 rndis_resp_t *r;
706 /* host "should" check only in RNDIS_DATA_INITIALIZED state */
708 r = rndis_add_response(params, sizeof(rndis_keepalive_cmplt_type));
709 if (!r)
710 return -ENOMEM;
711 resp = (rndis_keepalive_cmplt_type *)r->buf;
713 resp->MessageType = cpu_to_le32(RNDIS_MSG_KEEPALIVE_C);
714 resp->MessageLength = cpu_to_le32(16);
715 resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
716 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
718 params->resp_avail(params->v);
719 return 0;
724 * Device to Host Comunication
726 static int rndis_indicate_status_msg(struct rndis_params *params, u32 status)
728 rndis_indicate_status_msg_type *resp;
729 rndis_resp_t *r;
731 if (params->state == RNDIS_UNINITIALIZED)
732 return -ENOTSUPP;
734 r = rndis_add_response(params, sizeof(rndis_indicate_status_msg_type));
735 if (!r)
736 return -ENOMEM;
737 resp = (rndis_indicate_status_msg_type *)r->buf;
739 resp->MessageType = cpu_to_le32(RNDIS_MSG_INDICATE);
740 resp->MessageLength = cpu_to_le32(20);
741 resp->Status = cpu_to_le32(status);
742 resp->StatusBufferLength = cpu_to_le32(0);
743 resp->StatusBufferOffset = cpu_to_le32(0);
745 params->resp_avail(params->v);
746 return 0;
749 int rndis_signal_connect(struct rndis_params *params)
751 params->media_state = RNDIS_MEDIA_STATE_CONNECTED;
752 return rndis_indicate_status_msg(params, RNDIS_STATUS_MEDIA_CONNECT);
754 EXPORT_SYMBOL_GPL(rndis_signal_connect);
756 int rndis_signal_disconnect(struct rndis_params *params)
758 params->media_state = RNDIS_MEDIA_STATE_DISCONNECTED;
759 return rndis_indicate_status_msg(params, RNDIS_STATUS_MEDIA_DISCONNECT);
761 EXPORT_SYMBOL_GPL(rndis_signal_disconnect);
763 void rndis_uninit(struct rndis_params *params)
765 u8 *buf;
766 u32 length;
768 if (!params)
769 return;
770 params->state = RNDIS_UNINITIALIZED;
772 /* drain the response queue */
773 while ((buf = rndis_get_next_response(params, &length)))
774 rndis_free_response(params, buf);
776 EXPORT_SYMBOL_GPL(rndis_uninit);
778 void rndis_set_host_mac(struct rndis_params *params, const u8 *addr)
780 params->host_mac = addr;
782 EXPORT_SYMBOL_GPL(rndis_set_host_mac);
785 * Message Parser
787 int rndis_msg_parser(struct rndis_params *params, u8 *buf)
789 u32 MsgType, MsgLength;
790 __le32 *tmp;
792 if (!buf)
793 return -ENOMEM;
795 tmp = (__le32 *)buf;
796 MsgType = get_unaligned_le32(tmp++);
797 MsgLength = get_unaligned_le32(tmp++);
799 if (!params)
800 return -ENOTSUPP;
802 /* NOTE: RNDIS is *EXTREMELY* chatty ... Windows constantly polls for
803 * rx/tx statistics and link status, in addition to KEEPALIVE traffic
804 * and normal HC level polling to see if there's any IN traffic.
807 /* For USB: responses may take up to 10 seconds */
808 switch (MsgType) {
809 case RNDIS_MSG_INIT:
810 pr_debug("%s: RNDIS_MSG_INIT\n",
811 __func__);
812 params->state = RNDIS_INITIALIZED;
813 return rndis_init_response(params, (rndis_init_msg_type *)buf);
815 case RNDIS_MSG_HALT:
816 pr_debug("%s: RNDIS_MSG_HALT\n",
817 __func__);
818 params->state = RNDIS_UNINITIALIZED;
819 if (params->dev) {
820 netif_carrier_off(params->dev);
821 netif_stop_queue(params->dev);
823 return 0;
825 case RNDIS_MSG_QUERY:
826 return rndis_query_response(params,
827 (rndis_query_msg_type *)buf);
829 case RNDIS_MSG_SET:
830 return rndis_set_response(params, (rndis_set_msg_type *)buf);
832 case RNDIS_MSG_RESET:
833 pr_debug("%s: RNDIS_MSG_RESET\n",
834 __func__);
835 return rndis_reset_response(params,
836 (rndis_reset_msg_type *)buf);
838 case RNDIS_MSG_KEEPALIVE:
839 /* For USB: host does this every 5 seconds */
840 if (rndis_debug > 1)
841 pr_debug("%s: RNDIS_MSG_KEEPALIVE\n",
842 __func__);
843 return rndis_keepalive_response(params,
844 (rndis_keepalive_msg_type *)
845 buf);
847 default:
848 /* At least Windows XP emits some undefined RNDIS messages.
849 * In one case those messages seemed to relate to the host
850 * suspending itself.
852 pr_warn("%s: unknown RNDIS message 0x%08X len %d\n",
853 __func__, MsgType, MsgLength);
854 /* Garbled message can be huge, so limit what we display */
855 if (MsgLength > 16)
856 MsgLength = 16;
857 print_hex_dump_bytes(__func__, DUMP_PREFIX_OFFSET,
858 buf, MsgLength);
859 break;
862 return -ENOTSUPP;
864 EXPORT_SYMBOL_GPL(rndis_msg_parser);
866 static inline int rndis_get_nr(void)
868 return ida_simple_get(&rndis_ida, 0, 0, GFP_KERNEL);
871 static inline void rndis_put_nr(int nr)
873 ida_simple_remove(&rndis_ida, nr);
876 struct rndis_params *rndis_register(void (*resp_avail)(void *v), void *v)
878 struct rndis_params *params;
879 int i;
881 if (!resp_avail)
882 return ERR_PTR(-EINVAL);
884 i = rndis_get_nr();
885 if (i < 0) {
886 pr_debug("failed\n");
888 return ERR_PTR(-ENODEV);
891 params = kzalloc(sizeof(*params), GFP_KERNEL);
892 if (!params) {
893 rndis_put_nr(i);
895 return ERR_PTR(-ENOMEM);
898 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
900 struct proc_dir_entry *proc_entry;
901 char name[20];
903 sprintf(name, NAME_TEMPLATE, i);
904 proc_entry = proc_create_data(name, 0660, NULL,
905 &rndis_proc_ops, params);
906 if (!proc_entry) {
907 kfree(params);
908 rndis_put_nr(i);
910 return ERR_PTR(-EIO);
913 #endif
915 params->confignr = i;
916 params->used = 1;
917 params->state = RNDIS_UNINITIALIZED;
918 params->media_state = RNDIS_MEDIA_STATE_DISCONNECTED;
919 params->resp_avail = resp_avail;
920 params->v = v;
921 INIT_LIST_HEAD(&params->resp_queue);
922 pr_debug("%s: configNr = %d\n", __func__, i);
924 return params;
926 EXPORT_SYMBOL_GPL(rndis_register);
928 void rndis_deregister(struct rndis_params *params)
930 int i;
932 pr_debug("%s:\n", __func__);
934 if (!params)
935 return;
937 i = params->confignr;
939 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
941 char name[20];
943 sprintf(name, NAME_TEMPLATE, i);
944 remove_proc_entry(name, NULL);
946 #endif
948 kfree(params);
949 rndis_put_nr(i);
951 EXPORT_SYMBOL_GPL(rndis_deregister);
952 int rndis_set_param_dev(struct rndis_params *params, struct net_device *dev,
953 u16 *cdc_filter)
955 pr_debug("%s:\n", __func__);
956 if (!dev)
957 return -EINVAL;
958 if (!params)
959 return -1;
961 params->dev = dev;
962 params->filter = cdc_filter;
964 return 0;
966 EXPORT_SYMBOL_GPL(rndis_set_param_dev);
968 int rndis_set_param_vendor(struct rndis_params *params, u32 vendorID,
969 const char *vendorDescr)
971 pr_debug("%s:\n", __func__);
972 if (!vendorDescr) return -1;
973 if (!params)
974 return -1;
976 params->vendorID = vendorID;
977 params->vendorDescr = vendorDescr;
979 return 0;
981 EXPORT_SYMBOL_GPL(rndis_set_param_vendor);
983 int rndis_set_param_medium(struct rndis_params *params, u32 medium, u32 speed)
985 pr_debug("%s: %u %u\n", __func__, medium, speed);
986 if (!params)
987 return -1;
989 params->medium = medium;
990 params->speed = speed;
992 return 0;
994 EXPORT_SYMBOL_GPL(rndis_set_param_medium);
996 void rndis_add_hdr(struct sk_buff *skb)
998 struct rndis_packet_msg_type *header;
1000 if (!skb)
1001 return;
1002 header = skb_push(skb, sizeof(*header));
1003 memset(header, 0, sizeof *header);
1004 header->MessageType = cpu_to_le32(RNDIS_MSG_PACKET);
1005 header->MessageLength = cpu_to_le32(skb->len);
1006 header->DataOffset = cpu_to_le32(36);
1007 header->DataLength = cpu_to_le32(skb->len - sizeof(*header));
1009 EXPORT_SYMBOL_GPL(rndis_add_hdr);
1011 void rndis_free_response(struct rndis_params *params, u8 *buf)
1013 rndis_resp_t *r, *n;
1015 list_for_each_entry_safe(r, n, &params->resp_queue, list) {
1016 if (r->buf == buf) {
1017 list_del(&r->list);
1018 kfree(r);
1022 EXPORT_SYMBOL_GPL(rndis_free_response);
1024 u8 *rndis_get_next_response(struct rndis_params *params, u32 *length)
1026 rndis_resp_t *r, *n;
1028 if (!length) return NULL;
1030 list_for_each_entry_safe(r, n, &params->resp_queue, list) {
1031 if (!r->send) {
1032 r->send = 1;
1033 *length = r->length;
1034 return r->buf;
1038 return NULL;
1040 EXPORT_SYMBOL_GPL(rndis_get_next_response);
1042 static rndis_resp_t *rndis_add_response(struct rndis_params *params, u32 length)
1044 rndis_resp_t *r;
1046 /* NOTE: this gets copied into ether.c USB_BUFSIZ bytes ... */
1047 r = kmalloc(sizeof(rndis_resp_t) + length, GFP_ATOMIC);
1048 if (!r) return NULL;
1050 r->buf = (u8 *)(r + 1);
1051 r->length = length;
1052 r->send = 0;
1054 list_add_tail(&r->list, &params->resp_queue);
1055 return r;
1058 int rndis_rm_hdr(struct gether *port,
1059 struct sk_buff *skb,
1060 struct sk_buff_head *list)
1062 /* tmp points to a struct rndis_packet_msg_type */
1063 __le32 *tmp = (void *)skb->data;
1065 /* MessageType, MessageLength */
1066 if (cpu_to_le32(RNDIS_MSG_PACKET)
1067 != get_unaligned(tmp++)) {
1068 dev_kfree_skb_any(skb);
1069 return -EINVAL;
1071 tmp++;
1073 /* DataOffset, DataLength */
1074 if (!skb_pull(skb, get_unaligned_le32(tmp++) + 8)) {
1075 dev_kfree_skb_any(skb);
1076 return -EOVERFLOW;
1078 skb_trim(skb, get_unaligned_le32(tmp++));
1080 skb_queue_tail(list, skb);
1081 return 0;
1083 EXPORT_SYMBOL_GPL(rndis_rm_hdr);
1085 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
1087 static int rndis_proc_show(struct seq_file *m, void *v)
1089 rndis_params *param = m->private;
1091 seq_printf(m,
1092 "Config Nr. %d\n"
1093 "used : %s\n"
1094 "state : %s\n"
1095 "medium : 0x%08X\n"
1096 "speed : %d\n"
1097 "cable : %s\n"
1098 "vendor ID : 0x%08X\n"
1099 "vendor : %s\n",
1100 param->confignr, (param->used) ? "y" : "n",
1101 ({ char *s = "?";
1102 switch (param->state) {
1103 case RNDIS_UNINITIALIZED:
1104 s = "RNDIS_UNINITIALIZED"; break;
1105 case RNDIS_INITIALIZED:
1106 s = "RNDIS_INITIALIZED"; break;
1107 case RNDIS_DATA_INITIALIZED:
1108 s = "RNDIS_DATA_INITIALIZED"; break;
1109 } s; }),
1110 param->medium,
1111 (param->media_state) ? 0 : param->speed*100,
1112 (param->media_state) ? "disconnected" : "connected",
1113 param->vendorID, param->vendorDescr);
1114 return 0;
1117 static ssize_t rndis_proc_write(struct file *file, const char __user *buffer,
1118 size_t count, loff_t *ppos)
1120 rndis_params *p = PDE_DATA(file_inode(file));
1121 u32 speed = 0;
1122 int i, fl_speed = 0;
1124 for (i = 0; i < count; i++) {
1125 char c;
1126 if (get_user(c, buffer))
1127 return -EFAULT;
1128 switch (c) {
1129 case '0':
1130 case '1':
1131 case '2':
1132 case '3':
1133 case '4':
1134 case '5':
1135 case '6':
1136 case '7':
1137 case '8':
1138 case '9':
1139 fl_speed = 1;
1140 speed = speed * 10 + c - '0';
1141 break;
1142 case 'C':
1143 case 'c':
1144 rndis_signal_connect(p);
1145 break;
1146 case 'D':
1147 case 'd':
1148 rndis_signal_disconnect(p);
1149 break;
1150 default:
1151 if (fl_speed) p->speed = speed;
1152 else pr_debug("%c is not valid\n", c);
1153 break;
1156 buffer++;
1159 return count;
1162 static int rndis_proc_open(struct inode *inode, struct file *file)
1164 return single_open(file, rndis_proc_show, PDE_DATA(inode));
1167 static const struct proc_ops rndis_proc_ops = {
1168 .proc_open = rndis_proc_open,
1169 .proc_read = seq_read,
1170 .proc_lseek = seq_lseek,
1171 .proc_release = single_release,
1172 .proc_write = rndis_proc_write,
1175 #define NAME_TEMPLATE "driver/rndis-%03d"
1177 #endif /* CONFIG_USB_GADGET_DEBUG_FILES */