Unofficial Python API client for Pecron portable power stations. Query battery level, power input/output, switch states, and more from the Pecron cloud.

Disclaimer: This project is not affiliated with or endorsed by Pecron. It was reverse-engineered from the Pecron Android app for personal and home-automation use. Use at your own risk.

• Authenticate with the Pecron/Quectel cloud API (US, EU, CN regions)
• List all devices on your account
• Read live device properties: battery %, input/output wattage, AC/DC switches, UPS mode, charge/discharge time estimates, and more
• Control device outputs: turn AC and DC outputs on/off via the cloud API
• Discover device capabilities: query the TSL (Thing Specification Language) model to find all available properties and which are controllable
• CLI tool with human-readable and JSON output modes
• Clean Python API for integration into other projects (e.g. Home Assistant)

• Python 3.11+
• uv (recommended) or pip
• A Pecron account with at least one device bound

pip install unofficial-pecron-api

uv pip install unofficial-pecron-api

git clone https://github.com/jsightler/unofficial-pecron-api.git
cd unofficial-pecron-api
uv sync

The CLI is available as pecron after installation. With uv, prefix commands with uv run:

uv run pecron devices

# All devices
uv run pecron status

# A specific device (substring match on name)
uv run pecron status --device E300LFP

Example output:

  E300LFP_D469 (E300LFP) [Online]
    Firmware:       WIFI01R13A01_OCPU_QTH_MCU_1.0.3
    Battery:        [||||||||||||||||||||] 98%
    Input Power:    2 W
    Output Power:   145 W
    Switches:       AC=ON, DC=OFF, UPS=ON
    Time to Empty:  1h 58m
    AC Output:      145 W @ 124 V / 60 Hz
    AC Input:       2 W

Every command supports --json for machine-readable output:

uv run pecron status --json
uv run pecron devices --json

Turn AC or DC outputs on and off:

# Turn AC output on
uv run pecron set --ac on

# Turn DC output off for a specific device
uv run pecron set --dc off --device E300LFP

# Turn both AC and DC on at once
uv run pecron set --ac on --dc on

# Set an arbitrary property by TSL resource code
uv run pecron set --property ac_switch_hm --value true

Use the tsl command to see what properties your device supports:

# Show all properties
uv run pecron tsl

# Show only writable (controllable) properties
uv run pecron tsl --writable

Example output:

  E300LFP_D469 (E300LFP) - 2 writable properties:

    Code                           Name                 Type     Access
    ------------------------------ -------------------- -------- ------
    ac_switch_hm                   Ac switch            BOOL     RW
    dc_switch_hm                   Dc switch            BOOL     RW

For debugging or discovering new fields:

uv run pecron raw
uv run pecron raw --device E300LFP

Credentials can be provided three ways (in order of precedence):

1. Command-line flags:

   uv run pecron status --email user@example.com --password secret --region US

2. Environment variables:

   export PECRON_EMAIL="user@example.com"
   export PECRON_PASSWORD="secret"
   export PECRON_REGION="US"
   uv run pecron status

3. Interactive prompt (default if not provided above)

usage: pecron [-h] [-r {CN,EU,US}] [-e EMAIL] [-p PASSWORD] [-d NAME]
              [--json] [-v] [--version]
              {devices,status,set,tsl,raw} ...

Options:
  -r, --region {CN,EU,US}   Cloud region (default: US)
  -e, --email EMAIL          Account email
  -p, --password PASSWORD    Account password
  -d, --device NAME          Filter by device name (substring match)
  --json                     Output as JSON
  -v, --verbose              Increase verbosity (-v info, -vv debug)
  --version                  Show version

Commands:
  devices    List all devices on the account
  status     Show device properties (battery, power, switches)
  set        Control device outputs (--ac on/off, --dc on/off)
  tsl        Show device property definitions (--writable for controllable only)
  raw        Dump raw business attributes as JSON

from unofficial_pecron_api import PecronAPI

with PecronAPI(region="US") as api:
    api.login("user@example.com", "password")

    for device in api.get_devices():
        # Read device state
        props = api.get_device_properties(device)
        print(f"{device.device_name}: {props.battery_percentage}%")
        print(f"  Input: {props.total_input_power}W")
        print(f"  Output: {props.total_output_power}W")
        print(f"  AC: {'ON' if props.ac_switch else 'OFF'}")

        # Control outputs
        result = api.set_ac_output(device, enabled=True)
        print(f"  AC on: {'OK' if result.success else result.error_message}")

        result = api.set_dc_output(device, enabled=False)
        print(f"  DC off: {'OK' if result.success else result.error_message}")

        # Discover writable properties
        for prop in api.get_product_tsl(device):
            if prop.writable:
                print(f"  Writable: {prop.code} ({prop.data_type})")

PecronAPI(region="US") — Main client. Supports "US", "EU", "CN" regions.

Device — A bound device.

DeviceProperties — Live device state.

Use props.get_by_code("resource_code") to access any property not covered by the typed fields.

CommandResult — Result of a device command.

TslProperty — A device property definition from the TSL model.

The Pecron cloud API returns the same value for both remain_charging_time and remain_time (mapped to remain_discharging_time in this library). Both fields reflect the current device state:

• When discharging: both report time-to-empty
• When charging: both report time-to-full

Only one value is meaningful at a given time. You can infer which by checking power flow (e.g., total_input_power > total_output_power means charging).

This is a Pecron API/firmware bug, not a bug in this library — we parse exactly what the API provides. See #1 for details.

# Install with dev dependencies
uv sync --extra dev

# Run tests
uv run pytest

# Lint
uv run ruff check src/ tests/

MIT