1 nmrpflash - Netgear Unbrick Utility
2 ====================================
4 This program uses Netgear's [NMRP protocol]
5 (http://www.chubb.wattle.id.au/PeterChubb/nmrp.html)
6 to flash a new firmware image to a compatible device. This utility has been
7 tested with a Netgear EX2700, but is likely to work on many others as well.
9 Prebuilt binaries for Linux, OS X and Windows are available
10 [here](https://github.com/jclehner/nmrpflash/releases)
11 ([WinPcap](https://www.winpcap.org/install/default.htm) is required on Windows).
14 Usage: nmrpflash [OPTIONS...]
16 Options (-a, -i and -f are mandatory):
17 -a <ipaddr> IP address to assign to target device
18 -f <firmware> Firmware file
19 -i <interface> Network interface directly connected to device
20 -m <mac> MAC address of target device (xx:xx:xx:xx:xx:xx)
21 -M <netmask> Subnet mask to assign to target device
22 -t <timeout> Timeout (in milliseconds) for regular messages
23 -T <timeout> Time to wait after successfull TFTP upload
24 -p <port> Port to use for TFTP upload
27 -V Print version and exit
28 -L List network interfaces
34 Connect your Netgear router to your computer using a network cable.
35 Assign a static IP address to the network adapter that's plugged into
38 For this example, we'll assume that your network interface is `eth0`.
39 First, we have to assign a static IP address to our network interface.
40 In this example, we'll use `192.168.1.2`. All available network interfaces
45 eth0 192.168.1.2 f2:11:a1:02:03:b1
48 A firmware image file can usually be downloaded directly from
49 Netgear's FTP servers: for the Netgear EX2700 for example, download
50 ftp://updates1.netgear.com/ex2700/ww/fileinfo.txt. At the top there
51 should be an entry like this:
55 file=EX2700-V1.0.1.8.img
59 The download link for the latest firmware image for this device is thus:
60 ftp://updates1.netgear.com/ex2700/ww/EX2700-V1.0.1.8.img. Substitute
61 `ex2700` for your device (`wndr4300`, `wndr3700`, `r6100`, etc.).
63 Now we can start `nmrpflash`. The argument for the `-a` option needs
64 to be a *free* IP address from the same subnet as the one used by your
65 network interface. We'll use `192.168.1.254`. Power on your device immediately
66 after starting `nmrpflash`.
69 $ nmrpflash -i eth0 -a 192.168.1.254 -f EX2700-V1.0.1.8.img
70 Advertising NMRP server on eth0 ... /
71 Received configuration request from a4:2b:8c:00:00:01.
72 Sending configuration: ip 192.168.1.254, mask 255.255.255.0.
73 Uploading EX2700-V1.0.1.8.img ... OK
74 Waiting for remote to respond.
75 Remote finished. Closing connection.
79 ###### "No suitable network interfaces found."
81 If you're *not* on Windows, rerun `nmrpflash -L` using `sudo`. In any case,
82 use `-vvvL` to see more detailed messages, and file a bug report if applicable.
84 ###### "No response after 60 seconds. Bailing out."
86 The router did not respond. Try running `nmrpflash` with `-m` and specify
87 your router's MAC address. It's also entirely possible that your device does
88 not support the NMRP protocol.
90 ###### "Timeout while waiting for 0x04."
92 After a successful file upload, `nmrpflash` waits for up to 120 seconds for an
93 answer from your device. You can increase this by specifying a longer timeout
94 using `-T` switch (argument is in seconds).
96 It's entirely possible that the image was flashed successfully, but the
97 operation took longer than 120 seconds.
99 ### Building and installing
100 ###### Linux, Mac OS X, BSDs
103 $ make && sudo make install
108 The repository includes a
109 [DevCpp](http://sourceforge.net/projects/orwelldevcpp/)
110 project file (`nmrpflash.dev`). Download the latest
111 [WinPcap Developer Pack](https://www.winpcap.org/devel.htm)
112 and extract it into the root folder of the nmrpflash sources.