An GPSID sample code for Windows Mobile

I wrote a GPS driver for Mobile_XXX last week. They told me the GPS could be driven base on either UART or GPSID. I haven't heard of GPSID before that. So I decided to drive GPS on UART directly. It's a little complicated, because I have to read date from serial port, and assemble the data in buffer, analysis the text frame of GPS, and then get the position information. Besides, I have to control the power of GPS.

 

But at last, they asked me to implement the driver based on GPSID, because GPS might be used in several softwares simultaneously. Other softwares can't use GPS, if I open the hardware uart port. So, I had no choice but to learn how to use GPSID on the scene. Fortunately, GPSID is very very easy to use. 

 

First, I found the sample code for Mobile's GPSID. It contains three projects, the class GPSController is the key factor in the sample code. It's a perfect driver for GPS. So I decided to use the class GPSController in my driver. I don't have to do much change on it.

 

  1) define two callback functions to retrive GPS position information and device status information;

typedef DWORD (*SendGPSInfo)(GPS_POSITION position); typedef DWORD (*UpdateGPSState)(GPS_DEVICE device);

 2) add precompile option clause to add gpsapi.lib

#pragma comment(lib, "gpsapi.lib")

 3) implement callback functions

 4) write main() function, transport the callback functions to GPSController

Notes: there is no UI in this demo

GPS_driver.cpp

// GPS_driver.cpp : Defines the entry point for the console application. // #include "stdafx.h" #include "GPSController.h" #define MAX_TEXT 200 HANDLE EventHaltGPS; DWORD sendGPSInfo(GPS_POSITION position) { CHAR szTmp[MAX_TEXT] = ""; WCHAR wszTmp[MAX_TEXT] = L""; // The postion information is not reliable if the SatelliteCout is less than 4 if (position.dwSatelliteCount < 4) { printf("%d",position.dwSatelliteCount); return 0; } // Got the available position information sprintf(szTmp, "Satellites: %d/n Lattitude: %2.4f/n Longitude: %2.4f", position.dwSatelliteCount, position.dblLatitude, position.dblLongitude); StringCchPrintfEx(wszTmp, sizeof(wszTmp)/sizeof(wszTmp[0]), NULL, NULL, STRSAFE_NULL_ON_FAILURE, L"%hs", szTmp); MessageBox(NULL, wszTmp, L"Success!",MB_OK); // Terminate GPS // We should shut down GPS as soon as getting position info successfully, otherwise power will be wasted. SetEvent(EventHaltGPS); // HTTP send // HTTP recv return 0; } // Unnecessary functionality, don't need to update it. DWORD updateGPSState(GPS_DEVICE device) { printf("update status for GPS/n"); return 0; } // This thread is used to waite for GPS positioning DWORD WINAPI GPSProcedure(__opt LPVOID lpParameter) { DWORD dwRet = 0; CGPSController gpsCtl(sendGPSInfo, updateGPSState); EventHaltGPS = CreateEvent(NULL, FALSE, FALSE, NULL); if (!EventHaltGPS) { dwRet = GetLastError(); return -1; } printf("wait/n"); while (1) { dwRet = WaitForSingleObject(EventHaltGPS, 1000);//INFINITE); if (dwRet == WAIT_OBJECT_0) { // shut down GPS gpsCtl.UninitDevice(); break; } else { printf("."); } } return 0; } int _tmain(int argc, _TCHAR* argv[]) { DWORD dwRet = 0; HANDLE m_hThread = NULL; m_hThread = CreateThread(NULL, NULL, GPSProcedure, NULL, NULL, NULL); if (!m_hThread) { dwRet = GetLastError(); return 0; } // This message box is used for debugging // The program will be closed if you close this window MessageBox(NULL, L"Please don't close this window while debugging", L"Note!",MB_OK); if (m_hThread) { CloseHandle(m_hThread); m_hThread = NULL; } return 0; }

 

GPSController.h (some comments are deleted, to short this artical)

// // Copyright (c) Microsoft Corporation. All rights reserved. // // // Use of this sample source code is subject to the terms of the Microsoft // license agreement under which you licensed this sample source code. If // you did not accept the terms of the license agreement, you are not // authorized to use this sample source code. For the terms of the license, // please see the license agreement between you and Microsoft or, if applicable, // see the LICENSE.RTF on your install media or the root of your tools installation. // THE SAMPLE SOURCE CODE IS PROVIDED "AS IS", WITH NO WARRANTIES OR INDEMNITIES. // #pragma once #include <GPSApi.h> #pragma comment(lib, "gpsapi.lib") typedef DWORD (*SendGPSInfo)(GPS_POSITION position); typedef DWORD (*UpdateGPSState)(GPS_DEVICE device); class CGPSController { public: CGPSController(__in SendGPSInfo sendFunc, __in UpdateGPSState gpsState); HRESULT UninitDevice(); private: static DWORD WINAPI GPSThreadProc(__opt LPVOID lpParameter); HRESULT LoadThread(); HRESULT UnloadThread(); private: // Data available to the worker thread static HANDLE s_hGPS_Device; static HANDLE s_hNewLocationData; static HANDLE s_hDeviceStateChange; static HANDLE s_hExitThread; // Pointer to the call back interface static SendGPSInfo m_pfSendGPSInfo; static UpdateGPSState m_pfUpdateGPSState; // Thread Info HANDLE m_hThread; DWORD m_dwThreadID; };

 

GPSController.cpp (some comments are deleted, to short this artical)

// // Copyright (c) Microsoft Corporation. All rights reserved. // // // Use of this sample source code is subject to the terms of the Microsoft // license agreement under which you licensed this sample source code. If // you did not accept the terms of the license agreement, you are not // authorized to use this sample source code. For the terms of the license, // please see the license agreement between you and Microsoft or, if applicable, // see the LICENSE.RTF on your install media or the root of your tools installation. // THE SAMPLE SOURCE CODE IS PROVIDED "AS IS", WITH NO WARRANTIES OR INDEMNITIES. // #include "stdafx.h" //#include "GPSController.h" HANDLE CGPSController::s_hGPS_Device = NULL; HANDLE CGPSController::s_hNewLocationData = NULL; HANDLE CGPSController::s_hDeviceStateChange = NULL; HANDLE CGPSController::s_hExitThread = NULL; SendGPSInfo CGPSController::m_pfSendGPSInfo = NULL; UpdateGPSState CGPSController::m_pfUpdateGPSState = NULL; #define MAX_WAIT 5000 #define MAX_AGE 3000 #define GPS_CONTROLLER_EVENT_COUNT 3 CGPSController::CGPSController(__in SendGPSInfo sendFunc, __in UpdateGPSState gpsState) : m_hThread(NULL), m_dwThreadID(0) { HRESULT hr = E_FAIL; DWORD dwRet = 0; if (NULL == sendFunc) { hr = E_INVALIDARG; goto Exit; } if (s_hGPS_Device) { // InitDevice is to be called only once // This is best protected by implemeneting // an instantitor function and having the construtor set to become // private. hr = E_INVALIDARG; goto Exit; } m_pfSendGPSInfo = sendFunc; m_pfUpdateGPSState = gpsState; hr = LoadThread(); if (FAILED(hr)) { goto Exit; } s_hGPS_Device = GPSOpenDevice(s_hNewLocationData, s_hDeviceStateChange, NULL, NULL); if (!s_hGPS_Device) { dwRet = GetLastError(); hr = HRESULT_FROM_WIN32(dwRet); goto Exit; } hr = S_OK; Exit: if (FAILED(hr)) { UninitDevice(); } } DWORD WINAPI CGPSController::GPSThreadProc(__opt LPVOID lpParameter) { DWORD dwRet = 0; GPS_POSITION gps_Position = {0}; GPS_DEVICE gps_Device = {0}; HANDLE gpsHandles[GPS_CONTROLLER_EVENT_COUNT] = {s_hNewLocationData, s_hDeviceStateChange, s_hExitThread }; gps_Position.dwSize = sizeof(gps_Position); gps_Position.dwVersion = GPS_VERSION_1; gps_Device.dwVersion = GPS_VERSION_1; gps_Device.dwSize = sizeof(gps_Device); do { dwRet = WaitForMultipleObjects(GPS_CONTROLLER_EVENT_COUNT, gpsHandles, FALSE, INFINITE); if (dwRet == WAIT_OBJECT_0) { dwRet = GPSGetPosition(s_hGPS_Device, &gps_Position, MAX_AGE, 0); if (ERROR_SUCCESS != dwRet) { continue; } else { m_pfSendGPSInfo(gps_Position); } } else if (dwRet == WAIT_OBJECT_0 + 1) { dwRet = GPSGetDeviceState(&gps_Device); if (ERROR_SUCCESS != dwRet) { continue; } else { m_pfUpdateGPSState(gps_Device); } } else if (dwRet == WAIT_OBJECT_0 + 2) { break; } else { ASSERT(0); } } while (1); return 0; } HRESULT CGPSController::UnloadThread() { HRESULT hr = E_FAIL; BOOL bRet = FALSE; DWORD dwRet = 0; // Instruct the thread to unload // There is not much one can do if set event failed // Ignore the failure and continue unloading bRet = SetEvent(s_hExitThread); if (!bRet) { dwRet = GetLastError(); hr = HRESULT_FROM_WIN32(dwRet); goto Exit; } dwRet = WaitForSingleObject(m_hThread, MAX_WAIT); if(WAIT_OBJECT_0 != dwRet) { dwRet = GetLastError(); hr = HRESULT_FROM_WIN32(dwRet); goto Exit; } hr = S_OK; Exit: if (s_hNewLocationData) { CloseHandle(s_hNewLocationData); s_hNewLocationData = NULL; } if (s_hDeviceStateChange) { CloseHandle(s_hDeviceStateChange); s_hDeviceStateChange = NULL; } if (s_hExitThread) { CloseHandle(s_hExitThread); s_hExitThread = NULL; } if (m_hThread) { CloseHandle(m_hThread); m_hThread = NULL; } return hr; } HRESULT CGPSController::LoadThread() { HRESULT hr = E_FAIL; DWORD dwRet = 0; s_hNewLocationData = CreateEvent(NULL, FALSE, FALSE, NULL); if (!s_hNewLocationData) { dwRet = GetLastError(); hr = HRESULT_FROM_WIN32(dwRet); goto Exit; } s_hDeviceStateChange = CreateEvent(NULL, FALSE, FALSE, NULL); if (!s_hDeviceStateChange) { dwRet = GetLastError(); hr = HRESULT_FROM_WIN32(dwRet); goto Exit; } s_hExitThread = CreateEvent(NULL, FALSE, FALSE, NULL); if (!s_hExitThread) { dwRet = GetLastError(); hr = HRESULT_FROM_WIN32(dwRet); goto Exit; } m_hThread = CreateThread(NULL, NULL, GPSThreadProc, NULL, NULL, &m_dwThreadID); if (!m_hThread) { dwRet = GetLastError(); hr = HRESULT_FROM_WIN32(dwRet); goto Exit; } hr = S_OK; Exit: if (FAILED(hr)) { if (s_hNewLocationData) { CloseHandle(s_hNewLocationData); s_hNewLocationData = NULL; } if (s_hDeviceStateChange) { CloseHandle(s_hDeviceStateChange); s_hDeviceStateChange = NULL; } if (s_hExitThread) { CloseHandle(s_hExitThread); s_hExitThread = NULL; } // tmphThread is NULL & the thread was not created } return hr; } HRESULT CGPSController::UninitDevice() { HRESULT hr = E_FAIL; DWORD dwRet = 0; if (!s_hGPS_Device) { hr = E_INVALIDARG; goto Exit; } // Attempt to unload the thread // There is nothing much that one can do if it fails hr = UnloadThread(); // Attempt to unload the thread // there is nothing much that one can do if it fails dwRet = GPSCloseDevice(s_hGPS_Device); s_hGPS_Device = NULL; // return the origin of the failure if any if (FAILED(hr)) { goto Exit; } else if (ERROR_SUCCESS != dwRet) { dwRet = GetLastError(); hr = HRESULT_FROM_WIN32(dwRet); goto Exit; } hr = S_OK; Exit: return hr; }