83aaf73fa8347ec24132b3a651ef23837add0b4c
[oweals/nmrpflash.git] / README.md
1 nmrp-flash - 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.
7
8 This utility has been tested with a Netgear EX2700,
9 but is likely to work on many others as well.
10
11 ### Using nmrp-flash
12
13 Connect your Netgear router to your computer using a network cable.
14 Assign a static IP address to your computer (more specifically, to 
15 the network card that's plugged into the Netgear router).
16
17 For this example, we'll assume that your network interface is `eth0`.
18 First, we have to assign a static IP address to our network interface:
19
20 ````
21 $ sudo ifconfig eth0 192.168.1.2
22 ````
23
24 Now we can start `nmrp-flash`. The argument for the `-a` option needs
25 to be a *free* IP address from the same subnet as the one used by your
26 network interface. We'll use `192.168.1.254`. The firmware image file
27 can usually be downloaded directly from Netgear's FTP servers.
28
29 ````
30 $ sudo nmrp-flash -i eth0 -a 192.168.1.254 -f EX2700-V1.0.1.8.img
31 Advertising NMRP server on eth0 ... /
32 Received configuration request from XX:XX:XX:XX:XX:XX.
33 Sending configuration: ip 192.168.1.254, mask 255.255.255.0.
34 Uploading EX2700-V1.0.1.8.img ... OK
35 Waiting for remote to respond.
36 Remote finished. Closing connection.
37 ````
38
39 ### Building and installing
40
41 ````
42 $ make && sudo make install
43 ````