Skip to main content

Testing status

A checklist of what has and hasn't been tested on real hardware. The first hub prototype was built from commit 1645733. The current design files include fixes for problems found on it, and that revision has not been built yet.

StatusMeaning
TestedWorked on the prototype.
Issue, fixed in designFailed or misbehaved on the prototype. The fix is in the current files but has not been tested on a board.
IssueMisbehaves, with no fix yet.
Not yet testedNo result yet.

Features not listed here have not been tested.

Last updated 2026-10-13 (copy bundled with the site).

Power and charging

FeatureStatusNotes
Power from USB-CTested
DC / solar inputNot yet tested
Source selection between USB-C and DCNot yet tested
Solar MPPTNot yet tested
Charging a batteryTestedReached fast charge from USB at about 470 mA with no thermistor fitted and ts_ignore: true set. Without that setting the charger suspends charging by default.
Charger status LEDTestedBlinks while charging is suspended. Too bright, so the series resistor was raised in the current design (untested).
Charger and input readings in Home AssistantTestedInput source, input voltage and fault status.
Reverse-polarity protectionIssue, fixed in designOn the prototype the protection FETs were mounted the wrong way round, so their body diodes would conduct on a reversed input. The current design turns them around. Do not connect a reversed supply to the prototype.
3.3 V system railTested
Switched user railTestedToggling it from Home Assistant powers the STEMMA QT port's device on and off.
Power Cycle Board (Home Assistant button)Tested
Ship mode, and waking with SW3TestedWorks on battery power alone. With USB connected it does nothing, as the charger ignores it while an adapter is present. A brief tap of SW3 does not wake the board; holding it does.
SW3 held about 10 s to hard power-cycleTestedThe board dropped off the API and reconnected.
Running on battery aloneNot yet testedBoard keeps running with USB unplugged; battery current and time to empty look sensible.
End of chargeTestedCharging stopped with "Charge terminated" at about 4.19 V, "Battery Fully Charged" turned on, and the gauge reported 100%.
Charge current settingNot yet testedMeasured current follows "Charge Current Limit". Check board temperature at higher currents.
Input current limitNot yet testedA low "Input Current Limit" caps the input current while charging.
Charger shutdown modeNot yet testedOn battery only, "Charger Shutdown" turns the board off and plugging in USB wakes it.
Charger temperature and thermal regulationNot yet tested"Charger Temperature" reads sensibly while charging.
Enable USB / Enable Solar Input switchesNot yet testedTurning one off drops the board to the other source or the battery.
Charger HIZ modeNot yet testedThe input stops supplying the board.
Charger status LED switchNot yet tested"Enable Charger Status LED" off turns the LED dark.
Reset Charger RegistersNot yet testedThe firmware restores its settings afterwards, including the charge voltage limit and the ship-FET setting.
Charger interrupt (CHG_INT)Not yet tested"Charger Interrupt" fires when USB is plugged or unplugged.

Fuel gauge

FeatureStatusNotes
Battery voltage and levelTestedWith a battery connected, after a driver fix for the state-of-charge reading.
Operation with no batteryIssue, fixed in designThe gauge blocked the internal I2C bus. It is now powered from the system rail.
Current-sense filterNot yet testedAdded in the current design.
Temperature readingIssueReads implausibly cold without a thermistor on its connector.
Learned capacity and calibrationNot yet testedRun the current and board offset calibrations with the pack at rest, and compare the gauge's battery current with the charger's.
Thermistors on J302 and J401Not yet testedBoth temperatures read sensibly, charging works with ts_ignore off, and the gauge stops reporting "Charge inhibited".
Fuel-gauge alert (FG_ALERT)Not yet testedAn alert such as low charge fires, and can wake the board from deep sleep.

Connectivity and programming

FeatureStatusNotes
Flashing over the native USB portIssue, fixed in designFailed until the charger's USB data-line links were removed. They are now unpopulated by default.
Boot-mode and reset buttonsTestedUsed to enter download mode for the first flash.
Debug UART headerNot yet tested
ESPHome, Wi-Fi and Home AssistantTested
Over-the-air updatesTested
Internal I2C bus (J6)TestedCharger and gauge, and devices on the STEMMA QT port.
User I2C bus (J203)TestedDevices on the STEMMA QT port.
Differential I2C jacks (J201, J202)TestedBoth jacks work with SparkFun QwiicBus EndPoint modules and the I2C devices attached to them.
SunSprout Satellite boardNot yet testedThe PCB is fabricated but not yet assembled. The same pattern has been tested with the off-the-shelf EndPoint it is based on.
Deep sleep and wakeTestedSleep current has not been measured.
Deep sleep currentNot yet testedBattery current while asleep.
Status LEDIssue, fixed in designToo bright, so the series resistor was raised (untested).
Expansion headers (J7, J8)Not yet testedUnfitted by default. Check a GPIO and the 3.3 V pins once fitted.
VCC_2 injection (J2)Not yet testedCut JP2/JP3, inject through J2, and confirm it reaches the far end of the cable.
Wi-Fi range on the external antennaNot yet testedSignal at the real install distance.