Debian Codegraph @

gobi-api/Gobi_2012-06-18-1054/GobiSampleCM/GobiCMDLL.cpp

raw
1 /*===========================================================================
2 FILE:
3 GobiCMDLL.cpp
4
5 DESCRIPTION:
6 Simple class to load and interface to the Gobi CM DLL
7
8 PUBLIC CLASSES AND METHODS:
9 cGobiCMDLL
10 This class loads the Gobi CM DLL and then interfaces to it
11
12 Copyright (c) 2012, Code Aurora Forum. All rights reserved.
13
14 Redistribution and use in source and binary forms, with or without
15 modification, are permitted provided that the following conditions are met:
16 * Redistributions of source code must retain the above copyright
17 notice, this list of conditions and the following disclaimer.
18 * Redistributions in binary form must reproduce the above copyright
19 notice, this list of conditions and the following disclaimer in the
20 documentation and/or other materials provided with the distribution.
21 * Neither the name of Code Aurora Forum nor
22 the names of its contributors may be used to endorse or promote
23 products derived from this software without specific prior written
24 permission.
25
26
27 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
28 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
29 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
30 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
31 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
32 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
33 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
34 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
35 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
36 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
37 POSSIBILITY OF SUCH DAMAGE.
38 ===========================================================================*/
39
40 //---------------------------------------------------------------------------
41 // Include Files
42 //---------------------------------------------------------------------------
43 #include "GobiCMDLL.h"
44 #include "GobiConnectionMgmtAPIStructs.h"
45 #include "Gobi3000Translation.h"
46 #include <string.h>
47
48 /*=========================================================================*/
49 // cGobiCMDLL Methods
50 /*=========================================================================*/
51
52 /*===========================================================================
53 METHOD:
54 GetString (Internal Method)
55
56 DESCRIPTION:
57 Call a Gobi CM API function that returns a string
58
59 PARAMETERS:
60 mpFnString [ I ] - Gobi CM API function pointer
61 tlvID [ I ] - ID of response TLV that contains the string
62 strSz [ I ] - Max string size (including NULL terminator)
63 pStr [ O ] - Buffer to hold the string
64
65 RETURN VALUE:
66 ULONG
67 ===========================================================================*/
68 ULONG cGobiCMDLL::GetString(
69 tFNGobiInputOutput mpFnString,
70 BYTE tlvID,
71 BYTE strSz,
72 CHAR * pStr )
73 {
74 // Assume failure
75 if (strSz > 0 && pStr != 0)
76 {
77 pStr[0] = 0;
78 }
79
80 // Query for string?
81 ULONG status = eGOBI_ERR_GENERAL;
82 if (mpFnString == 0 || mhGobi == 0)
83 {
84 return status;
85 }
86
87 ULONG lo = 1024;
88 BYTE rsp[1024] = { 0 };
89 status = mpFnString( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
90 if (status != 0)
91 {
92 return status;
93 }
94
95 std::map <UINT8, const sQMIRawContentHeader *> tlvs = GetTLVs( &rsp[0], lo );
96 std::map <UINT8, const sQMIRawContentHeader *>::const_iterator pIter = tlvs.find( tlvID );
97 if (pIter == tlvs.end())
98 {
99 return eGOBI_ERR_GENERAL;
100 }
101
102 const sQMIRawContentHeader * pTmp = pIter->second;
103 ULONG strLen = (ULONG)pTmp->mLength;
104 pTmp++;
105
106 if (strLen != 0 && strSz > 0 && pStr != 0)
107 {
108 ULONG needLen = strLen;
109 if (needLen + 1 > strSz)
110 {
111 needLen = strSz - 1;
112 }
113
114 memcpy( pStr, pTmp, needLen );
115 pStr[needLen] = 0;
116 }
117
118 return status;
119 }
120
121 /*===========================================================================
122 METHOD:
123 Connect (Public Method)
124
125 DESCRIPTION:
126 Calls GobiConnect
127
128 PARAMETERS:
129 pInterface [ I ] - Interace to connect to
130
131 RETURN VALUE:
132 ULONG
133 ===========================================================================*/
134 ULONG cGobiCMDLL::Connect( LPCSTR pInterface )
135 {
136 // Connect to WDS, DMS, and NAS services
137 ULONG svc[3] = { 1, 2, 3 };
138 ULONG svcCount = 3;
139 GOBIHANDLE handle = 0;
140 ULONG status = GobiConnect( pInterface, &svcCount, &svc[0], &handle );
141 if (status == 0)
142 {
143 if (svcCount == 3)
144 {
145 mhGobi = handle;
146 }
147 else
148 {
149 // We require WDS, DMS, and NAS services
150 Disconnect();
151 status = eGOBI_ERR_GENERAL;
152 }
153 }
154
155 return status;
156 }
157
158 /*===========================================================================
159 METHOD:
160 Disconnect (Public Method)
161
162 DESCRIPTION:
163 Calls GobiDisconnect
164
165 RETURN VALUE:
166 ULONG
167 ===========================================================================*/
168 ULONG cGobiCMDLL::Disconnect()
169 {
170 if (mhGobi == 0)
171 {
172 return eGOBI_ERR_GENERAL;
173 }
174
175 return GobiDisconnect( mhGobi );
176 }
177
178 /*===========================================================================
179 ETHOD:
180 StartDataSession (Public Method)
181
182 DESCRIPTION:
183 Calls WDSStartNetworkInterface
184
185 PARAMETERS:
186 pAPN [ I ] - Access point name
187 pUser [ I ] - Username
188 pPwd [ I ] - Password
189 pSessionID [ O ] - Session ID
190 pFailureCode [ O ] - Failure code (if present)
191
192 RETURN VALUE:
193 ULONG
194 ===========================================================================*/
195 ULONG cGobiCMDLL::StartDataSession(
196 LPCSTR pAPN,
197 LPCSTR pUser,
198 LPCSTR pPwd,
199 ULONG * pSessionID,
200 ULONG * pFailureCode )
201 {
202 // Assume failure
203 if (pSessionID != 0)
204 {
205 *pSessionID = 0xFFFFFFFF;
206 }
207
208 // Start a data session?
209 ULONG status = eGOBI_ERR_GENERAL;
210 if (mhGobi == 0)
211 {
212 return status;
213 }
214
215 UINT8 req[1024] = { 0 };
216 UINT8 * pData = (UINT8 *)&req[0];
217
218 sQMIRawContentHeader * pTLV = (sQMIRawContentHeader *)pData;
219 pTLV->mTypeID = 0x16;
220 pTLV->mLength
221 = (UINT16)sizeof( sWDSStartNetworkInterfaceRequest_Authentication );
222 pData += sizeof( sQMIRawContentHeader );
223
224 sWDSStartNetworkInterfaceRequest_Authentication * pAuth =
225 (sWDSStartNetworkInterfaceRequest_Authentication *)pData;
226 pAuth->mEnablePAP = 1;
227 pAuth->mEnableCHAP = 1;
228 pData += sizeof( sWDSStartNetworkInterfaceRequest_Authentication );
229
230 if (pAPN != 0 && pAPN[0] != 0)
231 {
232 size_t len = strnlen( pAPN, 256 );
233
234 pTLV = (sQMIRawContentHeader *)pData;
235 pTLV->mTypeID = 0x14;
236 pTLV->mLength = (UINT16)len;
237 pData += sizeof( sQMIRawContentHeader );
238
239 memcpy( pData, pAPN, len );
240 pData += len;
241 }
242
243 if (pUser != 0 && pUser[0] != 0)
244 {
245 size_t len = strnlen( pUser, 256 );
246
247 pTLV = (sQMIRawContentHeader *)pData;
248 pTLV->mTypeID = 0x17;
249 pTLV->mLength = (UINT16)len;
250 pData += sizeof( sQMIRawContentHeader );
251
252 memcpy( pData, pUser, len );
253 pData += len;
254 }
255
256 if (pPwd != 0 && pPwd[0] != 0)
257 {
258 size_t len = strnlen( pPwd, 256 );
259
260 pTLV = (sQMIRawContentHeader *)pData;
261 pTLV->mTypeID = 0x18;
262 pTLV->mLength = (UINT16)len;
263 pData += sizeof( sQMIRawContentHeader );
264
265 memcpy( pData, pPwd, len );
266 pData += len;
267 }
268
269 ULONG li = (ULONG)pData - (ULONG)&req[0];
270 ULONG lo = 1024;
271 BYTE rsp[1024] = { 0 };
272 status = WDSStartNetworkInterface( mhGobi, 300000, li, &req[0], &lo, &rsp[0] );
273
274 // On success pSessionID is valid, on failure pFailureCode is valid
275 ULONG status2 = ParseStartDataSession( lo, &rsp[0], pSessionID, pFailureCode );
276
277 if (status == eGOBI_ERR_NONE)
278 {
279 return status2;
280 }
281
282 return status;
283 }
284
285 /*===========================================================================
286 METHOD:
287 CancelDataSession (Public Method)
288
289 DESCRIPTION:
290 Calls GobiCancel/WDSAbort
291
292 RETURN VALUE:
293 ULONG
294 ===========================================================================*/
295 ULONG cGobiCMDLL::CancelDataSession()
296 {
297 // Cancel outstanding API request?
298 if (mhGobi == 0)
299 {
300 return eGOBI_ERR_GENERAL;
301 }
302
303 // Cancel the request with the API
304 ULONG svcID = 1;
305 ULONG txID = 0xFFFFFFFF;
306 ULONG status = GobiCancel( mhGobi, svcID, &txID );
307 if (status != 0 || txID == 0xFFFFFFFF)
308 {
309 return eGOBI_ERR_GENERAL;
310 }
311
312 UINT8 req[256] = { 0 };
313 UINT8 * pData = (UINT8 *)&req[0];
314
315 sQMIRawContentHeader * pTLV = (sQMIRawContentHeader *)pData;
316 pTLV->mTypeID = 0x01;
317 pTLV->mLength = (UINT16)sizeof( sWDSAbortRequest_TransactionID );
318 pData += sizeof( sQMIRawContentHeader );
319
320 sWDSAbortRequest_TransactionID * pID =
321 (sWDSAbortRequest_TransactionID *)pData;
322 pID->mTransactionID = (UINT16)txID;
323 pData += sizeof( sWDSAbortRequest_TransactionID );
324
325 // Cancel the request with the device
326 ULONG li = (ULONG)pData - (ULONG)&req[0];
327 status = WDSAbort( mhGobi, 2000, li, &req[0], 0, 0 );
328 return status;
329 }
330
331 /*===========================================================================
332 METHOD:
333 StopDataSession (Public Method)
334
335 DESCRIPTION:
336 Calls WDSStopNetworkInterface
337
338 PARAMETERS:
339 sessionID [ I ] - Session ID
340
341 RETURN VALUE:
342 ULONG
343 ===========================================================================*/
344 ULONG cGobiCMDLL::StopDataSession( ULONG sessionID )
345 {
346 ULONG status = eGOBI_ERR_GENERAL;
347 if (mhGobi == 0)
348 {
349 return status;
350 }
351
352 UINT8 req[256] = { 0 };
353 ULONG li = 256;
354
355 status = PackStopDataSession( &li, &req[0], sessionID );
356 if (status != 0)
357 {
358 return status;
359 }
360
361 // Stop data session
362 status = WDSStopNetworkInterface( mhGobi, 2000, li, &req[0], 0, 0 );
363 return status;
364 }
365
366 /*===========================================================================
367 METHOD:
368 GetSessionState (Public Method)
369
370 DESCRIPTION:
371 Calls WDSGetPacketServiceStatus
372
373 PARAMETERS:
374 pSessionState [ O ] - Current session state
375
376 RETURN VALUE:
377 ULONG
378 ===========================================================================*/
379 ULONG cGobiCMDLL::GetSessionState( ULONG * pSessionState )
380 {
381 // Assume failure
382 if (pSessionState != 0)
383 {
384 *pSessionState = 0xFFFFFFFF;
385 }
386
387 ULONG status = eGOBI_ERR_GENERAL;
388 if (mhGobi == 0)
389 {
390 return status;
391 }
392
393 ULONG lo = 1024;
394 BYTE rsp[1024] = { 0 };
395 status = WDSGetPacketServiceStatus( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
396 if (status != 0)
397 {
398 return status;
399 }
400
401 status = ParseGetSessionState( lo, &rsp[0], pSessionState );
402 return status;
403 }
404
405 /*===========================================================================
406 METHOD:
407 GetSessionDuration (Public Method)
408
409 DESCRIPTION:
410 Calls WDSGetDataSessionDuration
411
412 PARAMETERS:
413 pSessionDuration [ O ] - Session duration
414
415 RETURN VALUE:
416 ULONG
417 ===========================================================================*/
418 ULONG cGobiCMDLL::GetSessionDuration( ULONGLONG * pSessionDuration )
419 {
420 // Assume failure
421 if (pSessionDuration != 0)
422 {
423 *pSessionDuration = 0xFFFFFFFF;
424 }
425
426 // Query for session duration
427 ULONG status = eGOBI_ERR_GENERAL;
428 if (mhGobi == 0)
429 {
430 return status;
431 }
432
433 ULONG lo = 1024;
434 BYTE rsp[1024] = { 0 };
435 status = WDSGetDataSessionDuration( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
436 if (status != 0)
437 {
438 return status;
439 }
440
441 status = ParseGetSessionDuration( lo, &rsp[0], pSessionDuration );
442 return status;
443 }
444
445 /*===========================================================================
446 METHOD:
447 GetDataBearerTechnology (Public Method)
448
449 DESCRIPTION:
450 Calls WDSGetDataBearerTechnology
451
452 PARAMETERS:
453 pDataBearerTech [ O ] - Data bearer technology
454
455 RETURN VALUE:
456 ULONG
457 ===========================================================================*/
458 ULONG cGobiCMDLL::GetDataBearerTechnology( ULONG * pDataBearerTech )
459 {
460 // Assume failure
461 if (pDataBearerTech != 0)
462 {
463 *pDataBearerTech = 0xFFFFFFFF;
464 }
465
466 // Query for data bearer duration?
467 ULONG status = eGOBI_ERR_GENERAL;
468 if (mhGobi == 0)
469 {
470 return status;
471 }
472
473 ULONG lo = 1024;
474 BYTE rsp[1024] = { 0 };
475 status = WDSGetDataBearerTechnology( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
476 if (status != 0)
477 {
478 return status;
479 }
480
481 status = ParseGetDataBearerTechnology( lo, &rsp[0], pDataBearerTech );
482 return status;
483 }
484
485 /*===========================================================================
486 METHOD:
487 GetConnectionRate (Public Method)
488
489 DESCRIPTION:
490 Calls WDSGetChannelRates
491
492 PARAMETERS:
493 pCurTX [ O ] - Current TX rate
494 pCurRX [ O ] - Current RX rate
495 pMaxTX [ O ] - Max TX rate
496 pMaxRX [ O ] - Max RX rate
497
498 RETURN VALUE:
499 ULONG
500 ===========================================================================*/
501 ULONG cGobiCMDLL::GetConnectionRate(
502 ULONG * pCurTX,
503 ULONG * pCurRX,
504 ULONG * pMaxTX,
505 ULONG * pMaxRX )
506 {
507 // Assume failure
508 pCurTX != 0 ? *pCurTX = 0xFFFFFFFF : 0;
509 pCurRX != 0 ? *pCurRX = 0xFFFFFFFF : 0;
510 pMaxTX != 0 ? *pMaxTX = 0xFFFFFFFF : 0;
511 pMaxRX != 0 ? *pMaxRX = 0xFFFFFFFF : 0;
512
513 // Query for rates?
514 ULONG status = eGOBI_ERR_GENERAL;
515 if (mhGobi == 0)
516 {
517 return status;
518 }
519
520 ULONG lo = 1024;
521 BYTE rsp[1024] = { 0 };
522 status = WDSGetChannelRates( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
523 if (status != 0)
524 {
525 return status;
526 }
527
528 status = ParseGetConnectionRate( lo,
529 &rsp[0],
530 pCurTX,
531 pCurRX,
532 pMaxTX,
533 pMaxRX );
534 return status;
535 }
536
537 /*===========================================================================
538 METHOD:
539 GetFirmwareRevision (Public Method)
540
541 DESCRIPTION:
542 Calls DMSGetDeviceRevision
543
544 PARAMETERS:
545 strSz [ I ] - Maximum number of characters
546 pStr [ O ] - Firmware revision string
547
548 RETURN VALUE:
549 ULONG
550 ===========================================================================*/
551 ULONG cGobiCMDLL::GetFirmwareRevision(
552 BYTE strSz,
553 CHAR * pStr )
554 {
555 return GetString( DMSGetDeviceRevision, 0x01, strSz, pStr );
556 }
557
558 /*===========================================================================
559 METHOD:
560 GetManufacturer (Public Method)
561
562 DESCRIPTION:
563 Calls DMSGetDeviceManfacturer
564
565 PARAMETERS:
566 strSz [ I ] - Maximum string size
567 pStr [ O ] - Manufacturer string
568
569 RETURN VALUE:
570 ULONG
571 ===========================================================================*/
572 ULONG cGobiCMDLL::GetManufacturer(
573 BYTE strSz,
574 CHAR * pStr )
575 {
576 return GetString( DMSGetDeviceManfacturer, 0x01, strSz, pStr );
577 }
578
579 /*===========================================================================
580 METHOD:
581 GetModelID (Public Method)
582
583 DESCRIPTION:
584 Calls GetModelID
585
586 PARAMETERS:
587 strSz [ I ] - Max string size
588 pStr [ O ] - Model ID string
589
590 RETURN VALUE:
591 ULONG
592 ===========================================================================*/
593 ULONG cGobiCMDLL::GetModelID(
594 BYTE strSz,
595 CHAR * pStr )
596 {
597 return GetString( DMSGetDeviceModel, 0x01, strSz, pStr );
598 }
599
600 /*===========================================================================
601 METHOD:
602 GetHardwareRevision (Public Method)
603
604 DESCRIPTION:
605 Calls DMSGetHardwareRevision
606
607 PARAMETERS:
608 strSz [ I ] - Max size of string
609 pStr [ O ] - Hardware revision string
610
611 RETURN VALUE:
612 ULONG
613 ===========================================================================*/
614 ULONG cGobiCMDLL::GetHardwareRevision(
615 BYTE strSz,
616 CHAR * pStr )
617 {
618 return GetString( DMSGetHardwareRevision, 0x01, strSz, pStr );
619 }
620
621 /*===========================================================================
622 METHOD:
623 GetVoiceNumber (Public Method)
624
625 DESCRIPTION:
626 Calls GetVoiceNumber
627
628 PARAMETERS:
629 voiceSz [ I ] - Max characters in voice string
630 pVoiceStr [ O ] - Voice number string
631 minSz [ I ] - Max characters in MIN string
632 pMINStr [ O ] - MIN string
633
634 RETURN VALUE:
635 ULONG
636 ===========================================================================*/
637 ULONG cGobiCMDLL::GetVoiceNumber(
638 BYTE voiceSz,
639 CHAR * pVoiceStr,
640 BYTE minSz,
641 CHAR * pMINStr )
642 {
643 // Assume failure
644 if (voiceSz > 0 && pVoiceStr != 0)
645 {
646 pVoiceStr[0] = 0;
647 }
648
649 if (minSz > 0 && pMINStr != 0)
650 {
651 pMINStr[0] = 0;
652 }
653
654 // Query for voice numbers?
655 ULONG status = eGOBI_ERR_GENERAL;
656 if (mhGobi == 0)
657 {
658 return status;
659 }
660
661 ULONG lo = 1024;
662 BYTE rsp[1024] = { 0 };
663 status = DMSGetDeviceVoiceNumber( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
664 if (status != 0)
665 {
666 return status;
667 }
668
669 status = ParseGetVoiceNumber( lo,
670 &rsp[0],
671 voiceSz,
672 pVoiceStr,
673 minSz,
674 pMINStr );
675 return status;
676 }
677
678 /*===========================================================================
679 METHOD:
680 GetSerialNumbers (Public Method)
681
682 DESCRIPTION:
683 Calls DMSGetDeviceSerialNumbers
684
685 PARAMETERS:
686 esnSz [ I ] - ESN size
687 pESNStr [ O ] - ESN string
688 imeiSz [ I ] - IMEI size
689 pIMEIStr [ O ] - IMSI string
690 meidSz [ I ] - MEID size
691 pMEIDStr [ O ] - MEID string
692
693 RETURN VALUE:
694 ULONG
695 ===========================================================================*/
696 ULONG cGobiCMDLL::GetSerialNumbers(
697 BYTE esnSz,
698 CHAR * pESNStr,
699 BYTE imeiSz,
700 CHAR * pIMEIStr,
701 BYTE meidSz,
702 CHAR * pMEIDStr )
703 {
704 // Assume failure
705 if (esnSz > 0 && pESNStr != 0)
706 {
707 pESNStr[0] = 0;
708 }
709
710 if (imeiSz > 0 && pIMEIStr != 0)
711 {
712 pIMEIStr[0] = 0;
713 }
714
715 if (meidSz > 0 && pMEIDStr != 0)
716 {
717 pMEIDStr[0] = 0;
718 }
719
720 // Query for serial numbers?
721 ULONG status = eGOBI_ERR_GENERAL;
722 if (mhGobi == 0)
723 {
724 return status;
725 }
726
727 ULONG lo = 1024;
728 BYTE rsp[1024] = { 0 };
729 status = DMSGetDeviceSerialNumbers( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
730 if (status != 0)
731 {
732 return status;
733 }
734
735 status = ParseGetSerialNumbers( lo,
736 &rsp[0],
737 esnSz,
738 pESNStr,
739 imeiSz,
740 pIMEIStr,
741 meidSz,
742 pMEIDStr );
743 return status;
744 }
745
746 /*===========================================================================
747 METHOD:
748 GetIMSI (Public Method)
749
750 DESCRIPTION:
751 Get IMSI
752
753 PARAMETERS:
754 imsiSz [ I ] - IMSI size
755 pIMSIStr [ O ] - IMSI string
756
757 RETURN VALUE:
758 ULONG
759 ===========================================================================*/
760 ULONG cGobiCMDLL::GetIMSI(
761 BYTE imsiSz,
762 CHAR * pIMSIStr )
763 {
764 return GetString( DMSGetDeviceVoiceNumber, 0x11, imsiSz, pIMSIStr );
765 }
766
767 /*===========================================================================
768 METHOD:
769 GetSignalStrengths (Public Method)
770
771 DESCRIPTION:
772 Calls NASGetSignalStrength
773
774 PARAMETERS:
775 pSigStrengths [ O ] - Received signal strength
776 pRadioInterfaces [ O ] - Radio interface technology
777
778 RETURN VALUE:
779 ULONG
780 ===========================================================================*/
781 ULONG cGobiCMDLL::GetSignalStrengths(
782 INT8 * pSigStrengths,
783 ULONG * pRadioInterfaces )
784 {
785 // Assume failure
786 for (ULONG s = 0; s < MAX_SIGNALS; s++)
787 {
788 pSigStrengths[s] = 0;
789 pRadioInterfaces[s] = 0xFFFFFFFF;
790 }
791
792 // Query for signal strengths?
793 ULONG status = eGOBI_ERR_GENERAL;
794 if (mhGobi == 0)
795 {
796 return status;
797 }
798
799 ULONG lo = 1024;
800 BYTE rsp[1024] = { 0 };
801 status = NASGetSignalStrength( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
802 if (status != 0)
803 {
804 return status;
805 }
806
807 status = ParseGetSignalStrength( lo,
808 &rsp[0],
809 pSigStrengths,
810 pRadioInterfaces );
811 return status;
812 }
813
814 /*===========================================================================
815 METHOD:
816 GetServingNetwork (Public Method)
817
818 DESCRIPTION:
819 Calls NASGetServingSystem
820
821 PARAMETERS:
822 pDataCapabilities [ O ] - Data capabilities
823 pMCC [ O ] - Mobile country code
824 pMNC [ O ] - Mobile network code
825 nameSize [ I ] - Network name max size
826 pName [ O ] - Network name
827 pSID [ O ] - System ID
828 pNID [ O ] - Network ID
829 pRoam [ O ] - Roaming indicator
830
831 RETURN VALUE:
832 ULONG
833 ===========================================================================*/
834 ULONG cGobiCMDLL::GetServingNetwork(
835 ULONG * pDataCapabilities,
836 WORD * pMCC,
837 WORD * pMNC,
838 BYTE nameSize,
839 CHAR * pName,
840 WORD * pSID,
841 WORD * pNID,
842 ULONG * pRoam )
843 {
844 // Assume failure
845 for (ULONG d = 0; d < MAX_DATA_CAPABILITIES; d++)
846 {
847 pDataCapabilities[d] = 0xFFFFFFFF;
848 }
849
850 if (nameSize > 0 && pName != 0)
851 {
852 pName[0] = 0;
853 }
854
855 pMCC != 0 ? *pMCC = 0xFFFF : 0;
856 pMNC != 0 ? *pMNC = 0xFFFF : 0;
857 pRoam != 0 ? *pRoam = 0xFFFFFFFF : 0;
858 pSID != 0 ? *pSID = 0xFFFF : 0;
859 pNID != 0 ? *pNID = 0xFFFF : 0;
860
861 // Query for serving system?
862 ULONG status = eGOBI_ERR_GENERAL;
863 if (mhGobi == 0)
864 {
865 return status;
866 }
867
868 ULONG lo = 8096;
869 BYTE rsp[8096] = { 0 };
870 status = NASGetServingSystem( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
871 if (status != 0)
872 {
873 return status;
874 }
875
876 std::map <UINT8, const sQMIRawContentHeader *> tlvs = GetTLVs( &rsp[0], lo );
877 std::map <UINT8, const sQMIRawContentHeader *>::const_iterator pIter = tlvs.find( 0x11 );
878 if (pIter != tlvs.end())
879 {
880 const sQMIRawContentHeader * pTmp = pIter->second;
881 ULONG tlvLen = (ULONG)pTmp->mLength;
882 ULONG dsLen = (ULONG)sizeof( sNASGetServingSystemResponse_DataServices );
883 if (tlvLen < dsLen)
884 {
885 return eGOBI_ERR_GENERAL;
886 }
887
888 pTmp++;
889 const sNASGetServingSystemResponse_DataServices * pDS =
890 (const sNASGetServingSystemResponse_DataServices *)pTmp;
891
892 ULONG dcCount = (ULONG)pDS->mNumberOfDataCapabilities;
893 ULONG dcSz = (ULONG)sizeof( eQMINASDataServiceCapabilities2 );
894 dsLen += dcCount * dcSz;
895 if (tlvLen < dsLen)
896 {
897 return eGOBI_ERR_GENERAL;
898 }
899
900 pDS++;
901 eQMINASDataServiceCapabilities2 * pCap = (eQMINASDataServiceCapabilities2 *)pDS;
902 if (dcCount > MAX_DATA_CAPABILITIES)
903 {
904 dcCount = MAX_DATA_CAPABILITIES;
905 }
906
907 for (ULONG i = 0; i < dcCount; i++)
908 {
909 pDataCapabilities[i] = (ULONG)*pCap++;
910 }
911 }
912
913 pIter = tlvs.find( 0x12 );
914 if (pIter != tlvs.end())
915 {
916 const sQMIRawContentHeader * pTmp = pIter->second;
917 ULONG tlvLen = (ULONG)pTmp->mLength;
918 ULONG plmnLen = (ULONG)sizeof( sNASGetServingSystemResponse_CurrentPLMN );
919 if (tlvLen < plmnLen)
920 {
921 return eGOBI_ERR_GENERAL;
922 }
923
924 pTmp++;
925 const sNASGetServingSystemResponse_CurrentPLMN * pPLMN =
926 (const sNASGetServingSystemResponse_CurrentPLMN *)pTmp;
927
928 ULONG strLen = (ULONG)pPLMN->mDescriptionLength;
929 plmnLen += strLen;
930 if (tlvLen < plmnLen)
931 {
932 return eGOBI_ERR_GENERAL;
933 }
934
935 pMCC != 0 ? *pMCC = (ULONG)pPLMN->mMobileCountryCode : 0;
936 pMNC != 0 ? *pMNC = (ULONG)pPLMN->mMobileNetworkCode : 0;
937 pPLMN++;
938
939 if (strLen != 0 && nameSize > 0 && pName != 0)
940 {
941 ULONG needLen = strLen;
942 if (needLen + 1 > nameSize)
943 {
944 needLen = nameSize - 1;
945 }
946
947 memcpy( pName, pPLMN, needLen );
948 pName[needLen] = 0;
949 }
950 }
951
952 pIter = tlvs.find( 0x13 );
953 if (pIter != tlvs.end())
954 {
955 const sQMIRawContentHeader * pTmp = pIter->second;
956 ULONG tlvLen = (ULONG)pTmp->mLength;
957 ULONG sysLen = (ULONG)sizeof( sNASGetServingSystemResponse_SystemID );
958 if (tlvLen < sysLen)
959 {
960 return eGOBI_ERR_GENERAL;
961 }
962
963 pTmp++;
964 const sNASGetServingSystemResponse_SystemID * pSys =
965 (const sNASGetServingSystemResponse_SystemID *)pTmp;
966
967 pSID != 0 ? *pSID = (ULONG)pSys->mSystemID : 0;
968 pNID != 0 ? *pNID = (ULONG)pSys->mNetworkID : 0;
969 }
970
971 pIter = tlvs.find( 0x16 );
972 if (pIter != tlvs.end())
973 {
974 const sQMIRawContentHeader * pTmp = pIter->second;
975 ULONG tlvLen = (ULONG)pTmp->mLength;
976 ULONG roamLen = (ULONG)sizeof( sNASGetServingSystemResponse_DefaultRoaming );
977 if (tlvLen < roamLen)
978 {
979 return eGOBI_ERR_GENERAL;
980 }
981
982 pTmp++;
983 const sNASGetServingSystemResponse_DefaultRoaming * pDR =
984 (const sNASGetServingSystemResponse_DefaultRoaming *)pTmp;
985
986 pRoam != 0 ? *pRoam = (ULONG)pDR->mRoamingIndicator : 0;
987 }
988
989 return status;
990 }
991
992 /*===========================================================================
993 METHOD:
994 GetHomeNetwork (Public Method)
995
996 DESCRIPTION:
997 Calls NASGetHomeNetwork
998
999 PARAMETERS:
1000 pHomeMCC [ O ] - Mobile country code
1001 pHomeMNC [ O ] - Mobile network code
1002 homeNameSize [ I ] - Max name size
1003 pHomeName [ O ] - Home network name
1004 pSID [ O ] - System ID
1005 pNID [ O ] - Network ID
1006
1007 RETURN VALUE:
1008 ULONG
1009 ===========================================================================*/
1010 ULONG cGobiCMDLL::GetHomeNetwork(
1011 WORD * pHomeMCC,
1012 WORD * pHomeMNC,
1013 BYTE homeNameSize,
1014 CHAR * pHomeName,
1015 WORD * pSID,
1016 WORD * pNID )
1017 {
1018 // Assume failure
1019 if (homeNameSize > 0 && pHomeName != 0)
1020 {
1021 pHomeName[0] = 0;
1022 }
1023
1024 pHomeMCC != 0 ? *pHomeMCC = 0xFFFF : 0;
1025 pHomeMNC != 0 ? *pHomeMNC = 0xFFFF : 0;
1026 pSID != 0 ? *pSID = 0xFFFF : 0;
1027 pNID != 0 ? *pNID = 0xFFFF : 0;
1028
1029 // Query for home system?
1030 ULONG status = eGOBI_ERR_GENERAL;
1031 if (mhGobi == 0)
1032 {
1033 return status;
1034 }
1035
1036 ULONG lo = 8096;
1037 BYTE rsp[8096] = { 0 };
1038 status = NASGetHomeNetwork( mhGobi, 2000, 0, 0, &lo, &rsp[0] );
1039 if (status != 0)
1040 {
1041 return status;
1042 }
1043
1044 status = ParseGetHomeNetwork( lo,
1045 &rsp[0],
1046 pHomeMCC,
1047 pHomeMNC,
1048 homeNameSize,
1049 pHomeName,
1050 pSID,
1051 pNID );
1052 return status;
1053 }
1054
1055 /*===========================================================================
1056 METHOD:
1057 SetWDSEventReportCB (Public Method)
1058
1059 DESCRIPTION:
1060 Calls WDSSetEventReport/SetGenericCallback
1061
1062 PARAMETERS:
1063 pCallback [ I ] - Callback function pointer
1064 interval [ I ] - Interval (in seconds) for transfer statistics
1065
1066 RETURN VALUE:
1067 ULONG
1068 ===========================================================================*/
1069 ULONG cGobiCMDLL::SetWDSEventReportCB(
1070 tFNGenericCallback pCallback,
1071 BYTE interval )
1072 {
1073 // Set WDS event callback?
1074 ULONG status = eGOBI_ERR_GENERAL;
1075 if (mhGobi == 0)
1076 {
1077 return status;
1078 }
1079
1080 // Configure the QMI service
1081 UINT8 req[1024] = { 0 };
1082 UINT8 * pData = (UINT8 *)&req[0];
1083
1084 sQMIRawContentHeader * pTLV = (sQMIRawContentHeader *)pData;
1085 pTLV->mTypeID = 0x11;
1086 pTLV->mLength = (UINT16)sizeof( sWDSSetEventReportRequest_TransferStatisticsIndicator );
1087 pData += sizeof( sQMIRawContentHeader );
1088
1089 sWDSSetEventReportRequest_TransferStatisticsIndicator * pTS =
1090 (sWDSSetEventReportRequest_TransferStatisticsIndicator *)pData;
1091 pTS->mTransferStatisticsIntervalSeconds = interval;
1092 pTS->mReportTXPacketSuccesses = 0;
1093 pTS->mReportRXPacketSuccesses = 0;
1094 pTS->mReportTXPacketErrors = 0;
1095 pTS->mReportRXPacketErrors = 0;
1096 pTS->mReportTXOverflows = 0;
1097 pTS->mReportRXOverflows = 0;
1098 pTS->mTXByteTotal = 1;
1099 pTS->mRXByteTotal = 1;
1100 pData += sizeof( sWDSSetEventReportRequest_TransferStatisticsIndicator );
1101
1102 pTLV = (sQMIRawContentHeader *)pData;
1103 pTLV->mTypeID = 0x12;
1104 pTLV->mLength = (UINT16)sizeof( sWDSSetEventReportRequest_DataBearerTechnologyIndicator );
1105 pData += sizeof( sQMIRawContentHeader );
1106
1107 sWDSSetEventReportRequest_DataBearerTechnologyIndicator * pTI =
1108 (sWDSSetEventReportRequest_DataBearerTechnologyIndicator *)pData;
1109 pTI->mReportDataBearerTechnology = 1;
1110 pData += sizeof( sWDSSetEventReportRequest_DataBearerTechnologyIndicator );
1111
1112 ULONG li = (ULONG)pData - (ULONG)&req[0];
1113 status = WDSSetEventReport( mhGobi, 2000, li, &req[0], 0, 0 );
1114 if (status != 0)
1115 {
1116 return status;
1117 }
1118
1119 // Configure the callback with the API
1120 status = SetGenericCallback( mhGobi, 1, 1, pCallback );
1121 return status;
1122 }
1123
1124 /*===========================================================================
1125 METHOD:
1126 SetWDSSessionStateCB (Public Method)
1127
1128 DESCRIPTION:
1129 Calls SetGenericCallback
1130
1131 PARAMETERS:
1132 pCallback [ I ] - Callback function pointer
1133
1134 RETURN VALUE:
1135 ULONG
1136 ===========================================================================*/
1137 ULONG cGobiCMDLL::SetWDSSessionStateCB( tFNGenericCallback pCallback )
1138 {
1139 // Set WDS packet service status callback?
1140 ULONG status = eGOBI_ERR_GENERAL;
1141 if (mhGobi == 0)
1142 {
1143 return status;
1144 }
1145
1146 // Configure the callback with the API
1147 status = SetGenericCallback( mhGobi, 1, 34, pCallback );
1148 return status;
1149 }
1150
1151 /*===========================================================================
1152 METHOD:
1153 SetNASEventReportCB (Public Method)
1154
1155 DESCRIPTION:
1156 Calls NASSetEventReport/SetGenericCallback
1157
1158 PARAMETERS:
1159 pCallback [ I ] - Callback function pointer
1160 thresholdsSize [ I ] - Threshold size
1161 pThresholds [ I ] - Array of thresholds
1162
1163 RETURN VALUE:
1164 ULONG
1165 ===========================================================================*/
1166 ULONG cGobiCMDLL::SetNASEventReportCB(
1167 tFNGenericCallback pCallback,
1168 BYTE thresholdsSize,
1169 INT8 * pThresholds )
1170 {
1171 // Set NAS event report callback request?
1172 ULONG status = eGOBI_ERR_GENERAL;
1173 if ( (mhGobi == 0)
1174 || (thresholdsSize > 0 && pThresholds == 0) )
1175 {
1176 return status;
1177 }
1178
1179 // Configure the QMI service
1180 UINT8 req[1024] = { 0 };
1181 UINT8 * pData = (UINT8 *)&req[0];
1182
1183 sQMIRawContentHeader * pTLV = (sQMIRawContentHeader *)pData;
1184 pTLV->mTypeID = 0x10;
1185 pTLV->mLength = (UINT16)sizeof( sNASSetEventReportRequest_SignalIndicator );
1186 pTLV->mLength += (UINT16)thresholdsSize;
1187 pData += sizeof( sQMIRawContentHeader );
1188
1189 sNASSetEventReportRequest_SignalIndicator * pSI =
1190 (sNASSetEventReportRequest_SignalIndicator *)pData;
1191 pSI->mReportSignalStrength = 1;
1192 pSI->mNumberOfThresholds = thresholdsSize;
1193 pData += sizeof( sNASSetEventReportRequest_SignalIndicator );
1194
1195 for (UINT8 i = 0; i < thresholdsSize; i++)
1196 {
1197 INT8 * pThresh = (INT8 *)pData;
1198 *pThresh = pThresholds[i];
1199 pData++;
1200 }
1201
1202 ULONG li = (ULONG)pData - (ULONG)&req[0];
1203 status = NASSetEventReport( mhGobi, 2000, li, &req[0], 0, 0 );
1204 if (status != 0)
1205 {
1206 return status;
1207 }
1208
1209 // Configure the callback with the API
1210 status = SetGenericCallback( mhGobi, 3, 2, pCallback );
1211 return status;
1212 }
1213
1214 /*===========================================================================
1215 METHOD:
1216 SetNASServingSystemCB (Public Method)
1217
1218 DESCRIPTION:
1219 Calls SetGenericCallback
1220
1221 PARAMETERS:
1222 pCallback [ I ] - Callback function pointer
1223
1224 RETURN VALUE:
1225 ULONG
1226 ===========================================================================*/
1227 ULONG cGobiCMDLL::SetNASServingSystemCB( tFNGenericCallback pCallback )
1228 {
1229 // Set NAS serving system request?
1230 ULONG status = eGOBI_ERR_GENERAL;
1231 if (mhGobi == 0)
1232 {
1233 return status;
1234 }
1235
1236 // Configure the callback with the API
1237 status = SetGenericCallback( mhGobi, 3, 36, pCallback );
1238 return status;
1239 }