skyrc-mc3000-gui 1.5.1

Cross-platform GUI for SKYRC MC3000 battery charger

SKYRC MC3000 Battery Charger GUI

Cross-platform Python GUI for monitoring and controlling the SKYRC MC3000 battery charger.

Features

• Real-time monitoring of all 4 charging slots
• Voltage, current, capacity, temperature, resistance, power, energy display
• Slot configuration with battery type selection
• Profile management (save/load charging profiles)
• Charging graphs with history
• Backup and restore slot configurations
• Color-coded status indicators
• Cross-platform (Windows, macOS, Linux)

Screenshots

Real-time monitoring with voltage graphs during charging

Discharge curves during refresh/analyze mode

Installation

From PyPI

pip install skyrc-mc3000-gui

From Source

git clone https://github.com/nuclearcat/SkyRCMC3000-GUI.git
cd SkyRCMC3000-GUI
pip install .

Linux Dependencies

On Linux, you also need libhidapi:

# Debian/Ubuntu
sudo apt install libhidapi-hidraw0

# Fedora
sudo dnf install hidapi

# Arch
sudo pacman -S hidapi

Usage

Run the GUI

mc3000-gui

Or run directly from source:

python main.py

Command-line Tools

# Backup/restore tool
mc3000-backup --help

Linux USB Access

To access the MC3000 without root, create /etc/udev/rules.d/99-mc3000.rules:

SUBSYSTEM=="usb", ATTR{idVendor}=="0000", ATTR{idProduct}=="0001", MODE="0666"
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="0000", ATTRS{idProduct}=="0001", MODE="0666"

Then reload:

sudo udevadm control --reload-rules
sudo udevadm trigger

Documentation

• Protocol Documentation - MC3000 USB HID protocol details
• Protocol Notes - Additional protocol observations

Example Code

Reading Slot Data

from mc3000_usb import MC3000USB
from mc3000_protocol import parse_slot_data

# Connect to charger
usb = MC3000USB()
usb.connect()

# Get real-time data for slot 0
data = usb.get_slot_data(0)
if data:
    print(f"Voltage: {data.voltage_v:.3f} V")
    print(f"Current: {data.current_ma} mA")
    print(f"Capacity: {data.capacity_mah} mAh")
    print(f"Temperature: {data.temperature_c:.1f} C")

usb.disconnect()

Reading Slot Configuration

from mc3000_usb import MC3000USB

usb = MC3000USB()
usb.connect()

# Get settings for slot 0
settings = usb.get_slot_settings(0)
if settings:
    print(f"Battery Type: {settings.battery_type}")
    print(f"Capacity: {settings.capacity_mah} mAh")
    print(f"Charge Current: {settings.charge_current_ma} mA")

usb.disconnect()

Using Profiles

from mc3000_profiles import ProfileManager

pm = ProfileManager()

# List available profiles
for name in pm.list_profiles():
    print(f"Profile: {name}")

# Get a profile
profile = pm.get_profile("NiMH AA 2000mAh")

Development

Install Development Dependencies

pip install -e ".[dev]"

Run Tests

pytest

Known Limitations

• Starting after "Finished": When a slot completes charging, you may need to press a button on the charger to clear the finished state before starting a new operation via USB.
• See Protocol Notes for more details.

License

MIT License - see LICENSE for details.

Links

• GitHub Repository
• PyPI Package
• Issue Tracker

Acknowledgments

Protocol implementation based on GNU DataExplorer by Winfried Bruegmann.