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 [qui] 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 reiniciar, el servicio de apagado seguro comenzará automáticamente. Si se presiona el botón durante 2 segundos o si la batería está baja, la Raspberry Pi se apagará y notificará a PiPower 3 para que apague la alimentación.
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 SDSIG apagará el PiPower. Esto implementa la función de apagado por baja batería de PiPower 3.
Nota
Si usas una Raspberry Pi, si la potencia utilizada es mayor a 3A, la batería no podrá mantener la alimentación durante mucho tiempo. Se recomienda configurar el porcentaje de apagado a 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 usando el comando, por ejemplo, configurándolo al 30%. Cuando el nivel de la batería esté por debajo del 30%, PiPower3 apagará la Raspberry Pi después de que esta 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 usa la biblioteca spc, que te permite obtener datos y establecer parámetros en Python. La biblioteca spc se instala en un entorno virtual, por lo que primero necesitas ingresar al entorno virtual.
source /opt/pipower3/venv/bin/activate
Si no deseas ingresar al entorno virtual, puedes reinstalar spc en el sistema, lo cual debe ser confirmado con --break-system debido a posibles conflictos con otras bibliotecas:
sudo pip3 install --break-system git+http://github.com/sunfounder/spc.git
O si prefieres instalarla en tu propio entorno virtual, simplemente ejecuta el comando de instalación después de ingresar a 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 establecer 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 apague, recibe una señal de apagado antes de apagarse completamente. Típicamente utilizado con SBCs como Raspberry Pi. Los microcontroladores que necesiten usar esta función deben retirar 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 PiPower 3.shutdown_when_request: Este ejemplo muestra cómo manejar las operaciones después de recibir una señal de apagado. Retira el capuchón del puente SDSIG y conecta el cable intermedio a un pin.
Documentación de la API de la Biblioteca Python: