You might want to continue reading on our documentation space, all inline links will be working there.


This is the documentation for the Hiveeyes Arduino repository of the Hiveeyes project, a beehive monitoring system. Enjoy reading!

All Arduino Core based firmware source code is living here. We support different hardware, so there are different flavors of the firmware, reflected by the directory naming convention <purpose>-<transport>-<protocol>.

There are firmwares for ATmega328, ESP8266 and ESP32_ MCUs.

  • purpose role name, either node or gateway
  • transport name of the physical transport mechanism, e.g. rfm69, gprs or wifi.
  • protocol name of the transmission protocol, e.g. beradio, mqtt, http or any.

For building, most programs are using PlatformIO, but some are still using Arduino-Makefile and even others are still based on Ino.


Source code

Get source code with all dependency libraries and tools:

git clone --recursive


PlatformIO is the recommended build environment.

Arduino IDE

If you want to use the Arduino IDE, you have to install all necessary libraries manually. In each programs subdirectory, there is a platformio.ini which will give you a clue about the libraries to use.


When using PlatformIO, installing all dependency libraries will be managed automatically.



cd node-esp32-generic

Upload to MCU

To build a firmware hex file, upload it to the MCU and finally start a serial port monitor, do:

export MCU_PORT=/dev/ttyUSB0
make upload

# Run serial port monitor
make monitor



All source codes are licensed under the GNU General Public License, see also “LICENSE.txt”.


All hardware designs and related things are licensed under the CERN Open Hardware Licence v1.2.


Licensed under the Creative Commons CC-BY-SA 4.0 license.