netif: added ESP-NETIF L2 TAP interface

components/esp_netif/include/esp_vfs_l2tap.h

@@ -0,0 +1,55 @@
+/*
+ * SPDX-FileCopyrightText: 2021 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#include "esp_netif.h"
+#include "esp_err.h"
+
+#define L2TAP_VFS_DEFAULT_PATH "/dev/net/tap"
+#define L2TAP_VFS_CONFIG_DEFAULT()                  \
+    {                                               \
+        .base_path = L2TAP_VFS_DEFAULT_PATH,      \
+    }
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef struct {
+    const char* base_path;
+} l2tap_vfs_config_t;
+
+typedef enum {
+    L2TAP_S_RCV_FILTER,
+    L2TAP_G_RCV_FILTER,
+    L2TAP_S_INTF_DEVICE,
+    L2TAP_G_INTF_DEVICE,
+} l2tap_ioctl_opt_t;
+
+/**
+ * @brief Add L2 TAP virtual filesystem driver
+ *
+ * This function must be called prior usage of ESP-NETIF L2 TAP Interface
+ *
+ * @param config L2 TAP virtual filesystem driver configuration. Default base path /dev/net/tap is used when this paramenter is NULL.
+ * @return esp_err_t
+ *          - ESP_OK on success
+ */
+esp_err_t esp_vfs_l2tap_intf_register(l2tap_vfs_config_t *config);
+
+/**
+ * @brief Removes L2 TAP virtual filesystem driver
+ *
+ * @param base_path Base path to the L2 TAP virtual filesystem driver. Default path /dev/net/tap is used when this paramenter is NULL.
+ * @return esp_err_t
+ *          - ESP_OK on success
+ */
+esp_err_t esp_vfs_l2tap_intf_unregister(const char *base_path);
+
+#ifdef __cplusplus
+}
+#endif