|
1 /* |
|
2 * Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies). |
|
3 * All rights reserved. |
|
4 * This component and the accompanying materials are made available |
|
5 * under the terms of "Eclipse Public License v1.0" |
|
6 * which accompanies this distribution, and is available |
|
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html". |
|
8 * |
|
9 * Initial Contributors: |
|
10 * Nokia Corporation - initial contribution. |
|
11 * |
|
12 * Contributors: |
|
13 * |
|
14 * Description: |
|
15 * |
|
16 */ |
|
17 |
|
18 /** |
|
19 @file |
|
20 @internalComponent |
|
21 */ |
|
22 |
|
23 #include <e32base.h> |
|
24 #include <usb/usblogger.h> |
|
25 #include "usbhoststack.h" |
|
26 #include "fdfapi.h" |
|
27 |
|
28 #ifdef __FLOG_ACTIVE |
|
29 _LIT8(KLogComponent, "usbhstcli"); |
|
30 #endif |
|
31 |
|
32 /** |
|
33 Starts the server process. |
|
34 */ |
|
35 static TInt StartServer() |
|
36 { |
|
37 LOG_STATIC_FUNC_ENTRY |
|
38 |
|
39 const TUidType serverUid(KNullUid, KNullUid, KUsbFdfUid); |
|
40 |
|
41 // |
|
42 // EPOC and EKA2 is easy, we just create a new server process. Simultaneous |
|
43 // launching of two such processes should be detected when the second one |
|
44 // attempts to create the server object, failing with KErrAlreadyExists. |
|
45 // |
|
46 RProcess server; |
|
47 TInt err = server.Create(KUsbFdfImg, KNullDesC, serverUid); |
|
48 LOGTEXT2(_L8("\terr = %d"), err); |
|
49 |
|
50 if ( err != KErrNone ) |
|
51 { |
|
52 return err; |
|
53 } |
|
54 |
|
55 TRequestStatus stat; |
|
56 server.Rendezvous(stat); |
|
57 |
|
58 if ( stat != KRequestPending ) |
|
59 { |
|
60 LOGTEXT(_L8("\taborting startup")); |
|
61 server.Kill(0); // abort startup |
|
62 } |
|
63 else |
|
64 { |
|
65 LOGTEXT(_L8("\tresuming")); |
|
66 server.Resume(); // logon OK - start the server |
|
67 } |
|
68 |
|
69 User::WaitForRequest(stat); // wait for start or death |
|
70 |
|
71 // we can't use the 'exit reason' if the server panicked as this |
|
72 // is the panic 'reason' and may be '0' which cannot be distinguished |
|
73 // from KErrNone |
|
74 LOGTEXT2(_L8("\tstat.Int = %d"), stat.Int()); |
|
75 err = (server.ExitType() == EExitPanic) ? KErrServerTerminated : stat.Int(); |
|
76 |
|
77 server.Close(); |
|
78 |
|
79 LOGTEXT2(_L8("\terr = %d"), err); |
|
80 return err; |
|
81 } |
|
82 |
|
83 EXPORT_C RUsbHostStack::RUsbHostStack() |
|
84 // these are all arbitrary initialisations |
|
85 : iDeviceEventPckg(TDeviceEventInformation()), |
|
86 iDevmonEventPckg(0) |
|
87 { |
|
88 LOGTEXT(_L8("*** Search on '***USB HOST STACK' to find device events.")); |
|
89 |
|
90 LOG_LINE |
|
91 LOG_FUNC |
|
92 } |
|
93 |
|
94 EXPORT_C TVersion RUsbHostStack::Version() const |
|
95 { |
|
96 LOG_LINE |
|
97 LOG_FUNC |
|
98 |
|
99 return(TVersion( KUsbFdfSrvMajorVersionNumber, |
|
100 KUsbFdfSrvMinorVersionNumber, |
|
101 KUsbFdfSrvBuildNumber |
|
102 ) |
|
103 ); |
|
104 } |
|
105 |
|
106 EXPORT_C TInt RUsbHostStack::Connect() |
|
107 { |
|
108 LOG_LINE |
|
109 LOG_FUNC; |
|
110 |
|
111 TInt err = DoConnect(); |
|
112 |
|
113 LOGTEXT2(_L8("\terr = %d"), err); |
|
114 return err; |
|
115 } |
|
116 |
|
117 /** |
|
118 Connects the session, starting the server if necessary |
|
119 @return Error. |
|
120 */ |
|
121 TInt RUsbHostStack::DoConnect() |
|
122 { |
|
123 LOG_FUNC |
|
124 |
|
125 TInt retry = 2; |
|
126 |
|
127 FOREVER |
|
128 { |
|
129 // Use message slots from the global pool. |
|
130 TInt err = CreateSession(KUsbFdfServerName, Version(), -1); |
|
131 LOGTEXT2(_L8("\terr = %d"), err); |
|
132 |
|
133 if ((err != KErrNotFound) && (err != KErrServerTerminated)) |
|
134 { |
|
135 LOGTEXT(_L8("\treturning after CreateSession")); |
|
136 return err; |
|
137 } |
|
138 |
|
139 if (--retry == 0) |
|
140 { |
|
141 LOGTEXT(_L8("\treturning after running out of retries")); |
|
142 return err; |
|
143 } |
|
144 |
|
145 err = StartServer(); |
|
146 LOGTEXT2(_L8("\terr = %d"), err); |
|
147 |
|
148 if ((err != KErrNone) && (err != KErrAlreadyExists)) |
|
149 { |
|
150 LOGTEXT(_L8("\treturning after StartServer")); |
|
151 return err; |
|
152 } |
|
153 } |
|
154 } |
|
155 |
|
156 EXPORT_C TInt RUsbHostStack::EnableDriverLoading() |
|
157 { |
|
158 LOG_LINE |
|
159 LOG_FUNC |
|
160 |
|
161 TInt ret = SendReceive(EUsbFdfSrvEnableDriverLoading); |
|
162 LOGTEXT2(_L8("\tret = %d"), ret); |
|
163 return ret; |
|
164 } |
|
165 |
|
166 EXPORT_C void RUsbHostStack::DisableDriverLoading() |
|
167 { |
|
168 LOG_LINE |
|
169 LOG_FUNC |
|
170 |
|
171 TInt ret = SendReceive(EUsbFdfSrvDisableDriverLoading); |
|
172 LOGTEXT2(_L8("\tret = %d"), ret); |
|
173 (void)ret; |
|
174 } |
|
175 |
|
176 EXPORT_C void RUsbHostStack::NotifyDeviceEvent(TRequestStatus& aStat, TDeviceEventInformation& aDeviceEventInformation) |
|
177 { |
|
178 LOG_LINE |
|
179 LOG_FUNC |
|
180 |
|
181 TIpcArgs args; |
|
182 iDeviceEventPckg.Set((TUint8*)&aDeviceEventInformation, sizeof(TDeviceEventInformation), sizeof(TDeviceEventInformation)); |
|
183 args.Set(0, &iDeviceEventPckg); |
|
184 |
|
185 SendReceive(EUsbFdfSrvNotifyDeviceEvent, args, aStat); |
|
186 } |
|
187 |
|
188 EXPORT_C void RUsbHostStack::NotifyDeviceEventCancel() |
|
189 { |
|
190 LOG_LINE |
|
191 LOG_FUNC |
|
192 |
|
193 TInt ret = SendReceive(EUsbFdfSrvNotifyDeviceEventCancel); |
|
194 LOGTEXT2(_L8("\tret = %d"), ret); |
|
195 (void)ret; |
|
196 } |
|
197 |
|
198 EXPORT_C void RUsbHostStack::NotifyDevmonEvent(TRequestStatus& aStat, TInt& aEvent) |
|
199 { |
|
200 LOG_LINE |
|
201 LOG_FUNC |
|
202 |
|
203 TIpcArgs args; |
|
204 iDevmonEventPckg.Set((TUint8*)&aEvent, sizeof(TInt), sizeof(TInt)); |
|
205 args.Set(0, &iDevmonEventPckg); |
|
206 |
|
207 SendReceive(EUsbFdfSrvNotifyDevmonEvent, args, aStat); |
|
208 } |
|
209 |
|
210 EXPORT_C void RUsbHostStack::NotifyDevmonEventCancel() |
|
211 { |
|
212 LOG_LINE |
|
213 LOG_FUNC |
|
214 |
|
215 TInt ret = SendReceive(EUsbFdfSrvNotifyDevmonEventCancel); |
|
216 LOGTEXT2(_L8("\tret = %d"), ret); |
|
217 (void)ret; |
|
218 } |
|
219 |
|
220 EXPORT_C TInt RUsbHostStack::GetSupportedLanguages(TUint aDeviceId, RArray<TUint>& aLangIds) |
|
221 { |
|
222 LOG_LINE |
|
223 LOG_FUNC |
|
224 |
|
225 aLangIds.Reset(); |
|
226 |
|
227 TUint singleLangIdOrNumLangs = 0; |
|
228 TPckg<TUint> singleLangIdOrNumLangsBuf(singleLangIdOrNumLangs); |
|
229 TInt ret = SendReceive(EUsbFdfSrvGetSingleSupportedLanguageOrNumberOfSupportedLanguages, TIpcArgs(aDeviceId, &singleLangIdOrNumLangsBuf)); |
|
230 LOGTEXT2(_L8("\tsingleLangIdOrNumLangs = %d"), singleLangIdOrNumLangs); |
|
231 switch ( ret ) |
|
232 { |
|
233 case KErrNotFound: |
|
234 LOGTEXT2(_L8("\tThere is no language available or the wrong device id %d was supplied"),aDeviceId); |
|
235 ret = KErrNotFound; |
|
236 break; |
|
237 |
|
238 case KErrNone: |
|
239 // The buffer is now either empty or contains the single supported language ID |
|
240 ret = CopyLangIdsToArray(aLangIds, singleLangIdOrNumLangsBuf); |
|
241 break; |
|
242 |
|
243 case KErrTooBig: |
|
244 { |
|
245 // The buffer now contains the number of supported languages (not 0 or 1). |
|
246 // Lang IDs are TUints. |
|
247 RBuf8 buf; |
|
248 ret = buf.Create(singleLangIdOrNumLangs * sizeof(TUint)); |
|
249 if ( ret == KErrNone ) |
|
250 { |
|
251 ret = SendReceive(EUsbFdfSrvGetSupportedLanguages, TIpcArgs(aDeviceId, &buf)); |
|
252 if ( ret == KErrNone ) |
|
253 { |
|
254 ret = CopyLangIdsToArray(aLangIds, buf); |
|
255 } |
|
256 buf.Close(); |
|
257 } |
|
258 } |
|
259 break; |
|
260 |
|
261 default: |
|
262 // Regular failure. |
|
263 break; |
|
264 } |
|
265 |
|
266 LOGTEXT2(_L8("\tret = %d"), ret); |
|
267 return ret; |
|
268 } |
|
269 |
|
270 TInt RUsbHostStack::CopyLangIdsToArray(RArray<TUint>& aLangIds, const TDesC8& aBuffer) |
|
271 { |
|
272 LOG_FUNC |
|
273 |
|
274 ASSERT(!(aBuffer.Size() % 4)); |
|
275 const TUint numLangs = aBuffer.Size() / 4; |
|
276 LOGTEXT2(_L8("\tnumLangs = %d"), numLangs); |
|
277 |
|
278 TInt ret = KErrNone; |
|
279 const TUint* ptr = reinterpret_cast<const TUint*>(aBuffer.Ptr()); |
|
280 for ( TUint ii = 0 ; ii < numLangs ; ++ii ) |
|
281 { |
|
282 ret = aLangIds.Append(*ptr++); // increments by sizeof(TUint) |
|
283 if ( ret ) |
|
284 { |
|
285 aLangIds.Reset(); |
|
286 break; |
|
287 } |
|
288 } |
|
289 |
|
290 LOGTEXT2(_L8("\tret = %d"), ret); |
|
291 return ret; |
|
292 } |
|
293 |
|
294 EXPORT_C TInt RUsbHostStack::GetManufacturerStringDescriptor(TUint aDeviceId, TUint aLangId, TName& aString) |
|
295 { |
|
296 LOG_LINE |
|
297 LOG_FUNC |
|
298 |
|
299 TInt ret = SendReceive(EUsbFdfSrvGetManufacturerStringDescriptor, TIpcArgs(aDeviceId, aLangId, &aString)); |
|
300 #ifdef __FLOG_ACTIVE |
|
301 if ( !ret ) |
|
302 { |
|
303 LOGTEXT2(_L("\taString = \"%S\""), &aString); |
|
304 } |
|
305 #endif |
|
306 LOGTEXT2(_L8("\tret = %d"), ret); |
|
307 return ret; |
|
308 } |
|
309 |
|
310 EXPORT_C TInt RUsbHostStack::GetProductStringDescriptor(TUint aDeviceId, TUint aLangId, TName& aString) |
|
311 { |
|
312 LOG_LINE |
|
313 LOG_FUNC |
|
314 |
|
315 TInt ret = SendReceive(EUsbFdfSrvGetProductStringDescriptor, TIpcArgs(aDeviceId, aLangId, &aString)); |
|
316 #ifdef __FLOG_ACTIVE |
|
317 if ( !ret ) |
|
318 { |
|
319 LOGTEXT2(_L("\taString = \"%S\""), &aString); |
|
320 } |
|
321 #endif |
|
322 LOGTEXT2(_L8("\tret = %d"), ret); |
|
323 return ret; |
|
324 } |
|
325 |
|
326 EXPORT_C TInt RUsbHostStack::GetOtgDescriptor(TUint aDeviceId, TOtgDescriptor& aDescriptor) |
|
327 { |
|
328 LOG_LINE |
|
329 LOG_FUNC |
|
330 |
|
331 TPckg<TOtgDescriptor> otgDescriptorPckg(aDescriptor); |
|
332 |
|
333 TIpcArgs args; |
|
334 args.Set(0, aDeviceId); |
|
335 args.Set(1, &otgDescriptorPckg); |
|
336 |
|
337 TInt ret = SendReceive(EUsbFdfSrvGetOtgDescriptor, args); |
|
338 #ifdef __FLOG_ACTIVE |
|
339 if ( !ret ) |
|
340 { |
|
341 LOGTEXT2(_L("\taDescriptor.iDeviceId = %d"), aDescriptor.iDeviceId); |
|
342 LOGTEXT2(_L("\taDescriptor.iAttributes = %d"), aDescriptor.iAttributes); |
|
343 } |
|
344 #endif |
|
345 LOGTEXT2(_L8("\tret = %d"), ret); |
|
346 return ret; |
|
347 } |
|
348 |
|
349 EXPORT_C TInt RUsbHostStack::__DbgFailNext(TInt aCount) |
|
350 { |
|
351 #ifdef _DEBUG |
|
352 return SendReceive(EUsbFdfSrvDbgFailNext, TIpcArgs(aCount)); |
|
353 #else |
|
354 (void)aCount; |
|
355 return KErrNone; |
|
356 #endif |
|
357 } |
|
358 |
|
359 EXPORT_C TInt RUsbHostStack::__DbgAlloc() |
|
360 { |
|
361 #ifdef _DEBUG |
|
362 return SendReceive(EUsbFdfSrvDbgAlloc); |
|
363 #else |
|
364 return KErrNone; |
|
365 #endif |
|
366 } |