TimerPWR Unit
The TimerPWR Unit is a timed power supply unit whose main functions are “charging & discharging + timed switching + screen display + boost output.” It features an internal STM32 microcontroller that implements RTC and overall control, allowing users to set automatic power on/off times as needed. It is powered via the Type-C interface and can be connected to an external rechargeable battery via a 1.25-2P interface. The unit includes a built-in battery charging circuit supporting a charging current of 330mA. It also features an integrated DCDC boost circuit that provides a 5V/800mA (1400mA @ 1C battery power) power output to external devices via the Grove port. Additionally, the INA3221 sensor is built-in, allowing real-time monitoring of power input and output current and voltage. The unit is equipped with a 0.66-inch OLED display and two side buttons for user interaction, making it easy to view real-time system status and modify settings. Users can set parameters such as power on/off using the side buttons or via the I2C bus through the Grove interface with I2C commands. This product is suitable for smart homes, industrial automation, and timed control devices.
Support the following products:
Micropython Example:
1# SPDX-FileCopyrightText: 2024 M5Stack Technology CO LTD 2# 3# SPDX-License-Identifier: MIT 4 5import os, sys, io 6import M5 7from M5 import * 8from unit import TimerPWRUnit 9from hardware import * 10 11 12label0 = None 13label1 = None 14label2 = None 15label3 = None 16label4 = None 17label5 = None 18label6 = None 19label7 = None 20label8 = None 21rect0 = None 22rect1 = None 23label10 = None 24rect2 = None 25rect3 = None 26label11 = None 27label12 = None 28label9 = None 29i2c0 = None 30timerpwr_0 = None 31 32 33en = None 34 35 36def timerpwr_0_btna_released_event(args): 37 global \ 38 label0, \ 39 label1, \ 40 label2, \ 41 label3, \ 42 label4, \ 43 label5, \ 44 label6, \ 45 label7, \ 46 label8, \ 47 rect0, \ 48 rect1, \ 49 label10, \ 50 rect2, \ 51 rect3, \ 52 label11, \ 53 label12, \ 54 label9, \ 55 i2c0, \ 56 timerpwr_0, \ 57 en 58 print(timerpwr_0.get_button_status(0)) 59 rect1.setColor(color=0x00FF00, fill_c=0x00FF00) 60 label11.setText(str("A")) 61 label11.setColor(0x00FF00, 0x00FF00) 62 63 64def timerpwr_0_btna_pressed_event(args): 65 global \ 66 label0, \ 67 label1, \ 68 label2, \ 69 label3, \ 70 label4, \ 71 label5, \ 72 label6, \ 73 label7, \ 74 label8, \ 75 rect0, \ 76 rect1, \ 77 label10, \ 78 rect2, \ 79 rect3, \ 80 label11, \ 81 label12, \ 82 label9, \ 83 i2c0, \ 84 timerpwr_0, \ 85 en 86 print(timerpwr_0.get_button_status(0)) 87 rect1.setColor(color=0xFF0000, fill_c=0xFF0000) 88 label11.setText(str("A")) 89 label11.setColor(0xFF0000, 0xFF0000) 90 91 92def timerpwr_0_btnb_released_event(args): 93 global \ 94 label0, \ 95 label1, \ 96 label2, \ 97 label3, \ 98 label4, \ 99 label5, \ 100 label6, \ 101 label7, \ 102 label8, \ 103 rect0, \ 104 rect1, \ 105 label10, \ 106 rect2, \ 107 rect3, \ 108 label11, \ 109 label12, \ 110 label9, \ 111 i2c0, \ 112 timerpwr_0, \ 113 en 114 print(timerpwr_0.get_button_status(1)) 115 rect2.setColor(color=0x00FF00, fill_c=0x00FF00) 116 label12.setText(str("B")) 117 label12.setColor(0x00FF00, 0x00FF00) 118 119 120def timerpwr_0_btnb_pressed_event(args): 121 global \ 122 label0, \ 123 label1, \ 124 label2, \ 125 label3, \ 126 label4, \ 127 label5, \ 128 label6, \ 129 label7, \ 130 label8, \ 131 rect0, \ 132 rect1, \ 133 label10, \ 134 rect2, \ 135 rect3, \ 136 label11, \ 137 label12, \ 138 label9, \ 139 i2c0, \ 140 timerpwr_0, \ 141 en 142 print(timerpwr_0.get_button_status(1)) 143 rect2.setColor(color=0xFF0000, fill_c=0xFF0000) 144 label12.setText(str("B")) 145 label12.setColor(0xFF0000, 0xFF0000) 146 147 148def timerpwr_0_usb_inserted_event(args): 149 global \ 150 label0, \ 151 label1, \ 152 label2, \ 153 label3, \ 154 label4, \ 155 label5, \ 156 label6, \ 157 label7, \ 158 label8, \ 159 rect0, \ 160 rect1, \ 161 label10, \ 162 rect2, \ 163 rect3, \ 164 label11, \ 165 label12, \ 166 label9, \ 167 i2c0, \ 168 timerpwr_0, \ 169 en 170 rect0.setColor(color=0x00FF00, fill_c=0x00FF00) 171 label10.setText(str("U")) 172 label10.setColor(0x00FF00, 0x00FF00) 173 174 175def timerpwr_0_usb_removed_event(args): 176 global \ 177 label0, \ 178 label1, \ 179 label2, \ 180 label3, \ 181 label4, \ 182 label5, \ 183 label6, \ 184 label7, \ 185 label8, \ 186 rect0, \ 187 rect1, \ 188 label10, \ 189 rect2, \ 190 rect3, \ 191 label11, \ 192 label12, \ 193 label9, \ 194 i2c0, \ 195 timerpwr_0, \ 196 en 197 rect0.setColor(color=0xFF0000, fill_c=0xFF0000) 198 label10.setText(str("U")) 199 label10.setColor(0xFF0000, 0xFF0000) 200 201 202def timerpwr_0_not_charging_event(args): 203 global \ 204 label0, \ 205 label1, \ 206 label2, \ 207 label3, \ 208 label4, \ 209 label5, \ 210 label6, \ 211 label7, \ 212 label8, \ 213 rect0, \ 214 rect1, \ 215 label10, \ 216 rect2, \ 217 rect3, \ 218 label11, \ 219 label12, \ 220 label9, \ 221 i2c0, \ 222 timerpwr_0, \ 223 en 224 rect3.setColor(color=0xFF0000, fill_c=0xFF0000) 225 label9.setText(str("C")) 226 label9.setColor(0xFF0000, 0xFF0000) 227 228 229def timerpwr_0_charging_event(args): 230 global \ 231 label0, \ 232 label1, \ 233 label2, \ 234 label3, \ 235 label4, \ 236 label5, \ 237 label6, \ 238 label7, \ 239 label8, \ 240 rect0, \ 241 rect1, \ 242 label10, \ 243 rect2, \ 244 rect3, \ 245 label11, \ 246 label12, \ 247 label9, \ 248 i2c0, \ 249 timerpwr_0, \ 250 en 251 rect3.setColor(color=0x00FF00, fill_c=0x00FF00) 252 label9.setText(str("C")) 253 label9.setColor(0x00FF00, 0x00FF00) 254 255 256def btnA_wasClicked_event(state): # noqa: N802 257 global \ 258 label0, \ 259 label1, \ 260 label2, \ 261 label3, \ 262 label4, \ 263 label5, \ 264 label6, \ 265 label7, \ 266 label8, \ 267 rect0, \ 268 rect1, \ 269 label10, \ 270 rect2, \ 271 rect3, \ 272 label11, \ 273 label12, \ 274 label9, \ 275 i2c0, \ 276 timerpwr_0, \ 277 en 278 timerpwr_0.sleep_cycle(0, 0, 30, 0, 0, 10) 279 280 281def setup(): 282 global \ 283 label0, \ 284 label1, \ 285 label2, \ 286 label3, \ 287 label4, \ 288 label5, \ 289 label6, \ 290 label7, \ 291 label8, \ 292 rect0, \ 293 rect1, \ 294 label10, \ 295 rect2, \ 296 rect3, \ 297 label11, \ 298 label12, \ 299 label9, \ 300 i2c0, \ 301 timerpwr_0, \ 302 en 303 304 M5.begin() 305 label0 = Widgets.Label("OUT", 13, 4, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu9) 306 label1 = Widgets.Label("label1", 9, 24, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu9) 307 label2 = Widgets.Label("label2", 9, 42, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu9) 308 label3 = Widgets.Label("BAT", 54, 4, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu9) 309 label4 = Widgets.Label("label4", 49, 24, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu9) 310 label5 = Widgets.Label("label5", 49, 42, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu9) 311 label6 = Widgets.Label("USB", 93, 4, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu9) 312 label7 = Widgets.Label("label7", 88, 24, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu9) 313 label8 = Widgets.Label("label8", 88, 42, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu9) 314 rect0 = Widgets.Rectangle(6, 98, 24, 24, 0x00FF00, 0x00FF00) 315 rect1 = Widgets.Rectangle(37, 98, 24, 24, 0x00FF00, 0x00FF00) 316 label10 = Widgets.Label("U", 13, 103, 1.0, 0xFFFFFF, 0x00FF00, Widgets.FONTS.DejaVu12) 317 rect2 = Widgets.Rectangle(67, 98, 24, 24, 0x00FF00, 0x00FF00) 318 rect3 = Widgets.Rectangle(97, 98, 24, 24, 0x00FF00, 0x00FF00) 319 label11 = Widgets.Label("A", 45, 103, 1.0, 0xFFFFFF, 0x00FF00, Widgets.FONTS.DejaVu12) 320 label12 = Widgets.Label("B", 75, 103, 1.0, 0xFFFFFF, 0x00FF00, Widgets.FONTS.DejaVu12) 321 label9 = Widgets.Label("C", 105, 103, 1.0, 0xFFFFFF, 0x00FF00, Widgets.FONTS.DejaVu12) 322 323 BtnA.setCallback(type=BtnA.CB_TYPE.WAS_CLICKED, cb=btnA_wasClicked_event) 324 325 i2c0 = I2C(0, scl=Pin(1), sda=Pin(2), freq=100000) 326 timerpwr_0 = TimerPWRUnit(i2c0, 0x56) 327 timerpwr_0.set_callback(timerpwr_0.EVENT_BUTTONA_RELEASED, timerpwr_0_btna_released_event) 328 timerpwr_0.set_callback(timerpwr_0.EVENT_BUTTONA_PRESSED, timerpwr_0_btna_pressed_event) 329 timerpwr_0.set_callback(timerpwr_0.EVENT_BUTTONB_RELEASED, timerpwr_0_btnb_released_event) 330 timerpwr_0.set_callback(timerpwr_0.EVENT_BUTTONB_PRESSED, timerpwr_0_btnb_pressed_event) 331 timerpwr_0.set_callback(timerpwr_0.EVENT_USB_INSERTED, timerpwr_0_usb_inserted_event) 332 timerpwr_0.set_callback(timerpwr_0.EVENT_USB_REMOVED, timerpwr_0_usb_removed_event) 333 timerpwr_0.set_callback(timerpwr_0.EVENT_NOT_CHARGING, timerpwr_0_not_charging_event) 334 timerpwr_0.set_callback(timerpwr_0.EVENT_CHARGING, timerpwr_0_charging_event) 335 en = True 336 timerpwr_0.set_wakeup_trigger(timerpwr_0.TRIG_ALL) 337 timerpwr_0.set_sleep_trigger(timerpwr_0.TRIG_ALL) 338 339 340def loop(): 341 global \ 342 label0, \ 343 label1, \ 344 label2, \ 345 label3, \ 346 label4, \ 347 label5, \ 348 label6, \ 349 label7, \ 350 label8, \ 351 rect0, \ 352 rect1, \ 353 label10, \ 354 rect2, \ 355 rect3, \ 356 label11, \ 357 label12, \ 358 label9, \ 359 i2c0, \ 360 timerpwr_0, \ 361 en 362 M5.update() 363 label1.setText(str(timerpwr_0.get_grove_voltage())) 364 label2.setText(str(timerpwr_0.get_battery_current())) 365 label4.setText(str(timerpwr_0.get_battery_voltage())) 366 label5.setText(str(timerpwr_0.get_battery_current())) 367 label7.setText(str(timerpwr_0.get_usb_voltage())) 368 label8.setText(str(timerpwr_0.get_usb_current())) 369 timerpwr_0.tick() 370 371 372if __name__ == "__main__": 373 try: 374 setup() 375 while True: 376 loop() 377 except (Exception, KeyboardInterrupt) as e: 378 try: 379 from utility import print_error_msg 380 381 print_error_msg(e) 382 except ImportError: 383 print("please update to latest firmware")
UIFLOW2 Example:
class TimerPWRUnit
Constructors
Methods
- TimerPWRUnit.get_firmware_version()
Get firmware version.
- Return (int):
Firmware version.
UIFLOW2:
- TimerPWRUnit.get_battery_voltage()
Get battery voltage.
- Return (int):
Battery voltage, in millivolt.
UIFLOW2:
- TimerPWRUnit.get_battery_current()
Get battery current.
- Return (int):
Battery current, in milliamperes.
UIFLOW2:
- TimerPWRUnit.get_usb_voltage()
Get USB voltage.
- Return (int):
USB voltage, in millivolt.
UIFLOW2:
- TimerPWRUnit.get_usb_current()
Get USB current.
- Return (int):
USB current, in milliamperes.
UIFLOW2:
- TimerPWRUnit.get_grove_voltage()
Get Grove voltage.
- Return (int):
Grove voltage, in millivolt.
UIFLOW2:
- TimerPWRUnit.get_grove_current()
Get Grove current.
- Return (int):
Grove current, in milliamperes.
UIFLOW2:
- TimerPWRUnit.is_charging()
Check if the battery is charging.
- Return (bool):
True if charging, False if not.
UIFLOW2:
- TimerPWRUnit.get_button_status(btn)
Get button status.
- Parameters:
btn (int) –
button index.
- Options:
A: 0B: 1
- Return (bool):
True if pressed, False if not.
UIFLOW2:
- TimerPWRUnit.save_data_to_flash()
Save data to flash.
UIFLOW2:
- TimerPWRUnit.get_grove_output_status()
Get Grove output status
- Return (bool):
True if enabled, False if disabled.
UIFLOW2:
- TimerPWRUnit.set_grove_output_status(enable)
Set Grove output status.
- Parameters:
enable (bool) –
Enable or disable Grove output.
- Options:
Enable: TrueDisable: False
UIFLOW2:
- TimerPWRUnit.get_oled_backlight_status()
Get OLED backlight status.
- Return (bool):
True if enabled, False if disabled.
UIFLOW2:
- TimerPWRUnit.set_oled_backlight_status(enable)
Set OLED backlight status.
- Parameters:
enable (bool) –
Enable or disable OLED backlight.
- Options:
Enable: TrueDisable: False
UIFLOW2:
- TimerPWRUnit.sleep_once(whours, wmintues, wseconds, shours, smintues, sseconds)
Set sleep once after hours, mintues, seconds and wake up in hours, mintues, seconds.
- Parameters:
UIFLOW2:
- TimerPWRUnit.set_power_on_time(hours, mintues, seconds)
Set power on time.
- TimerPWRUnit.set_power_off_time(hours, mintues, seconds)
Set power off time.
- TimerPWRUnit.sleep_cycle(whours, wmintues, wseconds, shours, smintues, sseconds)
Set sleep cycle after hours, mintues, seconds and wake up in hours, mintues, seconds.
- Parameters:
UIFLOW2:
- TimerPWRUnit.set_cycle_sleep(enable)
Set cycle sleep.
- Parameters:
enable (bool) –
Enable or disable cycle sleep.
- Options:
Enable: TrueDisable: False
- TimerPWRUnit.set_wakeup_trigger(trigger)
Set wake-up trigger.
- Parameters:
trigger –
Set wake-up trigger.
- Options:
ALL: timerpwrunit_0.TRIG_ALLTIMER: timerpwrunit_0.TRIG_TIMERBUTTON: timerpwrunit_0.TRIG_BUTTONNONE: timerpwrunit_0.TRIG_NONE
UIFLOW2:
- TimerPWRUnit.set_sleep_trigger(trigger)
Set sleep trigger.
- Parameters:
trigger –
Set sleep trigger.
- Options:
ALL: timerpwrunit_0.TRIG_ALLTIMER: timerpwrunit_0.TRIG_TIMERBUTTON: timerpwrunit_0.TRIG_BUTTONI2C: timerpwrunit_0.TRIG_I2CNONE: timerpwrunit_0.TRIG_NONE
UIFLOW2:
- TimerPWRUnit.set_callback(event, callback)
Set callback function.
- Parameters:
event –
event type.
- Options:
USB inserted: timerpwrunit_0.EVENT_USB_INSERTEDUSB removed: timerpwrunit_0.EVENT_USB_REMOVEDButton A pressed: timerpwrunit_0.EVENT_BUTTONA_PRESSEDButton A released: timerpwrunit_0.EVENT_BUTTONA_RELEASEDButton B pressed: timerpwrunit_0.EVENT_BUTTONB_PRESSEDButton B released: timerpwrunit_0.EVENT_BUTTONB_RELEASEDNot charging: timerpwrunit_0.EVENT_NOT_CHARGINGCharging: timerpwrunit_0.EVENT_CHARGING
callback – callback function.
UIFLOW2:
- TimerPWRUnit.tick()
Update status in loop.
UIFLOW2:
Constants
- TimerPWRUnit._SLEEP_COMMAND_REG
- TimerPWRUnit._CYCLE_REG
- TimerPWRUnit._GROVE_OUTPUT_REG
- TimerPWRUnit._OLED_BACKLIGHT_REG
- TimerPWRUnit._WAKE_UP_TRIGGER_REG
- TimerPWRUnit._SLEEP_TRIGGER_REG
- TimerPWRUnit._POWER_ON_TIME_REG
- TimerPWRUnit._POWER_OFF_TIME_REG
- TimerPWRUnit._BUTTON_STATUS_REG
- TimerPWRUnit._USB_VOLTAGE_REG
- TimerPWRUnit._USB_CURRENT_REG
- TimerPWRUnit._GROVE_VOLTAGE_REG
- TimerPWRUnit._GROVE_CURRENT_REG
- TimerPWRUnit._BATTERY_VOLTAGE_REG
- TimerPWRUnit._BATTERY_CURRENT_REG
- TimerPWRUnit._CHARGING_STATUS_REG
- TimerPWRUnit._SAVE_DATA_TO_FLASH_REG
- TimerPWRUnit._FW_VERSION_REG
- TimerPWRUnit._I2C_ADDRESS_REG
register address.
- TimerPWRUnit.TRIG_ALL
- TimerPWRUnit.TRIG_TIMER
- TimerPWRUnit.TRIG_BUTTON
- TimerPWRUnit.TRIG_I2C
- TimerPWRUnit.TRIG_NONE
trigger type.
- TimerPWRUnit.EVENT_USB_INSERTED
- TimerPWRUnit.EVENT_USB_REMOVED
- TimerPWRUnit.EVENT_BUTTONA_RELEASED
- TimerPWRUnit.EVENT_BUTTONA_PRESSED
- TimerPWRUnit.EVENT_BUTTONB_RELEASED
- TimerPWRUnit.EVENT_BUTTONB_PRESSED
- TimerPWRUnit.EVENT_NOT_CHARGING
- TimerPWRUnit.EVENT_CHARGING
event type.
- TimerPWRUnit._USB
- TimerPWRUnit._BUTTON_A
- TimerPWRUnit._BUTTON_B
- TimerPWRUnit._CHARGING
index.