Greekworm UPS Hat

And the UPS hat model?

EP-0118! It has to work… The question is how

Is this another manufacturer (not Geekworm)?

I understand that’s 52Pi. Their website has a different code for getting battery data. The component I sent will not work. It gets the data using a different algorithm.

Do you think it could work for x725?

Yes, I think so.

if somebody interested I’ve made it work for X708, but different approach using original scripts with altered, pure python smbus2 library.
Tested on HA dev 5.2 64 bit (needed for autoboot from SSD, X857 HAT)


  • I2C enabled
  • Installed smbus2, from ssh console: pip install smbus2
  • 2 scripts: and put in in /share folder


  - platform: rpi_gpio
    invert_logic: true
      6: UPSStatus
  - platform: command_line
    name: UPSBatteryVoltage
    unit_of_measurement: "V"
    command: python3 /share/
  - platform: command_line
    name: UPSBatteryCapacity
    unit_of_measurement: "%"
    command: python3 /share/

import struct
import sys
import time

from smbus2 import SMBus

def readVoltage(bus):
     address = 0x36
     read = bus.read_word_data(address, 2)
     swapped = struct.unpack("<H", struct.pack(">H", read))[0]
     voltage = swapped * 1.23 /1000/16
     return voltage

bus = SMBus(1) # 0 = /dev/i2c-0 (port I2C0), 1 = /dev/i2c-1 (port I2C1)
print ("%5.2f" % readVoltage(bus))

import struct
import sys
import time

from smbus2 import SMBus

def readCapacity(bus):
     address = 0x36
     read = bus.read_word_data(address, 4)
     swapped = struct.unpack("<H", struct.pack(">H", read))[0]
     capacity = swapped/256
     return capacity

bus = SMBus(1) # 0 = /dev/i2c-0 (port I2C0), 1 = /dev/i2c-1 (port I2C1)
print ("%5.2f" % readCapacity(bus))

Result (charging ongoing, changed voltage factor from original 1.25 to 1.23 based on multi-meter values to match)

Hi @rasterer, can this also work with Hassio?

1 Like

Ooooo, I am hoping this works. I have the X728 from Geekworm. Will give this a try.

I’m able to access the entities for capacity, voltage and status of the Geekworm X708 UPS.
Thanks @rasterer for for providing his instructions and scripts here:

My setup:

What I did:

  • Enabled I2C as described here:
  • Activated the advanced mode: Home Assistant > User > Advanced Mode
  • Installed the SSH & Web Terminal add-on: Home Assistant > Supervisor > Add-on Store
  • Installed smbus2 in the terminal: pip install smbus2
  • Created the files /share/ and /share/ provided by @rasterer.
  • Installed the File editor add-on: Home Assistant > Supervisor > Add-on Store
  • Added the configuration to the configuration.yaml file as defined by @rasterer.
  • Rebooted the Raspberry Pi 4 and the entities UPSBatteryCapacity, UPSBatteryVoltage and UPSStatus where listed and working.

Now it’ll be nice to know how to cleanly shutdown Home Assistant if the UPS sends the according signal. I’m sure it’s possible.

1 Like

Hi Beduir.
I’m too NOOB and I’m asking for help if you have a time for it…
1.Raspberry Pi 3B
2.Geekworm X750 -
Home Assistant OS 5.11

  1. I’ve editted file and replaced all “x720” letters with “x750”.
  2. Added files to custom_components directory.
  3. Editted configuration.yaml file and added
    • platform: x750
      name: ‘RPi Battery’

to the sensor section.
Edited and manifest.json file with the right address for Geekworm X750 section.
Made automations for notifying at 95% and shutdown at 35% (because the shutdown time is enough long - approximately 10 minutes; sometime longer…)
And everything with voltage and capacity is working.
But x750’s button isn’t working.
Is there a way to implement X750 software at
Added sudo trough SSH console.
But when I start the script the answer from the script is that there is no such file or directory for /etc/rc.local and for /home/pi/.
I’m trying to make implementation and because x750 is working after the RPi is shut downed from the automation ( I suppose there is no command from the Pi to switch off.)
Can you give me some advice, please?
Thank you in forward for time and support.

  1. I’ve editted file and replaced all “x720” letters with “x750”.

There was no need for that. It would work without changes.

Can you give me some advice, please?

Unfortunately, I don’t know if this is possible in HassOS.

1 Like

Hi again.
Anyway thanks for the time!
Will keep searching and trying.

1 Like

Hi! I tried your guide. It’s awsome, but i have some problems with reading values from batteries.

I’m running Home Assistant OS 5.13 64 bit on Rpi 4 / 4GB.

I2C is enabled.

smbus2 is probably installed ( i inserted rasbian and wrote down comand: pip install smbus2 - removed sd card plugged in ssd and turned on HA).

I pasted config into configuration.yaml and created two scripts (pasted into /share folder).

It is showing only UPSStatus /on/off.

Thanks for reply.


I did the same but I’m not able to get capacity and voltage from batteries.
How can I solve it? Could be caused by the batteries type? I’m using geekworm U100 module with 18650 batteries.

Thanks in advance


Just a quicky. Was someone able to find a case for both the RPI and X708 that fits ?


Were you able to get it to work ? And which case are you using ?

Yes it was working quite well. The only problem that I have was when restarting HA(not host; for example when making some HACS update) - the system loose the smbus communication and I have to restart the host to start working again (but I’m with RPi3B not RPi4). Maybe this is the problem.
I’m talking in past tense, because my Pi’s GPIO3 (SCL) port stop working(have tested - it’s not giving 3.3V anymore) and HA cannot communicate via smbus anymore. Have googling and there are written some ways to exchange the smbus port, but in my case I have to make totally new connector for X750(I’m with this UPS). And maybe is much better to buy new RPI3B.
For the case…
At AliExpress there are some cases wich can take X708 and RPI together. But you have to search exactly for your model of RPi and there are some limitations for some other plates.
There is my case but is DIY myself…:slight_smile:

It cost me about 1 month to make it, because I have no 3D printer and every wall of the box was hand made (from this box)
Anyway there are cases wich can handle X708 and RPi together, but not with mSATA module like in my configuration.
With hot (41C°) greeting from Bulgaria: Dik

  1. BGN 150.41 10%OFF | For Raspberry Pi 4, X857 V2.0 mSATA SSD Shield + X708 UPS & Power Mgnt Board + X857-C3 Case with Power Switch & Cooling Fan
  2. BGN 175.40 | Raspberry Pi 4B X873 V1.2 NVMe M.2 SSD Shield + X708 V1.2 UPS & Power Management Board + Matching Metal kit
  3. BGN 42.15 9%OFF | Geekworm Raspberry Pi X857-C3 Case for Raspberry Pi 4 & X857 V2.0/ X862 V2.0 & X735/ X708, X857-C3 Matching Case + Switch + Fan

Thank you for your suggestions. So I see you did some modifications to the installation procedure. Can you please outline what you did ? And what was the result ? I am considering buying but I need to know where I get myself into.

The modification is just one - replaced the model name from x720 to x750 at file. The effect from this is when I open lovelace to see x750 battery but not x720 battery. Nothing serious.
But for buying UPS module for RPi - I’m definitely :+1:
Because for safe shutdown and for backup electricity (if it’s stop suddenly) It’s worth it.
For the model - x708 and x720 are good enough. I’ve bought x750 because of 4 pc. of 18650 slots( for powering some other devices too - it gives 5V 8A totally)
RPi4 will consume 2A and you have 6A for other devices(in my case with RPi3 7A)