FreeCalypso > hg > freecalypso-tools

annotate CHANGES @ 443:715c55ba511d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
CHANGES: calversion documented
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 26 Dec 2018 07:22:44 +0000
parents 44f73d56b6f5
children a449ae0a1cec
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
440
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 438
diff changeset
1 Changes in the current code since fc-host-tools-r9a:
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 438
diff changeset
2
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 438
diff changeset
3 * New developer utility fc-rftab2c can convert per-band RF parameter tables
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 438
diff changeset
4 into C code snippets for inclusion into FreeCalypso firmware sources.
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 438
diff changeset
5
443
715c55ba511d CHANGES: calversion documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
6 * There have been many different versions of the Calypso silicon made over the
715c55ba511d CHANGES: calversion documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
7 years, including hardware differences, at least 3 ARM boot ROM versions and
715c55ba511d CHANGES: calversion documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
8 at least 3 DSP ROM versions. New target utility calversion (to be run via
715c55ba511d CHANGES: calversion documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
9 fc-iram) helps identify unknown Calypso chip versions: it reports the ARM
715c55ba511d CHANGES: calversion documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
10 boot ROM version, the DSP ROM version and the values read from the few
715c55ba511d CHANGES: calversion documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
11 documented ID registers.
715c55ba511d CHANGES: calversion documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
12
438
2ba7512efae5 CHANGES: Mot C155 flashing fix documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 436
diff changeset
13 Changes from fc-host-tools-r9 to fc-host-tools-r9a:
2ba7512efae5 CHANGES: Mot C155 flashing fix documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 436
diff changeset
14
2ba7512efae5 CHANGES: Mot C155 flashing fix documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 436
diff changeset
15 * fc-loadtool can now correctly program the flash on Mot C155/156 phones:
2ba7512efae5 CHANGES: Mot C155 flashing fix documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 436
diff changeset
16 it turns out that their flash is like the one on TI's D-Sample board
2ba7512efae5 CHANGES: Mot C155 flashing fix documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 436
diff changeset
17 and needs the same partition quirks.
2ba7512efae5 CHANGES: Mot C155 flashing fix documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 436
diff changeset
18
436
d43e7444f458 CHANGES: fc-host-tools-r9 released
Mychaela Falconia <falcon@freecalypso.org>
parents: 433
diff changeset
19 Changes from fc-host-tools-r8 to fc-host-tools-r9:
408
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
20
414
245047b16c47 CHANGES: mokosrec2bin addition and documentation updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 409
diff changeset
21 * mokosrec2bin utility added: it was originally written as a reverse
245047b16c47 CHANGES: mokosrec2bin addition and documentation updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 409
diff changeset
22 engineering aid and was previously maintained in the freecalypso-reveng
245047b16c47 CHANGES: mokosrec2bin addition and documentation updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 409
diff changeset
23 repository, but it has since been repurposed into a legitimate development
245047b16c47 CHANGES: mokosrec2bin addition and documentation updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 409
diff changeset
24 tool.
245047b16c47 CHANGES: mokosrec2bin addition and documentation updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 409
diff changeset
25
433
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
26 * Added workarounds for FTDI USB-serial adapters that feed previously
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
27 accumulated serial Rx bytes or outright garbage to newly started serial I/O
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
28 programs:
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
29
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
30 + fcup-atinterf back-end program for fcup-* does a sleep of 20 ms followed by
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
31 tcflush(target_fd, TCIFLUSH) on startup to flush any previously accumulated
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
32 serial Rx buffer garbage that would otherwise cause breakage. The two
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
33 delays in the deep sleep wakeup logic (see doc/Deep-sleep-support) have been
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
34 reduced from 50 to 30 ms each, thus the total length of initial delays has
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
35 been reduced from 100 to 80 ms.
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
36
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
37 + In the rvinterf suite (see doc/Rvinterf-tools) a similar startup delay has
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
38 been added in the special corner case of a non-interactive one-shot
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
39 operation being commanded with rvinterf also being launched from the client
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
40 program with -p; see the "Startup synchronization hack" section in the new
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
41 Rvinterf-tools document.
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
42
408
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
43 * fcup-smdump now restores the character set selection (AT+CSCS) setting on the
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
44 target to the default "IRA" (ASCII) upon successful completion, after
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
45 initially setting it to "HEX" for the operation; the intent of this change is
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
46 to avoid leaving a strange state for anyone using the AT command interface
409
e62e1203863f CHANGES: typo fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 408
diff changeset
47 manually after fcup-smdump.
408
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
48
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
49 * fcup-smsend bugfix: the corner case of omitting the destination address
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
50 argument with -W now works as documented.
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
51
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
52 * fcup-settime: minor code rearrangement should slightly reduce the unavoidable
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
53 delay between the time retrieval on the host and that time being set on the
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
54 target.
f0e6dd5971f2 CHANGES: fcup-* minor fixes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 404
diff changeset
55
418
cb3e8d080a23 CHANGES: FCDEV3B S/N 001 bug support removal
Mychaela Falconia <falcon@freecalypso.org>
parents: 414
diff changeset
56 * A hack that was added in fc-host-tools-r5 solely to support one (1) defective
cb3e8d080a23 CHANGES: FCDEV3B S/N 001 bug support removal
Mychaela Falconia <falcon@freecalypso.org>
parents: 414
diff changeset
57 FCDEV3B board with a particular flash boot defect has been removed.
cb3e8d080a23 CHANGES: FCDEV3B S/N 001 bug support removal
Mychaela Falconia <falcon@freecalypso.org>
parents: 414
diff changeset
58
433
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
59 * A number of documentation updates have been made: Deep-sleep-support and
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
60 Rvinterf-tools articles are new, RVTMUX and TIFFS-Overview write-ups got
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
61 long-overdue major updates, plus a number of minor updates as usual.
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
62
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
63 * For those who build the rarely needed ARM7 gcc toolchain from source, an old
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
64 bug in the toolchain/build+install.sh script which was masked on the Mother's
1a35a5cfe602 CHANGES: documented all changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 418
diff changeset
65 Slackware system for some reason has been fixed.
414
245047b16c47 CHANGES: mokosrec2bin addition and documentation updates
Mychaela Falconia <falcon@freecalypso.org>
parents: 409
diff changeset
66
404
c0716b2ddfce CHANGES: fc-host-tools-r8 is out
Mychaela Falconia <falcon@freecalypso.org>
parents: 403
diff changeset
67 Changes from fc-host-tools-r7 to fc-host-tools-r8:
266
f0662279848c CHANGES: removal of ffstools/aud-fcdev3b is the first post-r7 change
Mychaela Falconia <falcon@freecalypso.org>
parents: 263
diff changeset
68
327
973d885a68a0 CHANGES: fc-loadtool D-Sample fix documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 322
diff changeset
69 * fc-loadtool can now correctly program the flash on TI's D-Sample board
973d885a68a0 CHANGES: fc-loadtool D-Sample fix documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 322
diff changeset
70 after implementing the needed quirk for the Intel 28F640W30B flash chip.
973d885a68a0 CHANGES: fc-loadtool D-Sample fix documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 322
diff changeset
71
403
0094b049b2d2 CHANGES: target-utils Tx FIFO change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 400
diff changeset
72 * target-utils (loadagent and friends) serial output code changed to wait for
0094b049b2d2 CHANGES: target-utils Tx FIFO change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 400
diff changeset
73 the Tx FIFO not full condition instead of FIFO empty; this change makes these
0094b049b2d2 CHANGES: target-utils Tx FIFO change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 400
diff changeset
74 target utilities actually utilize the Tx FIFO feature of Calypso UARTs.
0094b049b2d2 CHANGES: target-utils Tx FIFO change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 400
diff changeset
75
312
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
76 * New c1xx-calextr utility can extract the factory RF calibration values for
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
77 Mot C1xx phones from a dump of their flash; see doc/Compal-calibration.
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
78
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
79 * Support for RF tables in FreeCalypso ASCII format (see doc/RF_tables) is
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
80 more complete: there is an ASCII format for the full 512 byte Tx ramps table,
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
81 any ASCII RF table can be converted to native binary with fc-cal2bin, most
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
82 ASCII RF tables can be uploaded directly into FFS with fc-fsio's new
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
83 upload-rf-table command.
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
84
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
85 * fc-cal2text change: Tx ramps tables are now emitted in the new ASCII format
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
86 with one file for the whole table, not split into 16 single ramp template
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
87 files any more.
eb6a0a052aab CHANGES: c1xx-calextr and RF table changes documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 268
diff changeset
88
322
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
89 * fc-fsio changes:
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
90
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
91 + new write-battery-table and write-charging-config commands for uploading
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
92 FreeCalypso-invented battery discharge threshold tables and charging config
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
93 files into the FFS of our FC devices with built-in compilation to binary;
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
94
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
95 + added upload-rf-table command for uploading ASCII RF tables directly into
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
96 FFS with built-in compilation to binary;
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
97
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
98 + pirelli-magnetite-init command now copies the previously missed
ee6443191465 CHANGES: documented fc-fsio additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 317
diff changeset
99 /gsm/rf/afcdac record.
268
081e22784044 CHANGES: fc-fsio pirelli-magnetite-init change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 266
diff changeset
100
317
b8479251ad0a CHANGES: fc-tmsh auw-fir command addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 312
diff changeset
101 * fc-tmsh can now upload audio FIR coefficient sets from FIR coefficient table
b8479251ad0a CHANGES: fc-tmsh auw-fir command addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 312
diff changeset
102 files with the new auw-fir command.
b8479251ad0a CHANGES: fc-tmsh auw-fir command addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 312
diff changeset
103
266
f0662279848c CHANGES: removal of ffstools/aud-fcdev3b is the first post-r7 change
Mychaela Falconia <falcon@freecalypso.org>
parents: 263
diff changeset
104 * The audio mode configurations that have been added in fc-host-tools-r7 have
f0662279848c CHANGES: removal of ffstools/aud-fcdev3b is the first post-r7 change
Mychaela Falconia <falcon@freecalypso.org>
parents: 263
diff changeset
105 been moved to a separate fc-audio-config repository and are no longer a part
f0662279848c CHANGES: removal of ffstools/aud-fcdev3b is the first post-r7 change
Mychaela Falconia <falcon@freecalypso.org>
parents: 263
diff changeset
106 of the core FC host tools package.
f0662279848c CHANGES: removal of ffstools/aud-fcdev3b is the first post-r7 change
Mychaela Falconia <falcon@freecalypso.org>
parents: 263
diff changeset
107
396
519d914e08a2 CHANGES: fc-lcdemu move-out and rvinterf -X output inversion fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 389
diff changeset
108 * The UI development aid utility fc-lcdemu which has been excluded from the
519d914e08a2 CHANGES: fc-lcdemu move-out and rvinterf -X output inversion fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 389
diff changeset
109 default build set since fc-host-tools-r5 has been moved to a separate
519d914e08a2 CHANGES: fc-lcdemu move-out and rvinterf -X output inversion fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 389
diff changeset
110 freecalypso-ui-dev repository and is no longer a part of the core FC host
519d914e08a2 CHANGES: fc-lcdemu move-out and rvinterf -X output inversion fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 389
diff changeset
111 tools package.
519d914e08a2 CHANGES: fc-lcdemu move-out and rvinterf -X output inversion fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 389
diff changeset
112
519d914e08a2 CHANGES: fc-lcdemu move-out and rvinterf -X output inversion fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 389
diff changeset
113 * rvinterf -X mechanism which pipes LCD output to fc-lcdemu now always inverts
519d914e08a2 CHANGES: fc-lcdemu move-out and rvinterf -X output inversion fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 389
diff changeset
114 the RGB565 values as needed, and the -v option has been removed; see usage
519d914e08a2 CHANGES: fc-lcdemu move-out and rvinterf -X output inversion fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 389
diff changeset
115 documentation in the freecalypso-ui-dev repository.
519d914e08a2 CHANGES: fc-lcdemu move-out and rvinterf -X output inversion fix
Mychaela Falconia <falcon@freecalypso.org>
parents: 389
diff changeset
116
400
be2683e1ac5e CHANGES: fc-shell key command addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 396
diff changeset
117 * fc-shell: added key command for sending sp MMI CONFIG KEY_SEQUENCE=<string>
be2683e1ac5e CHANGES: fc-shell key command addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 396
diff changeset
118 with a lot less typing, and keydown and keyup commands that do the same for
be2683e1ac5e CHANGES: fc-shell key command addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 396
diff changeset
119 KEY_PRESS and KEY_RELEASE "config" sysprim commands.
be2683e1ac5e CHANGES: fc-shell key command addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 396
diff changeset
120
389
2a47a8ef860a CHANGES: User Phone Tools addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 327
diff changeset
121 * There is a new suite of tools for talking to the AT command interface
2a47a8ef860a CHANGES: User Phone Tools addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 327
diff changeset
122 provided by FreeCalypso phones and modems, primarily for sending and
2a47a8ef860a CHANGES: User Phone Tools addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 327
diff changeset
123 retrieving SMS - see doc/User-phone-tools for more info.
2a47a8ef860a CHANGES: User Phone Tools addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 327
diff changeset
124
263
fa3c3643cbec CHANGES: fc-host-tools-r7 released
Mychaela Falconia <falcon@freecalypso.org>
parents: 260
diff changeset
125 Changes from fc-host-tools-r6 to fc-host-tools-r7:
243
b775a457940b CHANGES: first changes since fc-host-tools-r6
Mychaela Falconia <falcon@freecalypso.org>
parents: 239
diff changeset
126
257
62724d4928c2 CHANGES: libserial change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 243
diff changeset
127 * The way in which loadtools, rvinterf and miscellaneous tools operate on
62724d4928c2 CHANGES: libserial change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 243
diff changeset
128 serial ports for the purpose of talking to Calypso GSM devices has been
62724d4928c2 CHANGES: libserial change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 243
diff changeset
129 majorly reworked: the serial port handling code has been factored out into
62724d4928c2 CHANGES: libserial change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 243
diff changeset
130 libserial, and the new libserial uses Linux-specific direct ioctl calls
62724d4928c2 CHANGES: libserial change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 243
diff changeset
131 instead of generic termios. The effect is that you can now use the GSM-
62724d4928c2 CHANGES: libserial change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 243
diff changeset
132 specific high serial baud rates (up to 812500 bps) with FTDI adapters
62724d4928c2 CHANGES: libserial change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 243
diff changeset
133 (like the FT2232D adapter commonly used with FCDEV3B) with the standard
260
13e0fe68a358 CHANGES: added pointer to doc/High-speed-serial in the serial change blurb
Mychaela Falconia <falcon@freecalypso.org>
parents: 257
diff changeset
134 unpatched ftdi_sio kernel driver. See doc/High-speed-serial for more info.
257
62724d4928c2 CHANGES: libserial change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 243
diff changeset
135
243
b775a457940b CHANGES: first changes since fc-host-tools-r6
Mychaela Falconia <falcon@freecalypso.org>
parents: 239
diff changeset
136 * Added new utilities tiaud-compile and tiaud-mkvol for generating *.cfg and
b775a457940b CHANGES: first changes since fc-host-tools-r6
Mychaela Falconia <falcon@freecalypso.org>
parents: 239
diff changeset
137 *.vol binary files for the audio mode switching facility of TI's RiViera
b775a457940b CHANGES: first changes since fc-host-tools-r6
Mychaela Falconia <falcon@freecalypso.org>
parents: 239
diff changeset
138 Audio Service, to be uploaded under /aud into FreeCalypso GSM devices.
b775a457940b CHANGES: first changes since fc-host-tools-r6
Mychaela Falconia <falcon@freecalypso.org>
parents: 239
diff changeset
139
b775a457940b CHANGES: first changes since fc-host-tools-r6
Mychaela Falconia <falcon@freecalypso.org>
parents: 239
diff changeset
140 * A set of audio mode tables is built and installed in
b775a457940b CHANGES: first changes since fc-host-tools-r6
Mychaela Falconia <falcon@freecalypso.org>
parents: 239
diff changeset
141 /opt/freecalypso/aud-fcdev3b for uploading into /aud on FCDEV3B boards.
b775a457940b CHANGES: first changes since fc-host-tools-r6
Mychaela Falconia <falcon@freecalypso.org>
parents: 239
diff changeset
142
239
d55368e45bfe CHANGES: fc-host-tools-r6 released
Mychaela Falconia <falcon@freecalypso.org>
parents: 238
diff changeset
143 Changes from fc-host-tools-r5 to fc-host-tools-r6:
231
a58a7bbc0618 CHANGES: first changes since fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 225
diff changeset
144
a58a7bbc0618 CHANGES: first changes since fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 225
diff changeset
145 * loadtools and rvinterf now set TIOCEXCL on the tty to prevent the common
a58a7bbc0618 CHANGES: first changes since fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 225
diff changeset
146 error scenario of multiple processes trying to read from the same serial
a58a7bbc0618 CHANGES: first changes since fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 225
diff changeset
147 port.
a58a7bbc0618 CHANGES: first changes since fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 225
diff changeset
148
a58a7bbc0618 CHANGES: first changes since fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 225
diff changeset
149 * fc-loadtool: added a batch operation mode whereby the tool executes a given
a58a7bbc0618 CHANGES: first changes since fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 225
diff changeset
150 command script, cleans up (usually powers off) the target and exits.
a58a7bbc0618 CHANGES: first changes since fc-host-tools-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 225
diff changeset
151
234
4cee70d429bf CHANGES: fc-fsio format change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 231
diff changeset
152 * fc-loadtool exec command: scripts without slashes in the given name are now
4cee70d429bf CHANGES: fc-fsio format change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 231
diff changeset
153 sought in the current directory.
4cee70d429bf CHANGES: fc-fsio format change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 231
diff changeset
154
4cee70d429bf CHANGES: fc-fsio format change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 231
diff changeset
155 * fc-fsio format command: if the FFS is already formatted, the tool now prints
4cee70d429bf CHANGES: fc-fsio format change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 231
diff changeset
156 the error returned by the FFS code in the target fw, but does not stop the
4cee70d429bf CHANGES: fc-fsio format change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 231
diff changeset
157 execution of scripts; this change makes production scripts rerun-able.
4cee70d429bf CHANGES: fc-fsio format change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 231
diff changeset
158
238
08ad558c1fbc CHANGES: exitcodes.h addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 234
diff changeset
159 * exitcodes.h file installed in /opt/freecalypso/include/rvinterf: added
08ad558c1fbc CHANGES: exitcodes.h addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 234
diff changeset
160 ERROR_RFFAIL definition for use by fc-rfcal-tools.
08ad558c1fbc CHANGES: exitcodes.h addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 234
diff changeset
161
225
5af4990451d9 CHANGES: fc-host-tools-r5 released
Mychaela Falconia <falcon@freecalypso.org>
parents: 224
diff changeset
162 Changes from fc-host-tools-r4 to fc-host-tools-r5:
2
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
163
55
fb95b0493eca CHANGES: made note of the install location big change
Mychaela Falconia <falcon@freecalypso.org>
parents: 28
diff changeset
164 * New install location: everything is now under /opt/freecalypso instead of
fb95b0493eca CHANGES: made note of the install location big change
Mychaela Falconia <falcon@freecalypso.org>
parents: 28
diff changeset
165 /usr/local/bin and /usr/local/share/freecalypso.
fb95b0493eca CHANGES: made note of the install location big change
Mychaela Falconia <falcon@freecalypso.org>
parents: 28
diff changeset
166
2
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
167 * loadtools: added support for dsample (TI D-Sample) and fcfam (FreeCalypso
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
168 hardware family starting with FCDEV3B) targets.
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
169
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
170 * loadagent: UART autodetection now works not only with Calypso boot ROM
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
171 version 0300 found in the common Calypso devices, but also with the older
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
172 version 0200 found in the older Calypso silicon on early D-Sample boards.
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
173
11
21eec7569eb8 loadtools support for C139/140 target: -c 1004 compalstage variant
Mychaela Falconia <falcon@freecalypso.org>
parents: 2
diff changeset
174 * loadtools support for C139/140 target: use -h compal -c 1004 command line
21eec7569eb8 loadtools support for C139/140 target: -c 1004 compalstage variant
Mychaela Falconia <falcon@freecalypso.org>
parents: 2
diff changeset
175 options instead of the previous -h compal -c 1003 to support the newer
21eec7569eb8 loadtools support for C139/140 target: -c 1004 compalstage variant
Mychaela Falconia <falcon@freecalypso.org>
parents: 2
diff changeset
176 versions of C139/140 boot code which expect "1004" instead of the more
21eec7569eb8 loadtools support for C139/140 target: -c 1004 compalstage variant
Mychaela Falconia <falcon@freecalypso.org>
parents: 2
diff changeset
177 familiar "1003" in the serially downloaded code image. The new -c 1004
21eec7569eb8 loadtools support for C139/140 target: -c 1004 compalstage variant
Mychaela Falconia <falcon@freecalypso.org>
parents: 2
diff changeset
178 option ("1004" signature bytes) should work with all currently known
21eec7569eb8 loadtools support for C139/140 target: -c 1004 compalstage variant
Mychaela Falconia <falcon@freecalypso.org>
parents: 2
diff changeset
179 Mot/Compal boot code versions, thus -c 1003 is retained only for backward
21eec7569eb8 loadtools support for C139/140 target: -c 1004 compalstage variant
Mychaela Falconia <falcon@freecalypso.org>
parents: 2
diff changeset
180 compatibility with existing usage.
21eec7569eb8 loadtools support for C139/140 target: -c 1004 compalstage variant
Mychaela Falconia <falcon@freecalypso.org>
parents: 2
diff changeset
181
28
380d2e1f4eb7 CHANGES: fc-fsio changes since fc-host-tools-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 11
diff changeset
182 * fc-fsio: one can now type ls -l and not just the ll shorthand,
380d2e1f4eb7 CHANGES: fc-fsio changes since fc-host-tools-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 11
diff changeset
183 pirelli-get-imei and pirelli-magnetite-init commands added (former
380d2e1f4eb7 CHANGES: fc-fsio changes since fc-host-tools-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 11
diff changeset
184 fc-getpirimei and fc-pirhackinit separate utilities absorbed into fc-fsio),
380d2e1f4eb7 CHANGES: fc-fsio changes since fc-host-tools-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 11
diff changeset
185 help facility added.
380d2e1f4eb7 CHANGES: fc-fsio changes since fc-host-tools-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 11
diff changeset
186
169
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
187 * fc-tmsh changes:
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
188
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
189 + fc-tmsh now takes the -p option and supports one-shot command invokation
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
190 like fc-fsio and fc-shell;
72
e31b601744cd CHANGES: fc-tmsh change documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 55
diff changeset
191
169
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
192 + added support for L1/RF test mode commands and other TM3 protocol commands
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
193 (omr, omw, oabbr, oabbw, tm3ver);
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
194
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
195 + added ETM_AUDIO commands aul, aus, aur and auw.
152
9a08c09a07c0 CHANGES: list the addition of TM3 and l1tm command support to fc-tmsh
Mychaela Falconia <falcon@freecalypso.org>
parents: 72
diff changeset
196
153
9925fba699be fc-olddump replaced with fc-memdump
Mychaela Falconia <falcon@freecalypso.org>
parents: 152
diff changeset
197 * fc-olddump renamed to fc-memdump, can now use either TM3 or ETM memory read
9925fba699be fc-olddump replaced with fc-memdump
Mychaela Falconia <falcon@freecalypso.org>
parents: 152
diff changeset
198 commands.
9925fba699be fc-olddump replaced with fc-memdump
Mychaela Falconia <falcon@freecalypso.org>
parents: 152
diff changeset
199
2
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
200 * tiffs: added -O option to parse FFS images from the ancient 20020917 firmware
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
201 on the D-Sample.
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
202
169
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
203 * New in vitro analysis utilities: fc-cal2text and tiaud-decomp.
0b4167c0ed52 CHANGES: documenting fc-tmsh changes, fc-cal2text and tiaud-decomp addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 153
diff changeset
204
210
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
205 * Added tools for working with ringtone melodies: fc-e1decode and fc-e1gen for
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
206 loudspeaker melodies (see doc/Melody_E1) and fc-buzplay (plus target-side
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
207 buzplayer.srec) for devices that use a piezoelectric buzzer.
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
208
224
146f93bd5112 CHANGES: documented the addition of keepalive support to rvinterf
Mychaela Falconia <falcon@freecalypso.org>
parents: 210
diff changeset
209 * rvinterf: added support for the keepalive mechanism, see the description in
146f93bd5112 CHANGES: documented the addition of keepalive support to rvinterf
Mychaela Falconia <falcon@freecalypso.org>
parents: 210
diff changeset
210 doc/RVTMUX.
146f93bd5112 CHANGES: documented the addition of keepalive support to rvinterf
Mychaela Falconia <falcon@freecalypso.org>
parents: 210
diff changeset
211
2
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
212 * rvinterf & fc-shell: added support for the experimental TCH rerouting feature
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
213 of FreeCalypso Citrine firmware.
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
214
210
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
215 * fc-fr2tch, fc-gsm2vm, fc-tch2fr, fc-vm2hex: new utilities for converting
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
216 GSM 06.10 FR codec bits between different formats.
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
217
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
218 * c139explore & pirexplore: added host shell script wrappers invoking
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
219 fc-compalram and fc-iram with the respective target binaries.
071544322478 CHANGES: documented newly added utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 169
diff changeset
220
2
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
221 * Internal cleanup and refactoring in various places.
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
222
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
223 Changes from fc-host-tools-r3 to fc-host-tools-r4:
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
224
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
225 * Shellcode-based Compal phone break-in utility tfc139 reworked in a new way
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
226 that should work with all Mot C1xx firmwares beyond the original TFC139
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
227 target: see doc/Compal-unlock and doc/TFC139-breakin for the details.
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
228
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
229 * Documentation and cosmetic code changes to reflect the new understanding of
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
230 TI's TM (Test Mode) predating ETM (Enhanced Test Mode): see doc/RVTMUX for
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
231 a detailed explanation.
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
232
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
233 * Added support for the old non-enhanced Test Mode memory read command in the
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
234 form of fc-tmsh omr command, fc-fsio omemdump command and fc-olddump utility.
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
235
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
236 * rvtdump and rvinterf recognize the old all-ASCII GPF trace format emitted by
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
237 the D-Sample firmware from 20020917 and print these traces as ASCII instead
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
238 of hex.
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
239
803e4f4a3db6 CHANGES file added, following fc-host-tools releases
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
240 * fc-dspapidump fixed to be independent of host byte order.