.. include:: ../../resources.rst

.. _node-wifi-mqtt:

###########################
Basic WiFi/MQTT sensor node
###########################

.. contents::
   :local:
   :depth: 1

----

.. tip::

    You might want to `read this document on our documentation space <https://hiveeyes.org/docs/arduino/firmware/node-wifi-mqtt/README.html>`_,
    all inline links will be working there.


************
Introduction
************

A beehive monitoring sensor node based on the `Adafruit Feather HUZZAH`_, featuring an ESP8266_ MCU.
Telemetry data is transmitted using WiFi/MQTT.
The most recent firmware version is available at `node-wifi-mqtt.ino`_.

.. figure:: https://ptrace.hiveeyes.org/2016-06-17_openhive-huzzah.jpg
    :alt: Open Hive Adafruit Feather HUZZAH
    :width: 640px


Platform and supported peripherals
==================================
- `Adafruit Feather HUZZAH`_ with an ESP8266_ MCU
- HX711_ ADC weigh scale breakout board
- DS18B20_ digital thermometer
- DHT33_ (RHT04_) digital humidity/temperature sensor

.. seealso::

    - Nodes with identical hardware: :ref:`node-wifi-http` and :ref:`node-wifi-mqtt-homie`



*******
Details
*******

.. _esp8266-fritzing-wiring:

Wiring
======
These Fritzing schematics describe the breadboard hardware wiring
of the ESP8266 MCU with its sensor equipment (HX711, DS18B20 and DHT33).

.. figure:: https://ptrace.hiveeyes.org/2016-11-01_esp8266-feather-hx711-ds18b20-dht33_breadboard_01-top_v0.3.png
    :alt: ESP8266 with HX711, DS18B20 and DHT33 on breadboard, top view.
    :width: 640px

    Top view

----

.. figure:: https://ptrace.hiveeyes.org/2016-11-01_esp8266-feather-hx711-ds18b20-dht33_breadboard_02-bottom_v0.3.png
    :alt: ESP8266 with HX711, DS18B20 and DHT33 on breadboard, bottom view.
    :width: 640px

    Bottom view


********
Firmware
********
.. highlight:: bash


Clone git repository
====================
::

    # Get hold of the source code repository including all dependencies
    git clone https://github.com/hiveeyes/arduino

    # Select this firmware
    cd node-wifi-mqtt


Configure
=========
Have a look at the source code `node-wifi-mqtt.ino`_ and adapt setting variables according to your environment.

Configure WiFi and MQTT settings::

    // WiFi parameters
    #define WLAN_SSID       "change-to-your-ssid"
    #define WLAN_PASS       "change-to-your-pw"

    // MQTT server
    #define MQTT_BROKER     "swarm.hiveeyes.org"
    #define MQTT_PORT       1883
    #define AIO_USERNAME    ""
    #define AIO_KEY         ""


Build
=====

The build system is based on PlatformIO_.

Build firmware::

    make


Upload to MCU
=============
::

    export MCU_PORT=/dev/ttyUSB0
    make upload