annotate charging/c1xx/standard @ 6:cd0641c3611a

add README
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 06 Apr 2022 05:26:36 +0000
parents fa09662fe3e2
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 # This is the "standard" charging config for Mot C1xx phones running
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 # FreeCalypso fw. The key points are:
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 #
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 # 1) The battery is charged to the full 4.2 V, not a lower voltage,
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 # for traditional mobile phone usage patterns in which the user charges
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 # the battery fully before going out.
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 #
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 # 2) The start threshold is set fairly high on the reasoning that if
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 # the user connects the charging power source (which is not USB and thus
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 # not required for computer connection), it means that she actually intends
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 # to charge the battery, but it is set to 4100 mV instead of "always"
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 # so that if the battery is really full, an explicit AT@CHG=1 command
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 # or a future UI equivalent will be needed to force a charging start.
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 #
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 # 3) The restart threshold is a reasonable setting so if the phone is left
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 # plugged into the charger for a long time, the user won't be surprised
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 # with a battery that has run down significantly after the completion
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 # of the initial charging cycle.
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 start-threshold 4100 # mV
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 restart-threshold 3900 # mV
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 # Constant Voltage charging parameters mostly copied from Pirelli
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 ci2cv-threshold 4245 # mV, lowered from Pirelli's 4250
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 cv-initial-setpoint 4220 # mV
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 cv-ctrl-loop-high 4236 # mV
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 cv-ctrl-loop-low 4170 # mV, bumped up from Pirelli's 4160
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 cv-dac-max-incr 8 # DAC units
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 cv-dac-max-decr 50 # DAC units
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 cv-ctrl-loop-sample-count 6 # our logic is simpler than Pirelli's
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 overvoltage 4280 # mV, bumped up from Pirelli's 4270
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 # For the current settings, keep in mind that C1xx phones use a current
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 # measurement resistor of 0.15R instead of TI's "canonical" value of 0.20R,
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 # hence the conversion factor between mA and ADC/DAC numbers changes
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 # accordingly. The CI current setting is based on what Motorola's fw
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 # has been observed to set, but the end current setting is our own,
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 # chosen empirically.
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 ci-current 280 # DAC units, about 320 mA
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 end-current 60 # ADC units, about 68 mA
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 ichg-max-spike 26 # ADC units, about 30 mA
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 ichg-low-samples-needed 30 # sample count
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 # The apppropriate charging time limit and restart delay have yet to be
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 # determined; for now we give it a super-generous 6 h charging time limit
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48 # and 2 h restart delay.
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 charging-time-limit 21600
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51 restart-delay 7200
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53 # Motorola's fw does not seem to use the I2V offset mechanism,
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 # but we use the same setting as Pirelli.
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
55
fa09662fe3e2 batteries, charging: import from fc-battery-conf repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56 i2v-offset 0x18 # register setting