This repository is a part of the HomeWSN project.

Whsnbg is a C implementation of the MQTT broker, the MQTT-SN gateway and simple MQTT rules engine designed for embedded platforms with small memory requirements (like OpenWrt).

MQTT broker:

• MQTT Protocol Specification Version 3.1.
• Both plain TCP and Websockets connections on the selectable IPv4 network interface.
• SSL(TLS) encryption provided by the external library axTLS or OpenSSL.
• QoS level 0, 1 and 2.
• User authorization.
• Remote MySQL database support for the specific topics.

MQTT-SN gateway:

• MQTT-SN Protocol Specification Version 1.2.
• UDP connection on the selectable IPv4 network interface.
• QoS level 0, 1 and 2.
• active, asleep and awake states of the sensors.
• Remote MySQL database support for the specific topics.

MQTT rules engine:

• Rules are stored in the specific rules topic ($SYS/rulesengine/rules) and the external whsnbg.rules file.
• Rules can be modified on the fly by publishing to this specific rules topic.
• The rule set includes triggers (based on the cron or mqtt publish events), actions, conditions and the internal variables.

Download the latest release in tarball from github and untar it. Then build, install and run whsnbg.

$ curl -L https://github.com/homewsn/whsnbg/archive/v1.2.tar.gz | tar zx
$ cd whsnbg-1.2
$ make
$ sudo make install
$ whsnbg

Download the latest release in zip from github and unzip it. Open the MSVC++ 8.0 solution, build and run whsnbg.

• Install OpenWrt buildroot.
• Add the following line to the feeds.conf.default in the OpenWrt buildroot:

src-git homewsn https://github.com/homewsn/homewsn.openwrt.packages.git

• This feed should be included and enabled by default in the OpenWrt buildroot. To install all its package definitions, run:

$ ./scripts/feeds update homewsn
$ ./scripts/feeds install -a -p homewsn

• The packages should now appear in menuconfig. You can find and select whsnbg in the Network menu.
• Exit and save new configuration, then compile the package:

$ make package/whsnbg/compile V=99

Build options can be set on the command line with the make command, for example:

$ make DAEMON_VERSION=1

Configuration is carried out manually in the config.h file, for example:

// Windows
// ** Manually configure ** >>>>>

#define USE_TLS_LIBRARY			// use external TLS library
// TLS library
#define OPENSSL_LIBRARY		// OpenSSL
//#define AXTLS_LIBRARY			// axTLS
//#define SSL_LIBRARY_HEADERS	// TLS library headers

...

// <<<<< ** Manually configure **

$ make menuconfig

Then find Network -> whsnbg and press Enter. Configure options, setting to <*> or < >.

• If you enable TSL support please be sure you have installed the appropriate library (axTLS or OpenSSL).
• If you enable storing payload in the MySQL database you will need MySQL client library.

GNU GPL v 2.0