.. note:: ¡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 [|link_sf_facebook|] y únete hoy mismo! Uso con Raspberry Pi ======================== Descargar e Instalar el Módulo ``pipower3`` ---------------------------------------------------- Descarga el código desde GitHub e instálalo: .. code-block:: shell 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. .. note:: 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. .. code-block:: shell 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: .. code-block:: 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. .. code-block:: shell 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: .. code-block:: shell 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: .. code-block:: shell pip3 install git+http://github.com/sunfounder/spc.git Ahora puedes ejecutar ejemplos: .. code-block:: shell cd ~/pipower3/examples .. code-block:: shell 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