Skip to content

README.md

Latest commit

 

History

History
88 lines (68 loc) · 3.24 KB

README.md

File metadata and controls

88 lines (68 loc) · 3.24 KB

Pace BMS Integration for Home Assistant

hacs_badge GitHub release License

A Home Assistant integration for Pace Battery Management Systems (BMS) via Modbus RTU over serial connection.

Features

  • 📊 Real-time Monitoring

    • Pack voltage, current, and state of charge (SOC)
    • Individual cell voltages (up to 8 cells)
    • Multiple temperature sensors (cell, MOSFET, environment)
    • Remaining and full capacity
    • Cycle count and state of health (SOH)

  • ⚡ Binary Sensors

    • Charging/Discharging status
    • MOSFET states
    • Dynamic icons based on state

  • 🔧 Configurable Protection Parameters

    • Overvoltage/Undervoltage protection (pack and cell level)
    • Overcurrent protection (charging and discharging)
    • Temperature protection (charging, discharging, MOSFET, environment)
    • Balance settings
    • All parameters adjustable via Home Assistant UI

  • 🛡️ Status Monitoring

    • Warning flags
    • Protection flags
    • Fault status
    • Cell balancing status

Requirements

  • Home Assistant 2023.1 or newer
  • Pace BMS connected via USB-to-RS485 or direct serial connection
  • Modbus RTU communication configured on BMS

Installation

HACS (Recommended)

  1. Make sure HACS is installed
  2. Add this repository as a custom repository in HACS:
    • Open HACS
    • Click on "Integrations"
    • Click the three dots in the top right corner
    • Select "Custom repositories"
    • Add https://github.com/OwlBawl/Pace-BMS as repository
    • Select "Integration" as category
    • Click "Add"
  3. Click "Install" on the Pace BMS integration
  4. Restart Home Assistant

Manual Installation

  1. Download the latest release from the releases page
  2. Extract the Pace-BMS folder to your custom_components directory
  3. Restart Home Assistant

Configuration

Adding the Integration

  1. Go to Settings → Devices & Services
  2. Click + Add Integration
  3. Search for "Pace BMS"
  4. Enter the configuration:
    • Name: Friendly name for your BMS (default: "Pace BMS")
    • Port: Serial port (e.g., /dev/ttyUSB0, /dev/ttyACM0)
    • Baudrate: Communication speed (default: 9600)
    • Slave ID: Modbus slave address (default: 1)

Finding Your Serial Port

Home Assistant OS -> Settings -> Hardware - All Hardware

Lovelace card example inculuded (change you device name prefix in entities)