4. MAVLink心跳与系统状态：HEARTBEAT消息解析、系统状态监控

各位同学，今天我们来聊聊MAVLink里最基础、也最重要的消息——HEARTBEAT。

你想想看，无人机在天上飞，地面站怎么知道它还活着？飞控有没有死机？GPS有没有丢星？这些信息，全靠心跳消息来传递。说白了，HEARTBEAT就是无人机和地面站之间的“保活信号”，同时它还携带了系统状态的关键信息。

我个人习惯，在调试任何无人机系统时，第一件事就是看心跳。心跳不正常，后面所有数据都不用看了。今天我就把HEARTBEAT消息的每个字节掰开揉碎讲清楚，再教你如何搭建一个系统状态监控器。

4.1 HEARTBEAT消息结构

HEARTBEAT是MAVLink协议中消息ID为0的消息。为什么是0？因为它是优先级最高的消息，任何设备都必须支持。

它的载荷部分固定为9个字节，结构如下：

嗯，这里要注意：custom_mode占4个字节，不同自驾仪对它解释不同。PX4和ArduPilot的自定义模式编码方式完全不一样，后面我们会专门讲。

4.2 关键字段深度解析

4.2.1 type：系统类型

这个字段告诉接收方“我是什么设备”。常见值有：

• MAV_TYPE_GENERIC (0)：通用类型
• MAV_TYPE_QUADROTOR (2)：四旋翼
• MAV_TYPE_HEXAROTOR (13)：六旋翼
• MAV_TYPE_OCTOROTOR (14)：八旋翼
• MAV_TYPE_GCS (6)：地面站
• MAV_TYPE_ANTENNA_TRACKER (5)：天线跟踪器

我在项目中遇到过一个问题：地面站同时连接了飞控和相机，结果相机也发了HEARTBEAT，type填的是MAV_TYPE_CAMERA。地面站没做类型过滤，把相机当成了飞控，导致模式切换指令发错了对象。所以，接收端一定要根据type字段做分发。

4.2.2 base_mode：基础模式位掩码

这个字段用位掩码表示系统当前的基础状态。每个bit代表一个开关量：

举个例子，如果base_mode = 0b10000001，表示系统处于自定义模式且已解锁。你想想看，这个字段是不是很直观？

4.2.3 system_status：系统状态

这个字段表示系统当前的健康状况。常见值：

• 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)：正在关机

我曾经遇到过一架无人机，飞着飞着突然system_status变成了MAV_STATE_CRITICAL，但飞控没有报任何错误。后来发现是电压检测模块虚焊，导致飞控误判电池电压过低。所以，system_status只是飞控的“主观判断”，不一定反映真实硬件状态，需要结合其他消息综合判断。

4.3 心跳发送频率与超时机制

MAVLink规范建议HEARTBEAT的发送频率为1Hz（每秒1次）。但实际项目中，我见过飞控用2Hz甚至5Hz发心跳的。频率越高，地面站响应越快，但总线负载也越大。

地面站通常设置3~5秒超时。如果超过这个时间没收到心跳，就认为链路中断。我建议你设置超时时间为心跳间隔的3倍。比如心跳1Hz，超时设3秒；心跳2Hz，超时设5秒（留点余量）。

4.4 系统状态监控实战

光说不练假把式。下面我写一个简单的Python脚本，用pymavlink库监听HEARTBEAT并解析状态：

#!/usr/bin/env python3
"""
MAVLink心跳监控器
监听HEARTBEAT消息，实时显示系统状态
"""

import time
from pymavlink import mavutil

# 连接飞控（串口或UDP）
# 串口示例：/dev/ttyUSB0, 115200
# UDP示例：udp:127.0.0.1:14550
connection = mavutil.mavlink_connection('udp:127.0.0.1:14550')

print("等待心跳...")

# 等待第一个心跳
heartbeat = connection.wait_heartbeat(timeout=5)
if heartbeat is None:
    print("超时：未收到心跳")
    exit(1)

print(f"收到心跳！")
print(f"  系统类型: {heartbeat.type}")
print(f"  自驾仪类型: {heartbeat.autopilot}")
print(f"  基础模式: 0x{heartbeat.base_mode:02x}")
print(f"  自定义模式: {heartbeat.custom_mode}")
print(f"  系统状态: {heartbeat.system_status}")
print(f"  MAVLink版本: {heartbeat.mavlink_version}")

# 持续监控
last_heartbeat_time = time.time()
timeout_seconds = 5

while True:
    msg = connection.recv_match(type='HEARTBEAT', blocking=True, timeout=1)
    if msg:
        last_heartbeat_time = time.time()
        armed = (msg.base_mode & mavutil.mavlink.MAV_MODE_FLAG_SAFETY_ARMED) != 0
        status_str = ["未初始化", "启动中", "校准中", "待机", "激活", "紧急", "紧急情况", "关机中"]
        status = status_str[msg.system_status] if msg.system_status < len(status_str) else "未知"
        print(f"[{time.strftime('%H:%M:%S')}] 状态={status} 解锁={'是' if armed else '否'} 模式={msg.custom_mode}")
    else:
        elapsed = time.time() - last_heartbeat_time
        if elapsed > timeout_seconds:
            print(f"心跳超时！已{elapsed:.1f}秒未收到心跳")
            break

这个脚本很简单，但很实用。我每次调试新飞控，都会先跑这个脚本确认心跳正常，再去做其他操作。

4.5 知识体系总览

为了让你更直观地理解本章的知识结构，我画了一张图：

4.6 常见问题与排查思路

最后，我总结几个实际项目中经常遇到的问题，供你参考：

嗯，今天就讲到这里。HEARTBEAT虽然简单，但它是整个MAVLink通信的基石。你把这个搞透了，后面学其他消息就会轻松很多。