Nota

¡Hola, bienvenido a la Comunidad de Entusiastas de SunFounder Raspberry Pi & Arduino & ESP32 en Facebook! Profundiza en Raspberry Pi, Arduino y ESP32 con otros entusiastas.

¿Por qué unirse?

  • Soporte experto: Resuelve problemas postventa y desafíos técnicos con la ayuda de nuestra comunidad y equipo.

  • Aprender y compartir: Intercambia consejos y tutoriales para mejorar tus habilidades.

  • Vistas previas exclusivas: Accede antes que nadie a nuevos anuncios de productos y avances.

  • Descuentos especiales: Disfruta de descuentos exclusivos en nuestros productos más nuevos.

  • Promociones festivas y sorteos: Participa en sorteos y promociones especiales.

👉 ¿Listo para explorar y crear con nosotros? Haz clic en [aquí] y únete hoy mismo!

Uso con Raspberry Pi

Descargar e Instalar el Módulo pipower3

Descarga el código desde GitHub e instálalo:

git clone https://github.com/sunfounder/pipower3

cd pipower3
sudo python3 install.py

Después de la instalación, se te pedirá reiniciar. Ingresa Y y presiona enter para reiniciar. Tras el reinicio, el servicio de apagado seguro se iniciará automáticamente. Si el botón se presiona durante 2 segundos o si la batería está baja, la Raspberry Pi se apagará y notificará a PiPower 3 que debe apagarse.

Configurar el Porcentaje de Apagado

PiPower 3 envía una solicitud de apagado «BAJA BATERÍA» a través de I2C al host cuando no hay alimentación externa y el voltaje de la batería cae por debajo del porcentaje de apagado. El host puede leer la señal de solicitud de apagado a través de I2C, y si se detecta «BAJA BATERÍA», puede procesar el apagado.

Después de apagarse, elevar el pin SDSIG apagará el PiPower. Esto implementa la función de apagado por baja batería de PiPower 3.

Nota

Si estás utilizando Raspberry Pi, si la potencia utilizada es superior a 3A, la batería no podrá mantener la energía por mucho tiempo. Se recomienda configurar el porcentaje de apagado al 100%, es decir, notificar a la Raspberry Pi para que se apague inmediatamente cuando se desconecte la alimentación externa, para proteger la Raspberry Pi y los datos.

Puedes configurar el porcentaje de apagado utilizando el siguiente comando, por ejemplo, configurarlo al 30%. Cuando el nivel de la batería esté por debajo del 30%, PiPower3 apagará la Raspberry Pi después de que se apague.

pipower3 -sp 30

Ver las Configuraciones Básicas

Puedes usar el comando pipower3 para ver la información actual, el tutorial de uso detallado es el siguiente:

usage: pipower3-service [-h] [-sp [SHUTDOWN_PERCENTAGE]] [-pp [POWER_OFF_PERCENTAGE]] [-so SHUTDOWN_OVERRIDE] [-iv] [-ov] [-bv] [-bp] [-bs] [-ii] [-ib] [-ic] [-ao] [-sr] [-bi]
                        [-psv] [-a]
                        [command]

PiPower 3

positional arguments:
command               Command

options:
-h, --help            show this help message and exit
-sp [SHUTDOWN_PERCENTAGE], --shutdown-percentage [SHUTDOWN_PERCENTAGE]
                        Set shutdown percentage, leave empty to read
-iv, --input-voltage  Read input voltage
-ov, --output-voltage
                        Read output voltage
-bv, --battery-voltage
                        Read battery voltage
-bp, --battery-percentage
                        Read battery percentage
-bs, --battery-source
                        Read battery source
-ii, --is-input-plugged_in
                        Read is input plugged in
-ic, --is-charging    Read is charging
-do, --default-on     Read default on
-sr, --shutdown-request
                        Read shutdown request
-a, --all             All

Configurar con Python

PiPower 3 utiliza la biblioteca spc, que te permite obtener datos y configurar parámetros en Python. La biblioteca spc se instala en un entorno virtual, por lo que primero necesitas entrar en dicho entorno.

source /opt/pipower3/venv/bin/activate

Si no deseas entrar en el entorno virtual, puedes reinstalar spc en el sistema, lo cual requiere confirmar con --break-system debido a posibles conflictos con otras bibliotecas:

sudo pip3 install --break-system git+http://github.com/sunfounder/spc.git

O si deseas instalarlo en tu propio entorno virtual, simplemente ejecuta el comando de instalación después de entrar en tu entorno virtual:

pip3 install git+http://github.com/sunfounder/spc.git

Ahora puedes ejecutar ejemplos:

cd ~/pipower3/examples

python3 read_all.py

  • read_all.py: Usa este ejemplo si necesitas leer todos los datos a la vez y procesarlos individualmente.

  • read_individual.py: Si solo necesitas leer ciertos datos, este ejemplo proporciona instrucciones para recuperar datos individuales.

  • set_shutdown_percentage.py: Este ejemplo enseña cómo configurar un porcentaje de batería para apagado, el cual envía una señal de apagado al host cuando no hay carga y la batería cae por debajo de este valor. Después de que el host se apaga, recibe una señal de apagado antes de apagarse. Típicamente usado con SBCs como Raspberry Pi. Los microcontroladores que necesiten usar esta función deben quitar el capuchón del puente SDSIG y conectar el cable intermedio a un pin. Después de recibir la señal de apagado y apagarse de manera segura, eleva este pin para apagar el PiPower 3.

  • shutdown_when_request: Este ejemplo muestra cómo manejar operaciones después de recibir una señal de apagado. Quita el capuchón del puente SDSIG y conecta el cable intermedio a un pin.

Documentación de la API de la Biblioteca Python:

https://github.com/sunfounder/spc?tab=readme-ov-file#api