Bme replacement

Contents

Introduction

BME Replacement is a project aiming to bring proper FOSS replacement to Maemo's BME bits. It consists of both kernel and userland bits, cooperating, and make use of data provided by build-in hardware bq27x00 chip.

Unlike vanilla BME, replacement fully support USB hostmode, via usbmode.

Prerequisities

Kernel which provides bq2415x_charger, bq27x00_battery and rx51_battery modules. It also need to have "glue" between bq2415x_charger and monolitic musb driver. In practice, it means kernel-power52 or above (See: Kernel_Power)

Current state

Beta

.debs are available from: https://atrey.karlin.mff.cuni.cz/~pali/rx51-bme-replacement/ (might need to ignore expired certificate)

It works for everyday usage, but some major problems were found, see below.

Problems/bugs and proposed solutions

1. Premature shutdown

Device is shutting down at EDV1 voltage, not allowing bq27x00 chip to calibrate capacity. Calibrating require device to be *at or below* EDV1 for 15 seconds straight - going above even for a split second resets timer, so another straight 15 seconds is required.

Proposed solutions

1. gconf value, that allow power users to change voltage, at which device shutdowns to any arbitrary value.

This is preffered solution, as some devices are more like to have problems with GSM chip restarting at low voltage, even around EDV1 3248 mV. People with such problems, that preffer GSM stability over calibration, could bump voltage treeshold, to avoid problems. OTOH, people with less picky devices and/or dual-cell setups, could decrease limit, getting more from their batteries.

This method can be also augmented by solution 2, for "default" shutdown treeshold.

---

2. Using EDV1 flag, instead of EDV1 voltage, as trigger to shut device down. EDV1 *flag* being set, means, that device was just calibrated - it spares need complicated replication of 15 sec. calibration timer, mentioned in problem description.

EDV1 flag can be read from /sys/class/power_supply/bq24150a-0/registers address 0x55 0x0A, divided by 2.

2.a In case of EDV1 flag being not available*, fallback to using 3150 mV as shutdown treeshold. Rationale: 3150 mV shouldn't cause GSM chip restarts on devices, where 3248 mV haven't caused it already.

It doesn't guarantee calibration, as it require 15 seconds *straight* below 3248 mV (EDV1 voltage), and 3150 mV might be just momentary low voltage spike. But, it is better than current implementation, which permits calibration *ever* - and, after all, it is just theoretical fallback for hyphotetical, non-existing kernel.

* theoretical possibility with custom kernels, that fullfill basic requiments, but don't feed all data - currently, no such kernel exist

---

  • Pali: Add two gconf values. First (bool) to enable shutdown device at EDV1 flag, second (int) to shutdown device at specified <= voltage. Default values: bool = true and int = 3150 (as suggested)

2. Battery applet showing wrong value for capacity

From the #maemo-ssu irclog:

[14:15] <kerio> 2) instead of showing wildly inaccurate data, it's preferrable to show nothing, or a message indicating that data is unavailable

[14:16] <kerio> 3) f[censored] rx51-battery, given 2) there's no reason whatsoever to use it (except the temperature thing, but that's for dsme and pulseaudio, not for the battery/charging)

[14:17] <kerio> 4) bq27200 is our lord, bq27200 is our ruler, bq27200 is our saviour - when calibrated, /everything/ should be grabbed from bq27200 and that's it - percentages, capacity (when full and at the moment)

  • Pali: add gconf value (int) for using maximal (design) capacity from rx51_battery in battery applet. 0 - never, 1 - when not calibrated, 2 - always. Default value 1.
  • Pali: What battery applet should show (as maximal capacity) when gconf value is 0 and battery is not calibrated?

3. bq27x00_battery sysfs node reports -ENODATA when not calibrated

It is a very serious problem, as CI flag (calibration needed) is set, when >32 charging cycles since last calibration. This result in dropping data, even if it is perfectly correct.

CI flag is set also, when battery isn't inserted into device for few minutes (in some devices, even few seconds).

In both cases, all scripts/programs that depends on those sysfsnodes breaks, due to "data read error". Also, -ENODATA is wrong, as in fact, chip report value for LMD (Last Measured Discharge) it is ILMD, default value of 2056 mAh. It should be provided by sysfs node, even, if not accurate - in any case, it's better than -ENODATA or "read error".

Proposed solutions

1. Fixing module, to always report value via sysfs node, as provided by hardware. Also, modifying those BME replacement bits, that require correct data, to watch for CI flag.

---

  • Pali: ...all scripts/programs that depends on those sysfsnodes breaks, due to "data read error". ... - bug in programs open/read syscall could fail and set some errno value (see manpages for read and open)
  • Pali: I do not want to touch kernel drivers in maemo 2.6.28 kernel - this is very old version. Also "registers" sysfs entry is deprecated and is not upstreamed. In upstream kernel there is "regmap" api for exporting all needed registers to userspace, but there is no patch yet... See https://lkml.org/lkml/2013/1/19/162 Problem that userspace application cannot read battery i2c registers directly can be fixed with flag I2C_SLAVE_FORCE see: https://lkml.org/lkml/2013/1/20/20
  • Pali: question what should power supply function return to power supply interface when data are/could be incorrect is for power supply kernel maintainer. TODO: add link for mailinglist (lkml) discussion about it.
  • Proposal from Kerio on this: hald-addon-bme should provide a way to know if bq27k is calibrated or not, and the battery applet should show a "(CI)" whenever it's not; battery.reporting.design should always come from rx51-battery, other data should always come from bq27k (with the implicit message that if it's uncalibrated, it might be inaccurate); the battery applet should have three modes: a mode where it does *the same thing as stock*, without showing anything at all (default for CSSU stable maybe?), a mode (default on CSSU testing, maybe?) where it prefers to calculate against the battery design reported by rx51-battery, and a mode where it calculates against the last full charge as reported by bq27k, regardless of calibration (but showing the CI indicator next to the charge/full charge report)