A modern, local-polling integration to connect your Marstek CT Smart Meter with Home Assistant.

This integration brings your Marstek CT Meter into Home Assistant with a focus on ease of use and local control.

• 💻 UI Configuration: No YAML needed for setup! Add and configure your meter directly through the Home Assistant user interface.
• 📡 Local Polling: All data is fetched directly from your device via UDP on your local network. No cloud connection is required.
• 🏠 Automatic Device & Entities: Creates a device in Home Assistant and automatically adds all relevant sensors.
• 📊 Key Sensors: Provides sensors for Total Power, Phase A/B/C Power, and WLAN Signal Strength (RSSI).
• 🌐 Multi-Language Support: The setup process and sensor names will automatically use German if your Home Assistant is set to German, otherwise it defaults to English.

This is an independent, community-developed integration and is not officially affiliated with or endorsed by Marstek or Hame. It was created based on publicly available information and community research. Use at your own risk.

Before you can install and configure this integration, please ensure you have the following:

• Hardware:

  • A supported Marstek CT Smart Meter (tested with CT002 and CT003).
  • A local Wi-Fi network the meter is connected to.

• Home Assistant:

  • A working Home Assistant instance.
  • HACS (Home Assistant Community Store) installed.

• Required Information:

  • IP Address: The local IP Address of your CT meter.
  • Battery & CT Meter MAC: These are special 12-character MAC addresses found within the official Marstek mobile app under "Device Management".
    • Format: A 12-character hexadecimal string without colons or dashes.
    • Important: These are NOT the network MAC addresses that your router sees.
  • Device & CT Types: These are typically pre-filled correctly.
    • Device Type HMG-50: Corresponds to the Marstek Venus E 5.12.
    • CT Type HME-4: Corresponds to the CT002.
    • CT Type HME-3: Corresponds to the CT003.

Click the buttons below to add this integration to your Home Assistant instance.

After adding the repository, you need to install the integration.

1. Go to HACS > Integrations.
2. Search for "Marstek CT Meter" and click on it.
3. Click the DOWNLOAD button and wait for the installation to complete.
4. Restart Home Assistant when prompted.

After restarting, you can add and configure the integration.

This integration would not have been possible without the foundational work and protocol analysis by R. Weijnen.

• Original Research: rweijnen/marstek-venus-e-firmware-notes

If you encounter any issues or have suggestions for improvements, please open an issue on this GitHub repository. Contributions are always welcome!