FreeCalypso > hg > freecalypso-tools
comparison doc/Target-boot-control @ 585:d3e2b23ebf1d
doc/Target-boot-control: finished for now
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Mon, 03 Feb 2020 05:22:21 +0000 |
| parents | deda54106c0e |
| children | f19d12f5756f |
comparison
equal
deleted
inserted
replaced
| 584:ace7270e1161 | 585:d3e2b23ebf1d |
|---|---|
| 100 | 100 |
| 101 and then run fc-loadtool accordingly: | 101 and then run fc-loadtool accordingly: |
| 102 | 102 |
| 103 fc-loadtool -h fcfam -Puja1 /dev/ttyUSB3 | 103 fc-loadtool -h fcfam -Puja1 /dev/ttyUSB3 |
| 104 fc-loadtool -h fcfam -Puja2 /dev/ttyUSB4 | 104 fc-loadtool -h fcfam -Puja2 /dev/ttyUSB4 |
| 105 | |
| 106 Example 2: Openmoko GTA02 | |
| 107 ========================= | |
| 108 | |
| 109 There is a modem-power-ctrl.sh script provided in the openmoko directory of this | |
| 110 FC host tools package; if you are going to run fc-loadtool on the application | |
| 111 processor of your GTA02 smartphone, you should install this script in some | |
| 112 sensible location such as /usr/local/sbin/modem-power-ctrl. Then fill in your | |
| 113 /opt/freecalypso/bootctrl.conf file as follows: | |
| 114 | |
| 115 lm /usr/local/sbin/modem-power-ctrl boot | |
| 116 | |
| 117 The name 'lm' stands for "local modem"; you can then run fc-loadtool as follows: | |
| 118 | |
| 119 fc-loadtool -h fic -Plm /dev/ttySAC0 | |
| 120 | |
| 121 Change from the past | |
| 122 ==================== | |
| 123 | |
| 124 Back in 2013 the predecessor to our current FC host tools package was just | |
| 125 loadtools, and we had a special configuration for building our loadtools to run | |
| 126 on the GTA02 AP. But it worked backwards relative to our current arrangement: | |
| 127 the current sensible arrangement is that a tool like fc-loadtool run without | |
| 128 any special options simply operates on the specified serial port without any | |
| 129 special magic, and if special magic is desired, it needs to be requested | |
| 130 explicitly with the new -P option; the old loadtools-on-GTA02-AP arrangement | |
| 131 was the opposite: you needed to specify -n to get "regular" operation, otherwise | |
| 132 the tools would automatically operate the modem power control. | |
| 133 | |
| 134 Now that we support many more different Calypso hardware targets than we even | |
| 135 knew about in 2013-2014, a cleanup has been long overdue. The new arrangement | |
| 136 as of fc-host-tools-r12 cleans up the mess in several ways: | |
| 137 | |
| 138 * Our FC host tools package has grown so much that making special code | |
| 139 configurations for special environments like the AP of some particular | |
| 140 smartphone is no longer scalable; now we just have one standard FC host tools | |
| 141 package without platform-specific hacks. | |
| 142 | |
| 143 * Openmoko platform was certainly very special to us once, but it is not so | |
| 144 special any more - now we just treat it the same as any other. Our target | |
| 145 boot control mechanism has now been generalized from just OM GTA02 to any | |
| 146 arbitrary platform with similar needs. | |
| 147 | |
| 148 * No more reversal of the standard tool paradigm: we have standard operation by | |
| 149 default, magic on request with an option. |