Merge master.kernel.org:/pub/scm/linux/kernel/git/davej/agpgart
[linux-2.6] / Documentation / dvb / get_dvb_firmware
1 #!/usr/bin/perl
2 #     DVB firmware extractor
3 #
4 #     (c) 2004 Andrew de Quincey
5 #
6 #     This program is free software; you can redistribute it and/or modify
7 #       it under the terms of the GNU General Public License as published by
8 #       the Free Software Foundation; either version 2 of the License, or
9 #       (at your option) any later version.
10 #
11 #     This program is distributed in the hope that it will be useful,
12 #       but WITHOUT ANY WARRANTY; without even the implied warranty of
13 #       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 #
15 #     GNU General Public License for more details.
16 #
17 #     You should have received a copy of the GNU General Public License
18 #       along with this program; if not, write to the Free Software
19 #       Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20
21 use File::Temp qw/ tempdir /;
22 use IO::Handle;
23
24 @components = ( "sp8870", "sp887x", "tda10045", "tda10046", "av7110", "dec2000t",
25                 "dec2540t", "dec3000s", "vp7041", "dibusb", "nxt2002", "nxt2004",
26                 "or51211", "or51132_qam", "or51132_vsb");
27
28 # Check args
29 syntax() if (scalar(@ARGV) != 1);
30 $cid = $ARGV[0];
31
32 # Do it!
33 for ($i=0; $i < scalar(@components); $i++) {
34     if ($cid eq $components[$i]) {
35         $outfile = eval($cid);
36         die $@ if $@;
37         print STDERR "Firmware $outfile extracted successfully. Now copy it to either /lib/firmware or /usr/lib/hotplug/firmware/ (depending on your hotplug version).\n";
38         exit(0);
39     }
40 }
41
42 # If we get here, it wasn't found
43 print STDERR "Unknown component \"$cid\"\n";
44 syntax();
45
46
47
48
49 # ---------------------------------------------------------------
50 # Firmware-specific extraction subroutines
51
52 sub sp8870 {
53     my $sourcefile = "tt_Premium_217g.zip";
54     my $url = "http://www.technotrend.de/new/217g/$sourcefile";
55     my $hash = "53970ec17a538945a6d8cb608a7b3899";
56     my $outfile = "dvb-fe-sp8870.fw";
57     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
58
59     checkstandard();
60
61     wgetfile($sourcefile, $url);
62     unzip($sourcefile, $tmpdir);
63     verify("$tmpdir/software/OEM/HE/App/boot/SC_MAIN.MC", $hash);
64     copy("$tmpdir/software/OEM/HE/App/boot/SC_MAIN.MC", $outfile);
65
66     $outfile;
67 }
68
69 sub sp887x {
70     my $sourcefile = "Dvbt1.3.57.6.zip";
71     my $url = "http://www.avermedia.com/software/$sourcefile";
72     my $cabfile = "DVBT Net  Ver1.3.57.6/disk1/data1.cab";
73     my $hash = "237938d53a7f834c05c42b894ca68ac3";
74     my $outfile = "dvb-fe-sp887x.fw";
75     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
76
77     checkstandard();
78     checkunshield();
79
80     wgetfile($sourcefile, $url);
81     unzip($sourcefile, $tmpdir);
82     unshield("$tmpdir/$cabfile", $tmpdir);
83     verify("$tmpdir/ZEnglish/sc_main.mc", $hash);
84     copy("$tmpdir/ZEnglish/sc_main.mc", $outfile);
85
86     $outfile;
87 }
88
89 sub tda10045 {
90     my $sourcefile = "tt_budget_217g.zip";
91     my $url = "http://www.technotrend.de/new/217g/$sourcefile";
92     my $hash = "2105fd5bf37842fbcdfa4bfd58f3594a";
93     my $outfile = "dvb-fe-tda10045.fw";
94     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
95
96     checkstandard();
97
98     wgetfile($sourcefile, $url);
99     unzip($sourcefile, $tmpdir);
100     extract("$tmpdir/software/OEM/PCI/App/ttlcdacc.dll", 0x37ef9, 30555, "$tmpdir/fwtmp");
101     verify("$tmpdir/fwtmp", $hash);
102     copy("$tmpdir/fwtmp", $outfile);
103
104     $outfile;
105 }
106
107 sub tda10046 {
108     my $sourcefile = "tt_budget_217g.zip";
109     my $url = "http://www.technotrend.de/new/217g/$sourcefile";
110     my $hash = "6a7e1e2f2644b162ff0502367553c72d";
111     my $outfile = "dvb-fe-tda10046.fw";
112     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
113
114     checkstandard();
115
116     wgetfile($sourcefile, $url);
117     unzip($sourcefile, $tmpdir);
118     extract("$tmpdir/software/OEM/PCI/App/ttlcdacc.dll", 0x3f731, 24478, "$tmpdir/fwtmp");
119     verify("$tmpdir/fwtmp", $hash);
120     copy("$tmpdir/fwtmp", $outfile);
121
122     $outfile;
123 }
124
125 sub av7110 {
126     my $sourcefile = "dvb-ttpci-01.fw-261d";
127     my $url = "http://www.linuxtv.org/downloads/firmware/$sourcefile";
128     my $hash = "603431b6259715a8e88f376a53b64e2f";
129     my $outfile = "dvb-ttpci-01.fw";
130
131     checkstandard();
132
133     wgetfile($sourcefile, $url);
134     verify($sourcefile, $hash);
135     copy($sourcefile, $outfile);
136
137     $outfile;
138 }
139
140 sub dec2000t {
141     my $sourcefile = "dec217g.exe";
142     my $url = "http://hauppauge.lightpath.net/de/$sourcefile";
143     my $hash = "bd86f458cee4a8f0a8ce2d20c66215a9";
144     my $outfile = "dvb-ttusb-dec-2000t.fw";
145     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
146
147     checkstandard();
148
149     wgetfile($sourcefile, $url);
150     unzip($sourcefile, $tmpdir);
151     verify("$tmpdir/software/OEM/STB/App/Boot/STB_PC_T.bin", $hash);
152     copy("$tmpdir/software/OEM/STB/App/Boot/STB_PC_T.bin", $outfile);
153
154     $outfile;
155 }
156
157 sub dec2540t {
158     my $sourcefile = "dec217g.exe";
159     my $url = "http://hauppauge.lightpath.net/de/$sourcefile";
160     my $hash = "53e58f4f5b5c2930beee74a7681fed92";
161     my $outfile = "dvb-ttusb-dec-2540t.fw";
162     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
163
164     checkstandard();
165
166     wgetfile($sourcefile, $url);
167     unzip($sourcefile, $tmpdir);
168     verify("$tmpdir/software/OEM/STB/App/Boot/STB_PC_X.bin", $hash);
169     copy("$tmpdir/software/OEM/STB/App/Boot/STB_PC_X.bin", $outfile);
170
171     $outfile;
172 }
173
174 sub dec3000s {
175     my $sourcefile = "dec217g.exe";
176     my $url = "http://hauppauge.lightpath.net/de/$sourcefile";
177     my $hash = "b013ececea83f4d6d8d2a29ac7c1b448";
178     my $outfile = "dvb-ttusb-dec-3000s.fw";
179     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
180
181     checkstandard();
182
183     wgetfile($sourcefile, $url);
184     unzip($sourcefile, $tmpdir);
185     verify("$tmpdir/software/OEM/STB/App/Boot/STB_PC_S.bin", $hash);
186     copy("$tmpdir/software/OEM/STB/App/Boot/STB_PC_S.bin", $outfile);
187
188     $outfile;
189 }
190
191 sub vp7041 {
192     my $sourcefile = "2.422.zip";
193     my $url = "http://www.twinhan.com/files/driver/USB-Ter/$sourcefile";
194     my $hash = "e88c9372d1f66609a3e7b072c53fbcfe";
195     my $outfile = "dvb-vp7041-2.422.fw";
196     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
197
198     checkstandard();
199
200     wgetfile($sourcefile, $url);
201     unzip($sourcefile, $tmpdir);
202     extract("$tmpdir/VisionDTV/Drivers/Win2K&XP/UDTTload.sys", 12503, 3036, "$tmpdir/fwtmp1");
203     extract("$tmpdir/VisionDTV/Drivers/Win2K&XP/UDTTload.sys", 2207, 10274, "$tmpdir/fwtmp2");
204
205     my $CMD = "\000\001\000\222\177\000";
206     my $PAD = "\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000";
207     my ($FW);
208     open $FW, ">$tmpdir/fwtmp3";
209     print $FW "$CMD\001$PAD";
210     print $FW "$CMD\001$PAD";
211     appendfile($FW, "$tmpdir/fwtmp1");
212     print $FW "$CMD\000$PAD";
213     print $FW "$CMD\001$PAD";
214     appendfile($FW, "$tmpdir/fwtmp2");
215     print $FW "$CMD\001$PAD";
216     print $FW "$CMD\000$PAD";
217     close($FW);
218
219     verify("$tmpdir/fwtmp3", $hash);
220     copy("$tmpdir/fwtmp3", $outfile);
221
222     $outfile;
223 }
224
225 sub dibusb {
226         my $url = "http://www.linuxtv.org/downloads/firmware/dvb-dibusb-5.0.0.11.fw";
227         my $outfile = "dvb-dibusb-5.0.0.11.fw";
228         my $hash = "fa490295a527360ca16dcdf3224ca243";
229
230         checkstandard();
231
232         wgetfile($outfile, $url);
233         verify($outfile,$hash);
234
235         $outfile;
236 }
237
238 sub nxt2002 {
239     my $sourcefile = "Broadband4PC_4_2_11.zip";
240     my $url = "http://www.bbti.us/download/windows/$sourcefile";
241     my $hash = "c6d2ea47a8f456d887ada0cfb718ff2a";
242     my $outfile = "dvb-fe-nxt2002.fw";
243     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
244
245     checkstandard();
246     
247     wgetfile($sourcefile, $url);
248     unzip($sourcefile, $tmpdir);
249     verify("$tmpdir/SkyNETU.sys", $hash);
250     extract("$tmpdir/SkyNETU.sys", 375832, 5908, $outfile);
251
252     $outfile;
253 }
254
255 sub nxt2004 {
256     my $sourcefile = "AVerTVHD_MCE_A180_Drv_v1.2.2.16.zip";
257     my $url = "http://www.aver.com/support/Drivers/$sourcefile";
258     my $hash = "111cb885b1e009188346d72acfed024c";
259     my $outfile = "dvb-fe-nxt2004.fw";
260     my $tmpdir = tempdir(DIR => "/tmp", CLEANUP => 1);
261
262     checkstandard();
263
264     wgetfile($sourcefile, $url);
265     unzip($sourcefile, $tmpdir);
266     verify("$tmpdir/3xHybrid.sys", $hash);
267     extract("$tmpdir/3xHybrid.sys", 465304, 9584, $outfile);
268
269     $outfile;
270 }
271
272 sub or51211 {
273     my $fwfile = "dvb-fe-or51211.fw";
274     my $url = "http://linuxtv.org/downloads/firmware/$fwfile";
275     my $hash = "d830949c771a289505bf9eafc225d491";
276
277     checkstandard();
278
279     wgetfile($fwfile, $url);
280     verify($fwfile, $hash);
281
282     $fwfile;
283 }
284
285 sub or51132_qam {
286     my $fwfile = "dvb-fe-or51132-qam.fw";
287     my $url = "http://linuxtv.org/downloads/firmware/$fwfile";
288     my $hash = "7702e8938612de46ccadfe9b413cb3b5";
289
290     checkstandard();
291
292     wgetfile($fwfile, $url);
293     verify($fwfile, $hash);
294
295     $fwfile;
296 }
297
298 sub or51132_vsb {
299     my $fwfile = "dvb-fe-or51132-vsb.fw";
300     my $url = "http://linuxtv.org/downloads/firmware/$fwfile";
301     my $hash = "c16208e02f36fc439a557ad4c613364a";
302
303     checkstandard();
304
305     wgetfile($fwfile, $url);
306     verify($fwfile, $hash);
307
308     $fwfile;
309 }
310
311 # ---------------------------------------------------------------
312 # Utilities
313
314 sub checkstandard {
315     if (system("which unzip > /dev/null 2>&1")) {
316         die "This firmware requires the unzip command - see ftp://ftp.info-zip.org/pub/infozip/UnZip.html\n";
317     }
318     if (system("which md5sum > /dev/null 2>&1")) {
319         die "This firmware requires the md5sum command - see http://www.gnu.org/software/coreutils/\n";
320     }
321     if (system("which wget > /dev/null 2>&1")) {
322         die "This firmware requires the wget command - see http://wget.sunsite.dk/\n";
323     }
324 }
325
326 sub checkunshield {
327     if (system("which unshield > /dev/null 2>&1")) {
328         die "This firmware requires the unshield command - see http://sourceforge.net/projects/synce/\n";
329     }
330 }
331
332 sub wgetfile {
333     my ($sourcefile, $url) = @_;
334
335     if (! -f $sourcefile) {
336         system("wget -O \"$sourcefile\" \"$url\"") and die "wget failed - unable to download firmware";
337     }
338 }
339
340 sub unzip {
341     my ($sourcefile, $todir) = @_;
342
343     $status = system("unzip -q -o -d \"$todir\" \"$sourcefile\" 2>/dev/null" );
344     if ((($status >> 8) > 2) || (($status & 0xff) != 0)) {
345         die ("unzip failed - unable to extract firmware");
346     }
347 }
348
349 sub unshield {
350     my ($sourcefile, $todir) = @_;
351
352     system("unshield x -d \"$todir\" \"$sourcefile\" > /dev/null" ) and die ("unshield failed - unable to extract firmware");
353 }
354
355 sub verify {
356     my ($filename, $hash) = @_;
357     my ($testhash);
358
359     open(CMD, "md5sum \"$filename\"|");
360     $testhash = <CMD>;
361     $testhash =~ /([a-zA-Z0-9]*)/;
362     $testhash = $1;
363     close CMD;
364     die "Hash of extracted file does not match!\n" if ($testhash ne $hash);
365 }
366
367 sub copy {
368     my ($from, $to) = @_;
369
370     system("cp -f \"$from\" \"$to\"") and die ("cp failed");
371 }
372
373 sub extract {
374     my ($infile, $offset, $length, $outfile) = @_;
375     my ($chunklength, $buf, $rcount);
376
377     open INFILE, "<$infile";
378     open OUTFILE, ">$outfile";
379     sysseek(INFILE, $offset, SEEK_SET);
380     while($length > 0) {
381         # Calc chunk size
382         $chunklength = 2048;
383         $chunklength = $length if ($chunklength > $length);
384
385         $rcount = sysread(INFILE, $buf, $chunklength);
386         die "Ran out of data\n" if ($rcount != $chunklength);
387         syswrite(OUTFILE, $buf);
388         $length -= $rcount;
389     }
390     close INFILE;
391     close OUTFILE;
392 }
393
394 sub appendfile {
395     my ($FH, $infile) = @_;
396     my ($buf);
397
398     open INFILE, "<$infile";
399     while(1) {
400         $rcount = sysread(INFILE, $buf, 2048);
401         last if ($rcount == 0);
402         print $FH $buf;
403     }
404     close(INFILE);
405 }
406
407 sub syntax() {
408     print STDERR "syntax: get_dvb_firmware <component>\n";
409     print STDERR "Supported components:\n";
410     for($i=0; $i < scalar(@components); $i++) {
411         print STDERR "\t" . $components[$i] . "\n";
412     }
413     exit(1);
414 }