From 8baa251ce58a5ac77f9a7e4f51ff3d75111dda77 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9Cwangyanzhen=E2=80=9D?= <wangyanzhen4@huawei.com>
Date: Wed, 24 Aug 2022 07:27:40 +0000
Subject: [PATCH] feat:add hdi interface doc
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: “wangyanzhen” <wangyanzhen4@huawei.com>
---
 .../hdi/wlan/v1_0/IWlanInterface.idl          | 15 +++++++++++
 zh-cn/device_api/hdi/wlan/v1_0/WlanTypes.idl  | 27 +++++++++++++++++++
 2 files changed, 42 insertions(+)

diff --git a/zh-cn/device_api/hdi/wlan/v1_0/IWlanInterface.idl b/zh-cn/device_api/hdi/wlan/v1_0/IWlanInterface.idl
index fd496288..569ea719 100644
--- a/zh-cn/device_api/hdi/wlan/v1_0/IWlanInterface.idl
+++ b/zh-cn/device_api/hdi/wlan/v1_0/IWlanInterface.idl
@@ -458,5 +458,20 @@ interface IWlanInterface {
      * @version 1.0
      */
     WifiSendCmdIoctl([in] String ifName, [in] int cmdId, [in] byte[] paramBuf);
+
+    /**
+     * @brief 获取指定网卡的STA的信息。
+     *
+     * @param ifName 网卡名称。
+     * @param info 获取的STA的信息，详情请参考{@link WifiStationInfo}。
+     * @param mac STA的MAC地址。
+     *
+     * @return 如果操作成功，则返回0。
+     * @return 如果操作失败，则返回负值。
+     *
+     * @since 3.2
+     * @version 1.0
+     */
+     GetStaInfo([in] String ifName, [out] struct WifiStationInfo info, [in] unsigned char[] mac);
 }
 /** @} */
\ No newline at end of file
diff --git a/zh-cn/device_api/hdi/wlan/v1_0/WlanTypes.idl b/zh-cn/device_api/hdi/wlan/v1_0/WlanTypes.idl
index e9bcec83..e07cafe9 100644
--- a/zh-cn/device_api/hdi/wlan/v1_0/WlanTypes.idl
+++ b/zh-cn/device_api/hdi/wlan/v1_0/WlanTypes.idl
@@ -216,4 +216,31 @@ struct ProjectionScreenCmdParam {
     /** 投屏命令内容。 */
     byte[] buf;
 };
+
+/**
+ * @brief STA的信息。
+ *
+ * @since 3.2
+ * @version 1.0
+ */
+struct WifiStationInfo {
+    /** 接收速率。 */
+    unsigned int rxRate;
+    /** 发送速率。 */
+    unsigned int txRate;
+    /** 速率传输类型。 */
+    unsigned int flags;
+    /** 接收VHT-MCS（Very High Throughput Modulation and Coding Scheme）配置。 */
+    unsigned char rxVhtmcs;
+    /** 发送VHT-MCS（Very High Throughput Modulation and Coding Scheme）配置。 */
+    unsigned char txVhtmcs;
+    /** 接收MCS（Modulation and Coding Scheme）索引。 */
+    unsigned char rxMcs;
+    /** 发送MCS（Modulation and Coding Scheme）索引。 */
+    unsigned char txMcs;
+    /** 接收VHT-NSS（Very High Throughput Number of Spatial Streams）配置。 */
+    unsigned char rxVhtNss;
+    /** 发送VHT-NSS（Very High Throughput Number of Spatial Streams）配置。 */
+    unsigned char txVhtNss;
+};
 /** @} */
-- 
Gitee