Git Product home page Git Product logo

mmm-fhem's Introduction

Module: MMM-FHEM

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

🔴 This repository is no longer maintained.

If you are interested to maintain this project, please contact me and i will add you to this repository.

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)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.