annotate doc/Freerunner-Howto @ 635:baa0a02bc676

niq32.c DTR handling restored for targets that have it TI's original TCS211 fw treated GPIO 3 as the DTR input (wired so on C-Sample and D-Sample boards, also compatible with Leonardo and FCDEV3B which have a fixed pull-down resistor on this GPIO line), and the code in niq32.c called UAF_DTRInterruptHandler() (implemented in uartfax.c) from the IQ_KeypadGPIOHandler() function. But on Openmoko's GTA02 with their official fw this GPIO is a floating input, all of the DTR handling code in uartfax.c including the interrupt logic is still there, but the hobbled TCS211-20070608 semi-src delivery which OM got from TI contained a change in niq32.c (which had been kept in FC until now) that removed the call to UAF_DTRInterruptHandler() as part of those not-quite-understood "CC test" hacks. The present change fixes this bug at a long last: if we are building fw for a target that has TI's "classic" DTR & DCD GPIO arrangement (dsample, fcmodem and gtm900), we bring back all of TI's original code in both uartfax.c and niq32.c, whereas if we are building fw for a target that does not use this classic GPIO arrangement, the code in niq32.c goes back to what we got from OM and all DTR & DCD code in uartfax.c is conditioned out. This change also removes the very last remaining bit of "CC test" bogosity from our FreeCalypso code base.
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 19 Jan 2020 01:41:35 +0000
parents c9a65db8be4a
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
373
9399a83cb394 first round of documentation updates for 2018
Mychaela Falconia <falcon@freecalypso.org>
parents: 222
diff changeset
1 The latest official firmware for Openmoko Neo1973 and Neo FreeRunner Calypso
485
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
2 modems is moko13 as of this writing; moko13 is FreeCalypso Magnetite Hg
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
3 changeset 286:840113655bbf built for the gtamodem target in the l1reconst
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
4 configuration. There have been many changes in FC Magnetite since then, but
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
5 few of them affect the l1reconst config on the gtamodem target in any
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
6 noticeable way. The few noticeable post-moko13 changes which we do have in our
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
7 current l1reconst code are not deemed important enough to justify making
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
8 another formal release for a no-longer-made hardware platform that no longer
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
9 has any real user community either.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10
373
9399a83cb394 first round of documentation updates for 2018
Mychaela Falconia <falcon@freecalypso.org>
parents: 222
diff changeset
11 However, we also have the new TCS2/TCS3 hybrid config in which the old version
9399a83cb394 first round of documentation updates for 2018
Mychaela Falconia <falcon@freecalypso.org>
parents: 222
diff changeset
12 of the G23M protocol stack from Openmoko (binary libs only, no source) has been
9399a83cb394 first round of documentation updates for 2018
Mychaela Falconia <falcon@freecalypso.org>
parents: 222
diff changeset
13 replaced with a newer version from TI's TCS3/LoCosto program, and this new
485
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
14 version is full source. This hybrid firmware has now reached the state where
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
15 it is ready to be exercised by adventurous beta users in real-life usage.
222
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
16
373
9399a83cb394 first round of documentation updates for 2018
Mychaela Falconia <falcon@freecalypso.org>
parents: 222
diff changeset
17 The new hybrid fw for the gtamodem target can be built as follows:
222
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
18
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
19 ./configure.sh gtamodem hybrid
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
20 cd build-gtamodem-hybrid; make
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
21
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
22 Then after enduring the very slow build, you can flash it with fc-loadtool:
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
23
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
24 loadtool> flash erase 0 0x250000
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 loadtool> flash program-bin 0 fwimage.bin
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26
222
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
27 If you are brave enough to do the above, please let us know how this new modem
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
28 firmware fares when driven by QtMoko or SHR on the AP - it would definitely be
485
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
29 an adventure! We would be most interested in working with developers or
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
30 maintainers of specific AP software components that are directly responsible
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
31 for talking AT commands to the modem, if there are any such developers or
c9a65db8be4a doc/Freerunner-Howto: update for the current situation
Mychaela Falconia <falcon@freecalypso.org>
parents: 373
diff changeset
32 maintainers still around.