nmrpflash - Netgear Unbrick Utility
====================================

This program uses Netgear's [NMRP protocol]
(http://www.chubb.wattle.id.au/PeterChubb/nmrp.html)
to flash a new firmware image to a compatible device. This utility has been
tested with a Netgear EX2700, but is likely to work on many others as well.

Prebuilt binaries for Linux, OS X and Windows are available
[here](https://github.com/jclehner/nmrp-flash/releases).

````
Usage: nmrpflash [OPTIONS...]

Options (-a, -i and -f are mandatory):
 -a <ipaddr>     IP address to assign to target device
 -f <firmware>   Firmware file
 -i <interface>  Network interface directly connected to device
 -m <mac>        MAC address of target device (xx:xx:xx:xx:xx:xx)
 -M <netmask>    Subnet mask to assign to target device
 -t <timeout>    Timeout (in milliseconds) for regular messages
 -T <timeout>    Time to wait after successfull TFTP upload
 -p <port>       Port to use for TFTP upload
 -U              Test TFTP upload
 -v              Be verbose
 -V              Print version and exit
 -L              List network interfaces
 -h              Show this screen
````

### Using nmrpflash

Connect your Netgear router to your computer using a network cable.
Assign a static IP address to the network adapter that's plugged into
the Netgear router.

For this example, we'll assume that your network interface is `eth0`.
First, we have to assign a static IP address to our network interface.
In this example, we'll use `192.168.1.2`. All available network interfaces 
can be listed using

````
$ nmrpflash -L
eth0      192.168.1.2  f2:11:a1:02:03:b1
````

Now we can start `nmrpflash`. The argument for the `-a` option needs
to be a *free* IP address from the same subnet as the one used by your
network interface. We'll use `192.168.1.254`. The firmware image file
can usually be downloaded directly from Netgear's FTP servers.

````
$ nmrpflash -i eth0 -a 192.168.1.254 -f EX2700-V1.0.1.8.img
Advertising NMRP server on eth0 ... /
Received configuration request from a4:2b:8c:00:00:01.
Sending configuration: ip 192.168.1.254, mask 255.255.255.0.
Uploading EX2700-V1.0.1.8.img ... OK
Waiting for remote to respond.
Remote finished. Closing connection.
````

### Common issues
###### No suitable network interfaces found.

If you're *not* on Windows, rerun `nmrpflash -L` using `sudo`. In any case,
use `-vvvL` to see more detailed messages, and file a bug report if applicable.

###### No response after 60 seconds. Bailing out.

The router did not respond. Try running `nmrpflash` with `-m` and specify
your router's MAC address. It's also entirely possible that your device does
not support the NMRP protocol.

###### Timeout while waiting for 0x04.

After a successful file upload, `nmrpflash` waits for up to 60 seconds for an
answer from your device. You can increase this by specifying a longer timeout
using `-T` switch (argument is in milliseconds). 

It's entirely possible that the image was flashed successfully, but the
operation took longer than 60 seconds.

### Building and installing
###### Linux, Mac OS X, BSDs

````
$ make && sudo make install
````

###### Windows

The repository includes a 
[DevCpp](http://sourceforge.net/projects/orwelldevcpp/)
project file (`nmrpflash.dev`). Download the latest 
[WinPcap Developer Pack](http://www.winpcap.org/devel.htm) 
and extract it into the root folder of the nmrpflash sources.