A fast MQTT dashboard application and rule engine framework written in C for Linux, Raspberry Pi and WINDOWS.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
kollo d19d478e41 Merge pull request 'mention libpaho-mqtt-dev included in recent debian/ubuntu releases' (#12) from ashimokawa/MQTT-Hyperdash:paho-mqtt-readme into master 2 weeks ago
bitmaps Add default bitmap/icon. 2 years ago
dashboards Update Makefile et al. for WINDOWS version (incl. gtk2) 8 months ago
doc Update Automation concept 8 months ago
etc Added build command for inoffical paho deb packet 9 months ago
icons New Logo 11 months ago
screenshots Added a (generic) dashboard tree for the $SYS topics. 2 years ago
src fix linker error 2 weeks ago
CONTRIBUTING.md Update Readme + Contribution guide 11 months ago
COPYING initial commit (with the concept only) 2 years ago
README.md Update 'README.md' 2 weeks ago
RELEASE_NOTES Update Makefile et al. for WINDOWS version (incl. gtk2) 8 months ago

README.md

MQTT-Hyperdash

MQTT-Hyperdash

(C) 2019-2021 by Markus Hoffmann

A universal MQTT dashboard and rule engine framework.

Version     : 1.03
License     : GPLv2
Description :

MQTT-Hyperdash is a fast and efficient dashboard (GUI) for the MQTT framework. It uses the SDL library for graphics rendering, the paho.mqtt.c library for communication and the gtk2 framework for user input. The dashboard runs on Linux, but a port to other operating systems is possible.

Special features:

* Very simple and basic set of base elements. 
* animated analog input elements, potentiometers.
* Fast update rates of 20 Hz are possible.
* Easy to use: Each panel/dashboard is configured in a single .dash file.

This repository contains following set of applications:

hyperdash

hyperdash runs a panel/dashboard, which has been defined in a dash file. It opens a window, draws all elements, updates with each new topic message and takes user input with the mouse to manipulate topics contents.

Smart Home Dashboard

A description of the dash file format can be found in the doc/ section.

dashdesign (HyperDash Dashboard Designer)

Dashdesign is a graphical tool to create and edit the .dash files.

A brief explanation how to use dashdesign is in its man-page dashdesign man-page.

The usage with the graphical interface should be more or less self-explanatory. But maybe you want to have a look at its user manual.

hddashgen (HyperDash Dashboard-Generator)

Making dashboard files by hand with a text editor can be a lot of annoying manual work. To help this, there is the tool hddashgen to automatically create dash files from topic lists, so one has a good starting point to work with. hddashgen will do this job in combination with mqtt-list-topics (see below).

The default appearance is derived from the topics names, if they follow a naming convention. The naming convention used is explained in Dashgen Naming Conventions.

A brief explanation how to use hddashgen is in its man-page hddashgen man-page.

mqtt-list-topics

A tool to connect to a mqtt broker and list all topics available there to stdout.

mqtt-list-topics also performs a brief analysis on the topics content to classify the topic into binary, string, number, and integer. This classification is not perfect, since it is based on a single payload value only, but it can help making automatic dashboards for MQTT-Hyperdash.

A good starting point for the usage of mqtt-list-topics is its man-page mqtt-list-topics man-page.

rule-engine sysmeasure and syslogger

Rule engines are meant to be applications running completely in the background. They do not interact directly with user. Their function is to subscribe to a set of topics, watch their updates and trigger a routine, which calculates something based on the input topics and finally publish the result to output topics, which then can trigger other rules or rule engines. They also can perform actions on the machine they are running, like executing shell scripts when a topic content matches a certain pattern, or perform measurements by accessing local hardware components and publish the results to the mqtt network.

With multiple rule engines running even on different computers using the same broker, one can implement a full automation control, which would create the Internet of Things.

The concept of rule engines is not new and can be found in other automation concepts as well. This implementation is focused on high performance quick reaction, and reliability. And the realization is not very complicated. Please read the the rule engine howto in the doc/ section.

mqtt2serial

mqtt2serial connects to a mqtt broker and a serial (tty) device. This is a generic application (similar to the rule engine framework) to asynchronoulsy pass mqtt content to a serial line, and also accept asynchronously content from that line.

This way, an arduino could be easily hooked to the serial line and pass its values and accept commands from it.

A good starting point for the usage of mqtt2serial is its man-page mqtt2serial man-page.

Remarks

The project is not complete. Please see the file CONTRIBUTING.md how you can help to improve the project.

I had the impression, an application like this was still missing in 2019. So I started this project. Please let me know, if I am right....

Also I am thinking of a MQTT payload convention . This could be a field for discussions. Please feel free to join.

Installation

Preparation

First you should make sure, that all necessary packages are installed. In doubt, do a

 sudo apt-get install libsdl-gfx1.2-dev libsdl1.2-dev libsdl-ttf2.0-dev
 sudo apt-get install libgtk2.0-dev 

Also, it is essential, that the eclipse paho library (for the MQTT communication) is installed.

This library is included in Debian stable since Debian 11/Raspberry Pi OS 11 and included in Ubuntu since 21.04.

 sudo apt-get install libpaho-mqtt-dev

If the eclipse paho library is not included in your distribution, get it from their homepage: https://www.eclipse.org/paho/

You will need the "C client library". Eclipse provides a download link and installation instructions. However, if you do not want to install binary packages, it is totally fine to start from the git repository: https://github.com/eclipse/paho.mqtt.c

The "Build instructions for GNU Make" worked for me. Especially you should install the package libssl-dev.

 sudo apt-get install libssl-dev

And finally, you may want to install the core set of true type fonts:

sudo apt-get install ttf-mscorefonts-installer

(If you do not have this package installed, you can still use MQTT Hyperdash, but it would be necessary to specify an alternative font path.)

Compilation

When this is prepared, to make MQTT-Hyperdash, you can simply do a

 cd src/
 make
 sudo make install

Test run

Open a terminal and do a

hyperdash main.dash &

have fun....

Download

There is an (inofficial) binary distribution of MQTT-Hyperdash and the paho c library (.deb files) for 32bit linux, 64bit linux, Raspberry Pi and an alpha version for MS WINDOWS on codeberg in the releases section. But it is highly recommended to compile the most recent version from sources (see above).

Get it on Codeberg

Screenshots

App image App image App image
App image App image App image
App image App image App image
App image App image

Important Note:

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Acknowledgements

Thanks to all people, who helped me to realize this package.