ROS2 Humble中如何在rqt生成参数下拉菜单？

核心原理 #

ROS2的rqt_reconfigure支持基于参数描述符（ParameterDescriptor）的枚举下拉菜单，需要在参数声明时明确指定可选枚举值，并确保参数类型与枚举值类型一致。

Python实现示例 #

1. 在节点中声明参数时，创建ParameterDescriptor并设置enum_values：

from rcl_interfaces.msg import ParameterDescriptor
from rclpy.node import Node

class MyNode(Node):
    def __init__(self):
        super().__init__("my_node")
        
        # 整数类型枚举示例
        int_descriptor = ParameterDescriptor(
            description="选择工作模式",
            enum_values=[
                rcl_interfaces.msg.ParameterValue(integer_value=0),
                rcl_interfaces.msg.ParameterValue(integer_value=1),
                rcl_interfaces.msg.ParameterValue(integer_value=2)
            ]
        )
        self.declare_parameter("work_mode", 0, descriptor=int_descriptor)
        
        # 字符串类型枚举示例
        str_descriptor = ParameterDescriptor(
            description="选择输出格式",
            enum_values=[
                rcl_interfaces.msg.ParameterValue(string_value="json"),
                rcl_interfaces.msg.ParameterValue(string_value="xml"),
                rcl_interfaces.msg.ParameterValue(string_value="txt")
            ]
        )
        self.declare_parameter("output_format", "json", descriptor=str_descriptor)

2. 启动节点后，打开rqt_reconfigure，找到对应节点的参数即可看到下拉菜单。

C++实现示例 #

#include "rclcpp/rclcpp.hpp"
#include "rcl_interfaces/msg/parameter_descriptor.hpp"
#include "rcl_interfaces/msg/parameter_value.hpp"

class MyNode : public rclcpp::Node
{
public:
    MyNode() : Node("my_node")
    {
        // 整数枚举参数
        rcl_interfaces::msg::ParameterDescriptor int_desc;
        int_desc.description = "选择工作模式";
        rcl_interfaces::msg::ParameterValue val0, val1, val2;
        val0.integer_value = 0;
        val1.integer_value = 1;
        val2.integer_value = 2;
        int_desc.enum_values = {val0, val1, val2};
        this->declare_parameter("work_mode", 0, int_desc);
        
        // 字符串枚举参数
        rcl_interfaces::msg::ParameterDescriptor str_desc;
        str_desc.description = "选择输出格式";
        rcl_interfaces::msg::ParameterValue json_val, xml_val, txt_val;
        json_val.string_value = "json";
        xml_val.string_value = "xml";
        txt_val.string_value = "txt";
        str_desc.enum_values = {json_val, xml_val, txt_val};
        this->declare_parameter("output_format", "json", str_desc);
    }
};

int main(int argc, char ** argv)
{
    rclcpp::init(argc, argv);
    rclcpp::spin(std::make_shared<MyNode>());
    rclcpp::shutdown();
    return 0;
}

常见问题解决 #

• 为什么之前用Parameter Descriptor只出现拖动条？
  大概率是参数类型为浮点/整数但未设置枚举，而是设置了integer_range/floating_point_range，此时rqt会生成拖动条。只要正确设置enum_values，就会切换为下拉菜单。
• 为什么YAML设置数组后参数消失？
  ROS2的参数枚举不能通过YAML直接设置为数组，YAML仅用于设置参数的初始值，枚举约束必须在节点代码中通过ParameterDescriptor声明。

注意事项 #

• 确保使用的ROS2版本为Humble及以上，早期版本（如Foxy）的rqt_reconfigure对枚举的支持不完善。
• 枚举值的类型必须与参数的类型完全匹配（整数对应整数枚举，字符串对应字符串枚举）。

内容的提问来源于stack exchange，提问作者Bryan Liu