refactor: format CMakeLists.txt for better readability and add documentation comments in dmx.h

components/dmx/CMakeLists.txt

@@ -1 +1,8 @@
-idf_component_register(SRCS "src/dmx.c" INCLUDE_DIRS "include" REQUIRES logger esp_dmx)
+idf_component_register(
+  SRCS
+  "src/dmx.c"
+  INCLUDE_DIRS
+  "include"
+  REQUIRES
+  logger
+  esp_dmx)

components/dmx/include/dmx.h

@@ -6,8 +6,18 @@
 extern "C" {
 #endif
 
+/**
+ * @brief Initialize the DMX interface.
+ * @param port The DMX port to initialize.
+ * @param pin_tx The pin for TX of the RS485.
+ * @param pin_rx The pin for RX of the RS485.
+ */
 void init_dmx(dmx_port_t port, int pin_tx, int pin_rx);
 
+/**
+ * @brief Send some test DMX data on the specified port.
+ * @param port The DMX port to send data on.
+ */
 void send_dmx(dmx_port_t port);
 
 #ifdef __cplusplus

components/dmx/src/dmx.c

@@ -1,4 +1,4 @@
-#define LOG_TAG "DMX"
+#define LOG_TAG "DMX" ///< "DMX" log tag for this file
 
 #include <stdint.h>