FreeCalypso > hg > freecalypso-docs

comparison FC-handset-spec @ 55:df6c61d0e817

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
FC-handset-spec: firmware keypad model documented
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 12 Jun 2021 23:20:47 +0000
parents 138021ca5eae
children a39269dddca4
comparison
equal deleted inserted replaced
54:138021ca5eae 55:df6c61d0e817
1081 1081
1082 This area is one where we are NOT retaining TI's original way as an option in 1082 This area is one where we are NOT retaining TI's original way as an option in
1083 our actively maintained firmware. The difference between the two principal 1083 our actively maintained firmware. The difference between the two principal
1084 paradigms is too great, and we don't have any active-demand prospective targets 1084 paradigms is too great, and we don't have any active-demand prospective targets
1085 with B&W displays of the old traditional kind. 1085 with B&W displays of the old traditional kind.
1086
1087 2.2. Keypad assumptions
1088
1089 The keypad arrangement on our FC handset (see sections 1.5 and 1.6) will be
1090 exactly the same as on TI's D-Sample, thus no principal changes to the firmware
1091 are needed in this regard. Furthermore, the same 21-button keypad exists on
1092 Motorola C1xx phones, thus no firmware design variations are needed in this
1093 regard for secondary target support.
1094
1095 The only issue of concern is that the 3 side buttons which exist on D-Sample and
1096 Pirelli DP-L10 and will also exist on our FC handset don't exist on Mot C1xx.
1097 Our starting point code from TI does not do anything with these buttons (even
1098 though it was developed on the D-Sample platform where they exist), but when we
1099 do get around to adding support for these side buttons, we will need to take
1100 some extra care in preserving flexibility:
1101
1102 * The original code from TI uses navigation up/down buttons for volume control,
1103 for both ringer and earpiece volume. We are going to change the code to drive
1104 these volume controls with side buttons instead (dedicated volume up/down
1105 buttons), but when we make this change, we'll need to provide an option of
1106 restoring the old way for less button-equipped phones like Mot C1xx.
1107
1108 * Whatever functions we assign to the right side button, all of them will be
1109 our own inventions, as none exist in TI's original code. However, this right
1110 side button does not exist on Mot C1xx. The Mother's idea is to assign the
1111 right side button to loudspeaker on/off control - this arrangement will work
1112 well as the same C1xx phones that lack this button also lack the hands-free
1113 loudspeaker.
1114
1115 2.2.1. No support for 18-button main keypads
1116
1117 Prior to D-Sample, TI's C-Sample and earlier boards had keypads with fewer
1118 buttons, 18 instead of 21, and no side buttons. The difference between the
1119 C-Sample 18-button main keypad and the 21-button one found on D-Sample, Pirelli
1120 DP-L10 and Motorola C1xx is that the older 18-button keypad has only up and down
1121 navigation buttons in the place where the 21-button version has a 5-way
1122 navigation button group. In other words, navigation left, right and center keys
1123 don't exist on the 18-button version.
1124
1125 TI's demo/prototype/PoC UI code was originally developed on C-Sample or perhaps
1126 even earlier, thus it was originally designed for the 18-button keypad
1127 arrangement. For this reason, the code currently makes very little use of
1128 navigation left, right and center keys. However, some limited use is already
1129 being made of these extra keys (primarily on text and number entry screens, aka
1130 the editor), and our use of all available keys in the UI will keep growing. As
1131 a matter of project scope, we are NOT supporting backward compatibility with
1132 18-button keypads, given that the lowest-end Mot C1xx family already has
1133 21-button keypads.