More doxygen comments added.

Reviewed-on: #6

.drone.yml

@@ -6,7 +6,6 @@ steps:
   image: python:3
   commands:
   - pip install platformio
-  - pio check
   - pio run
 - name: upload
   image: python:3

.gitignore

@@ -1,6 +1,4 @@
-.pioenvs
-.piolibdeps
 .pio
 data/homie/config.json
-nbproject
 .vscode
+output/doxygen

Makefile

@@ -4,3 +4,6 @@ build:
 otaupload: 
 	pip install -r .pio/libdeps/nodemcu/Homie/scripts/ota_updater/requirements.txt
 	python .pio/libdeps/nodemcu/Homie/scripts/ota_updater/ota_updater.py -l mqtt.jcktrue.dk -i 18fe34f2f987 .pio/build/nodemcu/firmware.bin
+
+docs:
+	doxygen .\.doxygen

include/config.h

@@ -1,15 +1,36 @@
+/**
+ * \file
+ * \class Config
+ */
 #ifndef CONFIG_H
 #define CONFIG_H
 
 #ifndef VERSION
 //SEMVER style version
+/**
+ * \brief Version string. 
+ * Update as needed. Formatted as SEMVER style string.
+ * See https://semver.org/ for more information.
+ */
 #define VERSION          "0.4.5-Dev"
 #endif
 
+/**
+ * Set the default Serial baudrate in bits/seconds
+ */
 #define CONFIG_SERIAL_BAUDRATE  115200
 
+/**
+ * Pin ID of the output relay
+ */
 #define CONFIG_IO_RELAY         D1
+/**
+ * Pin ID of the DHT11 temperature sensor
+ */
 #define CONFIG_IO_DHT11         D2
 
+/**
+ * Interval at which the tempreature is sent in seconds
+ */
 #define CONFIG_TEMPERATURE_SEND_INTERVAL 60
 #endif

src/main.cpp

@@ -1,20 +1,38 @@
+/**
+ * \brief Entry point
+ * 
+ * Deskcontrol is a simple on/off timer switch inteded for use with an ATX PSU.
+ * The theory of operation is turning on and off power by pulling the control line low/high while 
+ * running of the 5V standby line.
+ * 
+ * Additional features include support for a DHT11 to log the temperature.
+ * \file
+ */
+
 #include "config.h"
 
 #include <Homie.h>
 
 #include <LoggerNode.h>
-LoggerNode LN;
+LoggerNode LN; ///<Instance of the LoggerNode library
 
 #include "DHTesp.h"
-DHTesp dht;
+DHTesp dht; ///< Instance of the DHT temperature controller. 
 
 
-#define OUTPUT_SET(x)  digitalWrite(CONFIG_IO_RELAY, x ? LOW : HIGH)
+#define OUTPUT_SET(x)  digitalWrite(CONFIG_IO_RELAY, x ? LOW : HIGH)  ///< Macro for controlling the output state.
-unsigned int timer = 0;
+unsigned int timer = 0;   ///< Remaining time when counting down.
-unsigned int next_timer_update = 0;
+unsigned int next_timer_update = 0; ///< Timer used to control when the timer value should be pushed to the server
+
 HomieNode powerNode("power", "Power", "switch");
 HomieNode temperatureNode("temperature", "Temperature", "temperature");
 
+/** Power state handler 
+ * Handles event on the power state MQTT node
+ * \param[in] range Currently unused
+ * \param[in] value New value of the power state. (Either "on" or off")
+ * \return False if input is invalid. Otherwise true.
+ */
 bool powerStateHandler(const HomieRange& range, const String& value)
 {
     if (value != "on" && value != "off") 
@@ -38,6 +56,13 @@ bool powerStateHandler(const HomieRange& range, const String& value)
     return true;
 }
 
+/**
+ * \brief powerTimer event handler.
+ * Handler for events on the powerTimer node.
+ * \param[in] range Currently unused.
+ * \param[in] value New value for the timer in minutes. ASCII representation of an integer from 1 to 120.
+ * \return False if input is invalid. Otherwise true.
+ */
 bool powerTimerHandler(const HomieRange& range, const String& value)
 {
     int settimer = value.toInt();
@@ -53,10 +78,11 @@ bool powerTimerHandler(const HomieRange& range, const String& value)
     return true;
 }
 
-
+/**
+ * setupHandler. Comply with Homie interface
+ */
 void setupHandler()
 {
-
   pinMode(CONFIG_IO_RELAY, OUTPUT);
   OUTPUT_SET(false);
   powerNode.setProperty("state").send("off");
@@ -65,6 +91,9 @@ void setupHandler()
   dht.setup(CONFIG_IO_DHT11, DHTesp::DHT11); // Connect DHT sensor to GPIO 17
 }
 
+/**
+ * Handle timer updates from the main event loop
+ */
 void loopHandleTimer() 
 {
   if(timer)
@@ -87,6 +116,9 @@ void loopHandleTimer()
   }
 }
 
+/**
+ * Handle periodic temperature measurements from the main event loop
+ */
 void loopHandleTemperature() 
 {
   static unsigned long lastTemperatureSent = 0;
@@ -101,12 +133,21 @@ void loopHandleTemperature()
   }
 }
 
+/**
+ * Main event loop. Part of the Homie API. This runs while the device is active and connected.
+ * 
+ * \callgraph
+ */
 void loopHandler()
 {
   loopHandleTimer();
   loopHandleTemperature();
 }
 
+/**
+ * Arduino style setup() routine.
+ * Configure the Homie framework by adding the two nodes "power" and "temperature"
+ */
 void setup()
 {
 
@@ -130,6 +171,9 @@ void setup()
     Homie.setup();
 }
 
+/**
+ * Arduino main loop. Forwarded to Homie framework
+ */
 void loop()
 {
     Homie.loop();