boards/boardctl: Add BOARDIOC_NET_GETMAC command

This commit adds a new boardctl command BOARDIOC_NET_GETMAC to retrieve the MAC address of the network interface.
The board_get_netmac function needs to be implemented by the board logic.

Signed-off-by: daichuan <[email protected]>

Author: 13627105546

boards/Kconfig

@@ -5322,6 +5322,14 @@ config BOARDCTL_START_CPU
 		Architecture specific logic must provide the board_start_cpu()
 		interface.
 
+config BOARDCTL_NET_GETMAC
+	bool "Get network MAC address"
+	default n
+	---help---
+		Enables support for the BOARDIOC_NET_GETMAC boardctl() command.
+		Architecture specific logic must provide the board_get_netmac()
+		interface.
+
 config BOARDCTL_IOCTL
 	bool "Board-specific boardctl() commands"
 	default n

boards/boardctl.c

@@ -906,6 +906,21 @@ int boardctl(unsigned int cmd, uintptr_t arg)
         break;
 #endif
 
+#ifdef CONFIG_BOARDCTL_NET_GETMAC
+      /* CMD:           BOARDIOC_NET_GETMAC
+       * DESCRIPTION:   Get the network driver mac address.
+       * ARG:           The mac address.
+       * CONFIGURATION: CONFIG_BOARDCTL_NET_GETMAC
+       * DEPENDENCIES:  Board logic must provide board_get_netmac()
+       */
+
+      case BOARDIOC_NET_GETMAC:
+        {
+          ret = board_get_netmac(0, (FAR uint8_t *)arg);
+        }
+        break;
+#endif
+
        default:
          {
 #ifdef CONFIG_BOARDCTL_IOCTL

include/nuttx/board.h

@@ -635,6 +635,26 @@ void board_autoled_off(int led);
 #  define board_autoled_off(led)
 #endif
 
+/****************************************************************************
+ * Name: board_get_netmac
+ *
+ * Description:
+ *   Get the network driver mac address.
+ *
+ * Input Parameters:
+ *   iface - The interface index.
+ *   mac   - The mac address.
+ *
+ * Returned Value:
+ *   Zero (OK) is returned on success; a negated errno value is returned on
+ *   any failure.
+ *
+ ****************************************************************************/
+
+#ifdef CONFIG_BOARDCTL_NET_GETMAC
+int board_get_netmac(int iface, FAR uint8_t *mac);
+#endif
+
 /****************************************************************************
  * Name:  board_userled_initialize
  *

include/sys/boardctl.h

@@ -216,6 +216,7 @@
 #define BOARDIOC_RESET_CAUSE       _BOARDIOC(0x0015)
 #define BOARDIOC_IRQ_AFFINITY      _BOARDIOC(0x0016)
 #define BOARDIOC_START_CPU         _BOARDIOC(0x0017)
+#define BOARDIOC_NET_GETMAC        _BOARDIOC(0x0018)
 
 /* If CONFIG_BOARDCTL_IOCTL=y, then board-specific commands will be support.
  * In this case, all commands not recognized by boardctl() will be forwarded
@@ -224,7 +225,7 @@
  * User defined board commands may begin with this value:
  */
 
-#define BOARDIOC_USER              _BOARDIOC(0x0018)
+#define BOARDIOC_USER              _BOARDIOC(0x0019)
 
 /****************************************************************************
  * Public Type Definitions