4 * Authors: Benedikt Spranger, Pengutronix
5 * Robert Schwebel, Pengutronix
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * version 2, as published by the Free Software Foundation.
11 * This software was originally developed in conformance with
12 * Microsoft's Remote NDIS Specification License Agreement.
14 * 03/12/2004 Kai-Uwe Bloem <linux-development@auerswald.de>
15 * Fixed message length bug in init_response
17 * 03/25/2004 Kai-Uwe Bloem <linux-development@auerswald.de>
18 * Fixed rndis_rm_hdr length bug.
20 * Copyright (C) 2004 by David Brownell
21 * updates to merge with Linux 2.6, better match RNDIS spec
24 #include <linux/module.h>
25 #include <linux/moduleparam.h>
26 #include <linux/kernel.h>
27 #include <linux/errno.h>
28 #include <linux/idr.h>
29 #include <linux/list.h>
30 #include <linux/proc_fs.h>
31 #include <linux/slab.h>
32 #include <linux/seq_file.h>
33 #include <linux/netdevice.h>
36 #include <asm/byteorder.h>
37 #include <asm/unaligned.h>
46 /* The driver for your USB chip needs to support ep0 OUT to work with
47 * RNDIS, plus all three CDC Ethernet endpoints (interrupt not optional).
49 * Windows hosts need an INF file like Documentation/usb/linux.inf
50 * and will be happier if you provide the host_addr module parameter.
54 static int rndis_debug = 0;
55 module_param (rndis_debug, int, 0);
56 MODULE_PARM_DESC (rndis_debug, "enable debugging");
61 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
63 #define NAME_TEMPLATE "driver/rndis-%03d"
65 #endif /* CONFIG_USB_GADGET_DEBUG_FILES */
67 static DEFINE_IDA(rndis_ida);
70 static const __le32 rndis_driver_version = cpu_to_le32(1);
72 /* Function Prototypes */
73 static rndis_resp_t *rndis_add_response(struct rndis_params *params,
76 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
78 static const struct file_operations rndis_proc_fops;
80 #endif /* CONFIG_USB_GADGET_DEBUG_FILES */
83 static const u32 oid_supported_list[] =
85 /* the general stuff */
86 RNDIS_OID_GEN_SUPPORTED_LIST,
87 RNDIS_OID_GEN_HARDWARE_STATUS,
88 RNDIS_OID_GEN_MEDIA_SUPPORTED,
89 RNDIS_OID_GEN_MEDIA_IN_USE,
90 RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE,
91 RNDIS_OID_GEN_LINK_SPEED,
92 RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE,
93 RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE,
94 RNDIS_OID_GEN_VENDOR_ID,
95 RNDIS_OID_GEN_VENDOR_DESCRIPTION,
96 RNDIS_OID_GEN_VENDOR_DRIVER_VERSION,
97 RNDIS_OID_GEN_CURRENT_PACKET_FILTER,
98 RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE,
99 RNDIS_OID_GEN_MEDIA_CONNECT_STATUS,
100 RNDIS_OID_GEN_PHYSICAL_MEDIUM,
102 /* the statistical stuff */
103 RNDIS_OID_GEN_XMIT_OK,
104 RNDIS_OID_GEN_RCV_OK,
105 RNDIS_OID_GEN_XMIT_ERROR,
106 RNDIS_OID_GEN_RCV_ERROR,
107 RNDIS_OID_GEN_RCV_NO_BUFFER,
108 #ifdef RNDIS_OPTIONAL_STATS
109 RNDIS_OID_GEN_DIRECTED_BYTES_XMIT,
110 RNDIS_OID_GEN_DIRECTED_FRAMES_XMIT,
111 RNDIS_OID_GEN_MULTICAST_BYTES_XMIT,
112 RNDIS_OID_GEN_MULTICAST_FRAMES_XMIT,
113 RNDIS_OID_GEN_BROADCAST_BYTES_XMIT,
114 RNDIS_OID_GEN_BROADCAST_FRAMES_XMIT,
115 RNDIS_OID_GEN_DIRECTED_BYTES_RCV,
116 RNDIS_OID_GEN_DIRECTED_FRAMES_RCV,
117 RNDIS_OID_GEN_MULTICAST_BYTES_RCV,
118 RNDIS_OID_GEN_MULTICAST_FRAMES_RCV,
119 RNDIS_OID_GEN_BROADCAST_BYTES_RCV,
120 RNDIS_OID_GEN_BROADCAST_FRAMES_RCV,
121 RNDIS_OID_GEN_RCV_CRC_ERROR,
122 RNDIS_OID_GEN_TRANSMIT_QUEUE_LENGTH,
123 #endif /* RNDIS_OPTIONAL_STATS */
125 /* mandatory 802.3 */
126 /* the general stuff */
127 RNDIS_OID_802_3_PERMANENT_ADDRESS,
128 RNDIS_OID_802_3_CURRENT_ADDRESS,
129 RNDIS_OID_802_3_MULTICAST_LIST,
130 RNDIS_OID_802_3_MAC_OPTIONS,
131 RNDIS_OID_802_3_MAXIMUM_LIST_SIZE,
133 /* the statistical stuff */
134 RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT,
135 RNDIS_OID_802_3_XMIT_ONE_COLLISION,
136 RNDIS_OID_802_3_XMIT_MORE_COLLISIONS,
137 #ifdef RNDIS_OPTIONAL_STATS
138 RNDIS_OID_802_3_XMIT_DEFERRED,
139 RNDIS_OID_802_3_XMIT_MAX_COLLISIONS,
140 RNDIS_OID_802_3_RCV_OVERRUN,
141 RNDIS_OID_802_3_XMIT_UNDERRUN,
142 RNDIS_OID_802_3_XMIT_HEARTBEAT_FAILURE,
143 RNDIS_OID_802_3_XMIT_TIMES_CRS_LOST,
144 RNDIS_OID_802_3_XMIT_LATE_COLLISIONS,
145 #endif /* RNDIS_OPTIONAL_STATS */
148 /* PM and wakeup are "mandatory" for USB, but the RNDIS specs
149 * don't say what they mean ... and the NDIS specs are often
150 * confusing and/or ambiguous in this context. (That is, more
151 * so than their specs for the other OIDs.)
153 * FIXME someone who knows what these should do, please
157 /* power management */
158 OID_PNP_CAPABILITIES,
164 OID_PNP_ENABLE_WAKE_UP,
165 OID_PNP_ADD_WAKE_UP_PATTERN,
166 OID_PNP_REMOVE_WAKE_UP_PATTERN,
167 #endif /* RNDIS_WAKEUP */
168 #endif /* RNDIS_PM */
173 static int gen_ndis_query_resp(struct rndis_params *params, u32 OID, u8 *buf,
174 unsigned buf_len, rndis_resp_t *r)
176 int retval = -ENOTSUPP;
177 u32 length = 4; /* usually */
180 rndis_query_cmplt_type *resp;
181 struct net_device *net;
182 struct rtnl_link_stats64 temp;
183 const struct rtnl_link_stats64 *stats;
185 if (!r) return -ENOMEM;
186 resp = (rndis_query_cmplt_type *)r->buf;
188 if (!resp) return -ENOMEM;
190 if (buf_len && rndis_debug > 1) {
191 pr_debug("query OID %08x value, len %d:\n", OID, buf_len);
192 for (i = 0; i < buf_len; i += 16) {
193 pr_debug("%03d: %08x %08x %08x %08x\n", i,
194 get_unaligned_le32(&buf[i]),
195 get_unaligned_le32(&buf[i + 4]),
196 get_unaligned_le32(&buf[i + 8]),
197 get_unaligned_le32(&buf[i + 12]));
201 /* response goes here, right after the header */
202 outbuf = (__le32 *)&resp[1];
203 resp->InformationBufferOffset = cpu_to_le32(16);
206 stats = dev_get_stats(net, &temp);
210 /* general oids (table 4-1) */
213 case RNDIS_OID_GEN_SUPPORTED_LIST:
214 pr_debug("%s: RNDIS_OID_GEN_SUPPORTED_LIST\n", __func__);
215 length = sizeof(oid_supported_list);
216 count = length / sizeof(u32);
217 for (i = 0; i < count; i++)
218 outbuf[i] = cpu_to_le32(oid_supported_list[i]);
223 case RNDIS_OID_GEN_HARDWARE_STATUS:
224 pr_debug("%s: RNDIS_OID_GEN_HARDWARE_STATUS\n", __func__);
226 * Hardware must be ready to receive high level protocols.
228 * reddite ergo quae sunt Caesaris Caesari
229 * et quae sunt Dei Deo!
231 *outbuf = cpu_to_le32(0);
236 case RNDIS_OID_GEN_MEDIA_SUPPORTED:
237 pr_debug("%s: RNDIS_OID_GEN_MEDIA_SUPPORTED\n", __func__);
238 *outbuf = cpu_to_le32(params->medium);
243 case RNDIS_OID_GEN_MEDIA_IN_USE:
244 pr_debug("%s: RNDIS_OID_GEN_MEDIA_IN_USE\n", __func__);
245 /* one medium, one transport... (maybe you do it better) */
246 *outbuf = cpu_to_le32(params->medium);
251 case RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE:
252 pr_debug("%s: RNDIS_OID_GEN_MAXIMUM_FRAME_SIZE\n", __func__);
254 *outbuf = cpu_to_le32(params->dev->mtu);
260 case RNDIS_OID_GEN_LINK_SPEED:
262 pr_debug("%s: RNDIS_OID_GEN_LINK_SPEED\n", __func__);
263 if (params->media_state == RNDIS_MEDIA_STATE_DISCONNECTED)
264 *outbuf = cpu_to_le32(0);
266 *outbuf = cpu_to_le32(params->speed);
271 case RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE:
272 pr_debug("%s: RNDIS_OID_GEN_TRANSMIT_BLOCK_SIZE\n", __func__);
274 *outbuf = cpu_to_le32(params->dev->mtu);
280 case RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE:
281 pr_debug("%s: RNDIS_OID_GEN_RECEIVE_BLOCK_SIZE\n", __func__);
283 *outbuf = cpu_to_le32(params->dev->mtu);
289 case RNDIS_OID_GEN_VENDOR_ID:
290 pr_debug("%s: RNDIS_OID_GEN_VENDOR_ID\n", __func__);
291 *outbuf = cpu_to_le32(params->vendorID);
296 case RNDIS_OID_GEN_VENDOR_DESCRIPTION:
297 pr_debug("%s: RNDIS_OID_GEN_VENDOR_DESCRIPTION\n", __func__);
298 if (params->vendorDescr) {
299 length = strlen(params->vendorDescr);
300 memcpy(outbuf, params->vendorDescr, length);
307 case RNDIS_OID_GEN_VENDOR_DRIVER_VERSION:
308 pr_debug("%s: RNDIS_OID_GEN_VENDOR_DRIVER_VERSION\n", __func__);
310 *outbuf = rndis_driver_version;
315 case RNDIS_OID_GEN_CURRENT_PACKET_FILTER:
316 pr_debug("%s: RNDIS_OID_GEN_CURRENT_PACKET_FILTER\n", __func__);
317 *outbuf = cpu_to_le32(*params->filter);
322 case RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE:
323 pr_debug("%s: RNDIS_OID_GEN_MAXIMUM_TOTAL_SIZE\n", __func__);
324 *outbuf = cpu_to_le32(RNDIS_MAX_TOTAL_SIZE);
329 case RNDIS_OID_GEN_MEDIA_CONNECT_STATUS:
331 pr_debug("%s: RNDIS_OID_GEN_MEDIA_CONNECT_STATUS\n", __func__);
332 *outbuf = cpu_to_le32(params->media_state);
336 case RNDIS_OID_GEN_PHYSICAL_MEDIUM:
337 pr_debug("%s: RNDIS_OID_GEN_PHYSICAL_MEDIUM\n", __func__);
338 *outbuf = cpu_to_le32(0);
342 /* The RNDIS specification is incomplete/wrong. Some versions
343 * of MS-Windows expect OIDs that aren't specified there. Other
344 * versions emit undefined RNDIS messages. DOCUMENT ALL THESE!
346 case RNDIS_OID_GEN_MAC_OPTIONS: /* from WinME */
347 pr_debug("%s: RNDIS_OID_GEN_MAC_OPTIONS\n", __func__);
348 *outbuf = cpu_to_le32(
349 RNDIS_MAC_OPTION_RECEIVE_SERIALIZED
350 | RNDIS_MAC_OPTION_FULL_DUPLEX);
354 /* statistics OIDs (table 4-2) */
357 case RNDIS_OID_GEN_XMIT_OK:
359 pr_debug("%s: RNDIS_OID_GEN_XMIT_OK\n", __func__);
361 *outbuf = cpu_to_le32(stats->tx_packets
362 - stats->tx_errors - stats->tx_dropped);
368 case RNDIS_OID_GEN_RCV_OK:
370 pr_debug("%s: RNDIS_OID_GEN_RCV_OK\n", __func__);
372 *outbuf = cpu_to_le32(stats->rx_packets
373 - stats->rx_errors - stats->rx_dropped);
379 case RNDIS_OID_GEN_XMIT_ERROR:
381 pr_debug("%s: RNDIS_OID_GEN_XMIT_ERROR\n", __func__);
383 *outbuf = cpu_to_le32(stats->tx_errors);
389 case RNDIS_OID_GEN_RCV_ERROR:
391 pr_debug("%s: RNDIS_OID_GEN_RCV_ERROR\n", __func__);
393 *outbuf = cpu_to_le32(stats->rx_errors);
399 case RNDIS_OID_GEN_RCV_NO_BUFFER:
400 pr_debug("%s: RNDIS_OID_GEN_RCV_NO_BUFFER\n", __func__);
402 *outbuf = cpu_to_le32(stats->rx_dropped);
407 /* ieee802.3 OIDs (table 4-3) */
410 case RNDIS_OID_802_3_PERMANENT_ADDRESS:
411 pr_debug("%s: RNDIS_OID_802_3_PERMANENT_ADDRESS\n", __func__);
414 memcpy(outbuf, params->host_mac, length);
420 case RNDIS_OID_802_3_CURRENT_ADDRESS:
421 pr_debug("%s: RNDIS_OID_802_3_CURRENT_ADDRESS\n", __func__);
424 memcpy(outbuf, params->host_mac, length);
430 case RNDIS_OID_802_3_MULTICAST_LIST:
431 pr_debug("%s: RNDIS_OID_802_3_MULTICAST_LIST\n", __func__);
432 /* Multicast base address only */
433 *outbuf = cpu_to_le32(0xE0000000);
438 case RNDIS_OID_802_3_MAXIMUM_LIST_SIZE:
439 pr_debug("%s: RNDIS_OID_802_3_MAXIMUM_LIST_SIZE\n", __func__);
440 /* Multicast base address only */
441 *outbuf = cpu_to_le32(1);
445 case RNDIS_OID_802_3_MAC_OPTIONS:
446 pr_debug("%s: RNDIS_OID_802_3_MAC_OPTIONS\n", __func__);
447 *outbuf = cpu_to_le32(0);
451 /* ieee802.3 statistics OIDs (table 4-4) */
454 case RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT:
455 pr_debug("%s: RNDIS_OID_802_3_RCV_ERROR_ALIGNMENT\n", __func__);
457 *outbuf = cpu_to_le32(stats->rx_frame_errors);
463 case RNDIS_OID_802_3_XMIT_ONE_COLLISION:
464 pr_debug("%s: RNDIS_OID_802_3_XMIT_ONE_COLLISION\n", __func__);
465 *outbuf = cpu_to_le32(0);
470 case RNDIS_OID_802_3_XMIT_MORE_COLLISIONS:
471 pr_debug("%s: RNDIS_OID_802_3_XMIT_MORE_COLLISIONS\n", __func__);
472 *outbuf = cpu_to_le32(0);
477 pr_warning("%s: query unknown OID 0x%08X\n",
483 resp->InformationBufferLength = cpu_to_le32(length);
484 r->length = length + sizeof(*resp);
485 resp->MessageLength = cpu_to_le32(r->length);
489 static int gen_ndis_set_resp(struct rndis_params *params, u32 OID,
490 u8 *buf, u32 buf_len, rndis_resp_t *r)
492 rndis_set_cmplt_type *resp;
493 int i, retval = -ENOTSUPP;
497 resp = (rndis_set_cmplt_type *)r->buf;
501 if (buf_len && rndis_debug > 1) {
502 pr_debug("set OID %08x value, len %d:\n", OID, buf_len);
503 for (i = 0; i < buf_len; i += 16) {
504 pr_debug("%03d: %08x %08x %08x %08x\n", i,
505 get_unaligned_le32(&buf[i]),
506 get_unaligned_le32(&buf[i + 4]),
507 get_unaligned_le32(&buf[i + 8]),
508 get_unaligned_le32(&buf[i + 12]));
513 case RNDIS_OID_GEN_CURRENT_PACKET_FILTER:
515 /* these NDIS_PACKET_TYPE_* bitflags are shared with
516 * cdc_filter; it's not RNDIS-specific
517 * NDIS_PACKET_TYPE_x == USB_CDC_PACKET_TYPE_x for x in:
518 * PROMISCUOUS, DIRECTED,
519 * MULTICAST, ALL_MULTICAST, BROADCAST
521 *params->filter = (u16)get_unaligned_le32(buf);
522 pr_debug("%s: RNDIS_OID_GEN_CURRENT_PACKET_FILTER %08x\n",
523 __func__, *params->filter);
525 /* this call has a significant side effect: it's
526 * what makes the packet flow start and stop, like
527 * activating the CDC Ethernet altsetting.
530 if (*params->filter) {
531 params->state = RNDIS_DATA_INITIALIZED;
532 netif_carrier_on(params->dev);
533 if (netif_running(params->dev))
534 netif_wake_queue(params->dev);
536 params->state = RNDIS_INITIALIZED;
537 netif_carrier_off(params->dev);
538 netif_stop_queue(params->dev);
542 case RNDIS_OID_802_3_MULTICAST_LIST:
543 /* I think we can ignore this */
544 pr_debug("%s: RNDIS_OID_802_3_MULTICAST_LIST\n", __func__);
549 pr_warning("%s: set unknown OID 0x%08X, size %d\n",
550 __func__, OID, buf_len);
560 static int rndis_init_response(struct rndis_params *params,
561 rndis_init_msg_type *buf)
563 rndis_init_cmplt_type *resp;
569 r = rndis_add_response(params, sizeof(rndis_init_cmplt_type));
572 resp = (rndis_init_cmplt_type *)r->buf;
574 resp->MessageType = cpu_to_le32(RNDIS_MSG_INIT_C);
575 resp->MessageLength = cpu_to_le32(52);
576 resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
577 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
578 resp->MajorVersion = cpu_to_le32(RNDIS_MAJOR_VERSION);
579 resp->MinorVersion = cpu_to_le32(RNDIS_MINOR_VERSION);
580 resp->DeviceFlags = cpu_to_le32(RNDIS_DF_CONNECTIONLESS);
581 resp->Medium = cpu_to_le32(RNDIS_MEDIUM_802_3);
582 resp->MaxPacketsPerTransfer = cpu_to_le32(1);
583 resp->MaxTransferSize = cpu_to_le32(
585 + sizeof(struct ethhdr)
586 + sizeof(struct rndis_packet_msg_type)
588 resp->PacketAlignmentFactor = cpu_to_le32(0);
589 resp->AFListOffset = cpu_to_le32(0);
590 resp->AFListSize = cpu_to_le32(0);
592 params->resp_avail(params->v);
596 static int rndis_query_response(struct rndis_params *params,
597 rndis_query_msg_type *buf)
599 rndis_query_cmplt_type *resp;
602 /* pr_debug("%s: OID = %08X\n", __func__, cpu_to_le32(buf->OID)); */
607 * we need more memory:
608 * gen_ndis_query_resp expects enough space for
609 * rndis_query_cmplt_type followed by data.
610 * oid_supported_list is the largest data reply
612 r = rndis_add_response(params,
613 sizeof(oid_supported_list) + sizeof(rndis_query_cmplt_type));
616 resp = (rndis_query_cmplt_type *)r->buf;
618 resp->MessageType = cpu_to_le32(RNDIS_MSG_QUERY_C);
619 resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
621 if (gen_ndis_query_resp(params, le32_to_cpu(buf->OID),
622 le32_to_cpu(buf->InformationBufferOffset)
624 le32_to_cpu(buf->InformationBufferLength),
626 /* OID not supported */
627 resp->Status = cpu_to_le32(RNDIS_STATUS_NOT_SUPPORTED);
628 resp->MessageLength = cpu_to_le32(sizeof *resp);
629 resp->InformationBufferLength = cpu_to_le32(0);
630 resp->InformationBufferOffset = cpu_to_le32(0);
632 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
634 params->resp_avail(params->v);
638 static int rndis_set_response(struct rndis_params *params,
639 rndis_set_msg_type *buf)
641 u32 BufLength, BufOffset;
642 rndis_set_cmplt_type *resp;
645 r = rndis_add_response(params, sizeof(rndis_set_cmplt_type));
648 resp = (rndis_set_cmplt_type *)r->buf;
650 BufLength = le32_to_cpu(buf->InformationBufferLength);
651 BufOffset = le32_to_cpu(buf->InformationBufferOffset);
654 pr_debug("%s: Length: %d\n", __func__, BufLength);
655 pr_debug("%s: Offset: %d\n", __func__, BufOffset);
656 pr_debug("%s: InfoBuffer: ", __func__);
658 for (i = 0; i < BufLength; i++) {
659 pr_debug("%02x ", *(((u8 *) buf) + i + 8 + BufOffset));
665 resp->MessageType = cpu_to_le32(RNDIS_MSG_SET_C);
666 resp->MessageLength = cpu_to_le32(16);
667 resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
668 if (gen_ndis_set_resp(params, le32_to_cpu(buf->OID),
669 ((u8 *)buf) + 8 + BufOffset, BufLength, r))
670 resp->Status = cpu_to_le32(RNDIS_STATUS_NOT_SUPPORTED);
672 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
674 params->resp_avail(params->v);
678 static int rndis_reset_response(struct rndis_params *params,
679 rndis_reset_msg_type *buf)
681 rndis_reset_cmplt_type *resp;
686 /* drain the response queue */
687 while ((xbuf = rndis_get_next_response(params, &length)))
688 rndis_free_response(params, xbuf);
690 r = rndis_add_response(params, sizeof(rndis_reset_cmplt_type));
693 resp = (rndis_reset_cmplt_type *)r->buf;
695 resp->MessageType = cpu_to_le32(RNDIS_MSG_RESET_C);
696 resp->MessageLength = cpu_to_le32(16);
697 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
698 /* resent information */
699 resp->AddressingReset = cpu_to_le32(1);
701 params->resp_avail(params->v);
705 static int rndis_keepalive_response(struct rndis_params *params,
706 rndis_keepalive_msg_type *buf)
708 rndis_keepalive_cmplt_type *resp;
711 /* host "should" check only in RNDIS_DATA_INITIALIZED state */
713 r = rndis_add_response(params, sizeof(rndis_keepalive_cmplt_type));
716 resp = (rndis_keepalive_cmplt_type *)r->buf;
718 resp->MessageType = cpu_to_le32(RNDIS_MSG_KEEPALIVE_C);
719 resp->MessageLength = cpu_to_le32(16);
720 resp->RequestID = buf->RequestID; /* Still LE in msg buffer */
721 resp->Status = cpu_to_le32(RNDIS_STATUS_SUCCESS);
723 params->resp_avail(params->v);
729 * Device to Host Comunication
731 static int rndis_indicate_status_msg(struct rndis_params *params, u32 status)
733 rndis_indicate_status_msg_type *resp;
736 if (params->state == RNDIS_UNINITIALIZED)
739 r = rndis_add_response(params, sizeof(rndis_indicate_status_msg_type));
742 resp = (rndis_indicate_status_msg_type *)r->buf;
744 resp->MessageType = cpu_to_le32(RNDIS_MSG_INDICATE);
745 resp->MessageLength = cpu_to_le32(20);
746 resp->Status = cpu_to_le32(status);
747 resp->StatusBufferLength = cpu_to_le32(0);
748 resp->StatusBufferOffset = cpu_to_le32(0);
750 params->resp_avail(params->v);
754 int rndis_signal_connect(struct rndis_params *params)
756 params->media_state = RNDIS_MEDIA_STATE_CONNECTED;
757 return rndis_indicate_status_msg(params, RNDIS_STATUS_MEDIA_CONNECT);
759 EXPORT_SYMBOL_GPL(rndis_signal_connect);
761 int rndis_signal_disconnect(struct rndis_params *params)
763 params->media_state = RNDIS_MEDIA_STATE_DISCONNECTED;
764 return rndis_indicate_status_msg(params, RNDIS_STATUS_MEDIA_DISCONNECT);
766 EXPORT_SYMBOL_GPL(rndis_signal_disconnect);
768 void rndis_uninit(struct rndis_params *params)
775 params->state = RNDIS_UNINITIALIZED;
777 /* drain the response queue */
778 while ((buf = rndis_get_next_response(params, &length)))
779 rndis_free_response(params, buf);
781 EXPORT_SYMBOL_GPL(rndis_uninit);
783 void rndis_set_host_mac(struct rndis_params *params, const u8 *addr)
785 params->host_mac = addr;
787 EXPORT_SYMBOL_GPL(rndis_set_host_mac);
792 int rndis_msg_parser(struct rndis_params *params, u8 *buf)
794 u32 MsgType, MsgLength;
801 MsgType = get_unaligned_le32(tmp++);
802 MsgLength = get_unaligned_le32(tmp++);
807 /* NOTE: RNDIS is *EXTREMELY* chatty ... Windows constantly polls for
808 * rx/tx statistics and link status, in addition to KEEPALIVE traffic
809 * and normal HC level polling to see if there's any IN traffic.
812 /* For USB: responses may take up to 10 seconds */
815 pr_debug("%s: RNDIS_MSG_INIT\n",
817 params->state = RNDIS_INITIALIZED;
818 return rndis_init_response(params, (rndis_init_msg_type *)buf);
821 pr_debug("%s: RNDIS_MSG_HALT\n",
823 params->state = RNDIS_UNINITIALIZED;
825 netif_carrier_off(params->dev);
826 netif_stop_queue(params->dev);
830 case RNDIS_MSG_QUERY:
831 return rndis_query_response(params,
832 (rndis_query_msg_type *)buf);
835 return rndis_set_response(params, (rndis_set_msg_type *)buf);
837 case RNDIS_MSG_RESET:
838 pr_debug("%s: RNDIS_MSG_RESET\n",
840 return rndis_reset_response(params,
841 (rndis_reset_msg_type *)buf);
843 case RNDIS_MSG_KEEPALIVE:
844 /* For USB: host does this every 5 seconds */
846 pr_debug("%s: RNDIS_MSG_KEEPALIVE\n",
848 return rndis_keepalive_response(params,
849 (rndis_keepalive_msg_type *)
853 /* At least Windows XP emits some undefined RNDIS messages.
854 * In one case those messages seemed to relate to the host
857 pr_warning("%s: unknown RNDIS message 0x%08X len %d\n",
858 __func__, MsgType, MsgLength);
859 print_hex_dump_bytes(__func__, DUMP_PREFIX_OFFSET,
866 EXPORT_SYMBOL_GPL(rndis_msg_parser);
868 static inline int rndis_get_nr(void)
870 return ida_simple_get(&rndis_ida, 0, 0, GFP_KERNEL);
873 static inline void rndis_put_nr(int nr)
875 ida_simple_remove(&rndis_ida, nr);
878 struct rndis_params *rndis_register(void (*resp_avail)(void *v), void *v)
880 struct rndis_params *params;
884 return ERR_PTR(-EINVAL);
888 pr_debug("failed\n");
890 return ERR_PTR(-ENODEV);
893 params = kzalloc(sizeof(*params), GFP_KERNEL);
897 return ERR_PTR(-ENOMEM);
900 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
902 struct proc_dir_entry *proc_entry;
905 sprintf(name, NAME_TEMPLATE, i);
906 proc_entry = proc_create_data(name, 0660, NULL,
907 &rndis_proc_fops, params);
912 return ERR_PTR(-EIO);
917 params->confignr = i;
919 params->state = RNDIS_UNINITIALIZED;
920 params->media_state = RNDIS_MEDIA_STATE_DISCONNECTED;
921 params->resp_avail = resp_avail;
923 INIT_LIST_HEAD(¶ms->resp_queue);
924 pr_debug("%s: configNr = %d\n", __func__, i);
928 EXPORT_SYMBOL_GPL(rndis_register);
930 void rndis_deregister(struct rndis_params *params)
934 pr_debug("%s:\n", __func__);
939 i = params->confignr;
941 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
945 sprintf(name, NAME_TEMPLATE, i);
946 remove_proc_entry(name, NULL);
953 EXPORT_SYMBOL_GPL(rndis_deregister);
954 int rndis_set_param_dev(struct rndis_params *params, struct net_device *dev,
957 pr_debug("%s:\n", __func__);
964 params->filter = cdc_filter;
968 EXPORT_SYMBOL_GPL(rndis_set_param_dev);
970 int rndis_set_param_vendor(struct rndis_params *params, u32 vendorID,
971 const char *vendorDescr)
973 pr_debug("%s:\n", __func__);
974 if (!vendorDescr) return -1;
978 params->vendorID = vendorID;
979 params->vendorDescr = vendorDescr;
983 EXPORT_SYMBOL_GPL(rndis_set_param_vendor);
985 int rndis_set_param_medium(struct rndis_params *params, u32 medium, u32 speed)
987 pr_debug("%s: %u %u\n", __func__, medium, speed);
991 params->medium = medium;
992 params->speed = speed;
996 EXPORT_SYMBOL_GPL(rndis_set_param_medium);
998 void rndis_add_hdr(struct sk_buff *skb)
1000 struct rndis_packet_msg_type *header;
1004 header = (void *)skb_push(skb, sizeof(*header));
1005 memset(header, 0, sizeof *header);
1006 header->MessageType = cpu_to_le32(RNDIS_MSG_PACKET);
1007 header->MessageLength = cpu_to_le32(skb->len);
1008 header->DataOffset = cpu_to_le32(36);
1009 header->DataLength = cpu_to_le32(skb->len - sizeof(*header));
1011 EXPORT_SYMBOL_GPL(rndis_add_hdr);
1013 void rndis_free_response(struct rndis_params *params, u8 *buf)
1015 rndis_resp_t *r, *n;
1017 list_for_each_entry_safe(r, n, ¶ms->resp_queue, list) {
1018 if (r->buf == buf) {
1024 EXPORT_SYMBOL_GPL(rndis_free_response);
1026 u8 *rndis_get_next_response(struct rndis_params *params, u32 *length)
1028 rndis_resp_t *r, *n;
1030 if (!length) return NULL;
1032 list_for_each_entry_safe(r, n, ¶ms->resp_queue, list) {
1035 *length = r->length;
1042 EXPORT_SYMBOL_GPL(rndis_get_next_response);
1044 static rndis_resp_t *rndis_add_response(struct rndis_params *params, u32 length)
1048 /* NOTE: this gets copied into ether.c USB_BUFSIZ bytes ... */
1049 r = kmalloc(sizeof(rndis_resp_t) + length, GFP_ATOMIC);
1050 if (!r) return NULL;
1052 r->buf = (u8 *)(r + 1);
1056 list_add_tail(&r->list, ¶ms->resp_queue);
1060 int rndis_rm_hdr(struct gether *port,
1061 struct sk_buff *skb,
1062 struct sk_buff_head *list)
1064 /* tmp points to a struct rndis_packet_msg_type */
1065 __le32 *tmp = (void *)skb->data;
1067 /* MessageType, MessageLength */
1068 if (cpu_to_le32(RNDIS_MSG_PACKET)
1069 != get_unaligned(tmp++)) {
1070 dev_kfree_skb_any(skb);
1075 /* DataOffset, DataLength */
1076 if (!skb_pull(skb, get_unaligned_le32(tmp++) + 8)) {
1077 dev_kfree_skb_any(skb);
1080 skb_trim(skb, get_unaligned_le32(tmp++));
1082 skb_queue_tail(list, skb);
1085 EXPORT_SYMBOL_GPL(rndis_rm_hdr);
1087 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
1089 static int rndis_proc_show(struct seq_file *m, void *v)
1091 rndis_params *param = m->private;
1100 "vendor ID : 0x%08X\n"
1102 param->confignr, (param->used) ? "y" : "n",
1104 switch (param->state) {
1105 case RNDIS_UNINITIALIZED:
1106 s = "RNDIS_UNINITIALIZED"; break;
1107 case RNDIS_INITIALIZED:
1108 s = "RNDIS_INITIALIZED"; break;
1109 case RNDIS_DATA_INITIALIZED:
1110 s = "RNDIS_DATA_INITIALIZED"; break;
1113 (param->media_state) ? 0 : param->speed*100,
1114 (param->media_state) ? "disconnected" : "connected",
1115 param->vendorID, param->vendorDescr);
1119 static ssize_t rndis_proc_write(struct file *file, const char __user *buffer,
1120 size_t count, loff_t *ppos)
1122 rndis_params *p = PDE_DATA(file_inode(file));
1124 int i, fl_speed = 0;
1126 for (i = 0; i < count; i++) {
1128 if (get_user(c, buffer))
1142 speed = speed * 10 + c - '0';
1146 rndis_signal_connect(p);
1150 rndis_signal_disconnect(p);
1153 if (fl_speed) p->speed = speed;
1154 else pr_debug("%c is not valid\n", c);
1164 static int rndis_proc_open(struct inode *inode, struct file *file)
1166 return single_open(file, rndis_proc_show, PDE_DATA(inode));
1169 static const struct file_operations rndis_proc_fops = {
1170 .owner = THIS_MODULE,
1171 .open = rndis_proc_open,
1173 .llseek = seq_lseek,
1174 .release = single_release,
1175 .write = rndis_proc_write,
1178 #define NAME_TEMPLATE "driver/rndis-%03d"
1180 #endif /* CONFIG_USB_GADGET_DEBUG_FILES */