nmrpflash 技术文档

安装指南

对于 Linux 用户

首选的方法是通过 Homebrew 安装（如果系统支持）：

sudo apt install curl file git
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Linuxbrew/install/master/install.sh)"
echoeval $(homebrew shellenv)
brew install nmrpflash

若无 Homebrew 支持，则需手动编译或查找对应发行版的软件包。

对于 macOS 用户

推荐使用 Homebrew 进行安装：

brew install nmrpflash

遇到“无法验证开发者”的警告时，按照macOS安全设置指引操作，或使用命令行解决问题。

对于 Windows 用户

需要先安装 Npcap，确保选择“WinPcap兼容性”，然后从项目发布页面下载预编译的可执行文件。

项目的使用说明

基本步骤

1. 确定设备型号，并准备相应的固件文件。
2. 连接设备，使用以太网线将路由器的LAN口直连到电脑上。
3. 确定网络接口，使用nmrpflash -L列出所有可用接口。
4. 运行命令，在关闭路由器后启动nmrpflash，在看到提示后开启路由器。

示例命令

假设你的设备连接在eth2接口上，要刷入EX2700-V1.0.1.8.img固件：

nmrpflash -i eth2 -f EX2700-V1.0.1.8.img

项目API使用文档

nmrpflash提供了一系列命令行参数来控制其行为：

• -a <ip>: 目标设备IP地址，默认为10.164.183.253。
• -f <firmware>: 要上传的固件文件路径。
• -i <interface>: 与目标设备相连的网络接口名。
• -m <mac>: 目标设备的MAC地址，如xx:xx:xx:xx:xx:xx。
• -v: 开启详细模式以查看更多日志信息。
• -V: 打印版本信息并退出。
• 其他高级选项如命令执行(-c)、指定远程文件名(-F)等，见具体文档或使用nmrpflash -h获得完整帮助。

固件升级流程

1. 环境准备: 确保计算机与路由器之间只有一个直接物理连接，并关闭路由器。
2. 启动nmrpflash: 在终端中输入正确的命令等待响应。
3. 刷写过程: 路由器开机后，nmrpflash将自动检测并开始固件传输。
4. 等待完成: 成功后，nmrpflash会提示重启路由器。
5. 设备重启: 按照提示重启路由器，完成固件升级。

解决常见问题

对于各种操作系统下遇到的具体错误，例如库文件缺失、dll文件找不到等问题，文档提供了针对性的解决方法，确保先满足依赖条件，如安装libpcap、Npcap以及处理macOS的安全限制等。

记住，在报告任何问题之前，首先使用-vvv选项以最高级别详细输出进行测试，以便更好地诊断。