Quectel Android GNSS Driver User Guide V1.2
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 15
| Download | |
| Open PDF In Browser | View PDF |
Android GNSS Driver User Guide GNSS/GSM/UMTS/LTE Module Series Rev. Android_GNSS_Driver_User_Guide_V1.2 Date: 2018-12-03 Status: Released www.quectel.com GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide Our aim is to provide customers with timely and comprehensive service. For any assistance, please contact our company headquarters: Quectel Wireless Solutions Co., Ltd. 7th Floor, Hongye Building, No.1801 Hongmei Road, Xuhui District, Shanghai 200233, China Tel: +86 21 5108 6236 Email: info@quectel.com Or our local office. For more information, please visit: http://www.quectel.com/support/sales.htm For technical support, or to report documentation errors, please visit: http://www.quectel.com/support/technical.htm Or email to: support@quectel.com GENERAL NOTES QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO CHANGE WITHOUT PRIOR NOTICE. COPYRIGHT THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF QUECTEL WIRELESS SOLUTIONS CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL OR DESIGN. Copyright © Quectel Wireless Solutions Co., Ltd. 2018. All rights reserved. Android_GNSS_Driver_User_Guide 1 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide About the Document History Revision Date Author Description 1.0 2014-05-06 Joe WANG Initial 1.1 2015-04-11 Kent XU Added applicable modules 1. 2. 1.2 2018-12-03 Marco GAO 3. Android_GNSS_Driver_User_Guide Modified the procedures of installing GNSS Driver in Chapter 2.2. Added the description of catching GNSS logs in Chapter 3.2. Added troubleshooting instructions on GNSS drivers running on Android 8.0 or later versions in Chapter 3.4. 2 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide Contents About the Document ................................................................................................................................... 2 Contents ....................................................................................................................................................... 3 Table Index ................................................................................................................................................... 4 Figure Index ................................................................................................................................................. 5 1 Introduction .......................................................................................................................................... 6 1.1. Applicable Modules ................................................................................................................... 6 2 System Integration............................................................................................................................... 7 2.1. The Structure of Android GNSS Driver ..................................................................................... 7 2.2. GNSS Driver Installation ........................................................................................................... 8 2.3. Delete Unnecessary gps.*.so Files ........................................................................................... 8 3 Supplementary Instructions ............................................................................................................... 9 3.1. Modify GNSS Configuration File ............................................................................................... 9 3.2. Catch GNSS Logs ................................................................................................................... 10 3.3. GNSS Driver Test .................................................................................................................... 11 3.4. Failed to Get GNSS Data ........................................................................................................ 11 4 Appendix A References..................................................................................................................... 14 Android_GNSS_Driver_User_Guide 3 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide Table Index TABLE 1: APPLICABLE MODULES .................................................................................................................... 6 TABLE 2: RELATED DOCUMENT .................................................................................................................... 14 TABLE 3: TERMS AND ABBREVIATIONS ........................................................................................................ 14 Android_GNSS_Driver_User_Guide 4 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide Figure Index FIGURE 1: GNSS DRIVER STRUCTURE (TAKING UC20 AS AN EXAMPLE) ................................................. 7 FIGURE 2: GNSS TEST WITH GPS TEST V1.5.4.APK .................................................................................... 11 Android_GNSS_Driver_User_Guide 5 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide 1 Introduction This document mainly introduces how to integrate the Android GNSS (Global Navigation Satellite System) driver into Android OS of Quectel modules supporting GNSS function. 1.1. Applicable Modules Table 1: Applicable Modules GNSS Modules All Quectel GNSS modules GSM Modules MCxx: includes MC60/MC90 modules UMTS Module UCxx: UC20 module AG35 module BG96 module ECxx: includes EC20/EC21/EC25 modules LTE Modules EG9x: includes EG91-NA/EG95-NA/EG91-EC/EG95-EC modules EM05 module Ex06 module: includes EG06/EP06/EM06 modules Android_GNSS_Driver_User_Guide 6 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide 2 System Integration This chapter describes the structure of Android GNSS driver and explains how to integrate the GNSS driver into Android OS of Quectel modules supporting GNSS function. 2.1. The Structure of Android GNSS Driver GNSS devices transmit the GNSS data through GNSS hardware driver, and then GNSS HAL driver transmits the received GNSS data to GNSS applications through JNI and Application Framework. The following figure illustrates the structure of GNSS driver. Quectel GNSS driver works in HAL, and it is compiled as gps.default.so file. Figure 1: GNSS Driver Structure (Taking UC20 as an Example) Android_GNSS_Driver_User_Guide 7 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide 2.2. GNSS Driver Installation Add the following two GNSS driver files, gps_cfg.inf and gps.default.so, to Android system. ⚫ For 32-bit Android system gps_cfg.inf gps.default.so ⚫ → /system/etc → /system/lib/hw For 64-bit Android system gps_cfg.inf gps.default.so → /system/etc → /system/lib64/hw 2.3. Delete Unnecessary gps.*.so Files Except for gps.default.so, other unnecessary gps.*.so files in the directory of /system/lib/hw or /system/lib64/hw should be deleted to ensure that the system can identify the correct GNSS driver. Android_GNSS_Driver_User_Guide 8 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide 3 Supplementary Instructions 3.1. Modify GNSS Configuration File Quectel GNSS driver has a configuration file named gps_cfg.inf. Customers can modify the configuration file by copying it to /system/etc in the android system and changing the NMEA port path in it. NMEA port path to be changed: 1. Quectel GNSS modules (for example, L76): NMEA_PORT_PATH=Serial name 2. Quectel GSM/UMTS/LTE modules (for example, UC20, MC20, EC20): NMEA_PORT_PATH=rild-nmea As for Quectel GSM/UMTS/LTE modules, the Quectel Android RIL driver should be integrated first. For detailed procedures, please refer to Quectel_Android_RIL_Driver_User_Guide. Android_GNSS_Driver_User_Guide 9 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide 3.2. Catch GNSS Logs 1) Catch the logs of GNSS module by typing the following command in Window’s CMD tool: adb logcat –s gps_ql –v time 2) Sometimes, customers may want to perform tests on lots of devices or for a long time, and it is not convenient to connect all devices with PC via USB cables. In such case, customers can catch the log files by following command: adb shell logcat –s gps_ql –v time –f& The character "&" makes the "logcat" process run in the background, thus customers’ devices can be disconnected. When customers’ tests are finished, the log files can be fetched from devices to a local directory by the following command: adb pull Android_GNSS_Driver_User_Guide 10 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide 3.3. GNSS Driver Test When the module is connected to an Android system, the Android system will identify it first and then read the GNSS driver data. A GNSS application, like GPS TEST v1.5.4.APK can be used to test the performance of the GNSS driver. Figure 2: GNSS Test with GPS TEST v1.5.4.APK In the above figure, the satellite number larger than 160 is China's "BeiDou" navigation system. 3.4. Failed to Get GNSS Data If customers’ GNSS applications fail to get GNSS data, the following items should be checked: ⚫ ⚫ ⚫ Move the GNSS antenna to the open air, make sure it can receive GNSS signals. Ensure that the directory of /system/lib/hw or /system/lib64/hw only contains gps.default.so. Ensure that gps_cfg.inf is in the right directory of the Android system and has been modified correctly. Android_GNSS_Driver_User_Guide 11 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide If customers’ GNSS applications with GNSS drivers running on Android 8.0 or later versions fail to get GNSS data, except for the items mentioned above, the following four files should be checked and confirmed (taking the rk3399-based platform as an example). 1. device/rockchip/rk3399/BoardConfig.mk 2. device/rockchip/rk3399/device.mk 3. device/rockchip/rk3399/manifest.xml Android_GNSS_Driver_User_Guide 12 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide 4. device/rockchip/rk3399/init.rk3399.rc If all the items above have been checked, but the problem still exists, please contact Quectel Technical Supports for assistance. Android_GNSS_Driver_User_Guide 13 / 14 GNSS/GSM/UMTS/LTE Module Series Android CNSS Driver User Guide 4 Appendix A References Table 2: Related Document SN Document Name Remark [1] Quectel_Android_RIL_Driver_User_Guide Android RIL Driver User Guide Table 3: Terms and Abbreviations Abbreviation Description GNSS Global Navigation Satellite System GPS Global Position System HAL Hardware Abstraction Layer OS Operating System Android_GNSS_Driver_User_Guide 14 / 14
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.7 Linearized : No Encryption : Standard V4.4 (128-bit) User Access : Copy, Extract Author : kelly Create Date : 2018:12:03 13:25:59+08:00 Modify Date : 2018:12:03 13:28:03+08:00 Language : zh-CN XMP Toolkit : Adobe XMP Core 4.2.1-c041 52.342996, 2008/05/07-20:48:00 Producer : Microsoft® Word 2016 Format : application/pdf Creator : kelly Creator Tool : Microsoft® Word 2016 Metadata Date : 2018:12:03 13:28:03+08:00 Document ID : uuid:B121AE34-E631-45DC-8F71-9D4FFA7E23B4 Instance ID : uuid:b0af602d-8f87-430d-acdd-3d384f68baa7 Page Mode : UseOutlines Page Count : 15EXIF Metadata provided by EXIF.tools