4、心跳与系统状态：HEARTBEAT消息解析

各位同学，欢迎来到第四章。今天咱们聊聊MAVLink里最基础、也最容易被忽视的一个消息——HEARTBEAT。

你想想看，无人机在天上飞，地面站怎么知道它还活着？怎么知道它现在是“准备起飞”还是“已经炸机”？答案就是心跳包。说白了，HEARTBEAT就是无人机和地面站之间的“你还活着吗？”和“我还活着”的对话。

我个人习惯把HEARTBEAT比作人的脉搏。没有脉搏，人就没救了；没有心跳包，地面站就该报警了。我在项目中遇到过好几次，因为心跳超时导致地面站误判，结果触发了紧急降落。嗯，那次教训挺深刻的。

4.1 HEARTBEAT消息结构

HEARTBEAT是MAVLink协议中唯一必须周期性发送的消息。它的消息ID是0，优先级最高。每个MAVLink系统，无论是飞控、地面站还是摄像头，都必须发送心跳包。

它的核心字段如下：

字段名	类型	说明
`type`	uint8_t	系统类型（飞控、地面站、相机等）
`autopilot`	uint8_t	自驾仪类型（PX4、ArduPilot等）
`base_mode`	uint8_t	系统基础状态（位掩码）
`custom_mode`	uint32_t	自定义模式（由自驾仪定义）
`system_status`	uint8_t	系统状态（初始化、待命、激活等）
`mavlink_version`	uint8_t	MAVLink协议版本（固定为3）

这里我要特别强调一下base_mode字段。它是一个位掩码，每个bit代表一个状态。比如bit 0表示是否已解锁（ARMED），bit 1表示是否在手动控制模式。我曾经见过一个新手，直接拿base_mode的整数值去判断模式，结果踩了坑。正确的做法是按位与（bitwise AND）来检查。

关键点：HEARTBEAT的发送频率通常是1Hz（每秒一次）。如果连续3次没收到心跳包，地面站就应该认为通信中断了。

4.2 系统状态（SYSTEM_STATUS）

system_status字段告诉你无人机当前处于什么阶段。它不像base_mode那样是位掩码，而是一个枚举值。常用的状态有：

MAV_STATE_UNINIT (0)：未初始化，刚上电
MAV_STATE_BOOT (1)：正在启动
MAV_STATE_CALIBRATING (2)：正在校准传感器
MAV_STATE_STANDBY (3)：待命，已就绪但未解锁
MAV_STATE_ACTIVE (4)：激活，正在飞行或执行任务
MAV_STATE_CRITICAL (5)：严重故障，比如电池电压过低
MAV_STATE_EMERGENCY (6)：紧急状态，比如触发了降落
MAV_STATE_POWEROFF (7)：正在关机

你可能会问：“为什么需要这么多状态？” 我举个例子。有一次我在测试一架新组装的四轴，地面站一直显示“STANDBY”，但飞控明明已经解锁了。后来发现是system_status没有正确更新，导致地面站认为飞机还在待命状态，拒绝发送航点任务。嗯，这种问题排查起来很头疼。

小技巧：在调试时，可以写一个简单的脚本，持续打印HEARTBEAT中的system_status变化。这样能快速定位是飞控状态机出了问题，还是通信链路有问题。

4.3 自定义模式与标准模式

这里有个容易混淆的地方。base_mode是标准模式，由MAVLink协议统一定义。而custom_mode是自定义模式，由具体的自驾仪（比如PX4或ArduPilot）自己定义。

举个例子：

标准模式（base_mode）：MAV_MODE_FLAG_MANUAL_INPUT_ENABLED（手动控制）、MAV_MODE_FLAG_STABILIZE_ENABLED（增稳）、MAV_MODE_FLAG_GUIDED_ENABLED（引导模式）等。这些是所有MAVLink系统都通用的。
自定义模式（custom_mode）：在PX4中，可能代表“定高模式”、“悬停模式”、“返航模式”等。在ArduPilot中，可能代表“Loiter”、“RTL”、“Auto”等。

我个人习惯的做法是：先检查base_mode，确认系统是否在引导模式（GUIDED）下。如果是，再读取custom_mode来获取更详细的飞行模式。这样既保证了兼容性，又能获取足够的信息。

注意：不同自驾仪对custom_mode的编码方式不同。PX4使用一个32位整数，每个bit代表一个模式组合。ArduPilot则使用简单的枚举值。如果你要开发跨平台的地面站，一定要查阅对应自驾仪的文档，否则解析出来的模式可能是错的。

4.4 知识体系图

下面这张图展示了HEARTBEAT消息在整个MAVLink通信中的位置，以及它如何连接系统状态和模式管理。

4.5 实战：解析HEARTBEAT

说了这么多理论，咱们来点实际的。下面是一个简单的Python代码片段，演示如何解析HEARTBEAT消息：

import pymavlink.mavutil as mavutil

# 连接到飞控（假设串口是 /dev/ttyUSB0，波特率 115200）
master = mavutil.mavlink_connection('/dev/ttyUSB0', baud=115200)

# 等待第一个HEARTBEAT
master.wait_heartbeat()
print("收到心跳包！")

# 获取系统状态
msg = master.recv_match(type='HEARTBEAT', blocking=True)
if msg:
    # 解析base_mode
    base_mode = msg.base_mode
    is_armed = base_mode & mavutil.mavlink.MAV_MODE_FLAG_SAFETY_ARMED
    is_guided = base_mode & mavutil.mavlink.MAV_MODE_FLAG_GUIDED_ENABLED
    
    print(f"系统类型: {msg.type}")
    print(f"系统状态: {msg.system_status}")
    print(f"已解锁: {bool(is_armed)}")
    print(f"引导模式: {bool(is_guided)}")
    print(f"自定义模式: {msg.custom_mode}")

这段代码很简单，但很实用。我在做地面站开发时，经常用这个片段来验证飞控是否正常工作。如果连心跳包都收不到，那后面的航点任务就无从谈起了。

避坑指南：我曾经遇到过一个问题：飞控明明在发送心跳包，但地面站就是收不到。后来发现是串口的波特率设置错了。MAVLink的默认波特率是57600或115200，但有些飞控可能用921600。所以，如果收不到心跳包，先检查波特率。

4.6 总结

这一章我们深入剖析了HEARTBEAT消息。它虽然只有8个字节，但承载了系统类型、状态和模式三大核心信息。理解HEARTBEAT，是理解MAVLink通信的第一步。

记住：没有心跳，就没有通信。没有通信，航点任务就是空中楼阁。

📚 课程目录

4、心跳与系统状态：HEARTBEAT消息解析

4.1 HEARTBEAT消息结构

4.2 系统状态（SYSTEM_STATUS）

4.3 自定义模式与标准模式

4.4 知识体系图

4.5 实战：解析HEARTBEAT

4.6 总结