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