)
OpenMower配置大全mower_config环境变量逐项详解(含NTRIP/RTK关键参数)【免费下载链接】open_mower_ros项目地址: https://gitcode.com/gh_mirrors/op/open_mower_rosOpenMower 是一个开源的 DIY 智能割草机器人项目它把普通的 YardForce 割草机改造为具备 RTK GPS 厘米级定位、自主割草与自动回充能力的机器人。而这一切的灵魂都藏在 mower_config 环境变量配置文件里。本文将逐项详解config/mower_config.sh.example中的全部关键参数并重点拆解 NTRIP/RTK 差分定位的配置方法让你从零开始也能完成 OpenMower 配置。一、mower_config 配置文件在哪里OpenMower 的核心配置位于项目根目录的config/mower_config.sh.example这是一份带详尽注释的 shell 环境变量模板。使用时将它复制为mower_config.sh并修改即可cp config/mower_config.sh.example mower_config.sh 两点提醒项目还提供了一份 JSON 版的参数说明config/mower_config.schema.json如果你想新增自定义变量需要同步维护两份文件。官方正在规划用可视化 UI 取代这个配置文件未来配置方式会更友好但现阶段读懂环境变量仍是 OpenMower 配置的必修课。二、必改的核心硬件环境变量新手先看这里打开配置文件文件头部就是Important Settings绝大多数情况下你只需要动这几个变量。它们决定了固件兼容性、机型物理参数和手柄映射。环境变量可选值说明OM_HARDWARE_VERSION0_13_X、0_12_X_LSM6DSO、0_11_X_WT901等主板的固件/IMU 芯片版本务必与你的硬件一致OM_MOWERYardForce500、YardForceSA650、Sabo、CUSTOM割草机机型自动套用天线位置、轮距等物理参数OM_MOWER_ESC_TYPExesc_mini、xesc_2040等电机驱动板类型STM32 版选 xesc_miniRP2040 版为实验特性OM_MOWER_GAMEPADps3、shield、xbox360等手柄型号用于手动遥控其中OM_MOWER对应的硬件参数存放在src/open_mower/params/hardware_specific/YardForce500/default_environment.sh这类机型脚本里例如天线偏移量OM_ANTENNA_OFFSET_X、轮距OM_WHEEL_DISTANCE_M、每米脉冲数OM_WHEEL_TICKS_PER_M等。选择CUSTOM机型时你需要把自己的参数放到~/mower_params/目录中。三、NTRIP/RTK 关键参数详解厘米级精度核心OpenMower 之所以能实现精准割草靠的是 RTK 差分定位通过 NTRIP 客户端从基站服务器获取 RTCM 差分数据让机载 GPS 达到厘米级精度。这一整组参数直接决定定位质量值得重点掌握。3.1 开启/关闭 NTRIP 差分export OM_USE_NTRIPTrueTrue通过 WiFi 从 NTRIP 服务器拉取差分数据推荐False使用插入 Ardusimple 板卡的外部电台接收差分信号。NTRIP 客户端节点由src/open_mower/launch/include/_ntrip_client.launch启动把 NMEA 上发给服务器、把 RTCM 下发给 GPS 模块。3.2 NTRIP 服务器连接参数账号配置环境变量示例含义OM_NTRIP_HOSTNAME192.168.178.55NTRIP 服务器地址或 IPOM_NTRIP_PORT2101NTRIP 服务端口Caster 常用 2101OM_NTRIP_USERgps账号用户名OM_NTRIP_PASSWORDgps账号密码OM_NTRIP_ENDPOINTBASE1挂载点Mount Point一般由服务器服务商提供这五项是连接 NTRIP 服务器的钥匙填错任何一个都会导致拿不到差分数据GPS 一直停留在米级精度。3.3 RTCM 超时与断线重连参数稳定性保障环境变量默认值含义OM_NTRIP_RTCM_TIMEOUT_SEC4.0等待 RTCM 数据超时时间秒超时即触发重连OM_NTRIP_ADAPTIVE_RECONNECTTrue开启自适应重连节奏控制OM_NTRIP_ADAPTIVE_BURST_MAX_ATTEMPTS12突发窗口内的最大重连次数OM_NTRIP_ADAPTIVE_BURST_WINDOW_SEC60.0突发限流窗口时长秒OM_NTRIP_ADAPTIVE_SLOW_AFTER_SEC300.0持续失败多久后进入慢速重连模式OM_NTRIP_ADAPTIVE_SLOW_INTERVAL_SEC300.0慢速模式下的重连间隔秒OM_NTRIP_RECONNECT_INITIAL_DELAY_SEC10.0指数退避的初始延迟秒OM_NTRIP_RECONNECT_MAX_DELAY_SEC300.0重连最大延迟秒OM_NTRIP_RECONNECT_BACKOFF_MULTIPLIER2.0退避倍数每次失败延迟翻倍OM_NTRIP_MAX_ATTEMPTS0最大重连次数0 表示无限重试调优建议如果家里 WiFi 不稳定、经常掉差分可适当调大OM_NTRIP_RTCM_TIMEOUT_SEC若 NTRIP 服务器对频繁连接有限制建议保持自适应重连开启避免被服务器封禁。四、GPS 定位参数地图原点与相对定位 ️定位参数决定坐标系怎么建立直接影响地图录制和后续导航。环境变量默认值含义OM_USE_RELATIVE_POSITIONFalseFalse用 DATUM 点作地图原点True以基站为原点推荐保持 False移动基站不用重录地图OM_DATUM_LAT/OM_DATUM_LONG需自行填写充电站附近的经纬度坐标作为地图原点OM_GPS_PROTOCOLUBXu-blox 芯片用 UBX其他芯片用 NMEAOM_GPS_BAUDRATE921600GPS 串口波特率OM_GPS_PORT自动检测GPS 串口设备路径USB 版可填/dev/serial/by-id/...OM_USE_F9R_SENSOR_FUSIONFalseF9R 芯片的传感器融合不稳定且无法测试不知道就别开如果你的 GPS 模块通过 TCP 转发数据如外接网络串口服务器还可以用OM_GPS_DEVICE_TYPEtcp配合OM_GPS_TCP_HOSTNAME、OM_GPS_TCP_PORT来读取。这些参数最终由src/open_mower/launch/include/_params.launch注入 ROS 参数服务器。五、割草行为与自动模式参数 想让割草机真正自动核心是这几个变量环境变量默认值含义OM_ENABLE_MOWERtrue是否启用割草电机调试阶段建议关掉OM_AUTOMATIC_MODE02AUTO 全自动、1SEMIAUTO 割完一遍等手动、0MANUAL 手动启动OM_OUTLINE_COUNT4沿边界跑几圈不建议低于 4OM_TOOL_WIDTH0.13割草行宽米设小一点可增加重叠防止漏割OM_OUTLINE_OFFSET0.05边界向内偏移的安全余量OM_MOWING_ANGLE_OFFSET0割草角度偏移-90 表示正北方向OM_MOWING_ANGLE_INCREMENT0每割完整张地图自动旋转的角度可减少草坪压痕六、出库与入库停靠参数 自动回充依赖两组参数配合出库UndockOM_UNDOCK_DISTANCE出库第一段距离需足够 GPS 定位、OM_UNDOCK_ANGLED_DISTANCE第二段斜向距离、OM_UNDOCK_ANGLE斜向角度负值向左、OM_UNDOCK_FIXED_ANGLE固定角度还是每次交替方向以减少草坪磨损、OM_UNDOCK_USE_CURVE第二段走曲线还是直线。入库DockOM_DOCKING_APPROACH_DISTANCE开始入库的距离必须大于充电站到割草区域的距离、OM_DOCKING_DISTANCE触到第二停靠点后继续前进的距离、OM_DOCKING_EXTRA_TIME检测到电压后继续顶入的时间增强触点接触、OM_DOCKING_RETRY_COUNT重试次数、OM_DOCKING_REDOCK入库后电压消失是否重新对接。部分 Mowgli 机型还可通过OM_PERIMETER_SIGNAL使用边界线信号辅助入库。七、电池与温度保护参数 环境变量默认值含义OM_BATTERY_FULL_VOLTAGE28.5判定满电的电压OM_BATTERY_EMPTY_VOLTAGE24.0低于此电压持续 20 秒后回充OM_BATTERY_CRITICAL_VOLTAGE23.0立即回充的临界电压OM_MOWING_MOTOR_TEMP_HIGH80.0割草电机过热停机温度OM_MOWING_MOTOR_TEMP_LOW40.0冷却到该温度后恢复割草进阶玩家还可以设置充电过压/过流保护OM_BATTERY_CRITICAL_HIGH_VOLTAGE、OM_CHARGE_CRITICAL_HIGH_VOLTAGE、OM_CHARGE_CRITICAL_HIGH_CURRENT。八、雨天策略参数 ️OM_RAIN_MODE提供 4 档策略0忽略降雨、1下雨立即回充、2回充等草干再出来时长由OM_RAIN_DELAY_MINUTES控制最小 30 分钟、3暂停自动模式。OM_CU_RAIN_THRESHOLD是雨量传感器阈值值越大判定越干燥。九、调试、录制与快照参数 ️OM_ENABLE_RECORDING_ALLTrue录制整段会话用于排查问题存放在 $HOME注意别长期开启以免塞满 SD 卡OM_SNAPSHOT_MEMORY_PER_TOPIC与OM_SNAPSHOT_DURATION在内存中缓存最近的 ROS 消息出问题时用utils/scripts/save_snapshot.sh一键导出快照包方便事后回放分析。十、MQTT 联动与声音参数 把割草机接入智能家居配置OM_MQTT_ENABLE、OM_MQTT_HOSTNAME、OM_MQTT_PORT、OM_MQTT_USER、OM_MQTT_PASSWORD和OM_MQTT_TOPIC_PREFIX即可向外部 MQTT Broker 发布状态数据。声音相关OM_DFP_IS_5V⚠️ 只有焊接改过 5V 跳线才能开否则可能烧毁树莓派 Pico、OM_LANGUAGEen/de、OM_VOLUME0-100-1 表示交给 CoverUI 管理、OM_BACKGROUND_SOUNDS下雨时哼歌等趣味背景音默认关闭以免吓到邻居。十一、配置完成后如何验证✅在 Docker 环境中重启 OpenMower 容器让环境变量重新注入打开 RViz 观察定位RTK 固定解Fixed状态下点位应稳定不漂移用遥控手柄OM_MOWER_GAMEPAD对应机型手动测试出库、入库检查 NTRIP 客户端日志确认 RTCM 数据持续流入。小结OpenMower 配置并不复杂核心思路就是硬件参数对齐 → NTRIP/RTK 连通 → 地图原点正确 → 行为参数微调。先把第三节的 NTRIP/RTK 关键参数配通你就能收获一台真正厘米级自主割草的机器人了。如果遇到问题对照config/mower_config.schema.json检查变量名拼写往往是最大的坑。【免费下载链接】open_mower_ros项目地址: https://gitcode.com/gh_mirrors/op/open_mower_ros创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenMower配置大全：mower_config环境变量逐项详解(含NTRIP/RTK关键参数)
OpenMower配置大全mower_config环境变量逐项详解(含NTRIP/RTK关键参数)【免费下载链接】open_mower_ros项目地址: https://gitcode.com/gh_mirrors/op/open_mower_rosOpenMower 是一个开源的 DIY 智能割草机器人项目它把普通的 YardForce 割草机改造为具备 RTK GPS 厘米级定位、自主割草与自动回充能力的机器人。而这一切的灵魂都藏在 mower_config 环境变量配置文件里。本文将逐项详解config/mower_config.sh.example中的全部关键参数并重点拆解 NTRIP/RTK 差分定位的配置方法让你从零开始也能完成 OpenMower 配置。一、mower_config 配置文件在哪里OpenMower 的核心配置位于项目根目录的config/mower_config.sh.example这是一份带详尽注释的 shell 环境变量模板。使用时将它复制为mower_config.sh并修改即可cp config/mower_config.sh.example mower_config.sh 两点提醒项目还提供了一份 JSON 版的参数说明config/mower_config.schema.json如果你想新增自定义变量需要同步维护两份文件。官方正在规划用可视化 UI 取代这个配置文件未来配置方式会更友好但现阶段读懂环境变量仍是 OpenMower 配置的必修课。二、必改的核心硬件环境变量新手先看这里打开配置文件文件头部就是Important Settings绝大多数情况下你只需要动这几个变量。它们决定了固件兼容性、机型物理参数和手柄映射。环境变量可选值说明OM_HARDWARE_VERSION0_13_X、0_12_X_LSM6DSO、0_11_X_WT901等主板的固件/IMU 芯片版本务必与你的硬件一致OM_MOWERYardForce500、YardForceSA650、Sabo、CUSTOM割草机机型自动套用天线位置、轮距等物理参数OM_MOWER_ESC_TYPExesc_mini、xesc_2040等电机驱动板类型STM32 版选 xesc_miniRP2040 版为实验特性OM_MOWER_GAMEPADps3、shield、xbox360等手柄型号用于手动遥控其中OM_MOWER对应的硬件参数存放在src/open_mower/params/hardware_specific/YardForce500/default_environment.sh这类机型脚本里例如天线偏移量OM_ANTENNA_OFFSET_X、轮距OM_WHEEL_DISTANCE_M、每米脉冲数OM_WHEEL_TICKS_PER_M等。选择CUSTOM机型时你需要把自己的参数放到~/mower_params/目录中。三、NTRIP/RTK 关键参数详解厘米级精度核心OpenMower 之所以能实现精准割草靠的是 RTK 差分定位通过 NTRIP 客户端从基站服务器获取 RTCM 差分数据让机载 GPS 达到厘米级精度。这一整组参数直接决定定位质量值得重点掌握。3.1 开启/关闭 NTRIP 差分export OM_USE_NTRIPTrueTrue通过 WiFi 从 NTRIP 服务器拉取差分数据推荐False使用插入 Ardusimple 板卡的外部电台接收差分信号。NTRIP 客户端节点由src/open_mower/launch/include/_ntrip_client.launch启动把 NMEA 上发给服务器、把 RTCM 下发给 GPS 模块。3.2 NTRIP 服务器连接参数账号配置环境变量示例含义OM_NTRIP_HOSTNAME192.168.178.55NTRIP 服务器地址或 IPOM_NTRIP_PORT2101NTRIP 服务端口Caster 常用 2101OM_NTRIP_USERgps账号用户名OM_NTRIP_PASSWORDgps账号密码OM_NTRIP_ENDPOINTBASE1挂载点Mount Point一般由服务器服务商提供这五项是连接 NTRIP 服务器的钥匙填错任何一个都会导致拿不到差分数据GPS 一直停留在米级精度。3.3 RTCM 超时与断线重连参数稳定性保障环境变量默认值含义OM_NTRIP_RTCM_TIMEOUT_SEC4.0等待 RTCM 数据超时时间秒超时即触发重连OM_NTRIP_ADAPTIVE_RECONNECTTrue开启自适应重连节奏控制OM_NTRIP_ADAPTIVE_BURST_MAX_ATTEMPTS12突发窗口内的最大重连次数OM_NTRIP_ADAPTIVE_BURST_WINDOW_SEC60.0突发限流窗口时长秒OM_NTRIP_ADAPTIVE_SLOW_AFTER_SEC300.0持续失败多久后进入慢速重连模式OM_NTRIP_ADAPTIVE_SLOW_INTERVAL_SEC300.0慢速模式下的重连间隔秒OM_NTRIP_RECONNECT_INITIAL_DELAY_SEC10.0指数退避的初始延迟秒OM_NTRIP_RECONNECT_MAX_DELAY_SEC300.0重连最大延迟秒OM_NTRIP_RECONNECT_BACKOFF_MULTIPLIER2.0退避倍数每次失败延迟翻倍OM_NTRIP_MAX_ATTEMPTS0最大重连次数0 表示无限重试调优建议如果家里 WiFi 不稳定、经常掉差分可适当调大OM_NTRIP_RTCM_TIMEOUT_SEC若 NTRIP 服务器对频繁连接有限制建议保持自适应重连开启避免被服务器封禁。四、GPS 定位参数地图原点与相对定位 ️定位参数决定坐标系怎么建立直接影响地图录制和后续导航。环境变量默认值含义OM_USE_RELATIVE_POSITIONFalseFalse用 DATUM 点作地图原点True以基站为原点推荐保持 False移动基站不用重录地图OM_DATUM_LAT/OM_DATUM_LONG需自行填写充电站附近的经纬度坐标作为地图原点OM_GPS_PROTOCOLUBXu-blox 芯片用 UBX其他芯片用 NMEAOM_GPS_BAUDRATE921600GPS 串口波特率OM_GPS_PORT自动检测GPS 串口设备路径USB 版可填/dev/serial/by-id/...OM_USE_F9R_SENSOR_FUSIONFalseF9R 芯片的传感器融合不稳定且无法测试不知道就别开如果你的 GPS 模块通过 TCP 转发数据如外接网络串口服务器还可以用OM_GPS_DEVICE_TYPEtcp配合OM_GPS_TCP_HOSTNAME、OM_GPS_TCP_PORT来读取。这些参数最终由src/open_mower/launch/include/_params.launch注入 ROS 参数服务器。五、割草行为与自动模式参数 想让割草机真正自动核心是这几个变量环境变量默认值含义OM_ENABLE_MOWERtrue是否启用割草电机调试阶段建议关掉OM_AUTOMATIC_MODE02AUTO 全自动、1SEMIAUTO 割完一遍等手动、0MANUAL 手动启动OM_OUTLINE_COUNT4沿边界跑几圈不建议低于 4OM_TOOL_WIDTH0.13割草行宽米设小一点可增加重叠防止漏割OM_OUTLINE_OFFSET0.05边界向内偏移的安全余量OM_MOWING_ANGLE_OFFSET0割草角度偏移-90 表示正北方向OM_MOWING_ANGLE_INCREMENT0每割完整张地图自动旋转的角度可减少草坪压痕六、出库与入库停靠参数 自动回充依赖两组参数配合出库UndockOM_UNDOCK_DISTANCE出库第一段距离需足够 GPS 定位、OM_UNDOCK_ANGLED_DISTANCE第二段斜向距离、OM_UNDOCK_ANGLE斜向角度负值向左、OM_UNDOCK_FIXED_ANGLE固定角度还是每次交替方向以减少草坪磨损、OM_UNDOCK_USE_CURVE第二段走曲线还是直线。入库DockOM_DOCKING_APPROACH_DISTANCE开始入库的距离必须大于充电站到割草区域的距离、OM_DOCKING_DISTANCE触到第二停靠点后继续前进的距离、OM_DOCKING_EXTRA_TIME检测到电压后继续顶入的时间增强触点接触、OM_DOCKING_RETRY_COUNT重试次数、OM_DOCKING_REDOCK入库后电压消失是否重新对接。部分 Mowgli 机型还可通过OM_PERIMETER_SIGNAL使用边界线信号辅助入库。七、电池与温度保护参数 环境变量默认值含义OM_BATTERY_FULL_VOLTAGE28.5判定满电的电压OM_BATTERY_EMPTY_VOLTAGE24.0低于此电压持续 20 秒后回充OM_BATTERY_CRITICAL_VOLTAGE23.0立即回充的临界电压OM_MOWING_MOTOR_TEMP_HIGH80.0割草电机过热停机温度OM_MOWING_MOTOR_TEMP_LOW40.0冷却到该温度后恢复割草进阶玩家还可以设置充电过压/过流保护OM_BATTERY_CRITICAL_HIGH_VOLTAGE、OM_CHARGE_CRITICAL_HIGH_VOLTAGE、OM_CHARGE_CRITICAL_HIGH_CURRENT。八、雨天策略参数 ️OM_RAIN_MODE提供 4 档策略0忽略降雨、1下雨立即回充、2回充等草干再出来时长由OM_RAIN_DELAY_MINUTES控制最小 30 分钟、3暂停自动模式。OM_CU_RAIN_THRESHOLD是雨量传感器阈值值越大判定越干燥。九、调试、录制与快照参数 ️OM_ENABLE_RECORDING_ALLTrue录制整段会话用于排查问题存放在 $HOME注意别长期开启以免塞满 SD 卡OM_SNAPSHOT_MEMORY_PER_TOPIC与OM_SNAPSHOT_DURATION在内存中缓存最近的 ROS 消息出问题时用utils/scripts/save_snapshot.sh一键导出快照包方便事后回放分析。十、MQTT 联动与声音参数 把割草机接入智能家居配置OM_MQTT_ENABLE、OM_MQTT_HOSTNAME、OM_MQTT_PORT、OM_MQTT_USER、OM_MQTT_PASSWORD和OM_MQTT_TOPIC_PREFIX即可向外部 MQTT Broker 发布状态数据。声音相关OM_DFP_IS_5V⚠️ 只有焊接改过 5V 跳线才能开否则可能烧毁树莓派 Pico、OM_LANGUAGEen/de、OM_VOLUME0-100-1 表示交给 CoverUI 管理、OM_BACKGROUND_SOUNDS下雨时哼歌等趣味背景音默认关闭以免吓到邻居。十一、配置完成后如何验证✅在 Docker 环境中重启 OpenMower 容器让环境变量重新注入打开 RViz 观察定位RTK 固定解Fixed状态下点位应稳定不漂移用遥控手柄OM_MOWER_GAMEPAD对应机型手动测试出库、入库检查 NTRIP 客户端日志确认 RTCM 数据持续流入。小结OpenMower 配置并不复杂核心思路就是硬件参数对齐 → NTRIP/RTK 连通 → 地图原点正确 → 行为参数微调。先把第三节的 NTRIP/RTK 关键参数配通你就能收获一台真正厘米级自主割草的机器人了。如果遇到问题对照config/mower_config.schema.json检查变量名拼写往往是最大的坑。【免费下载链接】open_mower_ros项目地址: https://gitcode.com/gh_mirrors/op/open_mower_ros创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考