Update readme
[oweals/nmrpflash.git] / README.md
index 5cf20c177758d1bb2ac6f7eefa7bb64685a48e82..3f885323cb3a6b2418dfeac3b3db224455e84b47 100644 (file)
--- a/README.md
+++ b/README.md
@@ -7,10 +7,8 @@ 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/nmrpflash/releases).
-
-To run `nmrpflash` on Windows, install
-[WinPcap](https://www.winpcap.org/install/default.htm).
+[here](https://github.com/jclehner/nmrpflash/releases)
+([WinPcap](https://www.winpcap.org/install/default.htm) is required on Windows).
 
 ````
 Usage: nmrpflash [OPTIONS...]
@@ -47,10 +45,12 @@ $ 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
+Now we can `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.
+network interface. We'll use `192.168.1.254`. Firmware images can usually 
+be downloaded directly from netgear. For details on how to do this, see
+[here](#obtaining-firmware-images). Power on your device immediately 
+after starting `nmrpflash`.
 
 ````
 $ nmrpflash -i eth0 -a 192.168.1.254 -f EX2700-V1.0.1.8.img
@@ -70,9 +70,9 @@ 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.
+The router did not respond. Try rebooting the device and run `nmrpflash` again.
+You could also try running `nmrpflash` with `-m` and specify your router's
+MAC address. It's also possible that your device does not support the NMRP protocol.
 
 ###### "Timeout while waiting for 0x04."
 
@@ -98,3 +98,21 @@ project file (`nmrpflash.dev`). Download the latest
 [WinPcap Developer Pack](https://www.winpcap.org/devel.htm)
 and extract it into the root folder of the nmrpflash sources.
 
+### Obtaining firmware images
+
+Firmware images can be downloaded directly from Netgear's FTP servers. 
+For the Netgear EX2700 for example, download 
+ftp://updates1.netgear.com/ex2700/ww/fileinfo.txt. At the top there 
+should be an entry like this:
+
+```
+[Major1]
+file=EX2700-V1.0.1.8.img
+...
+```
+
+The download link for the latest firmware image for this device is thus:
+ftp://updates1.netgear.com/ex2700/ww/EX2700-V1.0.1.8.img. Substitute 
+`ex2700` for your device (`wndr4300`, `wndr3700`, `r6100`, etc.). If
+neccessary, substitute `ww` (world-wide) for a specific region.
+