FreeCalypso > hg > freecalypso-tools
comparison rvinterf/asyncshell/helpfile @ 751:5dd748850f2b
fc-shell help: batt command: better documentation
The semantic meaning of the two bytes carried in the MMI_BATTERY_IND
primitive depends on the firmware version. Update the documentation
to describe what these two bytes mean in current FC Tourmaline firmware.
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Thu, 05 Nov 2020 19:30:14 +0000 |
parents | fa6fee41f06e |
children |
comparison
equal
deleted
inserted
replaced
750:db7b2724203b | 751:5dd748850f2b |
---|---|
33 Any time you send anything to ATI, fc-shell automatically performs the | 33 Any time you send anything to ATI, fc-shell automatically performs the |
34 equivalent of an enable ati command so you can see ATI's responses; any | 34 equivalent of an enable ati command so you can see ATI's responses; any |
35 asynchronous output from ATI is also enabled as a side effect. | 35 asynchronous output from ATI is also enabled as a side effect. |
36 | 36 |
37 === batt | 37 === batt |
38 batt <byte1> <byte2> | 38 batt <state> <level> |
39 | 39 |
40 TI's MFW (UI firmware component) uses MMI_BATTERY_IND primitive (in the GPF and | 40 TI's MFW (UI firmware component) uses MMI_BATTERY_IND primitive (in the GPF and |
41 protocol stack sense) to communicate battery events from driver callback | 41 protocol stack sense) to communicate battery events from driver callback |
42 functions to the MMI task. GPF allows any protocol stack primitive to be | 42 functions to the MMI task. GPF allows any protocol stack primitive to be |
43 injected externally; sending this MMI_BATTERY_IND primitive from the development | 43 injected externally; sending this MMI_BATTERY_IND primitive from the development |
44 host allows the UI firmware's battery functions to be exercised on development | 44 host allows the UI firmware's battery functions to be exercised on development |
45 boards that have no battery or charging hardware. | 45 boards that have no battery or charging hardware. |
46 | 46 |
47 fc-shell batt command sends an MMI_BATTERY_IND protocol stack primitive with | 47 fc-shell batt command sends an MMI_BATTERY_IND protocol stack primitive with |
48 user-specified parameter bytes; the meaning of these parameter bytes depends on | 48 user-specified parameter bytes; the meaning of these parameter bytes depends on |
49 the firmware version. | 49 the firmware version. In current FC Tourmaline fw the state byte communicates |
50 both durable states and transient events as listed below, whereas the level byte | |
51 sets the battery icon level in the [0,4] range or is set to 255 to mean no | |
52 battery level information in this event. Valid states and events for current | |
53 FC Tourmaline are as follows: | |
54 | |
55 batt 0 lev -- no charging activity, lev is in [0,4] range | |
56 batt 1 255 -- charging in progress, battery icon becomes animated | |
57 batt 2 4 -- charging complete, battery icon full | |
58 batt 3 255 -- charger plug transient event | |
50 | 59 |
51 === disable | 60 === disable |
52 === enable | 61 === enable |
53 {dis,en}able ati | 62 {dis,en}able ati |
54 {dis,en}able gpf | 63 {dis,en}able gpf |