annotate doc/DSP-ROM-dump @ 1014:961efadd530a default tip

fc-shell TCH DL handler: add support for CSD modes TCH DL capture mechanism in FC Tourmaline firmware has been extended to support CSD modes in addition to speech - add the necessary support on the host tools side. It needs to be noted that this mechanism in its present state does NOT provide the debug utility value that was sought: as we learned only after the code was implemented, TI's DSP has a misfeature in that the buffer we are reading (a_dd_0[]) is zeroed out when the IDS block is enabled, i.e., we are reading all zeros and not the real DL bits we were after. But since the code has already been written, we are keeping it - perhaps we can do some tests with IDS disabled.
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 26 Nov 2024 06:27:43 +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.