-
Notifications
You must be signed in to change notification settings - Fork 2
/
index.html
176 lines (145 loc) · 5.98 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<!DOCTYPE html>
<html>
<head>
<meta charset='utf-8'>
<title>coolaj86/wrt-firmware-tools @ GitHub</title>
<style type="text/css">
body {
margin-top: 1.0em;
background-color: #cceeff;
font-family: Helvetica, Arial, FreeSans, san-serif;
color: #000000;
}
#container {
margin: 0 auto;
width: 700px;
}
h1 { font-size: 3.8em; color: #742d0b; margin-bottom: 3px; }
h1 .small { font-size: 0.4em; }
h1 a { text-decoration: none }
h2 { font-size: 1.5em; color: #742d0b; }
h3 { text-align: center; color: #742d0b; }
a { color: #742d0b; }
.description { font-size: 1.2em; margin-bottom: 30px; margin-top: 30px; font-style: italic;}
.download { float: right; }
pre { background: #000; color: #fff; padding: 15px;}
hr { border: 0; width: 80%; border-bottom: 1px solid #aaa}
.footer { text-align:center; padding-top:30px; font-style: italic; }
</style>
</head>
<body>
<a href="http://github.com/coolaj86/wrt-firmware-tools"><img style="position: absolute; top: 0; right: 0; border: 0;" src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a>
<div id="container">
<div class="download">
<a href="http://github.com/coolaj86/wrt-firmware-tools/zipball/master">
<img border="0" width="90" src="http://github.com/images/modules/download/zip.png"></a>
<a href="http://github.com/coolaj86/wrt-firmware-tools/tarball/master">
<img border="0" width="90" src="http://github.com/images/modules/download/tar.png"></a>
</div>
<h1><a href="http://github.com/coolaj86/wrt-firmware-tools">wrt-firmware-tools</a>
<span class="small">by Jeremy Collake</span></h1>
<div class="description">
This kit allows for easy deconstruction and reconsutrction of firmware images for various embedded devices
</div>
<p>
NO GUARANTEE IS PROVIDED. WITH EVERY REBUILT IMAGE YOU STAND THE CHANCE OF **BRICKING YOUR DEVICE** (EITHER A SOFT OR HARD BRICK). DO NOT USE THIS TOOL IF YOU CAN NOT RECOVER FROM SUCH A BRICK. BY USING THIS TOOL YOU ASSUME LIABILITY OF ALL DAMAGES, TANGIBLE AND INTANGIBLE, RESULTING FROM THE USE OR MIS-USE OF THIS SOFTWARE.
</p>
<p>
READ THE ABOVE AGAIN BEFORE USING THIS SOFTWARE. **YOU ARE GOING TO BRICK YOUR ROUTER**. WHILE YOU MAY NOT, IT IS BETTER WE SAY YOU WILL SO THAT YOU UNDERSTAND THE RISK. MOST BRICKS ARE RECOVERABLE, BUT NOT ALL.
</p>
<p>This kit gives the user the ability to make changes to a firmware image without recompiling the firmware sources. It works by extracting the firmware into its component parts, then extracting the file system image. The user can then make modifications to the extracted file system, then rebuild the firmware image.</p>
<p>It is most useful for quick debugging of problems without having to rebuild the entire firmware image. It can even be deployed 'on the road'. A variety of formats are supported, mainly linux based GPL images known to be around; additionally, it can be used to customize DD-WRT web GUIs.</p>
<p>We've written a few custom utilities (i.e. untrx, wrt_vx_imgtool, spliter3) to support various devices. We've also made modifications to squashfs-tools and added known variants of squashfs-tools.</p>
<p>Recently, Binwalk was also integrated, to help identify and support even more firmware types and segment/filesystem types.</p>
<p>Un-guaranteed support for firmware image formats for the following devices:</p>
<ul>
<li>WRT54G v1 - v6</li>
<li>WRT54GS v1 - v6</li>
<li>WRTSL54G v?</li>
<li>M10 (Cisco Valet)</li>
<li>ASUS WL-330g</li>
<li>ASUS WL-500g/p</li>
<li>ASUS WL-520g</li>
<li>ASUS WL-530g</li>
<li>Belkin 7230-4 (some versions)</li>
<li>Belkin 7231-4 (?)</li>
<li>Buffalo WHR-G54S</li>
<li>Buffalo WHR-HP-G54</li>
<li>Siemens SE505</li>
<li>Trendnet TEW-632BRP</li>
<li>D-Link DIR615 (maybe, untested)</li>
<li>many others..</li>
</ul>
Some specific firmware types:
<ul>
<li>OpenWrt</li>
<li>Tomato</li>
<li>X-Wrt</li>
<li>DD-WRT v23 for all models</li>
<li>DD-WRT v24 SP1+ (for some models ONLY)</li>
</ul>
The following filesystems can be extracted and assembled:
<ul>
<li>squashfs 2.x (zlib)</li>
<li>squashfs 2.x (lzma)</li>
<li>squashfs 3.x (zlib)</li>
<li>squashfs 3.x (lzma)</li>
<li>squashfs 3.x (lzma with prepended encoding params)</li>
<li>squashfs 3.x (lzma with other variations)</li>
<li>JFFS2</li>
<li>cramfs (zlib)</li>
</ul>
<a href="http://www.bitsum.com/firmware_mod_kit.htm">Jeremy's Original Documentation</a>
<a href="./firmware_mod_kit.htm">( Mirror )</a>
</p>
<h2>Dependencies</h2>
<p>
<ul>
<li>build-essential</li>
<li>libz1g-dev</li>
</ul>
</p>
<h2>Install</h2>
<p>Tested on fresh VirtualBox installs of Ubuntu 11.04 32-bit and 64-bit
<pre>
sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install -y \
virtualbox-ose-guest-utils \
build-essential \
subversion \
unrar \
wget \
curl \
git \
vim
mkdir Code
cd ~/Code
git clone git://github.com/coolaj86/wrt-firmware-tools.git
cd firmware-mod-kit-read-only/trunk
</pre>
</p>
<h2>License</h2>
<p>GNU GPL v2</p>
<h2>Authors</h2>
<p>Craig Heffner <heffnercj@gmail.com><br/>Jeremy Collake <jeremy.collake@gmail.com><br/>Michael Tiernan <michael.tiernan@gmail.com></p>
<h2>Contact</h2>
<p>Craig Heffner <heffnercj@gmail.com></p>
<h2>Download</h2>
<p>
You can download this project in either
<a href="http://github.com/coolaj86/wrt-firmware-tools/zipball/master">zip</a> or
<a href="http://github.com/coolaj86/wrt-firmware-tools/tarball/master">tar</a> formats.
</p>
<p>You can also clone the project with <a href="http://git-scm.com">Git</a>
by running:
<pre>$ git clone git://github.com/coolaj86/wrt-firmware-tools</pre>
</p>
<div class="footer">
get the source code on GitHub : <a href="http://github.com/coolaj86/wrt-firmware-tools">coolaj86/wrt-firmware-tools</a>
</div>
</div>
</body>
</html>