annotate doc/Freerunner-Howto @ 250:9432dd63626b

firmware ident and build date mechanism implemented at the build level
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 03 Aug 2017 04:59:47 +0000
parents 79cb194284ca
children 9399a83cb394
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 Running FreeCalypso Magnetite firmware on the Neo Freerunner
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 ============================================================
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
222
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
4 As explained in the Modem-configs article, we currently have 3 different modem
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
5 fw configurations which differ in the degree of deblobbing. The classic
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
6 configuration is exactly the same as leo2moko from 2013; the l1reconst config
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
7 rebuilds most of L1 from source, but our L1 reconstruction is so accurate that
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
8 there will be no observable difference in behaviour. The hybrid configuration,
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
9 however, is quite interesting in that it is a new major development, as major
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
10 parts of the fw have been replaced with an entirely new version from another TI
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
11 program.
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12
222
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
13 The deblobbed TCS2/TCS3 hybrid configuration is intended to be our direction
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
14 going forward, but it will need extensive testing and debugging before it can
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
15 replace the classic/l1reconst configs (or older mokoN/leo2moko firmwares) for
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
16 production use. The principal developer's intent is to build our desired
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
17 FCDEV3B hardware and do this testing and debugging on that board, but it can
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
18 also be done on Openmoko devices.
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
19
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
20 Given the current state of the remains of what once was the Openmoko community,
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
21 I (Mychaela) do not feel like doing any significant work on this platform;
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
22 instead I would rather build our own FCDEV3B and leave Openmoko behind.
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
23 However, if anyone else feels otherwise and would like to play with our
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
24 TCS2/TCS3 hybrid modem fw on Openmoko hardware, you can build it like this:
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
25
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
26 ./configure.sh gtamodem hybrid
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
27 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
28
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
29 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
30
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
31 loadtool> flash erase 0 0x250000
94
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 loadtool> flash program-bin 0 fwimage.bin
596d86109e44 initial round of documentation
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33
222
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
34 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
35 firmware fares when driven by QtMoko or SHR on the AP - it would definitely be
79cb194284ca doc/Freerunner-Howto: update for the TCS2/TCS3 hybrid development
Mychaela Falconia <falcon@freecalypso.org>
parents: 94
diff changeset
36 an adventure!