A module for the MagicMirror, to display data from FHEM devices.
JavaScript CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
.jscsrc
LICENSE
MMM-FHEM.css
MMM-FHEM.js
README.md
mockup.sketch
node_helper.js
package.json

README.md

Module: MMM-FHEM

This MagicMirror module, shows values like temperature/humidity of FHEM devices.

Magic-Mirror Module MMM-FHEM screenshot Magic-Mirror Module MMM-FHEM screenshot

Dependencies

Installation

Navigate into your MagicMirror's modules folder:

cd ~/MagicMirror/modules

Clone this repository:

git clone https://github.com/BenRoe/MMM-FHEM

Navigate to the new MMM-FHEM folder and install the node dependencies.

npm install

Configure the module in your config.js file.

Update the module

Navigate into the MMM-FHEM folder with cd ~/MagicMirror/modules/MMM-FHEM and get the latest code from Github with git pull.

If you haven't changed the modules, this should work without any problems. Type git status to see your changes, if there are any, you can reset them with git reset --hard. After that, git pull should be possible.

Using the module

To use this module, add it to the modules array in the config/config.js file:

modules: [
  {
    module: 'MMM-FHEM',
    position: 'bottom_bar',
    config: {
      host: 'localhost',
      port: '8083',
      https: false,
      devices: [
                  { deviceName: 'FhemDeviceName1',
                    deviceReadings: [
                                      { name: 'temperature', icon: 'wi wi-thermometer', suffix: '°' },
                                      { name: 'humidity', icon: 'wi wi-humidity', suffix: '%' },
                                    ],
                  },
                  { deviceName: 'FhemDeviceName2',
                    deviceReadings: [
                                      { name: 'temperature', icon: 'wi wi-thermometer', suffix: '°' },
                                      { name: 'battery', icon: 'fa fa-battery-half', suffix: '' },                                      
                                    ],
                  },
                ],
    },
  },
]

Configuration options

The following properties can be configured:

Option Description
host Hostname/IP of the FHEM Server. Is only necessary, if FHEM and Magic-Mirror is not on the same machine (Raspberry Pi).
Possible values: localhost or a IP
Default value: localhost
port FHEM Port
Possible values: any number
Default value: 8083
https If your FHEM use https
Possible values: true or false
Default value: false
devices Array of objects. Object for the different FHEM devices.

{ deviceName: 'FhemDeviceName1',
  deviceReadings: [
     { name: 'temperature', icon: 'wi wi-thermometer', suffix: '°' },
     { name: 'humidity', icon: 'wi wi-humidity', suffix: '%' },
  ],
},
deviceName: Go to the FHEM Web-UI, find the device under Unsorted or another room and find NAME under Internals.
deviceReadings: array of objects for the device readings you want to display.
name: Name of the Reading (Required)
icon: CSS class of an icon (Font-Awesome and Weather Icons are pre installed)
suffix: any string/text
initialLoadDelay The initial delay before loading. (Milliseconds)
Default value: 1000 (1 second)
updateInterval Content update interval in Milliseconds.
Possible values: 1000 (1 second) to 86400000 (24 hours)
Default value: 60000 (1 minute)