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
|
//*****************************************************************************
//
// usbdevicepriv.h - Private header file used to share internal variables and
// function prototypes between the various device-related
// modules in the USB library. This header MUST NOT be
// used by application code.
//
// Copyright (c) 2008-2012 Texas Instruments Incorporated. All rights reserved.
// Software License Agreement
//
// Texas Instruments (TI) is supplying this software for use solely and
// exclusively on TI's microcontroller products. The software is owned by
// TI and/or its suppliers, and is protected under applicable copyright
// laws. You may not combine this software with "viral" open-source
// software in order to form a larger program.
//
// THIS SOFTWARE IS PROVIDED "AS IS" AND WITH ALL FAULTS.
// NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT
// NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. TI SHALL NOT, UNDER ANY
// CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
// DAMAGES, FOR ANY REASON WHATSOEVER.
//
// This is part of revision 9453 of the Stellaris USB Library.
//
//*****************************************************************************
#ifndef __USBDEVICEPRIV_H__
#define __USBDEVICEPRIV_H__
//*****************************************************************************
//
// If building with a C++ compiler, make all of the definitions in this header
// have a C binding.
//
//*****************************************************************************
#ifdef __cplusplus
extern "C"
{
#endif
//*****************************************************************************
//
// The states for endpoint zero during enumeration.
//
//*****************************************************************************
typedef enum
{
//
// The USB device is waiting on a request from the host controller on
// endpoint zero.
//
USB_STATE_IDLE,
//
// The USB device is sending data back to the host due to an IN request.
//
USB_STATE_TX,
//
// The USB device is sending the configuration descriptor back to the host
// due to an IN request.
//
USB_STATE_TX_CONFIG,
//
// The USB device is receiving data from the host due to an OUT
// request from the host.
//
USB_STATE_RX,
//
// The USB device has completed the IN or OUT request and is now waiting
// for the host to acknowledge the end of the IN/OUT transaction. This
// is the status phase for a USB control transaction.
//
USB_STATE_STATUS,
//
// This endpoint has signaled a stall condition and is waiting for the
// stall to be acknowledged by the host controller.
//
USB_STATE_STALL
}
tEP0State;
typedef struct tDeviceInfo tDeviceInfo;
typedef struct tDeviceInstance tDeviceInstance;
//*****************************************************************************
//
// The USB controller device information.
//
//*****************************************************************************
struct tDeviceInstance
{
//
// The device information for the USB device.
//
tDeviceInfo *psInfo;
//
// The instance data for the USB device.
//
void *pvInstance;
//
// The current state of endpoint zero.
//
volatile tEP0State eEP0State;
//
// The devices current address, this also has a change pending bit in the
// MSB of this value specified by DEV_ADDR_PENDING.
//
volatile unsigned long ulDevAddress;
//
// This holds the current active configuration for this device.
//
unsigned long ulConfiguration;
//
// This holds the configuration id that will take effect after a reset.
//
unsigned long ulDefaultConfiguration;
//
// This holds the current alternate interface for this device.
//
unsigned char pucAltSetting[USB_MAX_INTERFACES_PER_DEVICE];
//
// This is the pointer to the current data being sent out or received
// on endpoint zero.
//
unsigned char *pEP0Data;
//
// This is the number of bytes that remain to be sent from or received
// into the g_sUSBDeviceState.pEP0Data data buffer.
//
volatile unsigned long ulEP0DataRemain;
//
// The amount of data being sent/received due to a custom request.
//
unsigned long ulOUTDataSize;
//
// Holds the current device status.
//
unsigned char ucStatus;
//
// Holds the endpoint status for the HALT condition. This array is sized
// to hold halt status for all IN and OUT endpoints.
//
unsigned char ucHalt[2][USBLIB_NUM_EP - 1];
//
// Holds the configuration descriptor section number currently being sent
// to the host.
//
unsigned char ucConfigSection;
//
// Holds the offset within the configuration descriptor section currently
// being sent to the host.
//
unsigned char ucSectionOffset;
//
// Holds the index of the configuration that we are currently sending back
// to the host.
//
unsigned char ucConfigIndex;
//
// This flag is set to true if the client has called USBDPowerStatusSet
// and tells the USB library not to try to determine the current power
// status from the configuration descriptor.
//
tBoolean bPwrSrcSet;
//
// This flag indicates whether or not remote wake up signaling is in
// progress.
//
tBoolean bRemoteWakeup;
//
// During remote wake up signaling, this counter is used to track the
// number of milliseconds since the signaling was initiated.
//
unsigned char ucRemoteWakeupCount;
};
extern tDeviceInstance g_psUSBDevice[];
//*****************************************************************************
//
// Device enumeration functions provided by device/usbenum.c and called from
// the interrupt handler in device/usbhandler.c
//
//*****************************************************************************
extern tBoolean USBDeviceConfig(tDeviceInstance *psDevInst,
const tConfigHeader *psConfig);
extern tBoolean USBDeviceConfigAlternate(tDeviceInstance *psDevInst,
const tConfigHeader *psConfig,
unsigned char ucInterfaceNum,
unsigned char ucAlternateSetting);
//*****************************************************************************
//
// Mark the end of the C bindings section for C++ compilers.
//
//*****************************************************************************
#ifdef __cplusplus
}
#endif
#endif // __USBDEVICEPRIV_H__
|
