1. Manuals
  2. Brands
  3. SunFounder Manuals
  4. Computer Hardware
  5. PiPower
  6. Manual

SunFounder PiPower Manual

Hide thumbs Also See for PiPower:
Table of Contents

Advertisement

Quick Links

Download this manual
SunFounder PiPower
www.sunfounder.com
Aug 29, 2023

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the PiPower and is the answer not in the manual?

Questions and answers

Related Manuals for SunFounder PiPower

Summary of Contents for SunFounder PiPower

  • Page 1 SunFounder PiPower www.sunfounder.com Aug 29, 2023...

  • Page 3: Table Of Contents

    ........Which single-board computers can PiPower Pro be used on?
  • Page 5 About PiPower That’s why we designed PiPower in the first place. PiPower can be used as a second power source for the Raspberry Pi. A USB-C mains power supply plugged into the PiPower will directly power the Raspberry Pi and charge the battery at low current.
  • Page 6 When integrated with Home Assistant, users can easily access and review all parameter data, as well as configure automation for smart device scenarios. Additionally, PiPower Pro offers external IO interfaces for controlling the on/off state of sub-devices. With its open- source ESPHome configuration, users can customize IO functionalities and expand the system with more sensors.

  • Page 7: Component List

    CHAPTER COMPONENT LIST...
  • Page 8 SunFounder PiPower Chapter 1. Component List...

  • Page 9: Assemble The Pipower

    ASSEMBLE THE PIPOWER After getting familiar with the components in the package, we start to assemble PiPower. In the next steps, there are a lot of details you need to notice, especially the assembly position of the battery and the clear acrylic back cover.
  • Page 10 SunFounder PiPower 3. Bind the battery wires with a cable tie. 4. Now screw in four sets of standoffs. Chapter 2. Assemble the PiPower...
  • Page 11 SunFounder PiPower 5. Mount the Raspberry Pi on top.
  • Page 12 SunFounder PiPower 6. Secure a protective plate at the bottom. Chapter 2. Assemble the PiPower...
  • Page 13 SunFounder PiPower 7. Plug in the USB-C cable to power the Raspberry Pi.
  • Page 14 SunFounder PiPower 8. PiPower needs to be activated with the USB-C cable at the charge port the first time you use it or re-plug the battery Chapter 2. Assemble the PiPower...
  • Page 15 SunFounder PiPower Warning: When you put the battery in for the first time or when the battery is unplugged and put in again, the battery will not work properly, at this time, you need to plug the Type C cable into...
  • Page 16 SunFounder PiPower Chapter 2. Assemble the PiPower...

  • Page 17: Features

    CHAPTER THREE FEATURES • Pass Through Charging • Shutdown Current< 0.5mA • Input: – USB Type-C, 5V/3A – Battery Input • Output – USB Type-A, 5V/3A – 2x4P P2.54 pin headers • Charging Power5V/2A • Equipped Battery – Type: 3.7V Lithium-ion batteries x 2...

  • Page 18: Detailed Introduction

    USB Type C power, the ESP32 S2 will shut down completely. Switch Power Path PiPower Pro integrates a power path function that automatically switches power paths to ensure maximum output protection. 1. When external power is connected, the 5V output is directly supplied through the external USB Type C and can be turned off using the switch.
  • Page 19 Adjusted based on input voltage 1. When the switch is in the “Off” state, PiPower Pro does not supply power externally, and the charging current reaches a maximum of 2A, allowing for fast charging. The charging time from 0% to 100% is approximately 2 hours and 10 minutes.
  • Page 20 SunFounder PiPower You can connect your own battery using the Screw Terminal. The device only supports two 3.7V lithium-ion or lithium- polymer batteries. It’s preferable for the batteries to have a protection board and ensure an output of more than 15W.

  • Page 21: Battery Indicators

    SunFounder PiPower reaches the DC-DC protection temperature of 75 degrees Celsius, the DC-DC will shut down to prevent overheating damage. D8 LED The D8 LED is a charging status indicator provided by the IP2326 charging chip. Originally, this light was designed to indicate both the charging status and any abnormalities with the battery.
  • Page 22 SunFounder PiPower Chapter 3. Features...

  • Page 23: Start To Play

    CHAPTER FOUR START TO PLAY PiPower Pro can be integrated into Home Assistant. To do this, you need to have a Raspberry Pi with HassOS installed. Please follow the link below for setup. 4.1 Install the HassOS This section will guide you in installing the Home Assistant operating system on your Raspberry Pi. Please note that this process will result in the loss of all existing content on your Raspberry Pi system.
  • Page 24 SunFounder PiPower Step 3 Insert your SD card into the computer or laptop SD card slot. Step 4 In the Raspberry Pi Imager, select the OS that you want to install and the SD card you would like to install it on.
  • Page 25 SunFounder PiPower 4.1. Install the HassOS...
  • Page 26 SunFounder PiPower Step 5 Select the SD card you are using. Step 6 Click the WRITE button. Chapter 4. Start to Play...
  • Page 27 SunFounder PiPower Step 7 If your SD card currently has any files on it, you may wish to back up these files first to prevent you from permanently losing them. If there is no file to be backed up, click Yes.
  • Page 28 SunFounder PiPower Step 8 After waiting for a period of time, the following window will appear to represent the completion of writing. Chapter 4. Start to Play...
  • Page 29 SunFounder PiPower Step 9 Next, we will configure WiFi for Pironman. Note: If you intend to use a wired connection for network access, you can skip this step. Open File Explorer and access the SD card named Hassio-boot Create a new folder named CONFIG in the root partition.
  • Page 30 SunFounder PiPower Inside the network folder, create a new text file named my-network (without extension). In the my-network file, write the following text, replacing MY_SSID and MY_WLAN_SECRET_KEY with your own net- work’s SSID and password: [connection] id=my-network uuid=72111c67-4a5d-4d5c-925e-f8ee26efb3c3 type=802-11-wireless [802-11-wireless]...
  • Page 31 SunFounder PiPower Step 11 Next, you will be prompted to create the first account. 4.1. Install the HassOS...
  • Page 32 SunFounder PiPower The system will prompt you to install some detected devices, but for now, you can skip this by clicking FINISH. Chapter 4. Start to Play...

  • Page 33: Add Pipower Pro In Home Assistant

    Step 3 Configure the network for PiPower Pro. Search for Wi-Fi on your phone (or other device) and connect to PiPower Pro Fallback Hotspot. The password is 123456. 4.2. Add PiPower Pro in Home Assistant...
  • Page 34 SunFounder PiPower Chapter 4. Start to Play...
  • Page 35 SunFounder PiPower Step 4 Once connected, a configuration page will pop up on your phone. Complete the Wi-Fi configuration for PiPower here. 4.2. Add PiPower Pro in Home Assistant...
  • Page 36 SunFounder PiPower Chapter 4. Start to Play...
  • Page 37 SunFounder PiPower If the configuration page doesn’t automatically pop up, you can open a browser and visit pipower-pro.local. Step 5 Open your Home Assistant page, select Configuration from the left sidebar, then select Devices and Services. Step 6 Click on + ADD INTEGRATION at the bottom right.
  • Page 38 SunFounder PiPower Step 8 Enter pipower-pro.local and submit. Step 9 Choose an area for it and complete the setup. Chapter 4. Start to Play...

  • Page 39: Configure Dashboard

    SunFounder PiPower Step 10 You have now successfully added PiPower Pro. You can add the PiPower Pro configurations you need on the dashboard. 4.3 Configure Dashboard 1. On the Home Assistant page, click Overview on the left sidebar, which leads you to the control page.
  • Page 40 SunFounder PiPower 3. Click on the bottom right to add a card, select the desired card from the options, configure it as needed, then save. Chapter 4. Start to Play...

  • Page 41: Add Card By Code Editor

    1. After adding any card, you can manually edit the card’s yaml file. Click on SHOW CODE EDITOR on the card editing page. 2. Then directly modify the yaml file. We provide some useful PiPower Pro configurations. Please copy the follow- ing yaml code directly into the box.
  • Page 42 SunFounder PiPower Quick Overview Chapter 4. Start to Play...
  • Page 43 SunFounder PiPower type: vertical-stack cards: type: entities entities: entity: switch.pipower_pro_output_switch entity: sensor.pipower_pro_output_source entity: binary_sensor.pipower_pro_external_power entity: sensor.pipower_pro_battery_voltage entity: sensor.pipower_pro_output_voltage title: PiPower Pro show_header_toggle: true state_color: true square: true type: grid cards: type: gauge entity: sensor.pipower_pro_battery_current min: max: severity: green: yellow: red:...
  • Page 44 SunFounder PiPower (continued from previous page) name: Battery Current type: gauge entity: sensor.pipower_pro_output_current min: max: severity: green: yellow: red: needle: true name: Output Current type: gauge entity: sensor.pipower_pro_battery_level name: Battery Level min: max: severity: green: yellow: red: needle: true columns:...
  • Page 45 SunFounder PiPower (continued from previous page) columns: Output Information show_name: false show_icon: true show_state: true type: glance entities: entity: sensor.pipower_pro_output_voltage entity: sensor.pipower_pro_output_current entity: sensor.pipower_pro_output_power entity: sensor.pipower_pro_output_energy title: Output Battery Chart type: vertical-stack cards: type: markdown content: ## Battery square: true...
  • Page 46 SunFounder PiPower (continued from previous page) entity: sensor.pipower_pro_battery_current detail: name: Current hours_to_show: graph: line type: sensor entity: sensor.pipower_pro_battery_voltage detail: name: Voltage hours_to_show: graph: line type: sensor entity: sensor.pipower_pro_battery_power detail: name: Power Output Chart type: vertical-stack cards: type: markdown content: ## Output...
  • Page 47 SunFounder PiPower (continued from previous page) graph: line type: sensor entity: sensor.pipower_pro_output_power detail: name: Power Settings type: entities entities: entity: sensor.pipower_pro_input_voltage entity: sensor.pipower_pro_output_source entity: switch.pipower_pro_external_output entity: switch.pipower_pro_battery_output entity: switch.pipower_pro_esp32_power entity: binary_sensor.pipower_pro_sub_device_power_state entity: switch.pipower_pro_sub_device_power entity: sensor.pipower_pro_version entity: sensor.pipower_pro_battery_capacity_algorithm entity: button.pipower_pro_factory_reset title: Settings...

  • Page 48: Pipower Pro Entity

    (continued from previous page) state_color: true 4.5 PiPower Pro Entity If you are familiar with Home Assistant and want to customize the Card yourself, here is a list of PiPower Pro entities you can use. Basic Information • binary_sensor.pipower_pro_battery_low - Battery low status (bool) •...

  • Page 49: Setting Up Safe Shutdown

    Note: If the host running HassOS is set as a sub-device of PiPower Pro, it will also lose its functionality when the host shuts down, and remote power-on will not be possible.
  • Page 50 Raspberry Pi to shut down. Step 2 • Connect PiPower Pro’s pin 42 to the Raspberry Pi’s gpio-poweroff pin, here using pin 17. • Connect PiPower Pro’s pin 41 to the Raspberry Pi’s gpio-shutdown pin, here using pin 18.
  • Page 51 You can use the former to check if the Raspberry Pi is working and the latter to power off the Raspberry Pi. Note: PiPower-Pro Sub Device Power can only power off the Raspberry Pi. To power it on, you still need to supply power to the Raspberry Pi (i.e., turn on the main switch on the PiPower Pro Card).
  • Page 52 SunFounder PiPower 2. Create a new automation. Chapter 4. Start to Play...
  • Page 53 SunFounder PiPower 3. Click “Edit in YAML.” 4. Replace the existing code with the following code. alias: Safe shutdown RPi description: Turn off Raspberry Pi no external power plug in and battery␣ trigger: platform: state entity_id: binary_sensor.pipower_pro_external_power from: "on" (continues on next page)
  • Page 54 SunFounder PiPower (continued from previous page) "off" platform: numeric_state entity_id: sensor.pipower_pro_a03846_battery_level below: condition: condition: conditions: condition: state entity_id: binary_sensor.pipower_pro_a03846_external_power state: "off" condition: conditions: condition: state entity_id: switch.pipower_pro_sub_device_power state: "on" action: type: turn_off device_id: a0ee4e356c85c4f69f765ed72baad129 entity_id: switch.pipower_pro_sub_device_power domain: switch mode: single 5.
  • Page 55 SunFounder PiPower 7. Go back one level. Now you should see the newly set automation. Note: We need to create a few more automations. Refer to the previous steps to complete them all. Save Power alias: Save Power description: Turn off...
  • Page 56 SunFounder PiPower (continued from previous page) trigger: platform: state entity_id: binary_sensor.pipower_pro_sub_device_power_state from: "on" "off" condition: condition: state entity_id: switch.pipower_pro_sub_device_power state: "off" action: delay: hours: minutes: seconds: milliseconds: type: turn_off device_id: a0ee4e356c85c4f69f765ed72baad129 entity_id: switch.pipower_pro_a03846_power_switch domain: switch type: turn_off device_id: a0ee4e356c85c4f69f765ed72baad129 entity_id: switch.pipower_pro_a03846_esp32_power...
  • Page 57 SunFounder PiPower (continued from previous page) from: "off" "on" condition: [] action: type: turn_on device_id: a0ee4e356c85c4f69f765ed72baad129 entity_id: switch.pipower_pro_sub_device_power domain: switch mode: single Step 5 We use a simulated low-power state to trigger the test: 1. Open the SERVICES interface in Developer Tools.

  • Page 58: Coulomb Counter (Beta)

    You will see the PiPower battery light go off, and the battery level drop to 10% in the overview. The Raspberry Pi will then shut down, and 2 seconds after it completes the shutdown, the PiPower Pro will power off, and the PWR light will go off.

  • Page 59: Custom Development

    • 4 LEDs all off: 0%, batteries need to be charged. 4.8 Custom Development If you find that the basic functionality of PiPower Pro is not enough for your needs, you can perform custom development on PiPower Pro. All software for PiPower Pro is open source. Below is the basic tutorial and preparation for custom development.

  • Page 60: Multiple Pipower Pro Units

    Click “Install” in the upper right corner to install it on PiPower Pro. 4.9 Multiple PiPower Pro Units If you have multiple PiPower Pro units to use in the same Home Assistant environment, you need to modify the YAML settings. Add name_add_mac_suffix: true under “esphome.”...
  • Page 61 SunFounder PiPower Table 1: IO Expansion Functions Functions ADC,Touch,GPIO8 Ground ADC,Touch,GPIO9 GPIO10,Touch,ADC ADC,DAC,GPIO18 GPIO36 GPIO37 GPIO38 GPIO39 GPIO40 GPIO41 GPIO42 4.10. IO Expansion...
  • Page 62 SunFounder PiPower Chapter 4. Start to Play...

  • Page 63: Faq

    At this time, you need to plug the Type C cable into the charging port to release the protection circuit, and the battery can be used normally. 5.2 Which single-board computers can PiPower Pro be used on? PiPower Pro compatible single-board computers are shown below. Note: Functionally Compatible means that it can be powered by PiPower Pro normally.

Table of Contents