annotate doc/DSP-ROM-dump @ 833:625bee54ed34

CHANGES: document lunadrv init-kwh addition
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 22 Jun 2021 02:28:18 +0000
parents 9354a4f83fe8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
549
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 A pair of little ad hoc programs has been been added to FreeCalypso host tools
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 for the purpose of dumping the Calypso chip's internal DSP mask ROM. These two
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 programs are the dspdump target utility (see Target-utils) and the fc-dspromdump
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 front end host tool built in the loadtools suite. This addition is being
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 documented here for the sake of completeness, but it is not expected that anyone
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 will ever need to use these DSP ROM dump tools. Instead our fc-dspromdump tool
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 was written so it could be run exactly 3 times:
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 * Our new tool was run once against a common DSP 3606 target to verify that it
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 produces exactly the same output as the old tool implemented a decade ago by
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 our political rivals over at OsmocomBB, the dsp-rom-3606-dump.txt output that
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 has been published on our FTP site since 2017. The test result is yes, our
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 new tool produces exactly the same dump output when run against the same DSP
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 ROM version.
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 * Our fc-dspromdump tool was then run two more times against less common DSP ROM
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 versions: it was run on a D-Sample C05 board and an FCDEV3B-751774 board,
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 producing our newly published dumps of Calypso DSP ROM versions 3311 and 3416,
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 respectively.
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 We have now collected and published all 3 DSP ROM versions that are known to
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 have been featured in the evolutionary history of our beloved Calypso chip:
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 3311, 3416 and 3606. Because our target-utils and loadtools frameworks are
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 quite specific to Calypso and there are no other Calypso DSP ROM versions
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 besides the 3 which we've already collected and published, it is unlikely that
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 anyone else will need to run our DSP ROM dump tools as they stand. But if
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 anyone is interested in exploring some other TI DBB chips that came before or
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 after Calypso and is prepared to do the necessary work, our DSP ROM dump tools
9354a4f83fe8 doc/DSP-ROM-dump article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 might have some use as a starting point.