gnrc_gomach: deprecate module

RIOT-OS · Mar 27, 2024 · 653417d · 653417d
1 parent 2deb888
commit 653417d
Show file tree

Hide file tree

Showing 3 changed files with 10 additions and 1 deletion.
diff --git a/makefiles/deprecated_modules.inc.mk b/makefiles/deprecated_modules.inc.mk
@@ -1,7 +1,9 @@
 # Add deprecated modules here
 # Keep this list ALPHABETICALLY SORTED!!!!111elven
+DEPRECATED_MODULES += gnrc_gomach
 DEPRECATED_MODULES += gnrc_lwmac
 DEPRECATED_MODULES += gnrc_mac
+DEPRECATED_MODULES += gnrc_nettype_gomach
 DEPRECATED_MODULES += gnrc_nettype_lwmac
 DEPRECATED_MODULES += sema_deprecated
 DEPRECATED_MODULES += ztimer_now64
diff --git a/sys/include/net/gnrc/gomach/gomach.h b/sys/include/net/gnrc/gomach/gomach.h
@@ -10,6 +10,8 @@
  * @defgroup    net_gnrc_gomach GoMacH
  * @ingroup     net_gnrc
  * @brief       A traffic-adaptive multi-channel MAC
+ * @deprecated  This module is deprecated and will be removed after the 2024.10 release.
+ *              As an alternative MAC layer for IEEE 802.15.4, you can use @ref pkg_opendsme.
  *
  *
  * GoMacH is, "a General, nearly Optimal MAC protocol for multi-Hop communications",

diff --git a/sys/include/net/gnrc/nettype.h b/sys/include/net/gnrc/nettype.h
@@ -66,7 +66,12 @@ typedef enum {
      * @name Link layer
      */
 #if IS_USED(MODULE_GNRC_NETTYPE_GOMACH) || defined(DOXYGEN)
-    GNRC_NETTYPE_GOMACH,         /**< Protocol is GoMacH */
+    /**
+     * @brief       Protocol is GoMacH
+     * @deprecated  @ref net_gnrc_gomach was deprecated and will be removed after
+     *              the 2024.10 release together with this protocol type.
+     */
+    GNRC_NETTYPE_GOMACH,
 #endif
 #if IS_USED(MODULE_GNRC_NETTYPE_LWMAC) || defined(DOXYGEN)
     /**