feat(power): add battery monitoring and status overlays

This commit is contained in:
chenjintao
2026-08-18 11:53:14 +08:00
parent 609fe978f1
commit 8f8254b397
31 changed files with 1655 additions and 22 deletions
+6 -5
View File
@@ -1,8 +1,9 @@
# ESP32-S3 GPIO Map
This document defines the reference GPIO assignments for the ESP32-S3 board
from `SCH_招财猫0.3&商界0.2_2026-07-24.pdf`. Signal direction is described from
the MCU's perspective.
This document defines the active firmware GPIO assignments for the current
battery-sensing ESP32-S3 board revision. Signal direction is described from the
MCU's perspective. Older 2026-07-24 drawings assigned GPIO9 to a legacy power
hold net; that assignment is not valid for the current board.
## GPIO Table
@@ -24,8 +25,8 @@ the MCU's perspective.
| 14 | GPIO20 | ESP_D_P | Bidirectional | USB D+ | Type-C |
| 15 | GPIO3 | touch | Input | TTP223 touch-button output | Present on the board but not consumed by the current input policy |
| 16 | GPIO46 | UNASSIGNED | N/A | No connection assigned | Reserved; no signal assigned |
| 17 | GPIO9 | Power | Output | Board power hold | Active high |
| 18 | GPIO10 | Charge | Input | Charger status | Not consumed by current firmware |
| 17 | GPIO9 | Power_t | Analog input | Battery voltage sense | R17=100 kOhm from VBAT and R18=100 kOhm to GND; ADC voltage is one half of VBAT |
| 18 | GPIO10 | Charge | Input | TP4057 charger status | Active-low while charging; high means full or external power absent |
| 19 | GPIO11 | PA_CTRL | Output | Audio power-amplifier enable | Amplifier control |
| 20 | GPIO12 | SW1 | Input | Button 1 / turntable calibration switch | External 10 kOhm pull-up; active low |
| 21 | GPIO13 | SW2 | Input | Button 2 / K2 push-to-talk input | External 10 kOhm pull-up; active low |