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