Skip to content

Repository files navigation

MMM-MyHomeWizard

This a module for Magic Mirror² smart mirror project.
This modules is for use with the HomeWizard P1 meter and WaterMeter.

Currently this module uses the V1 API from HomeWizard.

SCR-20260228-ogwt
SCR-20260228-plnq

Enable the Local API

For MMM-MyHomeWizard to get access to the data from an Energy device, you have to enable the API for each device.
You can do this in the HomeWizard Energy app.

Go to Settings > Meters > ''Your meter'', and enable Local API for the P1 Meter and/or the Water Meter at the botom of the page.

Installation

Clone this repository in your modules folder, and install dependencies:

cd ~/MagicMirror/modules 
git clone https://github.com/htilburgs/MMM-MyHomeWizard.git
cd MMM-MyHomeWizard
npm install 

Update

When you need to update this module:

cd ~/MagicMirror/modules/MMM-MyHomeWizard
git pull
npm install

Configuration

Go to the MagicMirror/config directory and edit the config.js file. Add the module to your modules array in your config.js.

{
  module: 'MMM-MyHomeWizard',
  position: 'top_left',
  header: 'HomeWizard',
  disabled: false,
  config: {
		// Replace these with your actual meter IPs
		P1_IP: "0.0.0.0",	    	// IP Address HomeWizard P1 meter
		WM_IP: "0.0.0.0",	    	// IP Address HomeWizrd Water meter - Remove line when not used

		// Timing & update
		updateInterval: 5000,   	// Update every 5 seconds
 		maxWidth: "500px",			// Max width of the module

		// Display settings
		extraInfo: true,          	// show wifi & power fail info
        showFooter: true,        	// show meter model in footer
		showGas: true,            	// display gas usage
		showFeedback: true,       	// display feed back to grid
		showLastUpdate: true,     	// display the last update for the history data in the footer
		currentPower: true,       	// show current power usage
		currentWater: false,       	// show current water usage
		currentVoltage: true,     	// compact 3-fase, auto detection

		// Deltaws
        showDeltaPower: true,		// Show Delta between History and Current data (Power)
        showDeltaGas: true,			// Show Delta between History and Current data (Gas)
        showDeltaWater: false		// Show Delta between History and Current data (Water)
  		}
},

image
The Delta values needs 2 days in history_data.json, so this option will first show after 2 days.
So this is not a bug, but as designed!

Explanation

Total Power is the sum of Power usage from T1 and T2 (peak and off-peak rate)
Current Power is the current Power usage (Watt)
Total Feedback is the Total Feedback to the grid today (kWH)
Voltage is the current 3-phase Voltage usage (V) with autodetection if it is only 1-phase
Total Gas is the total of Gas usage (m³)
Current Water is the current Water usage (Liters per minute)
Total Water is the total Water usage (m³)
Power Failures are the number of power failures detected by the P1 meter
WiFi P1 / Water meter is the current WiFi Strenght

Module configuration

Here is the documentation of options for the modules configuration

Option Description
P1_IP REQUIRED if use P1 meter
The IP Address of your HomeWizard P1 meter

Number
Default: 0.0.0.0
WM_IP REQUIRED if use Water meter
The IP Address of your HomeWizard Water meter

Number
Default: 0.0.0.0

If you don't have a Water Meter, remove this line! or you get an error "Water Meter offline"
updateInterval REQUIRED - The interval the information is updated (in milliseconds)

Number
Default: 5000
extraInfo Show extra information from P1 meter

True/False
Default: true
currentPower Show the current power consumption

True/False
Default: true
currentWater Show the current water consumption

True/False
Default: false
currentVoltage Show the current 3-phase consumption

True/False
Default: true
showGas Show the Gas Option of youre PowerMeter

True/False
Default: true
showFooter Show the Footer with the name of youre PowerMeter

True/False
Default: true
showLastUpdate Show last update of the "history_data.json" file as footer

True/False
Default: true
showDeltaPower Show Delta between History and Current data (Power)

True/False
Default: true
showDeltaGas Show Delta between History and Current data (Gas)

True/False
Default: true
showDeltaWater Show Delta between History and Current data (Water)

True/False
Default: false

Versions

v2.0.1 (28-02-2026)

  • Add option currentVoltage for 3-phase usage

v2.0.0 (22-01-2026)

  • Update with daily saving data to history_data and option for show Deltas

v1.0.1 (29-12-2024)

  • Add option ShowGas

v1.0.0 (26-11-2024-: Initial version)

License

The MIT License (MIT)

Copyright © 2024 Harm Tilburgs

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

The software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.

About

MagicMirror module HomeWizard

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages