FreeCalypso > hg > freecalypso-tools
annotate doc/Target-boot-control @ 735:5b8287c655cf
fc-pulse-dtr and fc-pulse-rts utilities implemented
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Tue, 15 Sep 2020 04:29:43 +0000 |
parents | d3e2b23ebf1d |
children | f19d12f5756f |
rev | line source |
---|---|
582
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
1 There is a new feature in loadtools (fc-loadtool & friends) and rvinterf as of |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
2 fc-host-tools-r12: target boot control. In a typical development environment |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
3 where FC host tools run on a general-purpose PC or laptop and communicate with |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
4 various Calypso targets via general-purpose serial or USB-serial ports, adapters |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
5 and cables, there is generally no way for the host computer running FC host |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
6 tools to directly command the Calypso target to power on and/or reboot - instead |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
7 such control must be performed "out of band" by the operator pressing the PWON |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
8 or RESET button on the target device; some targets may even require complex |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
9 battery manipulations. However, there may be more elaborate (less casual) |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
10 setups where FC host tools run on a special kind of host system which does have |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
11 some means to directly control power and reset to an associated Calypso target: |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
12 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
13 * The Mother has a plan to produce a special FreeCalypso UART+JTAG Adapter, or |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
14 FC-UJA. This FC-UJA will be a special FT2232D adapter whose Channel A will |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
15 operate in MPSSE mode, connecting to the Calypso target's JTAG and nTESTRESET |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
16 signals, whereas Channel B will act as a standard UART, i.e., a ttyUSB device. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
17 This FC-UJA needs to be built as a prerequisite before embarking on the |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
18 ambitious HSMBP (Handset Motherboard Prototype) project, as the special |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
19 adapter will be required for working with the HSMBP in development. When |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
20 FC-UJA becomes a reality, FC host tools running on a development host with |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
21 this adapter will need to be given the ability to issue nTESTRESET pulses to |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
22 the target through the adapter's MPSSE+GPIO channel; this nTESTRESET pulse |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
23 will cause the Calypso target to deep-reset, power on and boot. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
24 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
25 * FC host tools (particularly fc-loadtool) may run on the application processor |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
26 of a smartphone such as Openmoko GTA02. In such environments the AP will have |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
27 special ad hoc control signals (typically GPIOs) to the modem, at the minimum |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
28 controlling the modem's PWON line. OM GTA02 added an overriding control of |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
29 overall power to the modem; other designs may reasonably add control of the |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
30 modem's RESET line. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
31 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
32 * There may be special commercial applications in which one or more Calypso |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
33 modems are subservient to a control processor that acts similarly to the AP |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
34 of a smartphone, with that control processor not only communicating with its |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
35 slave modems via UARTs, but also controlling their power and reset. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
36 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
37 Where does the desire for target boot control in loadtools and rvinterf come |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
38 from? Consider the conventional usage model where no target boot control |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
39 exists: you first run fc-loadtool or fc-iram or fc-xram or rvinterf on your |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
40 target /dev/ttyXXX, then press the PWON or RESET button on the target. Now |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
41 suppose that the finger-actuated button has been replaced with some magic |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
42 command that can be executed on the host system to produce the same effect - |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
43 now what? If the usage model stays the same, then you have to first run your |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
44 fc-loadtool or fc-iram or fc-xram or rvinterf command same as before, then as |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
45 it sits there waiting for the target to boot, you have to open another terminal |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
46 window, get another ssh session into the system or whatever, and run the magic |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
47 command that replaces the manual button press. Very cumbersome, hence the |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
48 desire for a better way. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
49 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
50 Support for target boot control in FC host tools consists of a new -P option |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
51 implemented in all of loadtools programs and in rvinterf, as well as a special |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
52 configuration file which needs to be manually created. The working model is as |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
53 follows: |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
54 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
55 * There exist one or more "magic commands": a magic command is any shell command |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
56 (anything that can be passed to /bin/sh -c) whose execution causes a connected |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
57 Calypso target device to power on and boot. Naturally these commands will be |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
58 very specific to your custom system; they are NOT part of FC host tools! |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
59 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
60 * These magic commands may be long, and requiring the user to include each magic |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
61 command in full on fc-loadtool, rvinterf etc invokation lines is undesirable. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
62 To save typing, we associate a short name (which you choose yourself as you |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
63 see fit) with each magic command, and we have a configuration file (which you |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
64 need to create) that defines the mapping. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
65 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
66 * The argument to the new -P option is the short name to be looked up in the |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
67 configuration file. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
68 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
69 The configuration file needs to be created in /opt/freecalypso/bootctrl.conf; |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
70 let us illustrate it with some examples. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
71 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
72 Example 1: FC-UJA |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
73 ================= |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
74 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
75 When FC-UJA becomes a reality, there will be a program called fc-testreset that |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
76 will locate the attached FC-UJA by its USB ID, connect to FT2232D Channel A and |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
77 generate the desired reset pulse on its output. The configuration in |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
78 /opt/freecalypso/bootctrl.conf may look as follows: |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
79 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
80 uja fc-testreset |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
81 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
82 This configuration associates boot control name 'uja' with shell command |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
83 fc-testreset. A developer would then run fc-loadtool like this: |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
84 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
85 fc-loadtool -h fcfam -Puja /dev/ttyUSB0 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
86 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
87 if ttyUSB0 is where FC-UJA's UART channel ended up. fc-loadtool would run |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
88 normally, sending beacons to /dev/ttyUSB0 and waiting for a Calypso boot ROM |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
89 response, but it would also execute the fc-testreset command listed in the |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
90 configuration file, and if everything is connected correctly, the resulting |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
91 nTESTRESET pulse will cause the target to boot. |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
92 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
93 The possibility of a single host talking to multiple Calypso targets is fully |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
94 supported: if you have multiple FC-UJA adapters with different USB descriptor |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
95 serial numbers programmed in their EEPROMs connected to respective Calypso |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
96 targets, you could have a /opt/freecalypso/bootctrl.conf setup like this: |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
97 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
98 uja1 fc-testreset -d serial1 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
99 uja2 fc-testreset -d serial2 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
100 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
101 and then run fc-loadtool accordingly: |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
102 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
103 fc-loadtool -h fcfam -Puja1 /dev/ttyUSB3 |
deda54106c0e
doc/Target-boot-control: first draft
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
104 fc-loadtool -h fcfam -Puja2 /dev/ttyUSB4 |
585
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
105 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
106 Example 2: Openmoko GTA02 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
107 ========================= |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
108 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
109 There is a modem-power-ctrl.sh script provided in the openmoko directory of this |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
110 FC host tools package; if you are going to run fc-loadtool on the application |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
111 processor of your GTA02 smartphone, you should install this script in some |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
112 sensible location such as /usr/local/sbin/modem-power-ctrl. Then fill in your |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
113 /opt/freecalypso/bootctrl.conf file as follows: |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
114 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
115 lm /usr/local/sbin/modem-power-ctrl boot |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
116 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
117 The name 'lm' stands for "local modem"; you can then run fc-loadtool as follows: |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
118 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
119 fc-loadtool -h fic -Plm /dev/ttySAC0 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
120 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
121 Change from the past |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
122 ==================== |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
123 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
124 Back in 2013 the predecessor to our current FC host tools package was just |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
125 loadtools, and we had a special configuration for building our loadtools to run |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
126 on the GTA02 AP. But it worked backwards relative to our current arrangement: |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
127 the current sensible arrangement is that a tool like fc-loadtool run without |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
128 any special options simply operates on the specified serial port without any |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
129 special magic, and if special magic is desired, it needs to be requested |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
130 explicitly with the new -P option; the old loadtools-on-GTA02-AP arrangement |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
131 was the opposite: you needed to specify -n to get "regular" operation, otherwise |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
132 the tools would automatically operate the modem power control. |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
133 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
134 Now that we support many more different Calypso hardware targets than we even |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
135 knew about in 2013-2014, a cleanup has been long overdue. The new arrangement |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
136 as of fc-host-tools-r12 cleans up the mess in several ways: |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
137 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
138 * Our FC host tools package has grown so much that making special code |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
139 configurations for special environments like the AP of some particular |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
140 smartphone is no longer scalable; now we just have one standard FC host tools |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
141 package without platform-specific hacks. |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
142 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
143 * Openmoko platform was certainly very special to us once, but it is not so |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
144 special any more - now we just treat it the same as any other. Our target |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
145 boot control mechanism has now been generalized from just OM GTA02 to any |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
146 arbitrary platform with similar needs. |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
147 |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
148 * No more reversal of the standard tool paradigm: we have standard operation by |
d3e2b23ebf1d
doc/Target-boot-control: finished for now
Mychaela Falconia <falcon@freecalypso.org>
parents:
582
diff
changeset
|
149 default, magic on request with an option. |