保姆级教程：全志A133 Android 10.0平台GPS模块移植实战（以WT-11-AK为例）
全志A133 Android 10.0平台GPS模块移植深度实战指南
第一次在全志A133平台上折腾GPS模块时，我盯着开发板上那个小小的WT-11-AK模块发了半天呆。作为嵌入式开发的老兵，我深知GPS移植这种工作看似简单，实则暗藏玄机——从HAL层配置到串口调试，每一步都可能成为拦路虎。本文将用最接地气的方式，带你完整走通这个流程。
1. 环境准备与基础概念
在开始动手前，我们需要先理清几个关键点。全志A133采用的是Cortex-A53架构，运行Android 10系统时，GPS功能需要通过HIDL接口与硬件交互。WT-11-AK是一款支持北斗/GPS双模的定位模块，默认通信波特率为9600bps。
必备工具清单：
- 全志A133开发板（建议使用官方EVB板）
- WT-11-AK GPS模块及配套天线
- USB转TTL调试器（用于串口监控）
- Android 10.0 SDK（全志提供定制版本）
- GpsTest1.5.4.apk（测试工具）
注意：不同批次的WT-11-AK模块可能有固件差异，建议先通过GNSSToolKit_Lite.exe工具确认模块基础功能正常。
开发环境配置建议使用Ubuntu 18.04 LTS，内存至少16GB。全志提供的编译工具链需要以下额外依赖：
sudo apt-get install git-core gnupg flex bison gperf build-essential \ zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \ lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev ccache \ libgl1-mesa-dev libxml2-utils xsltproc unzip2. 系统层配置修改
2.1 修改设备配置文件
首先找到设备专属的mk文件（如ceres_c3.mk），添加GPS相关模块声明。这个步骤决定了系统是否会包含GPS功能组件。
# 在PRODUCT_PACKAGES段添加 PRODUCT_PACKAGES += \ gps.ceres \ android.hardware.gnss@1.0-impl \ android.hardware.gnss@1.0-service同时需要确保HAL服务在系统启动时被加载，修改manifest.xml文件：
<hal format="hidl"> <name>android.hardware.gnss</name> <transport>hwbinder</transport> <version>1.0</version> <interface> <name>IGnss</name> <instance>default</instance> </interface> </hal>2.2 HAL层实现准备
GPS的硬件抽象层是关键所在。我们需要准备gnsshal库，建议将其放在external/目录下。典型的HAL实现包含以下文件结构：
gnsshal/ ├── Android.bp ├── gps_zkw.c └── include/ └── gps.h其中gps_zkw.c是核心实现文件，需要特别注意串口配置：
#define GPS_CHANNEL_NAME "/dev/ttyS3" // 根据实际硬件连接修改 #define GPS_BAUD_RATE B9600 // 默认波特率提示：全志A133的串口设备命名规则为ttyS0~ttyS7，具体对应关系需参考原理图。
3. 硬件连接与调试
3.1 物理连接指南
WT-11-AK模块通常通过4线制与开发板连接：
| 引脚名称 | 开发板对应引脚 | 说明 |
|---|---|---|
| VCC | 3.3V | 电源输入 |
| GND | GND | 地线 |
| TXD | UART3_RX | 数据发送（模块→CPU） |
| RXD | UART3_TX | 数据接收（CPU→模块） |
常见问题排查：
- 无电源：测量模块VCC脚电压应为3.3V±5%
- 无数据：交换TX/RX线序尝试
- 信号弱：确保天线已正确连接且未被金属屏蔽
3.2 串口调试技巧
在系统启动前，可以通过USB转TTL工具直接监控GPS原始数据：
screen /dev/ttyUSB0 9600正常工作的WT-11-AK模块会持续输出NMEA格式数据，类似：
$GPGGA,082559.00,4005.22599,N,11632.58234,E,1,08,1.01,62.5,M,-5.6,M,,*6B $GPRMC,082559.00,A,4005.22599,N,11632.58234,E,0.52,218.82,270123,,,A*7D如果看不到数据，可以尝试发送复位指令：
# 使用miniterm发送复位命令 python -m serial.tools.miniterm --eol CRLF /dev/ttyUSB0 9600 > $PCAS01,1*1D<CR><LF>4. 系统集成与测试
4.1 编译与烧写
完成代码修改后，执行全志平台的编译命令：
source build/envsetup.sh lunch ceres_c3-eng make -j8编译成功后，使用PhoenixSuit工具烧写系统镜像。特别注意要选择"强制擦除所有"选项，确保GPS相关服务能正确初始化。
4.2 功能验证
烧写完成后，可以通过多种方式验证GPS功能：
方法一：使用logcat监控
adb logcat | grep -i gps正常应该能看到类似输出：
D/GnssHAL: GPS module initialized I/GnssLocationProvider: GPS status update: 3方法二：使用测试APK将GpsTest1.5.4.apk安装到设备后，观察以下指标：
- 卫星锁定数量（建议在开阔地带测试）
- 定位精度（理想情况下应<5米）
- 首次定位时间（TTFF）
性能优化参数：
# 在gps.conf中添加 NTP_SERVER=pool.ntp.org SUPL_HOST=supl.google.com SUPL_PORT=72755. 进阶调试与优化
5.1 信号质量优化
GPS性能很大程度上取决于天线选择和摆放位置。建议：
- 使用有源天线时确保供电正常
- 天线应远离高速数字电路（如DDR内存）
- 在PCB设计阶段保留π型匹配电路
实测数据对比：
| 天线类型 | 平均锁定卫星数 | 定位误差 | 适用场景 |
|---|---|---|---|
| 陶瓷贴片 | 8-10 | 5-10米 | 室内/车载 |
| 外接有源 | 12-15 | 2-5米 | 无人机/高精度需求 |
5.2 低功耗配置
对于电池供电设备，可以修改HAL层实现：
// 在gps_zkw.c中添加 static void set_low_power_mode() { send_at_command("$PCAS10,1*1C"); // 1Hz定位频率 send_at_command("$PCAS11,5*1E"); // 低功耗模式 }5.3 多模定位配置
WT-11-AK支持GPS/北斗/GLONASS多系统，通过AT命令切换：
echo -e "$PCAS04,1,1,1,0,0*2A\r\n" > /dev/ttyS3各系统性能对比：
- GPS：成熟稳定，北美地区信号好
- 北斗：亚太地区卫星数量多
- GLONASS：高纬度地区表现优异
6. 常见问题解决方案
问题一：GPS服务无法启动检查步骤：
- 确认hal.mk中GNSS服务已添加
- 检查selinux策略是否阻止服务运行
- 查看/vendor/etc/init/下是否有gnss-service.rc
问题二：能搜星但无法定位可能原因：
- NTP服务器未同步
- SUPL配置错误
- 天线阻抗不匹配
问题三：定位漂移严重解决方法：
- 检查天线周围是否有干扰源
- 更新AGPS数据
- 尝试关闭多径抑制功能
最后分享一个实用技巧：在全志平台上，可以通过sysfs动态调整串口波特率而不用重新编译内核：
echo 115200 > /sys/class/tty/ttyS3/baudrate记得在完成调试后改回默认值。GPS移植看似复杂，但只要掌握了硬件连接、HAL配置和调试技巧这三个关键点，就能应对大多数场景。