README.md

   1 nmrpflash - Netgear Unbrick Utility
   2 ====================================
   3
   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.
   8
   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).
  12
  13 ```
  14 Usage: nmrpflash [OPTIONS...]
  15
  16 Options (-a, -i and -f and/or -c are mandatory):
  17  -a <ipaddr>     IP address to assign to target device
  18  -c <command>    Command to run before (or instead of) TFTP upload
  19  -f <firmware>   Firmware file
  20  -F <filename>   Remote filename to use during TFTP upload
  21  -i <interface>  Network interface directly connected to device
  22  -m <mac>        MAC address of target device (xx:xx:xx:xx:xx:xx)
  23  -M <netmask>    Subnet mask to assign to target device
  24  -t <timeout>    Timeout (in milliseconds) for regular messages
  25  -T <timeout>    Time (seconds) to wait after successfull TFTP upload
  26  -p <port>       Port to use for TFTP upload
  27  -R <region>     Set device region (NA, WW, GR, PR, RU, BZ, IN, KO, JP)
  28  -v              Be verbose
  29  -V              Print version and exit
  30  -L              List network interfaces
  31  -h              Show this screen
  32 ```
  33
  34 ### Using nmrpflash
  35
  36 Connect your Netgear router to your computer using a network cable.
  37 Assign a static IP address to the network adapter that's plugged into
  38 the Netgear router.
  39
  40 For this example, we'll assume that your network interface is `eth0`.
  41 First, we have to assign a static IP address to our network interface.
  42 In this example, we'll use `192.168.1.2`. All available network interfaces
  43 can be listed using
  44
  45 ```
  46 # nmrpflash -L
  47 eth0      192.168.1.2  f2:11:a1:02:03:b1
  48 ```
  49
  50 Now we can flash the image. The argument for the `-a` option needs
  51 to be a *free* IP address from the same subnet as the one used by your
  52 network interface; we'll use `192.168.1.254`. Firmware images can usually
  53 be downloaded directly from Netgear. For details on how to do this, see
  54 [here](#obtaining-firmware-images). Power on your device immediately
  55 after starting `nmrpflash`.
  56
  57 ```
  58 # nmrpflash -i eth0 -a 192.168.1.254 -f EX2700-V1.0.1.8.img
  59 Advertising NMRP server on eth0 ... /
  60 Received configuration request from a4:2b:8c:00:00:01.
  61 Sending configuration: ip 192.168.1.254, mask 255.255.255.0.
  62 Received upload request: filename 'firmware'.
  63 Uploading EX2700-V1.0.1.8.img ... OK
  64 Waiting for remote to respond.
  65 Remote finished. Closing connection.
  66 Reboot your device now.
  67 ```
  68
  69 ### Common issues
  70
  71 In any case, run `nmrpflash` with `-vvv` before filing a bug report.
  72
  73 ###### Linux: "error while loading shared libraries: libpcap.so.0.8"
  74
  75 You must install your Linux distribution's `libpcap` package. In
  76 openSUSE 42 for example, install `libpcap0.8` (cheers to
  77 [@gvcastellon](https://github.com/gvcastellon).
  78
  79 ###### Windows: "The program can't start because wpcap.dll is missing"
  80
  81 Install [WinPcap](https://www.winpcap.org/install/default.htm).
  82
  83 ###### "No suitable network interfaces found."
  84
  85 Make sure the network interface is up. Wireless interfaces are not supported.
  86 On Windows, try rebooting the WinPcap service (commands must be run as administrator):
  87
  88 ```
  89 C:\> net stop npf
  90 C:\> net start npf
  91 ```
  92
  93 ###### "No response after 60 seconds. Bailing out."
  94
  95 The router did not respond. Try rebooting the device and run `nmrpflash` again.
  96 You could also try running `nmrpflash` with `-m` and specify your router's
  97 MAC address. It's also possible that your device does not support the NMRP protocol.
  98
  99 ###### "Timeout while waiting for initial reply."
 100
 101 The device did not respond to `nmrpflash`'s TFTP upload request. This could indicate a bug
 102 in the TFTP code; try using an external tftp client (busybox in this example), by specifying
 103 the `-c` flag instead of the `-f` flag:
 104
 105 `# nmrpflash -i eth0 -a 192.168.1.254 -c "busybox tftp -p -l EX2700-V1.0.1.8.img 192.168.1.254"`
 106
 107 <strike>
 108 If the upload still fails, and you're on Windows, try executing the following command before
 109 running `nmrpflash`:
 110
 111 `C:\> netsh interface ip add neighbors <interface> <ip> <mac>`
 112
 113 where `<interface>` is the pretty interface name (e.g. "Local Area Connection"; as displayed by
 114 `nmrpflash -L`), `<ip>` is the same IP address you'd use for `nmrpflash`'s `-a` flag, and `<mac>`
 115 is the target device's mac address.
 116
 117 Cheers to [@ntadmin](https://github.com/ntadmin) for this info!
 118 </strike>
 119
 120 ###### "Timeout while waiting for CLOSE_REQ."
 121
 122 After a successful file upload, `nmrpflash` waits for up to 120 seconds for an
 123 answer from your device. You can increase this by specifying a longer timeout
 124 using `-T` switch (argument is in seconds).
 125
 126 It's entirely possible that the image was flashed successfully, but the
 127 operation took longer than 120 seconds.
 128
 129 ###### "Address X/Y cannot be used on interface Z."
 130
 131 `nmrpflash` refuses to use an IP address / subnet mask combination that would
 132 make the remote device unreachable from the device running `nmrpflash`. For
 133 example, if the IP address of your computer is 192.168.0.1/255.255.255.0, assigning
 134 192.168.2.1/255.255.255.0 to the router makes no sense, because the TFTP upload will
 135 fail.
 136
 137 ###### "IP address of X has changed. Please assign a static IP to the interface."
 138
 139 This can happen if the network interface in question automatically detects that
 140 the network cable has been connected, and your computer tries to reconfigure that
 141 interface (NetworkManager on Linux does this for example) - this can usually be
 142 disabled.
 143
 144 An alternative would be to add `-c 'ifconfig <interface> <ip>'` to the command line,
 145 for example:
 146
 147 `# nmrpflash -i eth0 -a 192.168.1.1 -f firmware.bin -c 'ifconfig eth0 192.168.1.2'`
 148
 149 This will execute the command specified by `-c` prior to starting the TFTP upload (in
 150 this case setting the IP address to 192.168.1.2).
 151
 152 ### Building and installing
 153 ###### Linux, Mac OS X, BSDs
 154
 155 ```
 156 $ make && sudo make install
 157 ```
 158
 159 ###### Windows
 160
 161 The repository includes a
 162 [DevCpp](http://sourceforge.net/projects/orwelldevcpp/)
 163 project file (`nmrpflash.dev`). Download the latest
 164 [WinPcap Developer Pack](https://www.winpcap.org/devel.htm)
 165 and extract it into the root folder of the nmrpflash sources.
 166
 167 ### Obtaining firmware images
 168
 169 Firmware images can be downloaded directly from Netgear's FTP servers.
 170 For the Netgear EX2700 for example, download
 171 ftp://updates1.netgear.com/ex2700/ww/fileinfo.txt. At the top there
 172 should be an entry like this:
 173
 174 ```
 175 [Major1]
 176 file=EX2700-V1.0.1.8.img
 177 ...
 178 ```
 179
 180 The download link for the latest firmware image for this device is thus:
 181 ftp://updates1.netgear.com/ex2700/ww/EX2700-V1.0.1.8.img. Substitute
 182 `ex2700` for your device (`wndr4300`, `wndr3700`, `r6100`, etc.). If
 183 neccessary, substitute `ww` (world-wide) for a specific region.
 184