[APP][Pro] Marstek Solar Battery - Committed to providing affordable clean energy products to every family

I present my app for managing the B2500 from Marstek.

Here is the link to the test version:

Requirements

For Bluetooth (BLE):

  • A Homey with BLE support, or a supported Homey Bridge satellite, within Bluetooth range of your B2500.
  • Disconnect HMJS and the Marstek app before connecting through Homey.
  • No MQTT broker is required.

For MQTT:

  • An MQTT broker reachable by both Homey and your B2500.
  • A B2500 configured to exchange status updates and commands through that broker.
  • The broker address, port and authentication details, if required.
  • Your battery’s hardware/protocol version and 12-character MAC address without separators.

BLE operation has been tested with the HMJ-2 running firmware 116.6. Other supported B2500 variants still require hardware verification.

Setup

Bluetooth (BLE):

  1. Install the app.
  2. Add Marstek B2500 (BLE) in Homey.
  3. Scan for nearby batteries and select your B2500. The app reads its identity automatically.
  4. The battery and its PV companion are added together.

After pairing, the battery’s Repair screen can optionally configure Wi-Fi and MQTT. These changes require confirmation and may replace the battery’s existing network or cloud connection.

MQTT:

  1. Configure your B2500 to use your MQTT broker. You can use an external configuration tool or this app’s BLE network configuration.
  2. Enter the broker details in the Homey app settings and restart the app after saving.
  3. Add Marstek B2500 (MQTT). Select the hardware/protocol version and enter the MAC address, available in the Marstek app’s device information.
  4. The app checks the matching MQTT topics and requests a response to identify the battery.
  5. The battery and its PV companion are added together.

Separate PV drivers remain available for adding a missing companion.

Avoid controlling the same battery through both transports simultaneously. Adding both can also double-count energy.

Usage

Monitor battery charge, output power, temperatures and device status in Homey.

Power control and schedules

Set the discharge target from -800 to 0 W. Negative values represent discharging and enable Homey control. Actual output depends on the connected inverter, output ports, charging mode and battery protections.

Homey reserves the last schedule slot: slot 5, or slot 3 on BLE devices reporting three slots. The Homey schedule applies from 06:00 to 22:00, according to the battery’s clock.

Before taking control, the app backs up the user schedules. BLE also backs up the adaptive mode. User slots are disabled during Homey control.

Switching back to device control, or setting the target to 0 W, restores the saved configuration. This does not necessarily stop output: restored schedules may request power.

Edit user schedules through the battery’s Repair screen. Switch to device control first. The last slot remains reserved for Homey.

Charging mode

Select the charging mode directly on the battery device or through the “Set charging mode” Flow action:

  • V2: simultaneous charging/discharging, or charge first and then discharge.
  • V1: mode 0 enables PV2 pass-through instead of simultaneous charging/discharging.

Homey power control does not automatically change the charging mode.

Depth of discharge

Adjust DoD using the 0–100% slider or “Set depth of discharge” Flow action. A DoD of 90% leaves 10% reserve.

MQTT V2 changes to DoD and charging mode are not stored in flash and may be lost after a battery restart.

BLE setting changes are stored in flash and limited to one modifying transaction per minute. Unchanged settings are skipped, and writes are checked through readback. Use MQTT for frequent power regulation.

Solar monitoring

Use the PV companion for solar measurements and solar-power Flow triggers.

For BLE, configure the shared polling interval on the battery device. Its interval also applies to the matching PV companion.

Connection and data freshness

Missing measurements are not treated as zero. If communication fails or data becomes stale, devices can become unavailable while retaining their last known readings. A successful refresh restores availability.

Check availability before relying on readings in automations. How Homey Energy handles retained readings during outages still requires hardware verification.

Energy dashboard

The battery and PV devices expose different measurements. Configure Homey Energy to match your installation and avoid double-counting, especially if the same battery is paired through both MQTT and BLE.

Energy mapping, including direct PV pass-through, still requires verification against real-world measurements.