all repos — zion-terminal @ 66508a0a605214d34c7a2231848d44ee63b394b2

dotfiles

opt/zion-terminal/docs/bateria-e-energia.md (view raw)

 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
# Bateria e energia

## Situação neste hardware (Orange Pi CM4)

Auditoria de `/sys/class/power_supply/`, `hwmon` e I2C confirmou:

- **Não há telemetria de bateria/UPS/USB-C** — `/sys/class/power_supply/` está vazio
  (o CM4 não possui PMIC de bateria exposto). `i2c-tools` não está instalado.
- Sensores de hardware presentes: **2 zonas térmicas** + **ventoinha PWM** (`hwmon/pwm-fan`).
  Nenhum sensor de tensão/corrente.

Por isso o ZION **não inventa** dados de bateria. Onde faria sentido, mostra:
`Bateria: telemetria indisponível`. O `zion saude` expõe o estado real da **ventoinha**
(PWM), quando legível.

## Como adicionar telemetria real no futuro

Para medir energia de verdade, adicione hardware por I²C e habilite `i2c-tools`:

- **INA219/INA226** (medidor de tensão/corrente) no barramento I²C.
- Um **UPS HAT** com controlador I²C (vários expõem capacidade/tensão em `/sys` ou via lib).

Depois de instalar (`sudo apt install i2c-tools`, `i2cdetect -y <bus>`), a leitura pode
ser integrada a `zion status`, `zion saude`, ao MOTD e ao `zion modo campo`.

Nunca controle carregamento/GPIO sem identificar o hardware com certeza.