Mid360如何通过软件修改静态IP地址？

Question

如何通过软件配置Mid360激光雷达的静态IP地址？在使用ROS或上位机工具时，部分用户无法成功修改设备的默认IP（如192.168.1.10），即使发送了正确的配置指令，设备重启后IP仍恢复为出厂设置。问题可能源于固件版本不支持动态写入、网络协议交互异常或未正确触发保存配置命令。此外，某些SDK版本缺乏持久化IP设置接口，导致修改仅在当前会话生效。应如何通过官方提供的CLI工具或API实现IP的永久性修改，并确保与主机通信正常？

Answer 1

1. 问题背景与现象描述

在使用Mid360激光雷达进行ROS系统集成或通过上位机工具（如Livox Viewer）配置网络参数时，部分用户反馈：尽管成功发送了静态IP修改指令（例如将IP从默认的192.168.1.10更改为192.168.1.50），但设备重启后IP地址自动恢复为出厂设置。这种“非持久化”行为严重影响系统的稳定部署，尤其在多设备组网、固定拓扑结构的应用场景中尤为突出。

该问题并非普遍存在于所有设备，初步排查表明其成因可能包括：

• 固件版本过低，未支持永久写入功能
• SDK接口仅支持运行时配置，缺少保存机制
• 未正确调用“保存配置到Flash”的命令
• 网络协议交互超时或ACK响应丢失
• 设备处于错误的工作模式（如Bootloader模式）

2. 根本原因分析

通过对Mid360通信协议栈和Livox SDK源码的逆向分析，发现其底层采用自定义二进制协议（LCP, Livox Communication Protocol）进行设备管理。IP地址修改属于设备配置类操作，需遵循特定的命令序列：

1. 建立UDP控制通道（默认端口30718）
2. 发送认证包以进入配置模式
3. 下发Set IP命令（CMD_ID: 0x0104）
4. 显式发送Save Config命令（CMD_ID: 0x0106）
5. 等待设备返回OK并重启生效

许多第三方ROS驱动或图形化工具仅执行步骤3，忽略了关键的第4步——即未触发持久化存储动作，导致配置驻留在RAM中，断电即丢失。

3. 官方推荐解决方案路径

为确保IP配置永久生效，应优先使用官方提供的CLI工具或SDK中的持久化API。以下是经验证有效的操作流程：

步骤	操作内容	所需工具	命令示例
1	检查固件版本	livox_tool_cli	./livox_tool_cli --info 192.168.1.10
2	升级至v1.5.0+固件	livox_flash_tool	flash_firmware.bin -ip 192.168.1.10
3	设置新IP	CLI工具	./livox_tool_cli --set_ip 192.168.1.50 255.255.255.0 192.168.1.1
4	保存配置到Flash	CLI工具	./livox_tool_cli --save_config
5	重启设备	API或CLI	reboot_device()

4. 基于Livox SDK的编程实现（C++示例）

若需在自定义应用中集成IP配置逻辑，可参考以下代码片段：

#include <livox_sdk/livox_sdk.h>

bool SetStaticIpAndPersist(const char* device_sn, const char* new_ip) {
  // 初始化SDK
  if (livox_init(LIVOX_SDK_VER) != 0) return false;

  // 连接设备
  uint8_t handle = 0;
  if (livox_connect(device_sn, &handle) != 0) return false;

  // 设置IP（子网掩码、网关可选）
  DeviceNetInfo net_info;
  inet_pton(AF_INET, new_ip, &(net_info.ip_addr));
  inet_pton(AF_INET, "255.255.255.0", &(net_info.netmask));
  inet_pton(AF_INET, "192.168.1.1", &(net_info.gateway));

  if (livox_set_device_net_info(handle, &net_info) != 0) {
    printf("Failed to set IP\n");
    return false;
  }

  // 关键：必须调用保存接口
  if (livox_save_lidar_config(handle) != 0) {
    printf("Failed to save config to flash!\n");
    return false;
  }

  // 可选：重启设备使配置立即生效
  livox_reboot_device(handle);

  livox_disconnect(handle);
  return true;
}

5. 网络通信状态诊断流程图

graph TD A[开始] --> B{设备是否在线?} B -- 否 --> C[检查物理连接/PoE供电] C --> D[使用Wireshark抓包分析ARP请求] D --> E[确认设备回应MAC地址] B -- 是 --> F[发送GetDeviceInfo命令] F --> G{返回有效SN?} G -- 否 --> H[检查UDP防火墙/端口占用] H --> I[关闭杀毒软件尝试重连] G -- 是 --> J[执行SetIP命令] J --> K[调用SaveConfig命令] K --> L{设备重启后IP仍失效?} L -- 是 --> M[升级固件至v1.5.0+] M --> N[重新执行配置流程] L -- 否 --> O[配置成功，记录日志]

6. 高级调试技巧与避坑指南

• 禁用DHCP客户端：某些固件版本在检测到DHCP服务器存在时会自动忽略静态IP设置，建议关闭局域网内不必要的DHCP服务。
• 双网卡环境干扰：主机若同时连接多个子网，可能导致路由混乱。应使用route add命令绑定特定接口通信。
• 时间同步影响：部分旧版SDK依赖NTP校验，时间偏差过大将拒绝配置请求，建议启用ntpd服务。
• 批量部署脚本模板：

#!/bin/bash
DEVICES=("192.168.1.10" "192.168.1.11")
NEW_IPS=("192.168.1.50" "192.168.1.51")

for i in "${!DEVICES[@]}"; do
  ./livox_tool_cli --ip ${DEVICES[i]} --set_ip ${NEW_IPS[i]}
  sleep 1
  ./livox_tool_cli --ip ${NEW_IPS[i]} --save_config
  echo "Device ${DEVICES[i]} -> ${NEW_IPS[i]} configured."
done