简介：这份参考手册面向嵌入式开发工程师、电子竞赛选手及高校学生，针对GPS/北斗双模定位模块的硬件接入与数据解析需求，系统讲解正点原子ATK-MO1218模块的使用方法。资源包共1个PDF文件，约1.47MB，内容涵盖模块特性参数、引脚定义、SkyTraq binary与NMEA-0183两种协议说明、GNSS_Viewer软件配置（波特率、测量频率、PPS脉冲宽度）以及结构尺寸等章节，并附有冷启动、温启动、热启动的区分说明与电气参数表。读者可据此掌握模块与单片机的串口对接、参数配置保存及定位数据读取流程，理解双模定位在嵌入式系统中的集成要点。目前已有1275人学习下载，适合需要快速上手该模块或查阅协议细节的开发者参考。
1. 一块 25×27mm 的北斗双模模块，为什么值得先读手册再上电
手里拿到一块 ATK-1218-BD，多数人的第一反应是插上 USB 转 TTL，打开串口助手，看到一堆$GNGGA就以为通了。真正翻车往往发生在后面：想改波特率，发出去的十六进制命令模块毫无反应；想跑 10Hz 高频输出，数据开始丢帧；断电重启后配置全没了，又得重新配一遍。这些问题的答案，其实都写在这份《ATK-1218-BD 参考手册》里，只是它被当成“随箱附赠的 PDF”忽略了。
这块模块基于 S1216F8-BD 模组，167 通道，支持 GPS 与北斗双模，定位精度 2.5m CEP（SBAS 下 2.0m CEP），冷启动最快 29 秒、热启动 1 秒，追踪灵敏度 -165dBm，板载可充电后备电池能在主电源掉电后维持约半小时星历数据。对嵌入式从业者来说，它的价值不在参数表好看，而在于两件事：一是串口可配置且配置能存 Flash，二是同时给出 SkyTraq binary 和 NMEA-0183 两套协议，既能当“傻瓜输出”用，也能做深度控制。这份手册适合正在做车载终端、手持设备、时间同步节点，或者单纯想把 GNSS 模块吃透的嵌入式工程师。下面按“先看懂它怎么说话，再动手配，最后避开那几个必踩的坑”的顺序拆。
2. 先把两套协议分清楚：NMEA-0183 与 SkyTraq binary 各管什么
模块对外只有一组 UART，但上面跑着两种完全不同性格的协议。搞不清分工，就会出现“用文本命令去改配置”或者“用二进制帧去解析定位”的错位操作。手册第 2.2、2.3 节把这两套协议并列讲，实际使用中它们的角色是明确的：NMEA-0183 负责“报数”，SkyTraq binary 负责“下命令”。
2.1 NMEA-0183：ASCII 帧的字段结构与校验算法
NMEA-0183 用纯 ASCII 传帧，帧首$，地址段Aaccc（Aa是标识符，ccc是帧名），字段间逗号分隔，*后跟两位十六进制校验和，帧尾<CR><LF>。校验范围是$与*之间所有字节逐字节异或。模块支持三种标识符：GP只含 GPS 数据，BD只含北斗数据，GN是混合或其他数据。共 7 种语句：GGA、GLL、GSA、GSV、RMC、VTG、ZDA。
实际解析时最常打交道的是 GGA 和 RMC。GGA 给时间、经纬度、定位质量、卫星数、HDOP、海拔；RMC 给时间、日期、位置、地面速度（节）、航向。这里有个新手常忽略的点：GGA 的经纬度格式是ddmm.mmmm和dddmm.mmmm，不是十进制度，转的时候要度 + 分/60，而且南纬西经要看后面的N/S、E/W指示位。校验和算错不会报错，只会让你解析出乱码，所以第一件事是把校验逻辑写对。
def nmea_checksum_ok(sentence: str) -> bool: # sentence 形如 "$GNGGA,....*6A"，不含 CR/LF if not sentence.startswith('$') or '*' not in sentence: return False body, chk = sentence[1:].split('*') calc = 0 for ch in body: calc ^= ord(ch) # 逐字节异或 return f"{calc:02X}" == chk.upper() def parse_gga(sentence: str): # 字段顺序：$--GGA,hhmmss.ss,lat,N/S,lon,E/W,quality,numSV,HDOP,alt,M,... f = sentence.split(',') lat_raw, lat_dir = f[2], f[3] lon_raw, lon_dir = f[4], f[5] def to_deg(raw, direction): if not raw: return None dot = raw.index('.') deg = float(raw[:dot-2]) # 小数点前两位是“分” minute = float(raw[dot-2:]) val = deg + minute / 60.0 return -val if direction in ('S', 'W') else val return { 'utc': f[1], 'lat': to_deg(lat_raw, lat_dir), 'lon': to_deg(lon_raw, lon_dir), 'quality': int(f[6]) if f[6] else 0, # 0 未定位，1 SPS，2 差分 'sats': int(f[7]) if f[7] else 0, 'hdop': float(f[8]) if f[8] else None, }上面两个函数是解析链的地基。nmea_checksum_ok里body取的是$之后、*之前，正好对应手册说的校验范围；parse_gga里raw[:dot-2]和raw[dot-2:]的切法依赖“度部分位数不固定、分部分固定两位整数”这一格式约定，纬度是 2 位度、经度是 3 位度，所以用小数点位置反推比硬编码下标更稳。quality字段一定要判，值为 0 时经纬度是空的或无效的，直接拿去算距离会得到离谱结果。
2.2 SkyTraq binary：帧格式、主从关系与 ACK 机制
配置类操作走 SkyTraq binary。帧结构五段：帧首固定0xA0 0xA1；2 字节 payload 长度；payload（首字节是消息 ID，部分消息 ID 后面还有子 ID）；1 字节校验，范围是整个 payload，逐字节异或；帧尾固定0x0D 0x0A。
手册特别强调了一条主从规则：模块是从机，不会主动发帧，只有主机能主动发；从机收到主机帧后，无论什么情况都必须先回 ACK（成功）或 NACK（失败）。这条规则决定了你的发送逻辑必须是“发一帧、等一帧应答”，不能连续猛发。很多人改波特率失败，就是因为发完配置帧没等 ACK 就切了波特率，模块还在按旧波特率回 ACK，两边错位。
def build_skytraq_frame(msg_id: int, payload: bytes) -> bytes: # payload 不含 msg_id，函数内部拼进去 body = bytes([msg_id]) + payload length = len(body).to_bytes(2, 'big') # 长度字段 2 字节，大端 chk = 0 for b in body: chk ^= b # 校验只覆盖 payload return b'\xA0\xA1' + length + body + bytes([chk]) + b'\x0D\x0A' def wait_ack(ser, timeout=1.0): # 读一帧，判断是 ACK(0x83) 还是 NACK(0x84) import time start = time.time() buf = b'' while time.time() - start < timeout: buf += ser.read(ser.in_waiting or 1) if b'\xA0\xA1' in buf and b'\x0D\x0A' in buf: idx = buf.index(b'\xA0\xA1') frame = buf[idx:] end = frame.index(b'\x0D\x0A') frame = frame[:end+2] msg_id = frame[4] # 帧首2 + 长度2 之后是消息ID return msg_id == 0x83 # 0x83 ACK, 0x84 NACK return Nonebuild_skytraq_frame里长度字段用大端，是因为手册帧格式图里高字节在前；校验只算 payload 不算帧首帧尾，这点和 NMEA 的校验范围逻辑一致但对象不同，别混。wait_ack里frame[4]的下标推导是：帧首 2 字节 + 长度 2 字节 = 4，第 5 个字节才是消息 ID。实际项目里我一般会把超时设成 1 秒并重试两次，因为模块刚上电或刚切频率时偶发不应答，一次失败就判定“模块坏了”是血泪教训。
2.3 两套协议怎么配合：一条数据链的完整走向
正常工作时，模块按设定频率主动吐 NMEA 语句，你的 MCU 只管收和解析；需要改配置时，MCU 切到 binary 模式发命令、收 ACK，改完继续收 NMEA。注意改波特率这类操作会改变链路本身，顺序必须是：发配置帧 → 等 ACK（此时还在旧波特率）→ 双方切新波特率 → 再验证能否收到 NMEA。手册 2.4.1 节演示把 38400 改 9600 并存 Flash，GNSS_Viewer 会自动跟着切，自己写代码就得手动处理这个切换窗口。
3. 上电到出数：接线、串口参数与 GNSS_Viewer 实操
协议看懂只是纸面功夫，真正让模块出数，靠的是接线正确、串口参数匹配、软件配置到位。这一章按“硬件连接 → 串口通信 → 软件配置”的顺序走，每一步都给可对照的参数。
3.1 五针接线与电平边界：TTL 不是 RS232
模块 5 个 2.54mm 排针：1 脚 VCC（3.3V~5V）、2 脚 GND、3 脚 TXD、4 脚 RXD、5 脚 PPS。TXD/RXD 是 TTL 电平，手册用感叹号强调“不能直接接 RS232 电平”。这句话不是客套，RS232 的 ±12V 直接灌进 TTL 引脚，模块当场报废。接单片机时 TXD 接 MCU 的 RXD、RXD 接 MCU 的 TXD，交叉接；接 PC 必须经 USB 转 TTL，且转换板电平要选 3.3V 档（模块 IO 兼容 3.3V/5V，但转换板若输出 5V TTL 一般也能识别，稳妥起见按 3.3V 走）。
PPS 引脚同时连着板载 LED，默认两种状态：常亮表示已上电工作但未定位；闪烁（100ms 灭、900ms 亮）表示已成功定位。这个 LED 是最省事的“定位状态指示器”，调试阶段先看灯再看串口，能少走很多弯路。天线走板载 IPX 接口，外接有源天线一般用 SMA 头，需要一根 IPX 转 SMA 的转接线；天线务必放室外或窗边，室内无源环境下等再久也定不了位。
| 引脚 | 名称 | 连接对象 | 注意 |
|---|---|---|---|
| 1 | VCC | 3.3V~5V 电源 | 与 MCU 共地 |
| 2 | GND | 电源地 | 必接，否则通信异常 |
| 3 | TXD | MCU RXD / USB-TTL RX | TTL 电平，禁接 RS232 |
| 4 | RXD | MCU TXD / USB-TTL TX | TTL 电平，禁接 RS232 |
| 5 | PPS | 可选，接 MCU 外部中断 | 默认 1Hz，宽度可配 |
3.2 串口参数：38400-8-N-1 与波特率档位
出厂默认 38400bps、8 位数据位、1 位停止位、无奇偶校验。手册列出的可选档位是 4800、9600、19200、38400、57600、115200、230400（原文有一处写成 7600，按上下文应为 57600，配置时以软件下拉框实际值为准）。这里有个硬约束必须记住：测量频率 4Hz~10Hz 时，波特率不低于 38400；20Hz 时不低于 115200。也就是说高频输出和低波特率不可兼得，想跑 20Hz 却还停在 9600，必然丢帧。
用 Python 快速验证链路是否通，比开图形软件更快：
import serial # 打开串口，参数与模块出厂默认一致 ser = serial.Serial( port='COM3', # Linux 下形如 /dev/ttyUSB0 baudrate=38400, # 出厂默认，改过就填改后的值 bytesize=8, parity='N', stopbits=1, timeout=1 ) # 连续读 5 行，确认能收到 NMEA 语句 for _ in range(5): line = ser.readline().decode('ascii', errors='ignore').strip() if line.startswith('$'): print(line) ser.close()timeout=1防止 readline 永久阻塞；errors='ignore'是因为上电瞬间可能读到半帧乱码，直接丢弃比抛异常省事。如果 5 行里一条$开头都没有，先查三件事：TX/RX 是否交叉、波特率是否被改过、天线是否接好（没天线也能出部分语句，但 GGA 的 quality 会是 0）。这一步通了，再上 GNSS_Viewer。
3.3 GNSS_Viewer 三项配置：波特率、测量频率、PPS 宽度
GNSS_Viewer 是配套评估软件，主界面选 Com Port 和 Baudrate，点 Close 打开连接（按钮文字是 Close 但作用是打开，别被字面误导）。连上后能看到卫星编号、信号强度、经纬度。三项常用配置都在菜单栏：
改波特率走 Binary → Configure Serial Port，选目标值点 Set，软件会自动把自身波特率也切过去，且配置存 Flash 断电不丢。改测量频率走 Binary → Configure Position Update Rate，选 20Hz 点 Accept，软件会自动把波特率提到 115200 以匹配。改 PPS 宽度走 1PPS Timing → Configure 1PPS Pulse Width，范围 1 微秒~100 毫秒，默认 100 毫秒，设成 50 毫秒后 LED 变成 50ms 灭、950ms 亮，用示波器或逻辑分析仪抓 PPS 引脚能直接验证。
提示：三项配置都会写 Flash，改之前想清楚目标值。尤其是波特率，改完忘了新值，下次上电按旧值连不上，会误以为模块坏了。
4. 避坑与排查：五个让新手卡半天的真实问题
手册给的是“正确路径”，实际调试里翻车点集中在协议细节和时序上。下面五条按“现象 → 原因 → 解决”写，都是这块模块上高频出现的。
现象一：发配置命令后模块毫无反应，串口只看到 NMEA 在刷。原因：配置帧格式错，最常见是长度字段用了小端、校验算了帧首帧尾、或者帧尾写成0x0A 0x0D。解决：拿逻辑分析仪抓自己发的字节，逐段对照A0 A1 | lenH lenL | msgID+payload | chk | 0D 0A，校验只对 payload 异或。先用一条最简单的查询类命令验证帧构造对不对，再发配置类。
现象二：改完波特率，模块“失联”。原因：发完配置帧没等 ACK 就切了本地波特率，或者 ACK 还没读完就关了串口重开。解决：严格按“发帧 → 旧波特率等 ACK → 切新波特率 → 读 NMEA 验证”的顺序，ACK 超时给 1 秒并重试。改之前把新波特率记在代码常量里，别靠记忆。
现象三：设了 10Hz 或 20Hz，数据开始丢帧、解析出错。原因：波特率不够。10Hz 要求不低于 38400，20Hz 要求不低于 115200，这是手册明写的约束。解决：先提波特率再提频率，顺序反了中间那段就是丢帧状态。另外 MCU 侧接收缓冲要够大，20Hz 下每秒数据量明显上升，用中断逐字节收比轮询稳。
现象四：GGA 解析出来经纬度是 0 或者乱跳。原因：没判quality字段，值为 0（未定位）时经纬度无效；或者经纬度没做度+分/60转换，直接把ddmm.mmmm当十进制度用。解决：解析前先判 quality ≥ 1，转换按小数点位置切分，南纬西经取负。冷启动最快 29 秒，刚上电那几十秒 quality 为 0 是正常的，别急着怀疑代码。
现象五：断电重启后配置回到出厂值。原因：配置命令没带“保存到 Flash”的语义，或者只改了 RAM 没触发存储。解决：SkyTraq binary 的配置消息通常有对应的保存动作，GNSS_Viewer 里点 Set/Accept 时已隐含保存；自己写代码要确认发的消息 ID 是“配置并保存”那条，改完断电重启验证一次，别只测热重启。
5. 进阶：用 PPS 做时间同步，以及一套可复用的验证习惯
模块真正拉开差距的地方是 PPS。定位成功后 PPS 引脚输出固定 1Hz 脉冲，高电平宽度可在 1 微秒~100 毫秒间配，默认 100 毫秒。做时间同步节点时，PPS 的上升沿就是秒边界，配合 GGA/RMC 里的 UTC 时间，能把本地时钟对齐到秒级以内。常见做法是 PPS 接 MCU 外部中断，上升沿触发时锁存本地计时器，同时用最近一帧 RMC 的 UTC 时间做绝对时间基准，两者结合消除串口传输延迟。
验证 PPS 是否真的在输出，别只信 LED。LED 闪烁只能说明“已定位”，脉冲宽度改没改对得看波形。没有示波器时，可以用 MCU 输入捕获测高电平持续时间，或者用一个简单办法：把 PPS 接到另一个串口的 CTS 引脚，用串口工具的引脚状态指示观察占空比变化。改宽度前后各测一次，50 毫秒和 100 毫秒的差别在占空比上是能看出来的。
| 验证项 | 方法 | 合格标准 |
|---|---|---|
| 链路通 | 串口读 5 行 | 至少 1 行$开头 |
| 定位有效 | 解析 GGA quality | ≥ 1，且卫星数 > 0 |
| 配置持久 | 改波特率后断电重启 | 新波特率仍生效 |
| 频率达标 | 统计 1 秒内 RMC 条数 | 与设定频率一致 |
| PPS 正确 | 输入捕获测高电平 | 与设定宽度误差在微秒级 |
我自己的习惯是：任何一块新 GNSS 模块上手，先不写业务代码，而是跑一个“最小验证脚本”——读 NMEA 判校验、发一条查询命令等 ACK、改一次波特率再断电重启、抓一次 PPS 宽度。这四步走完，模块的脾气就摸清了，后面接业务逻辑基本不会再出玄学问题。从那以后我每次拿到新模块都强制走一遍这套流程，省下的返工时间远比写脚本的时间多。希望帮到你。
本文还有配套的精品资源，点击获取
