MMM-Pir

After a configured time without any user interaction the display will turn off and hide all modules for economy mode.
It will wake up with a Pir sensor or Touch screen

Screenshot

Installation

Minimal node version requirement: v20

Clone the module into your MagicMirror module folder and execute npm install in the module's directory.

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

This module will verify if all screen saver is disabled and disable it if needed

Configuration

To display the module insert it in the config.js file.

Personalized configuration

{
  module: 'MMM-Pir',
  position: 'top_left',
  config: {
    debug: false,
    delay: 2 * 60 * 1000,
    mode: 1,
    displayCounter: true,
    displayBar: true,
    displayStyle: "Text",
    displayLastPresence: true,
    lastPresenceTimeFormat: "LL H:mm",
    mode6_gpio: 20,
    mode6_clearGpioValue: true,
    xrandrForceRotation: "normal",
    wrandrForceRotation: "normal",
    wrandrForceMode: "1920x1080",
    touchMode: 3,
    pir_gpio: 21,
    pir_mode: 0,
  }
},

Detailed Configuration

• Available mode:

  • mode: 1 - use vgencmd (For raspbian 10/11)

  • mode: 2 - use dpms (For raspbian 10/11 or raspbian 12 with x11 compositor)

  • mode: 3 - use tvservice (For raspbian 10/11)

  • mode: 4 - use HDMI CEC

  • mode: 5 - use dpms (linux version for debian, ubuntu, ...)

  • mode: 6 - use a relay switch command controled by GPIO with python

  • mode: 7 - use a relay switch command controled by GPIO with python (read reverse values)

  • mode: 8 - use ddcutil (not yet documented)

  • mode: 9 - use xrandr use xrandr (For raspbian 11 or raspbian 12 with x11 compositor)

  • mode: 10 - use wlr-randr (For rapsbian 12 with wayland compositor)

  • mode: 0 - disabled mode

  • Available touchMode:

  • touchMode: 0

    • Touch mode is disabled

  • touchMode: 1

    • One click on the screen will restart the timer (or Wake up the screen if needed)
    • Double Click on the screen will shutdown the screen

  • touchMode: 2

    • One Click on the MMM-Pir area will restart the timer
    • Long Click on the screen will shutdown or wake up the screen (toogle)

  • touchMode: 3

    • One Click on the MMM-Pir area will restart the timer
    • Doucle Click on the MMM-Pir area will shutdown the screen
    • One Click on the screen will wake up if shutdown

  • Available pir_mode:

  • pir_mode: 0 - use onoff library (For Raspberry Pi 3b+ and 4 with Rapsbian 10/11)

  • pir_mode: 1 - use python script with RPI.GPIO library (For Raspberry Pi 3b+ and 4 with Raspbian 10/11)

  • pir_mode: 2 - use python script with gpiozero library (For Raspberry Pi 3b+, 5 (not tested on Raspberry Pi 4) with Raspbian 11/12)

  • Notes:

  • If you lock your screen with TouchScreen, PIR sensor will be disabled

  • You need to unlock your screen with touchscreen to reactivate the PIR sensor

Developer Notes

• This module broadcasts:

  • USER_PRESENCE with payload true when your screen turn on.
  • USER_PRESENCE with payload false when your screen turn off.

• This module receive:

  • MMM_PIR-END notification to force the end of the count down
  • MMM_PIR-WAKEUP notification to wake up the screen and reset count down
  • MMM_PIR-LOCK notification keep the screen on and lock it (freeze counter and stop pir detection)
  • MMM_PIR-UNLOCK notification unlock the screen and restart counter and pir detection
  • USER_PRESENCE with payload true or false like MMM_PIR-WAKEUP or MMM_PIR-END notification

Update

Manual update

In a terminal try this command:

cd ~/MagicMirror/modules/MMM-Pir
npm run update

Automatic Update from updatenotification default module

Since MagicMirror² v2.27.x, we are able to Update automaticaly any modules from updatenotification.
Let's add MMM-Pir rule

  {
    module: "updatenotification",
    position: "top_center",
    config: {
      updateAutorestart: true, // restart MagicMirror automaticaly after update
      updates: [
        // MMM-Pir rule
        {
          "MMM-Pir": "npm run update"
        },
      ]
    }
  },

Reinstall

For reinstall this module or when an update of MagicMirror² is available, you can use this command:

cd ~/MagicMirror/modules/MMM-Pir
npm run rebuild

Notes

• mode 1 works with bullseye OS (raspbian 11)
  ↪️ Just use dtoverlay=vc4-fkms-v3d driver in /boot/config.txt
• Pir Error detected: EINVAL: invalid argument, write: Means that pir_mode: 0 is not suported on your system (onoff [old] library)
  ↪️ Just try another pir_mode value (1 or 2)

Support

• Get assistance on bugsounet website