Git Product home page Git Product logo

ism-catcher's Introduction

ism-catcher

Munin plugin and other stuff for rtl_433.

Program to parse the output of rtl_433.
It's designed to work as Munin plugin.

Usage: ism-catcher [--config=<INI>] --live
       Parse JSON from STDIN, one dataset per line!

Usage: ism-catcher [--config=<INI>] --dump=<ID>
       Dump packets of binary database <ID>.

Usage: ism-catcher [--config=<INI>] --watch=[<ID>, ...]
       Follow mode for single or multiple <ID>'s.

Usage: ism-catcher [--config=<INI>] [{autoconf|config}]
       Execute Munin plugin with optional arguments.

=========================
 Supported ENV variables 
=========================

 * hostname = virtual hostname for munin
 * ini_file = path to configuration file

Hardware Requirements

  • 24/7 running GNU/Linux system with USB port
  • DVB-T dongle with compatible RTL2832(U) chipset
  • Compatible wireless sensor (e.g. THN128 or THR128)

Software Requirements

  • Munin master/node setup (+ Webserver for Munin output)
  • rtl_433 installation (and JSON-enabled device)
  • PHP โ‰ฅ 5.5 (with JSON support)

Data Aggregation

See: other-scripts/run.sh & other-scripts/legacy/rtl_433.sh

Examples for multiple (split or aggregated) graphs are available at the wiki.

Plugin Installation

# Setup INI file...
cp -vn config/sample.ini ~/.ism.ini
editor ~/.ism.ini

# Setup plugin configuration...
cp -vn plugin-conf.d/ism /etc/munin/plugin-conf.d/
editor /etc/munin/plugin-conf.d/ism

# Enable plugin...
ln -s /full/path/to/ism-catcher /etc/munin/plugins/ism

# Test plugin...
munin-run ism config
munin-run ism

# Restart daemon...
systemctl restart --no-block munin-node

ism-catcher's People

Contributors

killerbees19 avatar

Stargazers

 avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

ism-catcher's Issues

Cleanup broken

Something is wrong with the cleanup part:

[2017-06-02T02:22:49+02:00]      25.800 (0x0000)
[2017-06-02T02:22:50+02:00]      25.800 (0x0000)
[2017-06-02T02:23:19+02:00]      25.800 (0x0000)
[2017-06-02T02:23:20+02:00]      25.800 (0x0000)
[2017-06-02T02:23:50+02:00]      25.800 (0x0000)
[2017-06-02T02:23:50+02:00]      25.800 (0x0000)
[2017-06-02T02:24:20+02:00]      25.800 (0x0000)
[2017-06-02T02:24:20+02:00]      25.800 (0x0000)
[2017-06-02T02:25:19+02:00]      25.800 (0x0000)
[2017-06-02T02:25:20+02:00]      25.800 (0x0000)
[2017-06-02T02:26:20+02:00]      25.800 (0x0000)
[2017-06-02T02:26:20+02:00]      25.800 (0x0000)
[2017-06-02T02:26:50+02:00]      25.800 (0x0000)
[2017-06-02T02:26:50+02:00]      25.800 (0x0000)
[2017-06-02T02:27:19+02:00]      25.800 (0x0000)
[2017-06-02T02:27:20+02:00]      25.800 (0x0000)
[2017-06-02T02:27:49+02:00]      25.800 (0x0000)
[2017-06-02T02:27:50+02:00]      25.800 (0x0000)
[2017-06-02T02:28:20+02:00]      25.800 (0x0000)
[2017-06-02T02:28:20+02:00]      25.800 (0x0000)
[2017-06-02T02:28:50+02:00]      25.800 (0x0000)
[2017-06-02T02:28:50+02:00]      25.800 (0x0000)
[2017-06-02T02:29:20+02:00]      25.800 (0x0000)
[2017-06-02T02:29:20+02:00]      25.800 (0x0000)
[2017-06-02T02:29:49+02:00]      25.800 (0x0000)
[2017-06-02T02:29:50+02:00]      25.800 (0x0000)
[2017-06-02T02:30:20+02:00]      25.800 (0x0000)
[2017-06-02T02:30:20+02:00]      25.800 (0x0000)
[2017-06-02T02:30:50+02:00]      25.800 (0x0000)
[2017-06-02T02:30:50+02:00]      25.800 (0x0000)
[2017-06-02T02:31:20+02:00]      25.800 (0x0000)
[2017-06-02T02:31:49+02:00]      25.800 (0x0000)
[2017-06-02T02:31:50+02:00]      25.800 (0x0000)
[2017-06-02T02:32:50+02:00]      25.700 (0x0000)
[2017-06-02T02:32:50+02:00]      25.700 (0x0000)
[2017-06-02T02:33:20+02:00]      25.700 (0x0000)
[2017-06-02T02:33:20+02:00]      25.700 (0x0000)
[2017-06-02T02:33:50+02:00]      25.700 (0x0000)
[2017-06-02T02:33:50+02:00]      25.700 (0x0000)
[2017-06-02T02:34:50+02:00]      25.700 (0x0000)
[2017-06-02T02:34:50+02:00]      25.700 (0x0000)
[2017-06-02T02:35:20+02:00]      25.700 (0x0000)
[2017-06-02T02:35:20+02:00]      25.700 (0x0000)
[2017-06-02T02:35:50+02:00]      25.700 (0x0000)
[2017-06-02T02:35:50+02:00]      25.700 (0x0000)
[2017-06-02T02:36:19+02:00]      25.700 (0x0000)
[2017-06-02T02:36:20+02:00]      25.700 (0x0000)
[2017-06-02T02:36:49+02:00]      25.600 (0x0000)
[2017-06-02T02:37:20+02:00]      25.600 (0x0000)
[2017-06-02T02:37:20+02:00]      25.600 (0x0000)
[2017-06-02T02:37:50+02:00]      25.600 (0x0000)
[2017-06-02T02:37:50+02:00]      25.600 (0x0000)
[2017-06-02T02:38:20+02:00]      25.600 (0x0000)
[2017-06-02T02:38:20+02:00]      25.600 (0x0000)
[2017-06-02T02:38:49+02:00]      25.600 (0x0000)
[2017-06-02T02:38:50+02:00]      25.600 (0x0000)
[2017-06-02T02:39:20+02:00]      25.600 (0x0000)
[2017-06-02T02:39:20+02:00]      25.600 (0x0000)
[2017-06-02T02:39:50+02:00]      25.600 (0x0000)
[2017-06-02T02:39:50+02:00]      25.600 (0x0000)
[2017-06-02T02:40:20+02:00]      25.600 (0x0000)
[2017-06-02T02:40:20+02:00]      25.600 (0x0000)
[2017-06-02T02:40:49+02:00]      25.600 (0x0000)
[2017-06-02T02:40:50+02:00]      25.600 (0x0000)
[2017-06-02T02:41:50+02:00]      25.600 (0x0000)
[2017-06-02T02:41:50+02:00]      25.600 (0x0000)
[2017-06-02T02:42:20+02:00]      25.600 (0x0000)
[2017-06-02T02:42:20+02:00]      25.600 (0x0000)
[2017-06-02T02:42:50+02:00]      25.600 (0x0000)
[2017-06-02T02:42:50+02:00]      25.600 (0x0000)
[2017-06-02T02:43:19+02:00]      25.600 (0x0000)
[2017-06-02T02:43:20+02:00]      25.600 (0x0000)
[2017-06-02T02:44:20+02:00]      25.600 (0x0000)
[2017-06-02T02:44:20+02:00]      25.600 (0x0000)
[2017-06-02T02:44:50+02:00]      25.600 (0x0000)
[2017-06-02T02:45:19+02:00]      25.600 (0x0000)
[2017-06-02T02:45:20+02:00]      25.600 (0x0000)
[2017-06-02T02:45:49+02:00]      25.600 (0x0000)
[2017-06-02T02:45:50+02:00]      25.600 (0x0000)
[2017-06-02T02:46:20+02:00]      25.600 (0x0000)
[2017-06-02T02:46:20+02:00]      25.600 (0x0000)
[2017-06-02T02:47:20+02:00]      25.600 (0x0000)
[2017-06-02T02:47:20+02:00]      25.600 (0x0000)
[2017-06-02T02:47:49+02:00]      25.600 (0x0000)
[2017-06-02T02:47:50+02:00]      25.600 (0x0000)
[2017-06-02T02:48:20+02:00]      25.600 (0x0000)
[2017-06-02T02:48:20+02:00]      25.600 (0x0000)
[2017-06-02T02:48:50+02:00]      25.600 (0x0000)
[2017-06-02T02:48:50+02:00]      25.600 (0x0000)
[2017-06-02T02:49:20+02:00]      25.600 (0x0000)
[2017-06-02T02:49:20+02:00]      25.600 (0x0000)
[2017-06-02T02:49:49+02:00]      25.600 (0x0000)
[2017-06-02T02:49:50+02:00]      25.600 (0x0000)
[2017-06-02T02:50:19+02:00]      25.600 (0x0000)
[2017-06-02T02:50:20+02:00]      25.600 (0x0000)
[2017-06-02T02:51:20+02:00]      25.600 (0x0000)
[2017-06-02T02:51:20+02:00]      25.600 (0x0000)
[2017-06-02T02:51:50+02:00]      25.500 (0x0000)
[2017-06-02T02:51:50+02:00]      25.500 (0x0000)
[2017-06-02T02:52:19+02:00]      25.500 (0x0000)
[2017-06-17T16:29:22+02:00]      25.000 (0x0000)
[2017-06-17T16:29:52+02:00]      25.000 (0x0000)
[2017-06-17T16:29:52+02:00]      25.000 (0x0000)
[2017-06-17T16:30:52+02:00]      25.000 (0x0000)
[2017-06-17T16:31:52+02:00]      25.000 (0x0000)
[2017-06-17T16:31:52+02:00]      25.000 (0x0000)
[2017-06-17T16:32:22+02:00]      25.000 (0x0000)
[2017-06-17T16:32:22+02:00]      25.000 (0x0000)
[2017-06-17T16:32:52+02:00]      25.000 (0x0000)
[2017-06-17T16:32:52+02:00]      25.000 (0x0000)
[2017-06-17T16:33:22+02:00]      25.000 (0x0000)
[2017-06-17T16:33:22+02:00]      25.000 (0x0000)
[2017-06-17T16:34:22+02:00]      25.000 (0x0000)
[2017-06-17T16:34:22+02:00]      25.000 (0x0000)
[2017-06-17T16:35:22+02:00]      25.000 (0x0000)
[2017-06-17T16:35:22+02:00]      25.000 (0x0000)
[2017-06-17T16:35:52+02:00]      25.000 (0x0000)
[2017-06-17T16:35:52+02:00]      25.000 (0x0000)
[2017-06-17T16:36:22+02:00]      25.000 (0x0000)
[2017-06-17T16:36:22+02:00]      25.000 (0x0000)
[2017-06-17T16:36:52+02:00]      25.000 (0x0000)
[2017-06-17T16:36:52+02:00]      25.000 (0x0000)

(example dump from special sensor)

Follow/Watch mode for multiple DB's

$ ism-catcher --watch ch1,ch2,ch3

        CH1     CH2     CH3
18:01   25.0    24.9    25.5
18:02   25.1    25.0    25.4
18:03   25.1     -      25.3
18:04   25.1     -      25.2
18:05   25.2    25.1    25.2

[...]

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.