Sorry! The tencent meeting will be held at 2024-06-12 16:00 scheduled by sig-WayCa SIG has been cancelled.
1
0
您好！
sig-WayCa 邀请您参加 2024-06-12 16:00 召开的Tencent会议
会议主题：例会
会议链接：https://meeting.tencent.com/dm/G5In1Ufz855S
会议纪要：https://etherpad.openeuler.org/p/sig-WayCa-meetings
更多资讯尽在：https://www.openeuler.org/zh/
Hello!
sig-WayCa invites you to attend the Tencent conference will be held at 2024-06-12 16:00,
The subject of the conference is 例会,
You can join the meeting at https://meeting.tencent.com/dm/G5In1Ufz855S.
Add topics at https://etherpad.openeuler.org/p/sig-WayCa-meetings.
More information: https://www.openeuler.org/en/
1
0
07 Oct '23
The hikptool ub_dfx command is submitted for the first time.
This command can be used to dump register information of the LRB, PFA, and PM modules.
Signed-off-by: Jianqiang Li <lijianqiang16(a)huawei.com>
---
libhikptdev/include/hikptdev_plug.h | 1 +
net/hikp_net_lib.h | 9 +
net/ub/ub_dfx/hikp_ub_dfx.c | 319 ++++++++++++++++++++++++++++
net/ub/ub_dfx/hikp_ub_dfx.h | 100 +++++++++
tool_lib/tool_lib.h | 2 +-
5 files changed, 430 insertions(+), 1 deletion(-)
create mode 100644 net/ub/ub_dfx/hikp_ub_dfx.c
create mode 100644 net/ub/ub_dfx/hikp_ub_dfx.h
diff --git a/libhikptdev/include/hikptdev_plug.h b/libhikptdev/include/hikptdev_plug.h
index 42bea6b..56cea78 100644
--- a/libhikptdev/include/hikptdev_plug.h
+++ b/libhikptdev/include/hikptdev_plug.h
@@ -43,6 +43,7 @@ enum cmd_module_type {
MAC_MOD = 8,
DPDK_MOD = 9,
CXL_MOD = 10,
+ UB_MOD = 11,
};
void hikp_unlock(void);
diff --git a/net/hikp_net_lib.h b/net/hikp_net_lib.h
index cc99d0c..af0a51d 100644
--- a/net/hikp_net_lib.h
+++ b/net/hikp_net_lib.h
@@ -98,6 +98,15 @@ enum roce_cmd_type {
GET_ROCEE_TSP_CMD,
};
+enum ub_cmd_type {
+ GET_UNIC_PPP_CMD = 0x1,
+ GET_UB_DFX_INFO_CMD,
+ GET_UB_LINK_INFO_CMD,
+ GET_UB_BP_INFO_CMD,
+ GET_UB_CRD_INFO_CMD,
+ GET_UB_BASIC_INFO_CMD,
+};
+
#define HIKP_MAX_PF_NUM 8
#define HIKP_NIC_MAX_FUNC_NUM 256
diff --git a/net/ub/ub_dfx/hikp_ub_dfx.c b/net/ub/ub_dfx/hikp_ub_dfx.c
new file mode 100644
index 0000000..c50f555
--- /dev/null
+++ b/net/ub/ub_dfx/hikp_ub_dfx.c
@@ -0,0 +1,319 @@
+/*
+ * Copyright (c) 2023 Hisilicon Technologies Co., Ltd.
+ * Hikptool is licensed under Mulan PSL v2.
+ * You can use this software according to the terms and conditions of the Mulan PSL v2.
+ * You may obtain a copy of Mulan PSL v2 at:
+ * http://license.coscl.org.cn/MulanPSL2
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
+ * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+#include "tool_cmd.h"
+#include "hikp_net_lib.h"
+#include "hikp_ub_dfx.h"
+
+struct ub_dfx_param g_ub_dfx_param = { 0 };
+
+static const struct dfx_module_cmd g_ub_dfx_module_parse[] = {
+ {"LRB", LRB_DFX_REG_DUMP},
+ {"PFA", PFA_DFX_REG_DUMP},
+ {"PM", PM_DFX_REG_DUMP}
+};
+
+static const struct dfx_type_parse g_dfx_type_parse[] = {
+ {INCORRECT_REG_TYPE, WIDTH_32_BIT, "INCORRECT TYPE"},
+ {TYPE_32_STATS, WIDTH_32_BIT, "32 bit statistics"},
+ {TYPE_32_RUNNING_STATUS, WIDTH_32_BIT, "32 bit running status"},
+ {TYPE_64_STATS, WIDTH_64_BIT, "64 bit statistics"},
+};
+
+static void dfx_help_info(const struct major_cmd_ctrl *self)
+{
+ printf("\n Usage: %s %s\n", self->cmd_ptr->name, "-i <interface>\n");
+ printf("\n %s\n", self->cmd_ptr->help_info);
+ printf(" Options:\n\n");
+ printf(" %s, %-25s %s\n", "-h", "--help", "display this help and exit");
+ printf(" %s, %-25s %s\n", "-i", "--interface=<interface>",
+ "device target or bdf id, e.g. ubn0 or 0000:35:00.0");
+ printf(" %s\n", " [-m/--module LRB/PFA/PM] : this is necessary param\n");
+}
+
+static int hikp_ub_dfx_help(struct major_cmd_ctrl *self, const char *argv)
+{
+ dfx_help_info(self);
+ return 0;
+}
+
+static int hikp_ub_dfx_target(struct major_cmd_ctrl *self, const char *argv)
+{
+ self->err_no = tool_check_and_get_valid_bdf_id(argv, &(g_ub_dfx_param.target));
+ if (self->err_no != 0) {
+ snprintf(self->err_str, sizeof(self->err_str), "Unknown device %s.", argv);
+ return self->err_no;
+ }
+
+ return 0;
+}
+
+static int hikp_ub_dfx_module_select(struct major_cmd_ctrl *self, const char *argv)
+{
+ size_t arr_size = HIKP_ARRAY_SIZE(g_ub_dfx_module_parse);
+ bool is_found;
+ size_t i;
+
+ for (i = 0; i < arr_size; i++) {
+ is_found = strncmp(argv, (const char *)g_ub_dfx_module_parse[i].module_name,
+ sizeof(g_ub_dfx_module_parse[i].module_name)) == 0;
+ if (is_found) {
+ g_ub_dfx_param.sub_cmd_code = g_ub_dfx_module_parse[i].sub_cmd_code;
+ g_ub_dfx_param.module_idx = i;
+ g_ub_dfx_param.flag |= MODULE_SET_FLAG;
+ return 0;
+ }
+ }
+ dfx_help_info(self);
+ snprintf(self->err_str, sizeof(self->err_str), "-m/--module param error!!!");
+ self->err_no = -EINVAL;
+
+ return -EINVAL;
+}
+
+static int hikp_ub_dfx_get_blk_data(struct hikp_cmd_ret **cmd_ret,
+ uint32_t blk_id, uint32_t sub_cmd_code)
+{
+ struct hikp_cmd_header req_header = { 0 };
+ struct ub_dfx_req_para req_data = { 0 };
+
+ req_data.bdf = g_ub_dfx_param.target.bdf;
+ req_data.block_id = blk_id;
+ hikp_cmd_init(&req_header, UB_MOD, GET_UB_DFX_INFO_CMD, sub_cmd_code);
+ *cmd_ret = hikp_cmd_alloc(&req_header, &req_data, sizeof(req_data));
+
+ return hikp_rsp_normal_check(*cmd_ret);
+}
+
+static int hikp_ub_get_first_blk_dfx(struct ub_dfx_rsp_head *rsp_head, uint32_t **reg_data,
+ uint32_t *max_dfx_size, uint32_t *version)
+{
+ struct ub_dfx_rsp *dfx_rsp = NULL;
+ struct hikp_cmd_ret *cmd_ret;
+ int ret;
+
+ ret = hikp_ub_dfx_get_blk_data(&cmd_ret, 0, g_ub_dfx_param.sub_cmd_code);
+ if (ret < 0)
+ goto err_out;
+
+ dfx_rsp = (struct ub_dfx_rsp *)(cmd_ret->rsp_data);
+ *version = cmd_ret->version;
+ *rsp_head = dfx_rsp->rsp_head;
+ if (rsp_head->total_blk_num == 0) {
+ /* if total block number is zero, set total type number to zero anyway */
+ rsp_head->total_type_num = 0;
+ goto err_out;
+ }
+ *max_dfx_size = (uint32_t)(rsp_head->total_blk_num * MAX_DFX_DATA_NUM * sizeof(uint32_t));
+ *reg_data = (uint32_t *)calloc(1, *max_dfx_size);
+ if (*reg_data == NULL) {
+ HIKP_ERROR_PRINT("malloc log memory 0x%x failed.\n", *max_dfx_size);
+ ret = -ENOMEM;
+ goto err_out;
+ }
+
+ if (rsp_head->cur_blk_size > *max_dfx_size) {
+ free(*reg_data);
+ *reg_data = NULL;
+ HIKP_ERROR_PRINT("blk0 reg_data copy size error, data size: 0x%x, max size: 0x%x\n",
+ rsp_head->cur_blk_size, *max_dfx_size);
+ ret = -EINVAL;
+ goto err_out;
+ }
+ memcpy(*reg_data, dfx_rsp->reg_data, rsp_head->cur_blk_size);
+
+ *max_dfx_size -= (uint32_t)rsp_head->cur_blk_size;
+err_out:
+ free(cmd_ret);
+ cmd_ret = NULL;
+
+ return ret;
+}
+
+static int hikp_ub_get_blk_dfx(struct ub_dfx_rsp_head *rsp_head, uint32_t blk_id,
+ uint32_t *reg_data, uint32_t *max_dfx_size)
+{
+ struct ub_dfx_rsp *dfx_rsp = NULL;
+ struct hikp_cmd_ret *cmd_ret;
+ int ret;
+
+ ret = hikp_ub_dfx_get_blk_data(&cmd_ret, blk_id, g_ub_dfx_param.sub_cmd_code);
+ if (ret < 0)
+ goto err_out;
+
+ dfx_rsp = (struct ub_dfx_rsp *)(cmd_ret->rsp_data);
+ *rsp_head = dfx_rsp->rsp_head;
+ if (rsp_head->cur_blk_size > *max_dfx_size) {
+ HIKP_ERROR_PRINT("blk%u reg_data copy size error, "
+ "data size: 0x%x, max size: 0x%x\n",
+ blk_id, rsp_head->cur_blk_size, *max_dfx_size);
+ ret = -EINVAL;
+ goto err_out;
+ }
+ memcpy(reg_data, dfx_rsp->reg_data, rsp_head->cur_blk_size);
+ *max_dfx_size -= (uint32_t)rsp_head->cur_blk_size;
+
+err_out:
+ free(cmd_ret);
+ cmd_ret = NULL;
+
+ return ret;
+}
+
+static bool is_type_found(uint16_t type_id, uint32_t *index)
+{
+ size_t arr_size = HIKP_ARRAY_SIZE(g_dfx_type_parse);
+ size_t i;
+
+ for (i = 0; i < arr_size; i++) {
+ if (g_dfx_type_parse[i].type_id == type_id) {
+ *index = i;
+ return true;
+ }
+ }
+
+ return false;
+}
+
+static void hikp_ub_dfx_print_type_head(uint8_t type_id, uint8_t *last_type_id)
+{
+ uint32_t index = 0;
+
+ if (type_id != *last_type_id) {
+ printf("-----------------------------------------------------\n");
+ if (is_type_found(type_id, &index))
+ printf("type name: %s\n\n", g_dfx_type_parse[index].type_name);
+ else
+ HIKP_WARN_PRINT("type name: unknown type, type id is %u\n\n", type_id);
+
+ *last_type_id = type_id;
+ }
+}
+
+static void hikp_ub_dfx_print_b32(uint32_t num, uint32_t *reg_data)
+{
+ uint32_t word_num = num * WORD_NUM_PER_REG;
+ uint16_t offset;
+ uint32_t value;
+ uint32_t index;
+ uint32_t i;
+
+ for (i = 0, index = 1; i < word_num; i = i + WORD_NUM_PER_REG, index++) {
+ offset = (uint16_t)HI_GET_BITFIELD(reg_data[i], 0, DFX_REG_ADDR_MASK);
+ value = reg_data[i + 1];
+ printf("%03u: 0x%04x\t0x%08x\n", index, offset, value);
+ }
+}
+
+static void hikp_ub_dfx_print_b64(uint32_t num, uint32_t *reg_data)
+{
+ uint32_t word_num = num * WORD_NUM_PER_REG;
+ uint16_t offset;
+ uint64_t value;
+ uint32_t index;
+ uint32_t i;
+
+ for (i = 0, index = 1; i < word_num; i = i + WORD_NUM_PER_REG, index++) {
+ offset = (uint16_t)HI_GET_BITFIELD(reg_data[i], 0, DFX_REG_ADDR_MASK);
+ value = (uint64_t)reg_data[i + 1] |
+ (HI_GET_BITFIELD((uint64_t)reg_data[i], DFX_REG_VALUE_OFF,
+ DFX_REG_VALUE_MASK) << BIT_NUM_OF_WORD);
+ printf("%03u: 0x%04x\t0x%016lx\n", index, offset, value);
+ }
+}
+
+static void hikp_ub_dfx_print(const struct ub_dfx_rsp_head *rsp_head, uint32_t *reg_data)
+{
+ struct ub_dfx_type_head *type_head;
+ uint8_t last_type_id = 0;
+ uint32_t *ptr = reg_data;
+ uint8_t i;
+
+ printf("****************** module %s reg dump start ********************\n",
+ g_ub_dfx_module_parse[g_ub_dfx_param.module_idx].module_name);
+ for (i = 0; i < rsp_head->total_type_num; i++) {
+ type_head = (struct ub_dfx_type_head *)ptr;
+ if (type_head->type_id == INCORRECT_REG_TYPE) {
+ HIKP_ERROR_PRINT("No.%u type is incorrect reg type\n", i + 1u);
+ break;
+ }
+ hikp_ub_dfx_print_type_head(type_head->type_id, &last_type_id);
+ ptr++;
+ if (type_head->bit_width == WIDTH_32_BIT) {
+ hikp_ub_dfx_print_b32((uint32_t)type_head->reg_num, ptr);
+ } else if (type_head->bit_width == WIDTH_64_BIT) {
+ hikp_ub_dfx_print_b64((uint32_t)type_head->reg_num, ptr);
+ } else {
+ HIKP_ERROR_PRINT("type%u's bit width error.\n", type_head->type_id);
+ break;
+ }
+ ptr += (uint32_t)type_head->reg_num * WORD_NUM_PER_REG;
+ }
+ printf("################### ====== dump end ====== ######################\n");
+}
+
+static void hikp_ub_dfx_execute(struct major_cmd_ctrl *self)
+{
+ struct ub_dfx_rsp_head rsp_head = { 0 };
+ struct ub_dfx_rsp_head tmp_head = { 0 };
+ uint32_t *reg_data = NULL;
+ uint32_t max_dfx_size = 0;
+ uint32_t real_reg_size;
+ uint32_t version;
+ uint32_t i;
+
+ if (!(g_ub_dfx_param.flag & MODULE_SET_FLAG)) {
+ self->err_no = -EINVAL;
+ snprintf(self->err_str, sizeof(self->err_str), "Please specify a module.");
+ dfx_help_info(self);
+ return;
+ }
+
+ self->err_no = hikp_ub_get_first_blk_dfx(&rsp_head, ®_data, &max_dfx_size, &version);
+ if (self->err_no != 0) {
+ snprintf(self->err_str, sizeof(self->err_str), "get the first block dfx fail.");
+ return;
+ }
+ real_reg_size = (uint32_t)rsp_head.cur_blk_size;
+ for (i = 1; i < rsp_head.total_blk_num; i++) {
+ self->err_no = hikp_ub_get_blk_dfx(&tmp_head, i,
+ reg_data + (real_reg_size / sizeof(uint32_t)),
+ &max_dfx_size);
+ if (self->err_no != 0) {
+ snprintf(self->err_str, sizeof(self->err_str),
+ "getting block%u reg fail.", i);
+ free(reg_data);
+ return;
+ }
+ real_reg_size += (uint32_t)tmp_head.cur_blk_size;
+ memset(&tmp_head, 0, sizeof(struct ub_dfx_rsp_head));
+ }
+
+ printf("DFX cmd version: 0x%x\n\n", version);
+ hikp_ub_dfx_print((const struct ub_dfx_rsp_head *)&rsp_head, reg_data);
+ free(reg_data);
+}
+
+static void cmd_ub_dfx_init(void)
+{
+ struct major_cmd_ctrl *major_cmd = get_major_cmd();
+
+ major_cmd->option_count = 0;
+ major_cmd->execute = hikp_ub_dfx_execute;
+
+ cmd_option_register("-h", "--help", false, hikp_ub_dfx_help);
+ cmd_option_register("-i", "--interface", true, hikp_ub_dfx_target);
+ cmd_option_register("-m", "--module", true, hikp_ub_dfx_module_select);
+}
+
+HIKP_CMD_DECLARE("ub_dfx", "dump ub dfx info of hardware", cmd_ub_dfx_init);
diff --git a/net/ub/ub_dfx/hikp_ub_dfx.h b/net/ub/ub_dfx/hikp_ub_dfx.h
new file mode 100644
index 0000000..4ba37a1
--- /dev/null
+++ b/net/ub/ub_dfx/hikp_ub_dfx.h
@@ -0,0 +1,100 @@
+/*
+ * Copyright (c) 2023 Hisilicon Technologies Co., Ltd.
+ * Hikptool is licensed under Mulan PSL v2.
+ * You can use this software according to the terms and conditions of the Mulan PSL v2.
+ * You may obtain a copy of Mulan PSL v2 at:
+ * http://license.coscl.org.cn/MulanPSL2
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
+ * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+#ifndef HIKP_UB_DFX_H
+#define HIKP_UB_DFX_H
+
+#include "hikp_net_lib.h"
+
+#define MAX_DFX_DATA_NUM 59
+#define MODULE_SET_FLAG 0x1
+
+enum ub_dfx_cmd_type {
+ LRB_DFX_REG_DUMP = 0,
+ PFA_DFX_REG_DUMP = 1,
+ PM_DFX_REG_DUMP = 2,
+ INVALID_MODULE = 0xFFFFFFFF,
+};
+
+enum ub_dfx_reg_type {
+ INCORRECT_REG_TYPE = 0,
+ TYPE_32_STATS = 1,
+ TYPE_32_RUNNING_STATUS = 2,
+ TYPE_64_STATS = 3,
+ TYPE_INVALID = 255,
+};
+
+#define MAX_TYPE_NAME_LEN 40
+
+enum ub_dfx_reg_width {
+ WIDTH_32_BIT = 32,
+ WIDTH_64_BIT = 64,
+};
+
+struct dfx_type_parse {
+ uint8_t type_id;
+ uint8_t bit_width;
+ uint8_t type_name[MAX_TYPE_NAME_LEN];
+};
+
+struct ub_dfx_param {
+ struct tool_target target;
+ uint32_t sub_cmd_code;
+ uint8_t module_idx;
+ uint8_t flag;
+};
+
+#define MAX_MODULE_NAME_LEN 20
+struct dfx_module_cmd {
+ uint8_t module_name[MAX_MODULE_NAME_LEN];
+ uint32_t sub_cmd_code;
+};
+
+struct ub_dfx_req_para {
+ struct bdf_t bdf;
+ uint8_t block_id;
+};
+
+struct ub_dfx_type_head {
+ uint8_t type_id;
+ uint8_t bit_width;
+ uint8_t reg_num;
+ uint8_t flag;
+};
+
+struct ub_dfx_rsp_head {
+ uint8_t total_blk_num;
+ uint8_t total_type_num;
+ uint8_t cur_blk_size;
+ uint8_t rsvd;
+};
+
+/*********************************************************
+ * All registers are returned as key-value pairs, and divided
+ * into three groups of data.
+ * 1. 32bit regs: R0 bit0~bit15: offset, R1 bit0~bit31: value
+ * 2. 64bit regs: R0 bit0~bit15: offset, R0 bit16~bit31 high16 value, R1 bit0~bit31: low32 value
+ *********************************************************/
+#define DFX_REG_VALUE_OFF 16
+#define DFX_REG_VALUE_MASK 0xFFFF
+#define DFX_REG_ADDR_MASK 0xFFFF
+
+#define WORD_NUM_PER_REG 2
+#define BIT_NUM_OF_WORD 32
+
+struct ub_dfx_rsp {
+ struct ub_dfx_rsp_head rsp_head;
+ uint32_t reg_data[MAX_DFX_DATA_NUM];
+};
+
+#endif /* HIKP_UB_DFX_H */
diff --git a/tool_lib/tool_lib.h b/tool_lib/tool_lib.h
index b211175..bf37465 100644
--- a/tool_lib/tool_lib.h
+++ b/tool_lib/tool_lib.h
@@ -18,7 +18,7 @@
#define TOOL_NAME "hikptool"
-#define TOOL_VER "1.0.14"
+#define TOOL_VER "1.0.15"
#define HI_GET_BITFIELD(value, start, mask) (((value) >> (start)) & (mask))
#define HI_SET_FIELD(origin, shift, val) ((origin) |= (val) << (shift))
--
2.36.1.windows.1
1
20
您好！
sig-WayCa SIG 邀请您参加 2023-07-12 15:30 召开的Zoom会议
会议主题：高速网络系列～dpdk
会议链接：https://us06web.zoom.us/j/82571778647?pwd=VlY2MjBRZFlITThUYldPOVJtSlZ2UT09
会议纪要：https://etherpad.openeuler.org/p/sig-WayCa-meetings
温馨提醒：建议接入会议后修改参会人的姓名，也可以使用您在gitee.com的ID
更多资讯尽在：https://openeuler.org/zh/
Hello!
openEuler sig-WayCa SIG invites you to attend the Zoom conference will be held at 2023-07-12 15:30,
The subject of the conference is 高速网络系列～dpdk,
You can join the meeting at https://us06web.zoom.us/j/82571778647?pwd=VlY2MjBRZFlITThUYldPOVJtSlZ2UT09.
Add topics at https://etherpad.openeuler.org/p/sig-WayCa-meetings.
Note: You are advised to change the participant name after joining the conference or use your ID at gitee.com.
More information: https://openeuler.org/en/
1
0
From: Jie Liu <liujie375(a)h-partners.com>
Add ECV doc.
Signed-off-by: Jie Liu <liujie375(a)h-partners.com>
---
.../Wayca-Kunpeng-高性能调度/README.md | 5 ++
...Kunpeng-高性能调度-CPU特性介绍.md | 26 +++++++
...g-高性能调度-ECV用户使用指南.md | 70 +++++++++++++++++++
3 files changed, 101 insertions(+)
create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/Wayca-Kunpeng-高性能调度-ECV用户使用指南.md
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/README.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/README.md
index 86a670f..b6fa051 100644
--- a/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/README.md
+++ b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/README.md
@@ -33,3 +33,8 @@
- Wayca-Kunpeng-高性能调度-LSE用户使用指南.md
- https://gitee.com/openeuler/WayCa
+
+### ECV用户使用指南
+
+- Wayca-Kunpeng-高性能调度-ECV用户使用指南.md
+- https://gitee.com/openeuler/WayCa
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/Wayca-Kunpeng-高性能调度-CPU特性介绍.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/Wayca-Kunpeng-高性能调度-CPU特性介绍.md
index bbfcaa1..2d7d414 100644
--- a/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/Wayca-Kunpeng-高性能调度-CPU特性介绍.md
+++ b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/Wayca-Kunpeng-高性能调度-CPU特性介绍.md
@@ -153,3 +153,29 @@ LSE仅在A64中支持, 要求在Armv8.1及之后的版本必须实现。
| 6059a7b6e818 | arm64: atomics: implement atomic{,64}_cmpxchg using cmpxchg | Y |
| db26217e6f54 | arm64: atomic64_dec_if_positive: fix incorrect branch condition | Y |
| 95eff6b27c40 | arm64: kconfig: select HAVE_CMPXCHG_LOCAL | Y |
+
+### 特性5：ECV(Enhanced Counter Virtualization)
+
+- 特性详解
+
+armv8.7引入ECV特性来读取系统用计数器，以减小为了确保指令执行顺序而设置isb(内存屏障)带来的开销。ECV提供了一组与通用寄存器对照的
+自同步寄存器，可读取这组映射通用计数器值的寄存器从而减少isb带来的开销。
+
+- 源码仓库： https://gitee.com/openeuler/kernel/
+
+- 特性代码： arch/arm64/kernel arch/arm64/include/asm drivers/clocksource/
+
+- 支持版本： openEuler 22.03 lts、openEuler 22.03 lts SP1
+
+- 回合的关键patches:
+| COMMITID | SUBJECT | openeuler OLK-5.10 enabled（Y/N） |
+| ---------- | ---------- | ----------- |
+| 57f27666f91a8 | clocksource/arm_arch_timer: Drop use of static key in arch_timer_reg_read_stable | Y |
+| 68b0fd268c118 | arm64: Add CNT{P,V}CTSS_EL0 alternatives to cnt{p,v}ct_el0 | Y |
+| 6acc71ccac718 | arm64: arch_timer: Allows a CPU-specific erratum to only affect a subset of CPUs | Y |
+| f31e98bfae1c8 | arm64: arch_timer: mark functions as __always_inline | Y |
+| 0ea415390cd34 | clocksource/arm_arch_timer: Use arch_timer_read_counter to access stable counters | Y |
+| 75a19a0202db2 | arm64: arch_timer: Ensure counter register reads occur with seqlock held | Y |
+| 1aee5d7a8120c | arm64: move from arm_generic to arm_arch_timer | Y |
+| 0583fe478a7d9 | ARM: convert arm/arm64 arch timer to use CLKSRC_OF init | Y |
+| 4ad499c94264a | Documentation: Add ARM64 to kernel-parameters.rst | Y |
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/Wayca-Kunpeng-高性能调度-ECV用户使用指南.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/Wayca-Kunpeng-高性能调度-ECV用户使用指南.md
new file mode 100644
index 0000000..9c502a4
--- /dev/null
+++ b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高性能调度/Wayca-Kunpeng-高性能调度-ECV用户使用指南.md
@@ -0,0 +1,70 @@
+# Wayca-Kunpeng-高性能调度-ECV用户使用指南
+
+当前Linux主线已支持该特性
+
+## 1. 介绍
+
+armv8.7引入ECV特性来读取系统用计数器，以减小为了确保指令执行顺序而设置isb(内存屏障)带来的开销。ECV提供了一组与通用寄存器对照的
+自同步寄存器，可读取这组映射通用计数器值的寄存器从而减少isb带来的开销。
+
+## 2. 内存屏障
+
+arm架构属于弱内存序，执行指令时不一定会顺序执行，可能会对指令进行重排序。
+内存屏障的引入，本质上是由于CPU重排序指令引起的，主要源自以下几种场景：
+- 编译器编译时的优化
+- 处理器执行时的多发射和乱序优化
+- 读取和存储指令的优化
+- 缓存同步顺序（导致可见性问题）
+
+内存屏障就是一类同步屏障指令，是CPU或者编译器在对内存随机访问的操作中的一个同步点，只有在此点之前的所有读写操作都执行后才可以执行
+此点之后的操作。
+
+## 3. 相关寄存器
+
+CNTPCT_EL0：保存64位物理计数值，该寄存器的值映射到AARCH32的通用计数器CNTPCT。
+CNTPCTSS_EL0：以自同步方式保持物理计数值（与CNTPCT值相同），此寄存器只有FEAT_ECV使能时才能访问，且不能被投机访问。CNTPCTSS_EL0
+的自同步以及不能被投机性访问的性质保证了CPU不能对对该寄存器的读写操作重排序。
+CNTPOFF_EL2：保存 64 位物理偏移量。这是启用增强计数器虚拟化时 AArch64 物理计时器和计数器的偏移量。当在当前安全状态下实现并启用
+EL2 时，如果满足以下任一条件，物理计数器将使用固定物理偏移量零：
+- CNTHCTL_EL2.ECV为 0
+- SCR_EL3.ECVEn为 0
+- HCR_EL2 .{E2H, TGE} 为{1, 1}
+
+相较于从EL2或EL3访问CNTPCTESS_EL0时，EL0和EL1该寄存器的值为(PhysicalCountInt<63:0> - CNTPOFF_EL2 <63:0>)，其中
+PhysicalCountInt<63:0> 是从 EL2 或 EL3 读取 CNTPCT_EL0 时返回的物理计数。
+
+## 4. 内核配置支持
+
+内核中没有ECV特性相关CONFIG，ARM64_HAS_ECV宏对ECV特性进行控制。
+
+## 5. 编译器支持
+
+ECV使能需要编译器支持
+
+- GCC
+
+当使用GCC编译器时, 需要支持以下选项
+
+-march=armv8.7-a或-march=Armv8-a+ecv
+
+- Clang
+
+当使用Clang编译器时, 需要支持-march=ecv选项
+
+## 6. 软件接口
+
+用户可以通过/proc/cpuinfo或HWCAP或者查询ID_AA64MMFR0_EL1.ECV域查询硬件对于ECV的支持情况。
+
+## 7. 涉及代码和使能
+
+| COMMITID | SUBJECT | openeuler OLK-5.10 enabled（Y/N） |
+| ---------- | ---------- | ----------- |
+| 57f27666f91a8 | clocksource/arm_arch_timer: Drop use of static key in arch_timer_reg_read_stable | Y |
+| 68b0fd268c118 | arm64: Add CNT{P,V}CTSS_EL0 alternatives to cnt{p,v}ct_el0 | Y |
+| 6acc71ccac718 | arm64: arch_timer: Allows a CPU-specific erratum to only affect a subset of CPUs | Y |
+| f31e98bfae1c8 | arm64: arch_timer: mark functions as __always_inline | Y |
+| 0ea415390cd34 | clocksource/arm_arch_timer: Use arch_timer_read_counter to access stable counters | Y |
+| 75a19a0202db2 | arm64: arch_timer: Ensure counter register reads occur with seqlock held | Y |
+| 1aee5d7a8120c | arm64: move from arm_generic to arm_arch_timer | Y |
+| 0583fe478a7d9 | ARM: convert arm/arm64 arch timer to use CLKSRC_OF init | Y |
+| 4ad499c94264a | Documentation: Add ARM64 to kernel-parameters.rst | Y |
--
2.24.0
1
4
From: caijian <caijian11(a)h-partners.com>
Signed-off-by: Jian Cai <caijian11(a)h-partners.com>
---
.../Wayca-Kunpeng-虚拟化/README.md | 22 +-
...yCa-Kunpeng-虚拟化模块特性介绍.md | 681 ++++++++++++++++++
...yCa-Kunpeng-虚拟化用户使用指南.md | 74 ++
...Kunpeng-虚拟化-xxx模块特性介绍.md | 38 -
...ng-虚拟化xxx技术用户使用指南.md | 39 --
5 files changed, 761 insertions(+), 93 deletions(-)
create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/WayCa-Kunpeng-虚拟化模块特性介绍.md
create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/WayCa-Kunpeng-虚拟化用户使用指南.md
delete mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/Wayca-Kunpeng-虚拟化-xxx模块特性介绍.md
delete mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/Wayca-Kunpeng-虚拟化xxx技术用户使用指南.md
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/README.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/README.md
index ee2c5f9..5e526ee 100644
--- a/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/README.md
+++ b/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/README.md
@@ -1,23 +1,13 @@
-# openEuler WayCa 鲲鹏 xxx
+# openEuler WayCa 鲲鹏 虚拟化
-## xxx
-- 鲲鹏高速网络主要使用鲲鹏硬件xxx模块， 主要应用涉及xxx技术和xxx等高速网络技术。
-本文档提供了鲲鹏xx特性的基本使用和模块的特性介绍，具体内容详见如下：
+## 虚拟化 文档
-## xxx 技术文档
+- WayCa-Kunpeng-虚拟化用户使用指南.md
+- https://gitee.com/openeuler/WayCa/blob/master/WayCa-Kunpeng-底软/Wayca-Kunpen…
-- WayCa-Kunpeng-xxx-xxx技术用户使用指南.md
-- https://gitee.com/openeuler/xxx/wayca-Kunpeng-xxx/xx文档
+- WayCa-Kunpeng-虚拟化模块特性介绍.md
+- https://gitee.com/openeuler/WayCa/blob/master/WayCa-Kunpeng-底软/Wayca-Kunpen…
-- WayCa-Kunpeng-xxxx-xxx模块特性介绍.md
-- https://gitee.com/openeuler/xxx/wayca-Kunpeng-xxx/xx文档
-## Roce rdma-core 技术文档
-
-- WayCa-Kunpeng-xxxx-xxx技术用户使用指南.md
-- https://gitee.com/openeuler/xxx/wayca-Kunpeng-xxxx/xx文档
-
-- WayCa-Kunpeng-xxxx-xxx模块特性介绍.md
-- https://gitee.com/openeuler/xxx/wayca-Kunpeng-xxxx/xx文档
\ No newline at end of file
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/WayCa-Kunpeng-虚拟化模块特性介绍.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/WayCa-Kunpeng-虚拟化模块特性介绍.md
new file mode 100644
index 0000000..c5a22ff
--- /dev/null
+++ b/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/WayCa-Kunpeng-虚拟化模块特性介绍.md
@@ -0,0 +1,653 @@
+# openEuler WayCa 鲲鹏虚拟化模块介绍
+
+## 一、虚拟化介绍
+虚拟化是一种资源管理技术，它将计算机的各种实体资源（CPU、内存、存储、网络等）予以抽象和转化出来，并提供分割、重新组合，以达到最大化利用物理资源的目的。
+虚拟化主要分为：CPU虚拟化、内存虚拟化、中断虚拟化、IO设备的虚拟化等。其中qemu-kvm虚拟化技术较为热门。KVM运行在内核空间，负责模拟虚拟机的CPU运行，内存管理，设备管理等；QEMU运行在用户空间，负责模拟虚拟机的IO设备接口以及用户态控制接口。QEMU通过设备文件/dev/kvm进行IOCTL控制KVM模块的运行过程。
+
+
+## 二、虚拟化特性介绍
+### 特性1：支持TRAP DELAY
+- 特性介绍
+
+TWE Delay是ARMv8.6扩展中一个可选特性，合入代码到内核中，进入系统后，
+dmesg | grep "Delayed Trapping of WFE"有如下打印：
+ 
+
+- 内核配置
+
+CONFIG_ARM64_TWED
+- 涉及代码及使能
+
+上游社区：https://gitee.com/openeuler/kernel/tree/OLK-5.10/
+
+| Commit ID | Subject | openeuler OLK-5.10 enabled(Y/N)| Linux Mainline enabled(Y/N) |
+| ------------ | ------------ | :------------: | :------------: |
+| 1d9393307f4f | arm64: cpufeature: TWED support detection | Y | N |
+| 9c8b91e8dbf7 | KVM: arm64: Make use of TWED feature | Y | N |
+
+### 特性2：支持ARM pvspinlock
+- 特性介绍
+
+对于Guest OS上每个CPU（称为VCPU）实际上为Host OS上一个线程，该线程可称为VCPU线程。当虚拟机上VCPU大于实际CPU数目时，很多VCPU线程可能处于被调出SCHED_OUT的状态。在调度和锁的某些场景下，这些VCPU线程虽然处于SCHED_OUT状态，无法工作，但在Guest OS中呈现出这些VCPU处于idle，因此在Guest OS中仍尝试将任务往这些VCPU上执行，从而造成任务的阻塞或时延增大。
+在当前内核的调度和锁的某些场景下允许Guest OS通过vcpu_is_preempted()检查VCPU是否被SCHED_OUT，从而决定在Guest OS中是否将任务在这些VCPU上执行，达到优化性能的目的。
+
+- 特性使能
+
+使能配置项：
+<br>
+CONFIG_PARAVIRT
+<br>
+CONFIG_PARAVIRT_SPINLOCKS
+- 特性测试
+
+ 
+- 涉及代码及使能
+
+上游代码分支：https://gitee.com/openeuler/kernel/tree/OLK-5.10
+
+| Commit ID | Subject | openEuler OLK-5.10 enabled(Y/N)| Linux Mainline enabled（Y/N）
+| ------------ | ------------ | :----------:| :-----------:|
+| b74edaf629bd | KVM: arm64: Document PV-sched interface | Y | N|
+| a0b95bdf6a0b | KVM: arm64: Implement PV_SCHED_FEATURES call | Y| N |
+| 76732c97a3ec | KVM: arm64: Support pvsched preempted via shared structure | Y| N|
+| 63042c58affc | KVM: arm64: Add interface to support vCPU preempted check | Y| N|
+| cf6d95e33dfa | KVM: arm64: Support the vCPU preemption check | Y| N|
+| 7a645f6e24ee | KVM: arm64: Add SMCCC PV-sched to kick cpu | Y| N|
+| efed88dd5934 | KVM: arm64: Implement PV_SCHED_KICK_CPU call | Y | N |
+| 12e1ed766c34 | KVM: arm64: Add interface to support PV qspinlock | Y | N |
+| 72fa593a0e5f | KVM: arm64: Enable PV qspinlock | Y| N|
+| fab413f6ee84 | KVM: arm64: Add tracepoints for PV qspinlock | Y | N |
+| 38134bb6f2a4 | arm/arm64: paravirt: Remove GPL from pv_ops export | Y | N |
+| bf96cce4df94 | kvm: arm64: fix some pvsched bugs | Y|N |
+
+### 特性3：支持VFIO直通热迁移
+- 特性介绍
+
+VFIO直通热迁移功能主要包含两方面内容：DMA脏页热迁移和中断状态热迁移。
+
+鲲鹏920设计实现SMMU HTTU硬件辅助虚拟化扩展，支持硬件自动标记脏页，将设备DMA脏页信息记录在页表项，为DMA脏页迁移提供了硬件支持。基于此硬件特性，在SMMU驱动层实现DMA自动标脏的机制，其中包括一套完整的页表操作、时序控制；同时在内核定义一套完整的脏页管理接口规范，包括开启/关闭标脏、取脏、清脏等用户态接口，实现设备DMA脏页热迁移。
+
+VFIO直通热迁移场景，采用GICv4.1中断透传场景，虚拟中断状态维护在VPT表中，需要软硬结合维护虚拟中断信息。鲲鹏920设计实现GICv4.1硬件辅助虚拟化扩展，通过软件方式同步GIC硬件cache。软件通过访问内存中的虚拟pending表，实现中断状态的保存&恢复。
+- 接口描述
+
+DMA脏页热迁移功能接口表
+
+| 接口名称 | 涉及子系统/模块 | 描述 |
+| ------------ | ------------ | ------------ |
+|vfio_iova_dirty_log_clear | VFIO/type1 | 接收并处理QEMU下发的清脏请求 |
+| iommu_switch_dirty_log | IOMMU/SMMU | 开启/关闭标脏 |
+| iommu_sync_dirty_log | IOMMU/SMMU | 获取DMA内存脏页信息 |
+| iommu_clear_dirty_log | IOMMU/SMMU | 清空DMA内存脏页bitmap，并将页表写保护 |
+
+中断状态热迁移功能接口表
+
+| 接口名称 | 涉及的子系统/模块 |描述 |
+| ------------ | ------------ | ------------ |
+| vgic_v4_get_vlpi_state | KVM | 根据规范从硬件获取中断状态 |
+- 涉及代码及使能
+
+DMA脏页热迁移：
+<br>
+内核部分上游社区：https://gitee.com/openeuler/kernel/tree/OLK-5.10/
+
+| Commit ID | Subject | openEuler OLK-5.10 enabled(Y/N) | Linux Mainline enabled(Y/N) |
+| ------------ | ------------ | :------------: | :------------: |
+| b5ea330577ac | vfio/iommu_type1: Mantain a counter for non_pinned_groups | Y | N |
+| bbf3b39e5576 | iommu: Introduce dirty log tracking framework | Y | N |
+| 341497bb2613 | iommu/io-pgtable-arm: Add quirk ARM_HD and ARM_BBMLx | Y | N |
+| 8b8bda8ea12f |iommu/io-pgtable-arm: Add and realize split_block ops | Y | N |
+| bca6b146b15b | iommu/io-pgtable-arm: Add and realize merge_page ops | Y | N |
+| f92820e88ef3 | iommu/io-pgtable-arm: Add and realize sync_dirty_log ops | Y | N|
+| bdc8c00c1eef | iommu/io-pgtable-arm: Add and realize clear_dirty_log ops | Y | N |
+| 240923005330 | iommu/arm-smmu-v3: Add support for Hardware Translation Table Update | Y | N |
+| c2f77dfa27a1 | iommu/arm-smmu-v3: Enable HTTU for stage1 with io-pgtable mapping | Y | N |
+| 829e1611a732 | iommu/arm-smmu-v3: Add feature detection for BBML | Y | N |
+| 947019a923b9 | iommu/arm-smmu-v3: Realize switch_dirty_log iommu ops | Y | N |
+| beee685e5432 | iommu/arm-smmu-v3: Realize sync_dirty_log iommu ops | Y | N |
+| 5e064fc06d95 | iommu/arm-smmu-v3: Realize clear_dirty_log iommu ops| Y| N|
+| 74f676cb92db| iommu/arm-smmu-v3: Realize support_dirty_log iommu ops |Y |N|
+| d2373c56459f| vfio/iommu_type1: Add HWDBM status maintenance | Y|N|
+| 1421b71ccda9|vfio/iommu_type1: Optimize dirty bitmap population based on iommu HWDBM |Y |N|
+| f1c9b9fa4fbc|vfio/iommu_type1: Add support for manual dirty log clear |Y|N|
+
+qemu部分上游社区:https://gitee.com/openeuler/qemu/tree/qemu-6.2.0
+
+| Commit ID | Subject | openEuler/qemu/qemu-6.2.0 enabled(Y/N) | qemu mainline enabled(Y/N) |
+| ------------ | ------------ | :------------: | :------------: |
+| 4051277362 | linux-headers: update against 5.10 and manual clear vfio dirty log series | Y | N |
+| ac1bf3edcd | vfio: Maintain DMA mapping range for the container | Y | N |
+| 815258f81a | vfio/migration: Add support for manual clear vfio dirty log | Y | N |
+
+中断状态热迁移：
+<br>
+上游社区仓库：https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
+
+| Commit ID | Subject | openEuler OLK-5.10 enabled(Y/N) | Linux Mainline enabled(Y/N) |
+| ------------ | ------------ | :------------: | :------------: |
+| 301beaf19739 |irqchip/gic-v3-its: Add a cache invalidation right after vPE unmapping | Y | Y |
+| c21bc068cdbe |irqchip/gic-v3-its: Drop the setting of PTZ altogether | Y | Y|
+| 80317fe4a653 | KVM: arm64: GICv4.1: Add function to get VLPI state | Y | Y |
+| f66b7b151e00 | KVM: arm64: GICv4.1: Try to save VLPI state in save_pending_tables | Y | Y|
+| 12df7429213a | KVM: arm64: GICv4.1: Restore VLPI pending state to physical side | Y | Y |
+| 8082d50f4817 | KVM: arm64: GICv4.1: Give a chance to save VLPI state | Y | Y|
+
+### 特性4：支持虚拟内存/存储
+- 特性介绍
+
+该特性主要是qemu支持nvdimm/pmem以及内存的热插操作，nvdimm用作虚拟机磁盘，pc-dimm用作虚拟机内存。
+- nvdimm支持
+
+虚拟机启动命令
+
+```c
+qemu-system-aarch64 -machine virt,kernel_irqchip=on,gic-version=3,nvdimm=on \
+-m 1G,maxmem=5G,slots=4 \
+-object memory-backend-ram,id=ram1,size=1G \
+-device nvdimm,id=dimm1,memdev=ram1 \
+-enable-kvm -cpu host \
+-smp 2 \
+-bios ./QEMU_EFI.fd \
+-kernel ./Image -initrd ./minifs.cpio.gz -nographic \
+-append "rdinit=init console=ttyAMA0 earlycon=pl011,0x90000000" -net none
+```
+
+进入虚拟机后，使用命令 fdisk -l 查看配置的nvdimm大小，按Ctrl + A后松开迅速按C进入（退出）qemu monitor中,输入以下命令查询配置的nvdimm相关信息
+
+```c
+info memory_size_summary
+info memory-devices
+```
+
+- pc-dimm支持
+
+虚拟机启动命令中添加
+
+```c
+qemu-system-aarch64 -machine virt,gic-version=3 \
+-m 4G,maxmem=8G,slots=4 \
+-object memory-backend-ram,id=ram1,size=1G \
+-device pc-dimm,id=dimm1,memdev=ram1 \
+-enable-kvm -cpu host -smp 4 \
+...
+```
+
+进入虚拟机后，使用 free 命令查看内存大小为配置的pc-dimm大小加上基础内存大小，按Ctrl + A后松开迅速按C进入（退出）qemu monitor中,输入以下命令查询配置的pc-dimm相关信息
+
+```c
+info memory_size_summary
+info memory-devices
+```
+- 涉及代码及使能
+
+上游社区代码仓：https://github.com/qemu/qemu.git
+
+| Commit ID | Subject | openEuler/qemu/qemu-6.2.0 enabled(Y/N) | qemu mainline enabled(Y/N) |
+| ------------ | ------------ | :------------: | :------------: |
+| ce4adc0b6e |exec: Fix for qemu_ram_resize() callback | Y | Y |
+| 71b0269ae9 | hw/acpi/nvdimm: Fix for NVDIMM incorrect DSM output buffer length | Y | Y |
+| 5c94b82662 | nvdimm: Use configurable ACPI IO base and size | Y | Y |
+| b5a60bee74 | hw/arm/virt: Add nvdimm hot-plug infrastructure | Y | Y |
+| c2505d1c56 | hw/arm/virt: Add nvdimm hotplug support | Y | Y |
+|122752d267 | tests: Update ACPI tables list for upcoming arm/virt test changes | Y | Y |
+| 62293b4f58 | bios-tables-test: test pc-dimm and nvdimm coldplug for arm/virt | Y | Y |
+
+- nvdimm热插
+
+虚拟机启动命令中加入
+
+```c
+qemu-system-aarch64 -machine virt，kernel_irqchip=on,gic-version=3,nvdimm=on \
+-m 8G,maxmem=16G,slots=4 \
+-enable-kvm -cpu host -smp 8 \
+-bios QEMU_EFI.fd \
+...
+```
+
+进入虚拟机后，按Ctrl + A后松开迅速按C进入qemu monitor中，使用以下命令向虚拟机插入nvdimm：
+
+```c
+object_add memory-backend-ram,id=ram1,size=2G
+device_add nvdimm,id=dimm1,memdev=ram1
+```
+
+显示热插成功后，输入以下命令查询插入的nvdimm相关信息
+```c
+info memory_size_summary
+info memory-devices
+```
+
+使用进入qemu monitor的同样方法退出qemu monitor，使用命令 fdisk -l 可以查看插入的nvdimm大小。
+- pc-dimm热插
+
+虚拟机启动命令中加入
+
+```c
+qemu-system-aarch64 -machine virt,gic-version=3 \
+-m 8G,maxmem=16G,slots=4 \
+-enable-kvm -cpu host -smp 8 \
+-bios QEMU_EFI.fd \
+...
+```
+
+进入虚拟机后，按Ctrl + A后松开迅速按C进入qemu monitor中，使用以下命令向虚拟机插入pc-dimm：
+```c
+object_add memory-backend-ram,id=ram1,size=2G
+device_add pc-dimm,id=dimm1,memdev=ram1
+```
+
+显示热插成功后，输入以下命令查询插入的pc-dimm相关信息
+```c
+info memory_size_summary
+info memory-devices
+```
+使用进入qemu monitor的同样方法退出qemu monitor，使用命令 free 可以查看插入的pc-dimm大小。
+- 涉及代码及使能
+
+上游社区代码仓：https://github.com/qemu/qemu.git
+
+| Commit ID | Subject | openEuler/qemu/qemu-6.2.0 enabled(Y/N) | qemu mainline enabled(Y/N) |
+| ------------ | ------------ | :------------: | :------------: |
+| 091c466e26 | hw/acpi: Make ACPI IO address space configurable | Y | Y |
+| 22338fea78 |Do not create memory hotplug method when handler is not defined | Y | Y |
+| ebb6207502 | hw/acpi: Add ACPI Generic Event Device Support | Y | Y |
+| 1f283ae124 | hw/arm/virt: Add memory hotplug framework | Y | Y |
+| cff51ac978 | hw/arm/virt: Enable device memory cold/hot plug with ACPI boot | Y | Y |
+| 442da7dc77 |hw/arm/virt-acpi-build: Add PC-DIMM in SRAT | Y | Y |
+| c345680cb4 | hw/arm: Factor out powerdown notifier from GPIO | Y | Y |
+| 1962f31b86 | hw/arm: Use GED for system_powerdown event | Y | Y |
+| e86fba5009 | docs/specs: Add ACPI GED documentation | Y | Y |
+| cd0f061c78 | tests: Update ACPI tables list for upcoming arm/virt tests | Y | Y |
+| 669c77433b | tests: Add bios tests to arm/virt | Y | Y |
+
+### 特性5：支持TLBI广播优化
+- 特性介绍
+
+在虚拟化场景，硬件不感知一个虚拟机vCPU线程具体在哪些pCPU上运行过，因此vCPU的TLBI指令会被统一广播到全系统范围的所有物理核上，并在所有物理核上刷新TLB，这里会产生不必要的性能开销。从功能上分析，硬件只需要在该vCPU运行过的那些pCPU上刷新TLB即可。
+
+DVMBM特性，用于TLBI广播优化。新增寄存器用于检测硬件是否支持该特性、开启/关闭特性、配置TLBI的广播范围等。开启TLBI广播优化特性后，在虚拟化场景，通过配置一个pCPU的LSUDVMBM_EL2寄存器，可以控制该pCPU上的虚拟机TLBI指令只在指定的CPU范围内广播，从而避免不必要的开销。
+- DVMBM使能
+
+软件上新增了一个内核启动参数，可以在用户态全局地开启/关闭DVMBM特性，系统默认为关闭。若要使能该特性，可以在Host内核的启动命令中配置该参数值为1，即kvm-arm.dvmbm_enabled =1，在KVM初始化阶段，若系统检测到硬件支持DVMBM特性且参数dvmbm_enabled的值为1时，会将所有的物理核的DVMBM特性开启，并打印kvm [1]: KVM dvmbm enabled 。否则，会将所有的物理核的DVMBM特性关闭，并打印kvm [1]: KVM dvmbm disabled 。
+
+- 内核配置
+
+CONFIG_KVM_HISI_VIRT
+
+- 特性检测及应用
+
+TLBI广播优化特性检测：
+<br>
+AIDR_EL1寄存器
+检测硬件是否支持DVMBM特性，即TLBI范围广播。
+读取AIDR_EL1：该寄存器为自定义特性ID寄存器。
+
+| [31:14] | [13:12] | [11] | [10] | [9] |[8]|[7]|[6]|[5]|[4]|[3-0]|
+| ------------ | ------------ | ------------ | ------------ | -------- | --- | -- | -- | -- | -- | -- |
+| | DVMBM | | |
+
+0b00：不支持TLBI广播优化特性；0b01：支持TLBI广播优化特性。
+
+TLBI广播优化特性应用：
+<br>
+LSUDVMBM_EL2寄存器
+增加LSUDVMBM_EL2寄存器，该寄存器用于保存TLBI范围广播的CPU位图。当虚拟机vCPU执行TLBI指令时，其所在的物理CPU会首先读取LSUDVMBM_EL2寄存器中保存的CPU位图，并只将TLBI指令广播至位图中指定的pCPU上，即只在一定范围内的物理CPU上刷新TLB。
+
+目前TLBI的广播范围以VM为粒度，即广播的CPU范围是该虚拟机所有vCPU绑核范围的并集。举例来说，配置4U虚拟机，vCPU 0-3分别一一绑核至物理机的2，4，6，8号CPU上，那么该虚拟机的TLBI广播范围为[2, 4, 6, 8]。当虚拟机的某个vCPU执行TLBI指令时，该vCPU所运行的物理核会将TLBI指令统一广播至2，4，6，8号CPU上执行。
+- 涉及代码及使能
+
+上游社区：https://gitee.com/openeuler/kernel/tree/OLK-5.10/
+
+| Commit ID | Subject | openeuler OLK-5.10 enabled（Y/N） | The Mainline of Linux enabled(Y/N)|
+| ------------ | ------------ | :------------: | :---: |
+| 7b4316e960ed | KVM: arm64: Support a new HiSi CPU type | Y |N|
+| 31e5359825aa | KVM: arm64: Probe and configure DVMBM capability on HiSi CPUs | Y |N |
+| 8d396309b829 | KVM: arm64: Add kvm_vcpu_arch::cpus_ptr and pre_cpus_ptr | Y |N |
+| f0a92b35997a | KVM: arm64: Add kvm_arch::dvm_cpumask and dvm_lock | Y | N|
+| 1489b74dd421 | KVM: arm64: Implement the capability of DVMBM | Y| N|
+### 特性6：支持SVE2虚拟化
+- 特性介绍
+
+SVE/SVE2虚拟化的目标，是要给虚拟机呈现SVE特性，包括SVE指令集以及SVE寄存器组，从而虚拟机能够基于SVE矢量运算提升整机计算性能，如编译性能优化等。
+- 内核配置及硬件支持
+
+SVE使能需要开启以下内核配置：CONFIG_ARM64_SVE
+
+硬件支持SVE/SVE2：ID_AA64PFR0_EL1和ID_AA64ZFR0_EL1寄存器
+
+ID_AA64PFR0_EL1寄存器的SVE, bits [35:32]
+
+Scalable Vector Extension. Defined values are:
+
+| SVE | Meaning |
+| ------------ | ------------ |
+| 0b0000 | SVE architectural state and programmers' model are not implemented. |
+| 0b0001 | SVE architectural state and programmers' model are implemented. |
+
+ID_AA64ZFR0_EL1寄存器的SVEver, bits [3:0]
+
+Indicates support for SVE.Defined values are:
+
+| SVEver | Meaning |
+| ------------ | ------------ |
+| 0b0000 | SVE instructions are implemented. |
+| 0b0001 | SVE and the non-optional SVE2 instructions are implemented.|
+
+- 接口描述
+
+| 接口名称 | 接口类型 | 涉及的子系统/模块 | 描述 |
+| ------------ | ------------ | ------------ | ------------ |
+| “sve” | QEMU命令行参数 | QEMU | 用户通过该参数，控制是否给vcpu使能FEAT_SVE |
+| “sve<N>”，如sve128，sve256等|QEMU命令行参数 | QEMU | 用户通过该参数，指定vcpu上支持的SVE vector length |
+
+qemu启动命令中-cpu 参数可以设置sve长度：-cpu host,sve128=on或者sve256=on等。
+
+查询SVE/SVE2特性支持情况：
+
+用户态软件可以通过<sys/auxv.h>中getauxval(AT_HWCAP)/getauxval(AT_HWCAP2)函数判断当前的硬件和内核是否支持SVE/SVE2；通过lscpu命令或/proc/cpuinfo文件可查看SVE/SVE2虚拟化的支持情况。
+
+可通过/proc/sys/abi/sve_default_vector_length查看SVE的向量长度。
+
+- 涉及代码及使能
+
+上游社区代码仓： https://github.com/qemu/qemu.git
+
+| Commit ID（qemu主线） | Subject | openEuler/qemu/qemu-6.2.0 enabled(Y/N)|
+| ------------ | ------------ | :------------: |
+| e19afd5667 | target/arm/monitor: Introduce qmp_query_cpu_model_expansion | Y |
+| bd31b751a3 | tests: arm: Introduce cpu feature tests | Y |
+| 73234775ad | target/arm: Allow SVE to be disabled via a CPU property | Y |
+| 0df9142d27 | target/arm/cpu64: max cpu: Introduce sve<N> properties | Y |
+| 40b3fd21fb | target/arm/kvm64: Add kvm_arch_get/put_sve | Y|
+| 14e99e0fbb | target/arm/kvm64: max cpu: Enable SVE when available | Y |
+| 0cdb4020b3 | target/arm/kvm: scratch vcpu: Preserve input kvm_vcpu_init features | Y |
+| 6fa8a37949 | target/arm/cpu64: max cpu: Support sve properties with KVM | Y |
+| 87014c6b36 | target/arm/kvm: host cpu: Add support for sve<N> properties|Y |
+
+上游社区代码仓： https://github.com/qemu/qemu.git
+
+| Commit ID (qemu主线) | Subject | openEuler/qemu/qemu-6.2.0 enabled(Y/N) |
+| ------------ | ------------ | :------------: |
+| 0dd14e9555 | target/arm: Use kvm_arm_sve_supported in kvm_arm_get_host_cpu_features |Y |
+| b9e8d68a39 | target/arm: Set KVM_ARM_VCPU_SVE while probing the host | Y |
+| 5265d24c98 | target/arm: Move sve probe inside kvm >= 4.15 branch | Y |
+
+
+上游社区代码仓： http://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
+
+| Commit ID（linux主线） | Subject | openeuler OLK-5.10 enabled（Y/N） |
+| ------------ | ------------ | :------------: |
+| fd3bc912d3d1 | KVM: Documentation: Document arm64 core registers in detail | Y |
+| efbc20249fee | arm64: fpsimd: Always set TIF_FOREIGN_FPSTATE on task state flush | Y |
+| 38abf22e122e | KVM: arm64: Delete orphaned declaration for __fpsimd_enabled() | Y|
+| 7aa92cf318f8 | KVM: arm64: Refactor kvm_arm_num_regs() for easier maintenance | Y |
+| 3f61f40947e8 | KVM: arm64: Add missing #includes to kvm_host.h | Y |
+| 8b08e8401fb4 | arm64/sve: Clarify role of the VQ map maintenance functions | Y |
+| d06b76be8dad | arm64/sve: Check SVE virtualisability | Y|
+| 0495067420f3 | arm64/sve: Enable SVE state tracking for non-task contexts | Y |
+|1765edbab16e| KVM: arm64: Add a vcpu flag to control SVE visibility for the guest|Y |
+|1c19991390ae| KVM: arm64: Propagate vcpu into read_id_reg()| Y|
+|7f34e4090394| KVM: arm64: Support runtime sysreg visibility filtering | Y|
+|73433762fcae| KVM: arm64/sve: System register context switch and access support|Y |
+|b43b5dd990eb| KVM: arm64/sve: Context switch the SVE registers| Y|
+|2b953ea34812| KVM: Allow 2048-bit register access via ioctl interface| Y|
+|dc52f31a928b| KVM: arm64: Add missing #include of <linux/string.h> in guest.c| Y|
+|be25bbb392fa| KVM: arm64: Factor out core register ID enumeration| Y|
+|8c86dfe39d5d| KVM: arm64: Reject ioctl access to FPSIMD V-regs on SVE vcpus|Y |
+|e1c9c98345b3| KVM: arm64/sve: Add SVE support to register access ioctl interface|Y |
+|8e3c54c8b6a9| KVM: arm64: Enumerate SVE register indices for KVM_GET_REG_LIST| Y|
+|ead9e430c0fb| arm64/sve: In-kernel vector length availability query interface| Y|
+|0f062bfe36b6| KVM: arm/arm64: Add hook for arch-specific KVM initialisation| Y|
+|7dd32a0d0103| KVM: arm/arm64: Add KVM_ARM_VCPU_FINALIZE ioctl| Y|
+|9033bba4b535| KVM: arm64/sve: Add pseudo-register for the guest's vector lengths|Y |
+|9a3cdf26e336| KVM: arm64/sve: Allow userspace to enable SVE for vcpus| Y|
+|555f3d03e7fb| KVM: arm64: Add a capability to advertise SVE support|Y |
+|395f562f2b4c| KVM: Document errors for KVM_GET_ONE_REG and KVM_SET_ONE_REG|Y |
+|50036ad06b7f| KVM: arm64/sve: Document KVM API extensions for SVE| Y|
+
+### 特性7：支持vCPU热插
+- 特性介绍
+
+虚拟机vCPU热插支持可以帮助虚拟机在高负载的情况下，不用停机直接通过热插vCPU的方式动态地为虚拟机进行弹性扩展，保证虚拟机里的业务稳定。openEuler社区的qemu-4.1.0实现了aarch64 CPU热插特性，qemu-6.2.0中增加了smp.clusters热插支持。CPU热插功能涉及的修改主要包括ACPI（MADT表，DSDT表），GED，GICv3，以及热插流程的支持。
+
+- 热插使能支持
+
+虚拟机需要以ACPI的方式启动
+
+- 虚拟机vCPU热插操作及接口查询
+
+起虚拟机命令参数：
+```
+qemu-system-aarch64 \
+... \
+-cpu host -enable-kvm \
+-bios QEMU_EFI.fd \
+-smp cpus=14,maxcpus=16,sockets=2,clusters=2,cores=2,threads=2 \
+...
+```
+进入虚拟机后按Ctrl + A 松开迅速按下C进入qemu monitor里面执行
+```
+(qemu)device_add host-arm-cpu,socket-id=1,cluster-id=1,core-id=1,thread-id=0,id=core14
+(qemu)device_add host-arm-cpu,socket-id=1,cluster-id=1,core-id=1,thread-id=1,id=core15
+```
+同样方法退出qemu monitor后按回车进入虚拟机；
+
+lscpu可以查看到处于offline的CPU即为热插的CPU，也可以在/sys/devices/system/cpu/目录下查看到cpu14、cpu15文件夹（热插之前是没有的），里面记录着热插CPU的信息。
+
+上线热插的CPU
+```
+echo 1 > /sys/devices/system/cpu/cpu14/online
+echo 1 > /sys/devices/system/cpu/cpu15/online
+```
+- 涉及代码及使能
+
+上游社区代码仓：https://gitee.com/openeuler/qemu.git
+
+| Commit ID (未合入qemu社区主线) | Subject | openEuler/qemu/qemu-6.2.0 enabled(Y/N) |
+| ------------ | ------------ | :-----: |
+| b8b69f4c45 | hw/arm/virt: Simplify by moving the gic in the machine state | Y |
+| 1e11a139bf | bugfix: Use gicr_typer in arm_gicv3_icc_reset | Y |
+|119a2ef1dc | Typo: Correct the name of CPU hotplug memory region | Y |
+| 4f50ed9007 | acpi/madt: Factor out the building of MADT GICC struct | Y |
+| ae74dda87e | hw/arm/virt: Assign virt_madt_cpu_entry to acpi_ged madt_cpu hook | Y |
+| 06837491e2 | arm/virt/acpi: Factor out CPPC building from DSDT CPU aml | Y |
+| 1ab75151c0 | acpi/cpu: Prepare build_cpus_aml for arm virt | Y |
+| 603cbcc5ef | acpi/ged: Extend ACPI GED to support CPU hotplug |Y |
+|42072fd4b3|arm/cpu: assign arm_get_arch_id handler to get_arch_id hook|Y|
+|d215714b9a|tests/acpi/bios-tables-test: Allow changes to virt/DSDT file|Y|
+|6b0f94aee8|arm/virt: Attach ACPI CPU hotplug support to virt|Y|
+|d3d158cbf6|tests/acpi/bios-table-test: Update expected virt/DSDT file|Y|
+|209b3e4e52|arm/virt: Add CPU hotplug framework|Y|
+|5454c00908|arm/virt: Add CPU topology support|Y|
+|1a347bf3f8|test/numa: Adjust aarch64 numa test|Y|
+|7838609e9a|hw/arm/virt: Factor out some CPU init codes to pre_plug hook|Y|
+|9dc22ff87e|hw/arm/boot: Add manually register and trigger of CPU reset|Y|
+|03e050611d|arm/virt/gic: Construct irqs connection from create_gic|Y|
+|06cb0756a0|intc/gicv3_common: Factor out arm_gicv3_common_cpu_realize|Y|
+|62b5c897e3|intc/gicv3_cpuif: Factor out gicv3_init_one_cpuif|Y|
+|dd03bc6071|intc/kvm_gicv3: Factor out kvm_arm_gicv3_cpu_realize|Y|
+|e94b8dc43d|hw/intc/gicv3: Add CPU hotplug realize hook|Y|
+|c950cda473|accel/kvm: Add pre-park vCPU support|Y|
+|3ed7dcc4a8|intc/gicv3: Add pre-sizing capability to GICv3|Y|
+|8bd05cdb81|acpi/madt: Add pre-sizing capability to MADT GICC struct|Y|
+|965eb25b03|arm/virt: Add cpu_hotplug_enabled field|Y|
+|e3522e63a2|arm/virt/acpi: Extend cpufreq to support max_cpus|Y|
+|3063d421cd|arm/virt: Pre-sizing MADT-GICC GICv3 and Pre-park KVM vCPU|Y|
+|a2d8cf86a3|arm/virt: Start up CPU hot-plug and cold-plug|Y|
+|add7ed9bb5|arm/virt: Fix vcpu hotplug idx_from_topo_ids|Y|
+
+上游社区代码仓：https://gitee.com/openeuler/kernel.git
+
+| Commit ID (未合入linux社区主线) | Subject | openEuler OLK-5.10 enabled(Y/N) |
+| ------------ | ------------ | :------------: |
+| 121f2a1c7c | arm64: mark all the GICC nodes in MADT as possible cpu | Y |
+| 7eaf6534f7 | arm64: Add CPU hotplug support | Y |
+
+### 特性8：支持GICv4.0/v4.1
+- 特性介绍
+
+GICv4.0继承了GICv3的所有关键特性，它增加了虚拟中断的直接注入。该特性允许软件向ITS描述物理event是如何映射到虚拟中断。如果虚拟中断发往的vPE正在运行时，虚拟中断可以直接发往而不需要先进入hypervisor。
+GICv4.0支持直接注入虚拟LPI，通过减少进入hypervisor的次数减少虚拟化开销。GICv4.1扩展到支持直接注入虚拟SGI。
+- GICv4.0/v4.1使能
+
+GICv4.0默认没有使能，内核日志打印“kvm [1]: GICv4 support disabled”，在内核启动命令中添加参数kvm-arm.vgic_v4_enable=1，内核日志打印“kvm [1]: GICv4 support enabled”；GICv4.1需要在bios中设置开关，打开使能开关并在内核启动命令中添加参数kvm-arm.vgic_v4_enable=1来使能GICv4.1，内核日志打印如下：
+
+
+- 涉及代码及使能
+
+GICv4.0上游社区代码仓：http://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
+
+| Commit ID | Subject | openEuler OLK-5.10 enabled(Y/N) | Linux Mainline(Y/N) |
+| ------------ | ------------ | :------------: | :------------: |
+| d4d7b4ad2f05 | irqchip/gic-v3-its: Setup VLPI properties at map time | Y | Y |
+| 2412405b3141 | KVM: arm/arm64: register irq bypass consumer on ARM/ARM64 | Y | Y |
+| 47bbd31f740c | KVM: arm/arm64: vgic: restructure kvm_vgic_(un)map_phys_irq | Y | Y |
+| 7129a9d8a6f3 | KVM: arm: Select ARM_GIC_V3 and ARM_GIC_V3_ITS | Y| Y |
+| b2c9a85dd75a | KVM: arm/arm64: vgic: Move kvm_vgic_destroy call around | Y | Y |
+| bebfd2a20373 | KVM: arm/arm64: vITS: Add MSI translation helpers | Y | Y |
+| 08c9fd042117 | KVM: arm/arm64: vITS: Add a helper to update the affinity of an LPI | Y| Y |
+| e7c48059248e | KVM: arm/arm64: GICv4: Add property field and per-VM predicate | Y | Y |
+| 74fe55dc9ab7 | KVM: arm/arm64: GICv4: Add init/teardown of the per-VM vPE irq domain | Y | Y |
+| 196b136498b3 | KVM: arm/arm64: GICv4: Wire mapping/unmapping of VLPIs in VFIO irq bypass | Y| Y|
+| 1b7fe468b0ca | KVM: arm/arm64: GICv4: Handle INT command applied to a VLPI | Y| Y|
+| 07b46ed116cf |KVM: arm/arm64: GICv4: Unmap VLPI when freeing an LPI | Y| Y|
+| 0fc9a58ee455 |KVM: arm/arm64: GICv4: Propagate affinity changes to the physical ITS | Y|Y |
+| fb0cada604fc |KVM: arm/arm64: GICv4: Handle CLEAR applied to a VLPI | Y| Y|
+| ff9c114394aa |KVM: arm/arm64: GICv4: Handle MOVALL applied to a vPE | Y| Y|
+| af340f992c56 |KVM: arm/arm64: GICv4: Propagate property updates to VLPIs |Y |Y |
+| 6ce18e3a5f33 |KVM: arm/arm64: GICv4: Handle INVALL applied to a vPE | Y| Y|
+| c971968071d3 |KVM: arm/arm64: GICv4: Use pending_last as a scheduling hint | Y|Y |
+| bdb2d2ccac65 | KVM: arm/arm64: GICv4: Add doorbell interrupt handling| Y| Y|
+| df9ba95993b9 |KVM: arm/arm64: GICv4: Use the doorbell interrupt as an unblocking source | Y|Y |
+| 6277579778d6 |KVM: arm/arm64: GICv4: Hook vPE scheduling into vgic flush/sync |Y | Y|
+| 374be35e231e |KVM: arm/arm64: GICv4: Enable virtual cpuif if VLPIs can be delivered |Y |Y |
+| bd94e7aea403 |KVM: arm/arm64: GICv4: Prevent a VM using GICv4 from being saved | Y| Y|
+| d3d83f7fef9d | KVM: arm/arm64: GICv4: Prevent userspace from changing doorbell affinity| Y|Y |
+| a75460547e13 |KVM: arm/arm64: GICv4: Enable VLPI support |Y | Y|
+| ed8703a506a8 | KVM: arm/arm64: GICv4: Theory of operations| Y| Y|
+<br>
+
+GICv4.1上游社区代码仓：http://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
+
+| Commit ID | Subject | openEuler OLK-5.10 enabled（Y/N） | Linux Mainline(Y/N) |
+| ------------ | ------------ | :------------: | :------------: |
+| 0b04758b002b | irqchip/gic-v3: Use SGIs without active state if offered | Y | Y |
+| 28d160de5194 | irqchip/gic-v4.1: Skip absent CPUs while iterating over redistributors | Y | Y |
+| f3a059219bc7 | irqchip/gic-v4.1: Ensure mutual exclusion between vPE affinity change and RD access | Y | Y |
+| b978c25f6ee7 | irqchip/gic-v4.1: Wait for completion of redistributor's INVALL operation | Y | Y |
+| 9058a4e98064 | irqchip/gic-v4.1: Ensure mutual exclusion betwen invalidations on the same RD | Y | Y |
+| 3c40706d05fd | irqchip/gic-v4.1: Advertise support v4.1 to KVM | Y | Y |
+| 5e46a48413a6 | irqchip/gic-v4.1: Map the ITS SGIR register page | Y | Y |
+| 166cba71818c | irqchip/gic-v4.1: Plumb skeletal VSGI irqchip | Y |Y |
+| e252cf8a34d9 |irqchip/gic-v4.1: Add initial SGI configuration | Y |Y |
+| b4e8d644ec62 | irqchip/gic-v4.1: Plumb mask/unmask SGI callbacks | Y |Y |
+| 7017ff0ee1de | irqchip/gic-v4.1: Plumb get/set_irqchip_state SGI callbacks | Y | Y |
+| 05d32df13c6b | irqchip/gic-v4.1: Plumb set_vcpu_affinity SGI callbacks | Y | Y |
+| ae699ad348cd | irqchip/gic-v4.1: Move doorbell management to the GICv4 abstraction layer | Y| Y |
+| 6d31b6ff985d | irqchip/gic-v4.1: Add VSGI allocation/teardown | Y| Y |
+| d50676f5ce84 | irqchip/gic-v4.1: Add VSGI property setup | Y | Y |
+| 009384b38034 | irqchip/gic-v4.1: Eagerly vmap vPEs | Y | Y |
+| 9879b79aefe5 | KVM: arm64: GICv4.1: Let doorbells be auto-enabled | Y | Y |
+| ef1820be4777 | KVM: arm64: GICv4.1: Add direct injection capability to SGI registers | Y | Y |
+|bacf2c60548b|KVM: arm64: GICv4.1: Allow SGIs to switch between HW and SW interrupts |Y | Y|
+|2291ff2f2a56|KVM: arm64: GICv4.1: Plumb SGI implementation selection in the distributor | Y| Y|
+|d9c3872cd2f8|KVM: arm64: GICv4.1: Reload VLPI configuration on distributor enable/disable | Y|Y |
+|7bdabad12784| KVM: arm64: GICv4.1: Allow non-trapping WFI when using HW SGIs| Y|Y|
+|dab4fe3bf6dd|KVM: arm64: GICv4.1: Expose HW-based SGIs in debugfs | Y|Y|
+
+### 特性9：支持虚拟拓扑
+- 特性介绍
+
+虚拟拓扑包含虚拟NUMA拓扑，虚拟CPU拓扑，虚拟cache拓扑。虚拟拓扑的实现，是为了提升虚拟机的性能，合理地配置虚拟拓扑结构，能有效地提升vCPU的访问性能和调度性能。
+
+- 接口查询
+
+虚拟NUMA拓扑：
+<br>
+进入虚拟机后：可用命令lscpu查看虚拟NUMA拓扑结构，可用numactl -H查看虚拟NUMA拓扑结构及节点上cpu、内存和node distances信息；可通过/sys/devices/system/node/查看虚拟NUMA拓扑及相关信息。
+
+虚拟CPU拓扑：
+<br>
+进入虚拟机后：可用命令lscpu查看虚拟CPU拓扑结构；可通过/sys/devices/system/cpu/cpux/topology 查看虚拟CPU拓扑信息。
+
+虚拟cache拓扑：
+<br>
+进入虚拟机后：可用命令lscpu查看虚拟cache拓扑结构，可以看到有L1、L2和L3三级缓存；可通过/sys/devices/system/cpu/cpux/cache/indexn/ 查看虚拟cache拓扑信息，其中index0 表示L1d, index1表示L1i, index2表示L2, index3表示L3。
+- 虚拟机启动参数配置
+
+虚拟NUMA拓扑：
+
+```
+-object memory-backend-ram,id=ram-node0,size=8G,policy=default
+-numa node,nodeid=0,cpus=0-7,memdev=ram-node0
+-object memory-backend-ram,id=ram-node1,size=8G,policy=default
+-numa node,nodeid=1,cpus=8-15,memdev=ram-node1
+```
+
+解释:以上参数为虚拟机配置两个NUMA节点，每个NUMA节点上内存大小为8G，每个NUMA节点上有8个vCPU.
+
+虚拟CPU拓扑（需以ACPI方式启动虚拟机）:
+```
+-smp cpus=16,sockets=2,clusters=2,cores=2,threads=2
+```
+解释：为虚拟机分配16个vCPU，这些vCPU平均分配在2个socket上，每个socket上有2个cluster，每个cluster上有2个core，每个core有2个thread；
+```
+-smp cpus=16,sockets=4,clusters=2,cores=2,threads=1
+```
+解释：为虚拟机分配16个vCPU，这些vCPU平均分配在4个socket上，每个socket上有2个cluster，每个cluster上有2个core，每个core有1个thread；
+
+- 涉及代码及使能
+
+虚拟NUMA拓扑:
+<br>
+qemu上游社区代码仓： https://github.com/qemu/qemu.git
+
+|Commit ID | Subject | openEuler/qemu/qemu-6.2.0 enabled(Y/N) |
+| :------------ | :------------ | :------------: |
+| 9695200ad8 | ARM: Virt: Set numa-node-id for cpu and memory nodes | Y |
+| e6e400d54f | ACPI: Add GICC Affinity Structure | Y|
+| ea9fcbd7d0|ACPI: Fix the definition of proximity in AcpiSratMemoryAffinity |Y |
+| 64b831367b |ACPI: move acpi_build_srat_memory to common place | Y|
+| 2b302e1e3c|ACPI: Virt: Generate SRAT table | Y|
+
+kernel上游社区代码仓：http://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
+
+| Commit ID | Subject |openEuler OLK-5.10 enabled(Y/N) |
+|--|--|:--:|
+| 500899c2cc3e |efi: ARM/arm64: ignore DT memory nodes instead of removing them | Y |
+|2bc4da1d2b4d|Documentation, dt, numa: dt bindings for NUMA.|Y|
+|298535c00a2c|of, numa: Add NUMA of binding implementation.|Y|
+|3194ac6e66cc|arm64: Move unflatten_device_tree() call earlier.|Y|
+|1a2db300348b|arm64, numa: Add NUMA support for arm64 platforms.|Y|
+|561662301eb6|arm64, mm, numa: Add NUMA balancing support for arm64.|Y|
+
+| Commit ID | Subject |openEuler OLK-5.10 enabled(Y/N) |
+|--|--|:--:|
+| ac906a6d56b7 | ACPI / NUMA: Use pr_fmt() instead of printk | Y|
+|3dda448189af|ACPI / NUMA: Replace ACPI_DEBUG_PRINT() with pr_debug()|Y|
+|258cb74ba5d1|ACPI / NUMA: remove duplicate NULL check|Y|
+|312521d05435|ACPI / NUMA: Move acpi_numa_arch_fixup() to ia64 only|Y|
+|6525afdf53b3|ACPI / NUMA: move acpi_numa_slit_init() to drivers/acpi/numa.c|Y|
+|8ccbbdaa2bc0|arm64, NUMA: rework numa_add_memblk()|Y|
+|2faeff1d507c|x86 / ACPI / NUMA: cleanup acpi_numa_processor_affinity_init()|Y|
+|e84025e274e6|ACPI / NUMA: move bad_srat() and srat_disabled() to drivers/acpi/numa.c|Y|
+|fb1f4181cef6|ACPI / NUMA: remove unneeded acpi_numa=1|Y|
+|3770442e7938|ACPI / NUMA: Move acpi_numa_memory_affinity_init() to drivers/acpi/numa.c|Y|
+|e0af261a437d|ACPI / NUMA: Improve SRAT error detection and add messages|Y|
+|d8b47fca8c23|arm64, ACPI, NUMA: NUMA support based on SRAT and SLIT|Y|
+|4bac6fa73db7|ACPI / NUMA: Enable ACPI based NUMA on ARM64|Y|
+|34c333705238|arm64, NUMA: Cleanup NUMA disabled messages|Y|
+
+虚拟CPU拓扑:
+<br>
+上游社区代码仓： https://github.com/qemu/qemu.git
+
+| Commit ID | Subject |openEuler/qemu/qemu-6.2.0 enabled(Y/N) |
+| :------------ | :------------ | :------------: |
+| 31511b6fe0 | hw/arm/virt: Only describe cpu topology since virt-6.2 | Y |
+| b863f0b758 | device_tree: Add qemu_fdt_add_path | Y|
+| 72b0527ff6 | hw/arm/virt: Add cpu-map to device tree | Y |
+| 9de36ef872 | hw/acpi/aml-build: Add Processor hierarchy node structure | Y |
+| 099f2df2e6 | hw/acpi/aml-build: Add PPTT table | Y |
+| 4ebd52b92a | tests/data/acpi/virt: Add an empty expected file for PPTT | Y |
+| 70d23ed534 | hw/arm/virt-acpi-build: Generate PPTT table | Y |
+| f801789ff0 | tests/data/acpi/virt: Update the empty expected file for PPTT | Y |
+
+vCPU cluster 拓扑:
+<br>
+上游社区代码仓： https://github.com/qemu/qemu.git
+
+| Commit ID | Subject | openEuler/qemu/qemu-6.2.0 enabled(Y/N) |
+| :------------ | :------------ | :------------: |
+| 0d87178523| qemu-options: Improve readability of SMP related Docs| Y|
+| 864c3b5c32| hw/core/machine: Introduce CPU cluster topology support|Y |
+|e5ef89ae44|tests/unit/test-smp-parse: Add testcases for CPU clusters |Y |
+|16f5738476|tests/unit/test-smp-parse: No need to explicitly zero MachineClass members | Y|
+|a2348fa232|tests/unit/test-smp-parse: Keep default MIN/MAX CPUs in machine_base_class_init | Y|
+| d55c316f91 | hw/arm/virt: Support CPU cluster on ARM virt machine | Y |
+| 28a60a59c0 | hw/arm/virt: Support cluster level in DT cpu-map | Y |
+| 11b9eb1b8a | hw/acpi/aml-build: Improve scalability of PPTT generation | Y|
+| 291f6dd566 | tests/acpi/bios-tables-test: Allow changes to virt/PPTT file | Y |
+| 88d0278aa7 | hw/acpi/aml-build: Support cluster level in PPTT generation | Y|
+| 3cda85b203 | tests/acpi/bios-table-test: Update expected virt/PPTT file | Y |
+
+虚拟cache拓扑:
+<br>
+上游社区：https://gitee.com/openeuler/qemu/tree/qemu-6.2.0/
+
+| Commit ID | Subject | openEuler/qemu/qemu-6.2.0 enabled(Y/N) |
+| :------------ | :------------ | :------------: |
+| c5cd762bb7 | hw/arm64: add vcpu cache info support | Y |
+
+#### PS：虚拟NUMA拓扑和虚拟CPU拓扑（包含vCPU cluster拓扑）代码已合入qemu或linux内核主线中，虚拟cache拓扑代码未合入qemu主线中。
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/WayCa-Kunpeng-虚拟化用户使用指南.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/WayCa-Kunpeng-虚拟化用户使用指南.md
new file mode 100644
index 0000000..b18b6a7
--- /dev/null
+++ b/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/WayCa-Kunpeng-虚拟化用户使用指南.md
@@ -0,0 +1,74 @@
+# openEuler WayCa 鲲鹏虚拟化用户使用指南
+## 软件版本
+- openEuler 22.03 lts sp1
+- openEuler 22.03 lts sp2
+- 用户态软件包：https://gitee.com/src-openeuler/qemu.git
+
+## 工具安装使用
+- 安装qemu工具：
+<br>
+yum install qemu-system-aarch64
+- qemu使用帮助：
+<br>
+qemu-system-aarch64 -h 可以查看起虚拟机可选的一些参数
+
+## 起虚拟机基本命令
+
+```c
+qemu-system-aarch64 -machine virt,gic-version=3 \
+-enable-kvm -cpu host -m 4G \
+-smp 4 \
+-kernel /path/to/Image -initrd /path/to/rootfs -nographic \
+-append "rdinit=init console=ttyAMA0 earlycon=pl011,0x90000000" -net none
+```
+## 虚拟机基本操作
+
+- 退出虚拟机方法
+1.按 Ctrl A 松开后迅速按下 C 进入qemu monitor中，输入 q 退出虚拟机；
+<br>
+2.在host(主机)上查询qemu进程：ps -ef | grep qemu-system-aarch64 ，kill 掉对应的进程号虚拟机退出。
+
+- qemu monitor控制台
+
+在qemu monitor控制台中，可以完成很多常规操作，比如设备的增加删除、信息查询、获取虚拟机运行状态等。按 Ctrl A 松开后迅速按下 C 进入qemu monitor中，使用同样的方法退出qemu monitor进入虚拟机。
+在qemu monitor中输入help可以获取更多指令及其功能信息。
+ 
+
+## 其他方法起虚拟机
+还可通过libvirt来起虚拟机。
+- 工具安装
+```c
+yum install libvirt
+yum install qemu
+yum install qemu-img
+yum install edk2-aarch64
+```
+- 启动libvirt服务
+systemctl start libvirtd
+- 安装虚拟机
+1.创建虚拟机img
+```c
+#硬盘空间大小为5G
+qemu-img create -f qcow2 openEuler-image.qcow2 5G
+```
+2.编写虚拟机安装引导的xml文件
+
+3.将iso拷贝到/var/lib/libvirt/images/目录下
+
+4.定义虚拟机
+```c
+virsh define openEulerVM.xml
+```
+5.安装虚拟机
+```c
+virsh start openEulerVM --console /*openEulerVM为xml中定义的虚拟机名称*/
+```
+6.其他virsh管理虚拟机命令
+```c
+virsh list --all /*列出虚拟机列表*/
+virsh shutdown openEulerVM /*关闭虚拟机*/
+virsh destroy openEulerVM /*立即下电*/
+/* 按Ctrl ] 退出虚拟机，虚拟机后台运行 */
+virsh console openEulerVM /*接入虚拟机*/
+virsh undefine openEulerVM --nvram /*删除虚拟机，使用该命令需确保虚拟机处于关闭状态*/
+```
\ No newline at end of file
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/Wayca-Kunpeng-虚拟化-xxx模块特性介绍.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/Wayca-Kunpeng-虚拟化-xxx模块特性介绍.md
deleted file mode 100644
index c4cf2a1..0000000
--- a/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/Wayca-Kunpeng-虚拟化-xxx模块特性介绍.md
+++ /dev/null
@@ -1,38 +0,0 @@
-
-# openEuler WayCa 鲲鹏xxx xxx模块介绍
-
-## xxx功能描述
-
-xxx 全称为 Data Plane Development Kit，是 Intel 提供的一套用户态库，为用户在多个平台提供一套高速处理数据报文的编程接口，为通信领域，云数据中心等网络或存储应用场景提供高性能加速。
-DPDK加强了对 ARM64 的支持，集成了 hns3 PMD 驱动，完整支持鲲鹏芯片网口特性。鲲鹏芯片板载网口配套 hns3 PMD 支持 10G、25G、100G 等速率，支持单播、多播、广播、混杂等网口基本特性，支持 VLAN、流表、TSO、GRO 等高级特性，并利用 NEON 指令实现数据面高速转
-原生 DPDK 以轮询代替中断，避免上下文切换开销，并利用多核实现并行 IO，通过旁路内核实现零拷贝，实现用户态
-高速转发能力。
-DPDK 在鲲鹏网卡支持关键特性如下：
-• 支持 SRIOV：DPDK 可使用多个 VF 进行业务处理，充分挖掘设备在 VM 或容器场景下的扩展能力。
-• 支持单播、多播、广播、混杂等网络特性。
-• 支持 RSS：支持使用网卡多队列，实现多处理器系统下使接收报文在多个 CPU 之间高效分发，增加 cache 命中率，
-提高收发速率。
-• 支持 VLAN：支持 VLAN 过滤，VLAN 添加删除，VLAN 剥离等功能。
-• 支持流表：支持流规则设置，根据报文元组等信息进行数据流路由到指定队列。
-• 支持 checksum 卸载：卸载 checksum 校验、计算到网卡，释放 CPU 能力，提高转发速率。
-• 支持 TSO、GRO 卸载：支持报文 TCP 分片、聚合卸载到网卡，降低 CPU 负载，加快报文处理速率。
-• 支持 SIMD 向量指令处理：利用 NEON 指令高效处理网卡收发报文，提高报文处理速率。
-• 支持 bonding: 支持网口聚合功能，提高带宽能力，增大冗余能力。
-• 支持 dfx 维护：提供设备各功能状态查询、报文统计查询，提供在线定位能力。
-
-## 特性详解
-
-### 特性1：支持 SRIOV：DPDK 可使用多个 VF 进行业务处理，充分挖掘设备在 VM 或容器场景下的扩展能力。
-- 特性详解
-描述特性1。
-- 支持版本： openEuler 22.03 lts
-
-### 特性2：支持 RSS：支持使用网卡多队列，实现多处理器系统下使接收报文在多个 CPU 之间高效分发，增加 cache 命中率，提高收发速率。
-- 特性详解
-描述特性2。
-- 支持版本： openEuler 22.03 lts openEuler 22.03 lts SP1
-
-### 特性XX：支持 RSS：支持使用网卡多队列，实现多处理器系统下使接收报文在多个 CPU 之间高效分发，增加 cache 命中率，提高收发速率。
-- 特性详解
-描述特性X。
-- 支持版本： openEuler 22.03 lts openEuler 22.03 lts SP1
\ No newline at end of file
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/Wayca-Kunpeng-虚拟化xxx技术用户使用指南.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/Wayca-Kunpeng-虚拟化xxx技术用户使用指南.md
deleted file mode 100644
index 1a3e151..0000000
--- a/WayCa-Kunpeng-底软/Wayca-Kunpeng-虚拟化/Wayca-Kunpeng-虚拟化xxx技术用户使用指南.md
+++ /dev/null
@@ -1,39 +0,0 @@
-
-# openEuler WayCa 鲲鹏xxx xxx用户使用指南
-
-## 使用场景
-
-- 存储、ceph、待探索 （NA或介绍各场景收益及使用特性）
-
-## 硬件环境
-- 鲲鹏920
-- 固件依赖需求可按照实际情况补齐 bmc cpld bios 最低版本要求。
-
-## 软件版本
-
-- openEuler 22.03 lts
-- openEuler 22.03 lts SP1
-
-## 安装使用
-
-- 1）安装openEuler系统
--- 详见安装指导
-- 2）本地ISO 源配置
--- 挂载BMC iso
--- mount xxx
--- 修改 sourcelist
--- rpm update
-- 3）安装dpdk软件包
--- rpm install xxx
--- xxx -v
-- 4）基本功能测试
--- testpm xxx
--- xxx效果
-备注：保证功能可用
-
-## 交流答疑
-
-- https://gitee.com/openeuler/wayca/issue
-提单title 标识： 【Way-Kunpeng-高速网络-dpdk】
-
-备注：用于交流基本使用、特性、场景、需求和问题答疑等。
\ No newline at end of file
--
2.30.0
1
0
29 Jun '23
Add DPDK hns3 driver features description doc.
Signed-off-by: Huisong Li <lihuisong(a)huawei.com>
---
...�络-板载网卡DPDK驱动特性介绍.md | 338 ++++++++++++++++++
.../images/iofwd_image.png | Bin 0 -> 57678 bytes
.../images/perf_test_model_image.png | Bin 0 -> 69898 bytes
3 files changed, 338 insertions(+)
create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/WayCa-Kunpeng-高速网络-板载网卡DPDK驱动特性介绍.md
create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/images/iofwd_image.png
create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/images/perf_test_model_image.png
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/WayCa-Kunpeng-高速网络-板载网卡DPDK驱动特性介绍.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/WayCa-Kunpeng-高速网络-板载网卡DPDK驱动特性介绍.md
new file mode 100644
index 0000000..eea7109
--- /dev/null
+++ b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/WayCa-Kunpeng-高速网络-板载网卡DPDK驱动特性介绍.md
@@ -0,0 +1,338 @@
+# WayCa SIG 鲲鹏板载网卡DPDK驱动介绍
+
+## DPDK hns3驱动简介
+
+鲲鹏920系列处理器网络控制器的驱动有两个：内核态的hns3驱动和DPDK中的hns3驱动(用户态)。网卡设备同一时刻可在两者中的任意一个驱动下正常运行。DPDK hns3驱动支持物理网卡(PF)设备，也支持内核态PF生成的SR-IOV的虚拟网卡(VF)设备。
+
+### 源码仓路径
+openeuler kernel仓：https://gitee.com/openeuler/kernel.git
+openeuler DPDK仓： https://gitee.com/src-openeuler/dpdk
+DPDK社区主线仓：http://dpdk.org/git/dpdk
+DPDK稳定分支仓：http://dpdk.org/git/dpdk-stable
+驱动代码目录：drivers/net/hns3
+
+### 内核依赖
+板载网卡设备需通过内核态UIO驱动将设备托管到用户态才可运行，hns3驱动支持的UIO驱动有：igb_uio和vfio_pci。
+
+- igb_uio驱动
+该驱动不随linux主线演进，由DPDK社区自己维护，需使用源码编译ko，方可使用。
+•限制：
+(1) 仅可在关SMMU场景使用。
+(2) 仅支持一个中断，在多中断场景不可使用。
+
+- vfio驱动
+该驱动随linux主线演进，开和关SMMU场景均支持，支持多中断场景(如中断+轮训收包模式)，因此推荐使用vfio_pci驱动。
+VFIO相关的编译选项:
+
+```
+CONFIG_VFIO=m
+CONFIG_VFIO_PCI=m
+CONFIG_VFIO_NOIOMMU=y
+CONFIG_VFIO_VIRQFD=m
+CONFIG_VFIO_IOMMU_TYPE1=m
+```
+注：不同的内核版本vfio相关的ko不同，请以实际的内核版本为准。
+
+## 基础版本特性列表
+* 支持多种接口形态
+•支持光口、电口和背板形态
+•支持10M/100M/1000M/10G/25G/40G/50G/100G速率
+•电口支持速率和流控自协商
+•光口和背板支持速率、FEC、PAUSE流控自协商
+* 支持多种收包模式
+•轮询模式
+•中断+轮询模式
+* 支持CPU卸载
+• 支持TX/RX校验和卸载
+• 支持TSO&GRO卸载
+• 支持VLAN TAG卸载
+• 支持RSS
+• 支持流表
+* 支持基本配置
+• 支持配置MTU
+• 支持配置MAC地址
+• 支持混杂和全组播模式配置
+• 支持VLAN过滤和PVID
+• 支持配置队列数和修改队列深度
+• 支持rx_buf_len指定
+• 支持MAC pause流控
+• 支持FEC功能
+• 支持速率切换
+• 支持keep CRC功能
+• 支持Basic统计功能
+• 支持link状态管理(link查询/LSC功能/link up/down设置)
+* 支持QOS功能
+• 支持ETS和PFC
+• 支持TM功能
+* 支持故障检测和恢复处理
+• 支持RAS处理
+• 支持FLR复位恢复
+* 支持多种dump功能
+• 支持xstats统计功能
+• 支持dump寄存器
+• 支持设备私有数据
+• 支持dump RxTx描述符信息
+• 支持dump光模块信息
+
+## 重要特性
+• 支持LSE事件上报
+• 支持runtime config功能
+• 支持多种收发包函数
+• 支持多进程功能
+• 支持故障检测和恢复处理
+• 支持高精度时钟协议
+• 支持RSS规则叠加功能
+• 支持流表规则配置
+
+* 更详细的特性列表，以及PF和VF之间特性差异见DPDK官网。
+http://doc.dpdk.org/guides/nics/overview.html
+
+以下主要针对重要特性进行介绍。
+
+### 特性1：支持LSE事件上报
+LSE全称为link status event，表示link事件快速上报，对一些需快速感知link状态变化的业务非常有用。
+
+用户通过rte_eth_dev_info_get()获取设备的dev_flags是否支持LSC能力。
+用法：
+(1) 业务注册事件处理函数；
+(2) 在调用rte_eth_dev_configure()时，若设备支持LSC能力，将struct rte_eth_conf::intr_conf::lsc设置为1。
+(3) 设备link状态变化时，事件处理函数就会被调用。
+
+- 注：
+ (1）PF和VF于DPDK-21.11及以后的版本支持该功能。
+ (2) VF的LSE功能，依赖PF驱动支持主动推送link状态的补丁。
+
+- 内核态依赖
+
+| Commit ID | Subject | Tag |OpenEuler合入状态<br><Y/N> |
+| :------------: | :------------: | :------------: | :------------: |
+| 18b6e31f8bf4 | [net: hns3: PF add support for pushing link status to VFs](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/com… | kernel v5.13-rc1 | Y |
+
+
+- 用户态patch
+
+| Commit ID | Subject | Tag |OpenEuler合入状态<br><Y/N> |
+| :------------: | :------------: | :------------: | :------------: |
+| 3b37cbe6179a | [net/hns3: support LSC event report](https://git.dpdk.org/next/dpdk-next-net/commit/?id=e63ae349e1a829b2… | DPDK-v21.05 | Y |
+| 3b37cbe6179a | [net/hns3: refactor PF LSC event report](https://git.dpdk.org/next/dpdk-next-net/commit/?id=3b37cbe6179aeebc… | DPDK-v21.05 | Y |
+| 9bc2289fe5ea | [net/hns3: refactor VF LSC event report](https://git.dpdk.org/next/dpdk-next-net/commit/?id=9bc2289fe5ea771f… | DPDK-v21.05 | Y |
+| 2192c428f9a6 |[net/hns3: fix firmware compatibility configuration](https://git.dpdk.org/next/dpdk-next-net/commit/?id=2192c428f… DPDK-v21.05 | Y |
+
+
+注：用户态patch列表中的commit_id为dpdk社区主线的id，下同。
+
+### 特性2：支持runtime config功能
+业务dpdk初始化进程一般会为rte_eal_init传入一些参数，其中程序加载何种设备一般是通过白名单“-a BDF”方式指定的。runtime config就是紧随设备的PCI设备号传入的那部分参数，如"-a 0000:7d:00.0,rx_func_hint=common"。这些参数可传递给该BDF对应的驱动以实现某些功能控制，驱动支持的runtime配置如下表：
+| 参数名 | 参数取值 | 说明 |
+| :------------: | :------------: | :------------ |
+| rx_func_hint | vec/simple/common | 供用户指定目标收包算法 |
+| tx_func_hint | vec/simple/common | 供用户指定目标发包算法 |
+| mbx_time_limit_ms | 2字节十进制数 | 修改VF的同步mbox消息的等待时间，范围(500，UINT16_MAX]。<br>VF与PF同步mbox消息，需要等待PF回复，默认等待时间为500ms。<br>若存在cpu调度原因PF可能未在500ms内回复VF的消息，从而导致VF命令发送超时而失败。此时，用户可通过增加此时间以规避问题出现。 |
+
+
+- 用户态patch
+
+| Commit ID | Subject | Tag |OpenEuler合入状态<br><Y/N> |
+| :------------: | :------------: | :------------: | :------------: |
+| a124f9e9591b | [net/hns3: add runtime config to select IO burst function](https://git.dpdk.org/next/dpdk-next-net/commit/?id=a124f9e9591bf2… | DPDK-v21.11 | Y |
+| 2fc3e696a7f1 | [net/hns3: add runtime config for mailbox limit time](https://git.dpdk.org/next/dpdk-next-net/commit/?id=2fc3e696a7f1925b20… | DPDK-v21.11 | Y |
+
+### 特性3：支持多种收发包算法
+基于性能和功能的权衡考虑，驱动支持以下多种收发包算法。
+| 算法名称 | 对应接口 | 特征 | 支持的版本 |
+| :------------: | :------------: | :------------ | :------------: |
+| Scalar<br>Scattered<br>(common) | hns3_recv_scattered_pkts<br>hns3_xmit_pkts | 支持报文多BD发送和接收；<br>支持CKSUM、VLAN、PTP、LRO、TSO等offlaod；<br>功能齐全更通用 | >=19.11 |
+| Scalar<br>Simple | hns3_recv_pkts_simple<br>hns3_xmit_pkts_simple |仅支持单BD报文收发；<br>Tx只能工作在MBUF_FAST_FREE或者无offlaod能力模式；<br>Rx不可工作在scattered场景和不支持LRO功能;<br>可运用于PTP场景；| >=20.11 |
+| Vector<br>Neon | hns3_recv_pkts_vec<br>hns3_xmit_pkts_vec | Neon向量指令加速解析和填充描述符；<br>仅支持单BD报文收发；<br>Tx只可工作在MBUF_FAST_FREE offload模式；<br>不可运行在PTP场景；<br>Rx不支持LRO、VLAN、PTP等功能，接收队列深度有限制;<br>Rx burst大小为1时不支持;<br>不支持上报流表的fd_id。 | >=20.11 |
+
+- 注意：
+1. 上表所述的单BD，即一个报文用一个描述符接收，只有一个mbuf。
+2. Rx方向的VLAN功能包括vlan strip/filter、qinq strip。
+3. 向量算法的接收队列深度需满足：大小是64的整数倍、且大于等于128；
+4. 网卡支持的最小发包长度为33Byte，小于该长度的报文需软件padding到该长度驱动方可发送。Simple、Neon向量发包算法，不支持软件padding，由业务保证。
+5. 驱动根据用户配置的offload能力，进行收发包算法匹配。可通过rx/tx_burst_mode接口获取当前收发包算法。
+
+- 用户态patch
+
+| CommitID | Subject | Tag |OpenEuler合入状态<br><Y/N> |
+| :------------: | :------------: | :------------: | :------------: |
+|7ef933908f| [net/hns3: add simple Tx path](https://git.dpdk.org/next/dpdk-next-net/commit/?id=7ef933908f04983ce6… | DPDK-20.05 |Y|
+|a3d4f4d291 |[net/hns3: support NEON Rx](https://git.dpdk.org/next/dpdk-next-net/commit/?id=a3d4f4d291d79e280139… DPDK-20.11 | Y |
+|e31f123db0 |[net/hns3: support NEON Tx](https://git.dpdk.org/next/dpdk-next-net/commit/?id=e31f123db06b4400dbaa… DPDK-20.11 | Y |
+
+
+### 特性4：支持多进程功能
+DPDK框架支持多进程功能，主进程对主从进程间的共享内存和资源具有完全的控制权限，负责创建共享内存区并对共享内存做初始化操作。从进程依附于主进程，不会做共享内存区的初始化，不能对主从进程共享的内存做释放和重申请的操作。若从进程中有ethdev设备，从进程不能为设备做队列的建立或释放，不可对设备进行初始化和卸载。
+
+hns3 PF和VF驱动均支持ethdev设备的主从进程方式运行，支持情况如下：
+(1) 主进程负责对网络设备的初始化，可对设备进行配置和查询；从进程仅支持查询设备配置信息。
+(2) 只支持主进程到从进程的通讯，支持的消息类型有：
+|消息名 | 功能 |
+| :------------: | :------------: |
+|HNS3_MP_REQ_START_RXTX | 请求使能RxTx数据通路 |
+|HNS3_MP_REQ_STOP_RXTX| 请求关闭RxTx数据通路|
+|HNS3_MP_REQ_START_TX| 请求使能Tx数据通路|
+|HNS3_MP_REQ_STOP_TX|请求关闭Tx数据通路|
+
+- 合入主线patch
+
+| Commit ID | Subject | Tag | OpenEuler合入状态<br><Y/N> |
+| :------------: | :------------: | :------------: |:------------: |
+|69f9b420d858| [net/hns3: add Tx start/stop multi-process handling](https://git.dpdk.org/next/dpdk-next-net/commit/?id=69f9b420d858dd… DPDK-21.11 | Y |
+|ff6dc76e40b8| [net/hns3: refactor multi-process initialization](https://git.dpdk.org/next/dpdk-next-net/commit/?id=ff6dc76e… Y |
+|443242212bae| [net/hns3: unregister MP action on close for secondary](https://git.dpdk.org/next/dpdk-next-net/commit/?id=443242212baeb… Y |
+|841f8693536f| [net/hns3: fix multi-process action register and unregister](https://git.dpdk.org/next/dpdk-next-net/commit/?id=841f8693536f… Y |
+|323263717774| [net/hns3: fix secondary process reference count](https://git.dpdk.org/next/dpdk-next-net/commit/?id=323263717774df318… Y |
+|ac8962e96599| [net/hns3: fix ordering in secondary process initialization](https://git.dpdk.org/next/dpdk-next-net/commit/?id=ac8962e9… Y |
+|23d4b61fee5d| [net/hns3: support multiple process](https://git.dpdk.org/next/dpdk-next-net/commit/?id=23d4b61fee5dc75… Y |
+
+
+### 特性5：支持故障检测和恢复处理
+网卡硬件支持RAS错误故障上报，驱动支持RAS故障检测，并通过IMP、Global、PF/VF等复位进行功能恢复，以支持在不复位系统就能恢复模块功能，从而增强系统可靠性。
+网卡异常时，支持FLR(function level reset)复位恢复，命令如下：
+> echo 1 > /sys/bus/pci/devices/0000\:7d\:00.0/reset
+
+如果业务正在进行收发包处理，驱动会先通过替换收发包算法为dummy函数的方式来停流，再进行硬件复位流程。触发复位后，PF和VF驱动有复位相关日志打印，驱动xstats统计中有复位相关统计。
+
+### 特性6：支持高精度时钟协议
+
+IEEE1588 协议，又称 PTP（ precise time protocol，精确时间协议），时间同步精度可以达到亚微秒级别。
+使用方法请参考DPDK工程中examles\ptpclient的实现。
+
+- 合入主线patch
+
+| Commit ID | Subject | Tag |OpenEuler合入状态<br><Y/N> |
+| :------------: | :------------: | :------------: |:------------: |
+|6170abd5c0cc|[net/hns3: fix inaccurate RTC time to read](https://git.dpdk.org/next/dpdk-next-net/commit/?id=6170abd5c0cc3d8cf4… DPDK-23.03 | Y |
+|4ac14c1d961b|[net/hns3: fix Rx with PTP](https://git.dpdk.org/next/dpdk-next-net/commit/?id=4ac14c1d961b27212f7… DPDK-22.11 | Y |
+|3ca3dcd65101 | [net/hns3: fix vector Rx/Tx when PTP enabled](https://git.dpdk.org/next/dpdk-next-net/commit/?id=3ca3dcd65101271… DPDK-22.03 | Y |
+|38b539d96eb6 |[net/hns3: support IEEE 1588 PTP](https://git.dpdk.org/next/dpdk-next-net/commit/?id=38b539d96eb60cd8bb5… DPDK-21.05 | Y |
+
+
+### 特性7：支持RSS规则叠加功能
+驱动rte_flow接口支持配置的RSS action有：types(元组)、func(算法)、key和queue(重定向表)。RSS action配置接口如下：
+
+```
+struct rte_flow_action_rss {
+ enum rte_eth_hash_function func; /**< RSS hash function to apply. */
+ uint32_t level;
+ uint64_t types; /**< Specific RSS hash types (see RTE_ETH_RSS_*). */
+ uint32_t key_len; /**< Hash key length in bytes. */
+ uint32_t queue_num; /**< Number of entries in @p queue. */
+ const uint8_t *key; /**< Hash key. */
+ const uint16_t *queue; /**< Queue indices to use. */
+};
+```
+hash算法、KEY和重定向表，在硬件中一个function只有一个硬件寄存器开关或者一个表项，属于全局配置。元组使能的配置，硬件每个function可基于报文类型来使能对应的元组域，属于非全局配置。
+DPDK-20.11.8及以后的版本支持RSS规则叠加功能(若使用版本中没有此功能，请查看是否回合了此关键patch: e3069658da9f ("[net/hns3: reimplement hash flow function](https://git.dpdk.org/next/dpdk-next-net/commit/?id=e3069658da9ffb…"))。
+
+* 配置策略如下：
+1. rte flow接口配置RSS功能的优先级高于ethdev ops接口。
+2. 驱动支持带pattern和不带pattern属性+RSS action的规则。
+ (a) 不带pattern属性创建规则时，表示RSS规则中的action是作用于所有流类型。
+ (b) 带pattern属性创建规则，一般表示该规则只对pattern属性指定的流类型生效。
+3. 带pattern属性配置规则时，若RSS types为0，则与pattern指定流类型匹配的所有类型的报文的RSS hash均会被disable；若types大于0，则types需按照如下要求配置：
+ (a) types中必须包含与pattern指定的流类型关联的RSS types，且只允许指定一种。如pattern指定eth/ipv4，types只可指定为ipv4、ipv4-other或ipv4-frag。
+ (b) types还可指定L3或L4的SRC/DST_ONLY，但同一层的SRC和DST不可同时下发。若types中不设置任何SRC/DST_ONLY，则会使能该报文类型支持的所有元组。
+4. 不带pattern属性配置RSS types，其配置效果等价于ethdev ops接口配置元组，会作用于所有流类型。
+5. 后面的规则与前面的规则有配置项重叠时，新规则的配置项会覆盖旧规则的重叠配置项；若后面的规则被销毁后，前面的规则重叠配置项会被激活。
+6. destroy一条规则，若驱动中还有其他规则，会还原被该条规则覆盖的旧规则中的配置项。若无任何规则，则RSS配置会还原到ethdev ops接口的配置状态或者默认RSS配置状态。
+7. flush所有规则，RSS配置会还原到ethdev ops接口的配置状态或者默认RSS配置状态。
+
+- 注意：
+1. RSS ethdev ops接口和rte_flow接口不支持交叉混合使用。
+2. 带pattern属性创建RSS规则时，该规则一般只对pattern指定的流类型生效。但hns3驱动的重定向表、算法和hash key为全局配置，对其他流类型同样生效。因此不建议用户带有pattern属性配置重定向表、算法和hash key。
+
+
+### 特性8：支持流表规则配置
+- 通过配置一些过滤规则，对接收的报文进行匹配，根据命中结果对报文进行丢弃或转发处理；提供的计数功能可支持规则的命中计数。仅hns3 PF驱动支持该功能。
+- 接收路径上流表优先级高于RSS，接收报文时先按照流表规则进行匹配，若不命中再走RSS处理流程。
+
+- 支持ether、vlan、tcp/udp/sctp(ipv4和ipv6)、隧道报文(vxlan/nvgre/geneve)的规则匹配；驱动支持根据以下表中的报文字段进行规则匹配：
+
+| 报文字段 | 字段宽度(bits) | 说明 |
+| :------------: | :------------: | :------------: |
+|ot_eth_type |16|外层报文Ether type|
+|ot_ip_proto |8|外层报文Protocol field for IPv4 packet and Next header field for IPv6 packet|
+|ot_sp |16 |外层报文UDP source port|
+|ot_dp |16 |外层报文UDP destination port|
+|ot_tun_vni |24 |外层报文VxLAN/GENEVE Network identifier or NVGRE Virtual Subnet ID|
+|ot_tun_flow_id |8 |外层报文NVGRE Flow ID|
+|in_dmac|48 |内层报文DMAC |
+|in_smac|48|内层报文SMAC |
+|in_vlan_tag_fst|16 |内层报文Tag1|
+|in_vlan_tag_sec|16 |内层报文Tag2|
+|in_eth_type|16 |内层报文Ether type|
+|in_ip_tos|8|内层报文Type of servers|
+|in_ip_proto|8|内层报文Protocol field for IPv4 packet and Next header field for IPv6 packet|
+|in_sip |128|内层报文IPv4 or IPv6 source address|
+|in_dip |128|内层报文IPv4 or IPv6 destination address|
+|in_sp |16 |内层报文TCP/UDP/SCTP source port|
+|in_dp |16 |内层报文TCP/UDP/SCTP destination port|
+|in_l4_rsv |32| 内层报文SCTP tag information|
+
+
+- 支持的action类型如下表：
+
+| 报文字段 | 字段宽度(bits) |
+| :------------: | :------------: |
+|RTE_FLOW_ACTION_TYPE_QUEUE |指定报文到给定的队列|
+|RTE_FLOW_ACTION_TYPE_DROP |指定报文丢弃|
+|RTE_FLOW_ACTION_TYPE_RSS |指定报文到几个队列中(流表+RSS)|
+|RTE_FLOW_ACTION_TYPE_MARK |指定报文的Rx mbuf中带有指定的fd_id|
+|RTE_FLOW_ACTION_TYPE_FLAG |指定报文的Rx mbuf中带有fd_id|
+|RTE_FLOW_ACTION_TYPE_COUNT |指定的规则需要硬件计数(支持多个规则共用一个计数寄存器，结合indirect action使用)|
+|RTE_FLOW_ACTION_TYPE_INDIRECT |指定报文流的action为indirect action(需要先创建indiret action)|
+
+- 合入主线patch
+-
+| Commit ID | Subject | Tag |OpenEuler合入状态<br><Y/N> |
+| :------------: | :------------: | :------------: |:------------: |
+| f8e7fcbfd0 | [net/hns3: support flow action of queue region](https://git.dpdk.org/next/dpdk-next-net/commit/?id=f8e7fcbfd0b8d883… | DPDK-20.11 | Y |
+|fcba820d9b9e| [net/hns3: support flow director](https://git.dpdk.org/next/dpdk-next-net/commit/?id=fcba820d9b9e34… | DPDK-19.11 | Y |
+
+## 性能
+### 测试组网：
+
+
+
+
+### 环境配套
+|名称| 描述|
+| :------------: | :------------ |
+|服务器 |XA320 V2 Kunpeng 920|
+|BIOS版本 |1.09 (U76)|
+|OS版本 |openEuler release 22.03 (LTS-Next) |
+|kernel版本 |5.10.0-142.0.0.71.oe2203.aarch64|
+|DPDK版本 |dpdk-22.11.2|
+|GCC版本 |gcc version 10.3.1 (GCC)|
+|meson版本 |0.59.4|
+|编译命令 |meson build && ninja -C build|
+|CPU |主频2600 MHz，96 cores/96 threads|
+|内存 |16 * 32768 MB，主频 2933 MHz|
+|网卡 |华为HNS3 1*100G板载网卡 1块 |
+|驱动 |HNS3 DPDK PMD (based on vfio-pci)|
+|BIOS设置 |开SMMU<br>Advanced->MISC Config->Support Smmu->Enabled<br>关闭CPU动态调频<br>Advanced->Performance Config->Power Policy->Performance|
+|grub cmdline |default_hugepagesz=1G hugepagesz=1G hugepages=80 isolcpus=1-18 nohz_full=1-18 rcu_nocbs=1-18 iommu.strict=0|
+
+- 用例1：HNS3网卡1*100G 不同收发包算法的单核转发能力
+启动命令：
+> ./build/app/dpdk-testpmd -l 1,3 -n 4 -a 0000:7d:00.0,rx_func_hint=common,tx_func_hint=common --file-prefix=lee -- -i --rxq=1 --txq=1 --txd=2048 --rxd=2048 --burst=64 --nb-cores=1 --forward-mode=io -a
+./build/app/dpdk-testpmd -l 1,3 -n 4 -a 0000:7d:00.0,rx_func_hint=simple,tx_func_hint=simple --file-prefix=lee -- -i --rxq=1 --txq=1 --txd=2048 --rxd=2048 --burst=64 --nb-cores=1 --forward-mode=io -a
+./build/app/dpdk-testpmd -l 1,3 -n 4 -a 0000:7d:00.0,rx_func_hint=vec,tx_func_hint=vec --file-prefix=lee -- -i --rxq=1 --txq=1 --txd=2048 --rxd=2048 --burst=64 --nb-cores=1 --forward-mode=io -a
+
+发包仪以100%速率发包，统计Rx吞吐量。不同收发包算法单核iofwd测试如下：
+
+
+- 用例2：HNS3网卡1*100G 4队列macfwd零丢包性能测试
+启动命令：
+> ./build/app/dpdk-testpmd -l 1,3,5,7,9 -n 4 -a 0000:7d:00.0,rx_func_hint=vec,tx_func_hint=vec --file-prefix=lee -- -i --rxq=4 --txq=4 --txd=2048 --rxd=2048 --burst=64 --nb-cores=4 --forward-mode=mac -a
+
+|Frame Size<br>(Bytes)|Line Rate<br>`[1*100G`](Mpps)|Throughput<br>(Mpps)|Line Rate<br>(%)|
+| :------------: | :------------: | :------------: | :------------: |
+|64|148.809|98.0|65.86|
+|128|84.459|84.451|99.99|
+|256|45.289|45.285|99.99|
+|512|23.496|23.494|99.99|
+|1024|11.973|11.973|100|
+|1518|8.127|8.127|100|
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/images/iofwd_image.png b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/images/iofwd_image.png
new file mode 100644
index 0000000000000000000000000000000000000000..f7aa256723ceaeb54bc09f24d1a7f3f91cc54138
GIT binary patch
literal 57678
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
literal 0
HcmV?d00001
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/images/perf_test_model_image.png b/WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/images/perf_test_model_image.png
new file mode 100644
index 0000000000000000000000000000000000000000..7352a0c8f4e073ae0e90ecfe3ff38aa99c83a85e
GIT binary patch
literal 69898
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
literal 0
HcmV?d00001
--
2.22.0
1
0
您好！
sig-WayCa SIG 邀请您参加 2023-06-28 15:30 召开的Zoom会议
会议主题：Wayca sig 双周例会
会议内容：
1. 新项目numafast介绍
2.高速网络系列--roce rdma-core
会议链接：https://us06web.zoom.us/j/89987193395?pwd=dStzUGZkS2dvRmF6QTduQmJLSTYyUT09
会议纪要：https://etherpad.openeuler.org/p/sig-WayCa-meetings
温馨提醒：建议接入会议后修改参会人的姓名，也可以使用您在gitee.com的ID
更多资讯尽在：https://openeuler.org/zh/
Hello!
openEuler sig-WayCa SIG invites you to attend the Zoom conference will be held at 2023-06-28 15:30,
The subject of the conference is Wayca sig 双周例会,
Summary:
1. 新项目numafast介绍
2.高速网络系列--roce rdma-core
You can join the meeting at https://us06web.zoom.us/j/89987193395?pwd=dStzUGZkS2dvRmF6QTduQmJLSTYyUT09.
Add topics at https://etherpad.openeuler.org/p/sig-WayCa-meetings.
Note: You are advised to change the participant name after joining the conference or use your ID at gitee.com.
More information: https://openeuler.org/en/
1
0
From: Juan Zhou <zhoujuan51(a)h-partners.com>
The first one is the user guide, and the second one is the feature
introduction.
Chengchang Tang (2):
Add the RoCE user guide
Add RoCE features description doc
...eng-高速网络-RoCE用户使用指南.md | 462 +++++
...eng-高速网络-RoCE驱动特性介绍.md | 1738 +++++++++++++++++
2 files changed, 2200 insertions(+)
create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/WayCa-Kunpeng-高速网络-RoCE用户使用指南.md
create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-高速网络/WayCa-Kunpeng-高速网络-RoCE驱动特性介绍.md
--
2.30.0
1
2
From: JiangShui Yang <yangjiangshui(a)h-partners.com>
Added the accelerator WayCa SIG document.
Signed-off-by: JiangShui Yang <yangjiangshui(a)h-partners.com>
---
.../openEuler-WayCa-SIG-加速器介绍.md | 462 ++++++++++++++++++
1 file changed, 462 insertions(+)
create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-加速器/openEuler-WayCa-SIG-加速器介绍.md
diff --git a/WayCa-Kunpeng-底软/Wayca-Kunpeng-加速器/openEuler-WayCa-SIG-加速器介绍.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-加速器/openEuler-WayCa-SIG-加速器介绍.md
new file mode 100644
index 0000000..9e2c0da
--- /dev/null
+++ b/WayCa-Kunpeng-底软/Wayca-Kunpeng-加速器/openEuler-WayCa-SIG-加速器介绍.md
@@ -0,0 +1,462 @@
+# openEuler WayCa SIG 加速器介绍
+
+* 加速器模块包含基于CRYPTO、HWRNG、UACCE、UADK框架实现的支持鲲鹏加速器设备的内核态与用户态驱动。加速器模块包括5个子模块，分别为队列管理模块QM、高性能RSA计算引擎HPRE、硬件安全加速引擎SEC、压缩算法加速引擎ZIP、真随机数产生器TRNG模块。QM是为了统一加速器设备和软件之间的接口，采用统一的队列管理模块QM来和软件进行交互。加速器HPRE、SEC、ZIP设备都集成QM模块。HPRE模块支持RSA/DH/ECDH/X25519/X448/ECDSA/SM2算法，ZIP模块支持gzip/zlib/deflate/lz77_zstd算法，SEC模块支持AEAD/SKCIPHER/DIGEST算法，TRNG模块支持获取随机数。加速器驱动代码已上传到linux和linaro社区。
+
+## ACC 模块介绍
+
+* ACC模块是加速器内核态硬件驱动，内核态驱动主要实现加速器设备虚拟化（SRIOV）、限流、DFX信息查询、crypto内核态硬件算法、虚拟化热迁移、RAS硬件错误处理、FLR复位、低功耗等这几大特性。
+
+### 一、内核态驱动使能
+
+#### 源码获取路径
+
+* linux kernel 仓库：<https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git>
+* openeuler 仓库：<https://gitee.com/openeuler/kernel.git>
+* 源码目录：drivers/crypto/hisilicon/
+
+#### 内核配置
+
+* 加速器模块，内核态驱动涉及的config选项有：
+
+ * CONFIG_CRYPTO_DEV_HISI_QM=m hisi_qm.ko编译配置选项
+ CONFIG_CRYPTO_DEV_HISI_ZIP=m hisi_zip.ko编译配置选项
+ CONFIG_CRYPTO_DEV_HISI_HPRE=m hisi_hpre.ko编译配置选项
+ CONFIG_CRYPTO_DEV_HISI_SEC2=m hisi_sec2.ko编译配置选项
+ CONFIG_CRYPTO_DEV_HISI_TRNG=m hisi-trng-v2.ko编译配置选项
+ CONFIG_CRYPTO_DEV_HISI_MIGRATION=m hisi_migration.ko编译配置选项
+ CONFIG_UACCE=m uacce.ko编译配置选项，该模块用于支持用户态驱动，如果不使能加速器仅支持内核态驱动
+
+* 虚拟化热迁移依赖的内核config选项有：
+
+ * CONFIG_VFIO=m vfio.ko编译配置选项
+ CONFIG_VFIO_PCI=m vfio_pci.ko编译配置选项
+
+ 此外加速器内核态算法的实现依赖于内核crypto子系统。
+
+#### 模块依赖及参数配置指导
+
+* 当用户态驱动依赖的config项CONFIG_UACCE未配置时，ZIP、HPRE、SEC驱动支持内核态。hisi_qm模块为zip、sec、hpre三个加速器设备驱动提供内核态中间层接口，故这几个ko的依赖关系为：
+ * hisi_zip.ko《== hisi_qm.ko
+ * hisi_sec2.ko《== hisi_qm.ko
+ * hisi_hpre.ko《== hisi_qm.ko
+ * hisi-trng-v2.ko《== rng-core.ko
+* 加速器模块(SEC、ZIP、HPRE)参数如下表所示，模块参数的支持范围和配置策略会在配置说明中列出。加载驱动时模块参数没有先后顺序。加载驱动后，可以通过cat /sys/bus/pci/drivers/<driver>/module/parameters/ 来查询模块参数。模块参数在加载驱动后不支持更新。如zip驱动的加载（示例为不支持用户态的情况下）：
+ * insmod hisi_zip.ko pf_q_num =16 vfs_num=1 sgl_sge_nr=16
+* 模块参数说明
+
+| 参数 | 参数范围 | 加载配置示例 | 配置说明 |
+| ---------- | :-------------------------------------- | ------------------------------------------------------------ | ------------------------ |
+| pf_q_num | 2~1024 SEC 默认为256 HPRE/ZIP 默认为64 | insmod hisi_zip.ko pf_q_num=16<br />insmod hisi_hpre.ko pf_q_num=16<br />insmod hisi_sec2.ko pf_q_num=16 | PF可用队列数 |
+| vfs_num | 0~63 默认值为0 | insmod hisi_zip.ko vfs_num=1<br />insmod hisi_hpre.ko vfs_num=1<br />insmod hisi_sec2.ko vfs_num=1 | 使能VF数 |
+| sgl_sge_nr | 1~225 默认值为10 | insmod hisi_zip.ko sgl_sge_nr=16 | 单个sgl的sge数量 （仅ZIP模块参数） |
+| ctx_q_num | 2~32，仅偶数默认值为2 | insmod hisi_sec2.ko ctx_q_num=16 | crypto tfm下的硬件队列数 |
+| uacce_mode | 0、1 默认值为0 | insmod hisi_zip.ko uacce_mode=1<br />insmod hisi_hpre.ko uacce_mode=1<br />insmod hisi_sec.ko <u>uacce_mode=1</u> | 用户态驱动开关 |
+
+### 二、ZIP SEC HPRE内核态特性
+
+#### 1、加速器支持SRIOV
+
+* 特性介绍
+
+ 加速器设备支持通过PCI驱动框架注册设备驱动，加速器设备支持PCI function的SRIOV功能实现设备虚拟化操作，并且支持通过驱动模块参数直接配置虚拟化设备VF的个数。
+
+ 用户通过vfs_num模块参数，可设置初始的vf数目，加载驱动模块后，每个加速器PF将产生对应数量的vf（不支持模块加载后再对该模块参数进行更新，且通过模块参数只能查询到初始配置的值）。同时，支持pci sysfs方式更新vf的个数，可用于更新对应PCI物理设备的vf数量，配置功能仅在PF，同时pf支持的算法业务、FLR、限流vf同样支持。
+
+* 涉及代码与使能
+
+ | commitid | subject | openeuler enabled（Y/N） |
+ | ------------ | ------------------------------------------------------------ | ------------------------ |
+ | 5ec302a364bf | crypto: hisilicon - add SRIOV support for HPRE | Y |
+ | 35ee280fb1fb | crypto: hisilicon - add vfs_num module parameter for hpre/sec | Y |
+ | 73bcb049a77 | crypto: hisilicon - add SRIOV for HiSilicon SEC | Y |
+ | 79e09f30eeba | crypto: hisilicon - add SRIOV support for ZIP | Y |
+ | 39977f4b51c | crypto: hisilicon - add vfs_num module param for zip | Y |
+
+
+
+* 示例
+
+ 用户也可以在加载驱动时直接通过模块参数vfs_num配置vf：
+
+ ~~~
+ modprobe hisi_zip vfs_num=1
+ ~~~
+
+ 模块加载之后支持pci sysfs方式跟新vf个数：
+
+ ~~~
+ echo 2 > /sys/devices/<pci_bus>/<pci_device>/<device>/sriov_numvfs
+ echo 2 > /sys/devices/pci0000:30/0000:30:00.0/0000:31:00.0/sriov_numvfs
+ ~~~
+
+#### 2、加速器支持限流功能
+
+* 特性介绍
+
+ HAC(HPRE/ZIP/SEC)加速器设备在支持虚拟化时，不同VF设备分配给不同的虚拟机VM，即不同的用户使用，考虑到加速器作为附加的硬件计算资源，需要以‘算力’为单位，每个VF的算力应该定量分配出去，让每个用户能够获得足够的计算资源，同时，让同一个加速器物理设备上的VF的‘算力’相互不受干扰，用户购买了多少算力，比如AES-CBC 20Gbps，那么就给可以用户配20Gbps算力。仅支持root权限用户可以配置算力，可对各个function(包括PF) 进行‘算力’大小查询与配置，VF用户只能查询，不能配置。
+
+ 用户可以在设备debugfs下面看到alg_qos文件节点，算力配置命令为echo bdf qos > alg_qos,以Hip09为例，用户知道aes-cbc满配是100Gbps，用户想要设置0000:39:00.1配置20Gbps，那么实际上输入为20%，则echo 0000:39:00.1 200 > alg_qos，如果想要配置0000:39:00.2，则echo 0000:76:00.2 200 > alg_qos ，zip支持压缩、解压缩，hpre支持ECC、RSA。sec支持加解密算法配置、qos表示流量比例。从1~1000, 表示0.1%~100.0%。
+
+* 涉及代码与使能
+
+ | commitid | subject | openeuler enabled（Y/N） |
+ | ------------ | ------------------------------------------------------------ | ------------------------ |
+ | 72b010dc33b9 | crypto: hisilicon/qm - supports writing QoS int the host | Y |
+ | cc0c40c613d2 | crypto: hisilicon/qm - add the "alg_qos" file node | Y |
+ | 362c50bad3a7 | crypto: hisilicon/qm - merges the work initialization process into a single function | Y |
+ | 2966d9d3078c | crypto: hisilicon/qm - add pf ping single vf function | Y |
+ | 3bbf0783636b | crypto: hisilicon/qm - supports to inquiry each function's QoS | Y |
+ | 3d2a429271bb | crypto: hisilicon/sec - adds the max shaper type rate | Y |
+
+
+
+* 示例
+
+ sec vf流量配置：
+
+ ~~~
+ modprobe hisi_sec2 vfs_num=2
+ echo 0000:39:00.1 200 > /sys/kernel/debug/hisi_sec2/0000:39:00.1/alg_qos
+ cat /sys/kernel/debug/hisi_sec2/0000:39:00.1/alg_qos
+ ~~~
+
+#### 3、加速器提供配置信息查询功能
+
+* 特性介绍
+
+ 支持通过DebugFS文件系统，查询当前设备的基本配置信息，错误信息和业务运行时的状态信息。
+
+ DebugFS能够查询到的信息：
+
+ * 首先是基本的状态查询，包含软件和硬件：QM状态查询功能，SQC/CQC配置信息，配置寄存器等信息。
+ * 其次，正常和异常下收发包数量统计。
+ * 另外包括临终遗言功能，复位前将异常变化的寄存器dump，这些寄存器复位后会被还原。
+ * 还包括提供寄存器一键比对check功能，快速发现前后变化的寄存器状态。
+
+* 涉及代码与使能
+
+ | commitid | subject | openeuler enabled（Y/N） |
+ | ------------ | ---------------------------------------------------------- | ------------------------ |
+ | 72c7a68d2ea3 | crypto: hisilicon - add debugfs for ZIP and QM | Y |
+ | 8502652542c6 | crypto: hisilicon/qm - add debugfs for QM | Y |
+ | 0a3a3960210b | crypto: hisilicon/qm - add debugfs to the QM state machine | Y |
+ | c31dc9fe165d | crypto: hisilicon/qm - add DebugFS for xQC and xQE dump | Y |
+ | 848974151618 | crypto: hisilicon - Add debugfs for HPRE | Y |
+ | 1e9bc276f | crypto: hisilicon - add DebugFS for HiSilicon SEC | Y |
+
+
+
+* 示例
+
+ 查看zip设备qm dfx：
+
+ ~~~
+ cat /sys/kernel/debug/hisi_zip/0000:31:00.0/qm/regs 查看qm相关寄存器
+ cat /sys/kernel/debug/hisi_zip/0000:31:00.0/comp_core0/regs 查看算法核相关寄存器
+ ~~~
+
+ 更多更详细DFX功能可查看加速器DFX手册。
+
+#### 4、加速器内核态基本算法加速功能
+
+* 特性介绍
+
+ linux内核加/解密和压缩/算法有内核crypto子系统承载，crypto子系统支持内核态算法扩展及替换。加速器内核态驱动在模块初始化阶段将加速器硬算算法接口注册到crypto子系统中，通过crypto相关算法的接口可以调用加速器设备。
+
+ 查看加速器驱动支持的算法
+
+ ~~~
+ cat /proc/crypto | grep -B 4 -A 8 hisi_sec2 //查看sec设备支持的算法
+ cat /proc/crypto | grep -B 4 -A 8 hisi_hpre //查看hpre设备支持的算法
+ cat /proc/crypto | grep -B 4 -A 8 hisi_zip //查看zip设备支持的算法
+ ~~~
+
+* 涉及代码与使能
+
+ | commitid | subject | openeuler enabled（Y/N） |
+ | ------------ | ------------------------------------------------------------ | ------------------------ |
+ | 62c455ca853e | crypto: hisilicon - add HiSilicon ZIP accelerator support | Y |
+ | 7b44c0eecd6a | crypto: hisilicon/sec - add new skcipher mode for SEC | Y |
+ | 2f072d75d1ab | crypto: hisilicon - Add aead support on SEC2 | Y |
+ | c16a70c1f253 | crypto: hisilicon/sec - add new algorithm mode for AEAD | Y |
+ | 6c46a3297bea | crypto: hisilicon/sec - add fallback tfm supporting for aeads | Y |
+ | c8b4b477079d | crypto: hisilicon - add HiSilicon HPRE accelerator | Y |
+ | fbc75d03fda0 | crypto: hisilicon/hpre - enable Elliptic curve cryptography | Y |
+ | 05e7b906aa7c | crypto: hisilicon/hpre - add 'ECDH' algorithm | Y |
+ | b981f7990e1a | crypto: hisilicon/hpre - register ecdh NIST P384 | Y |
+ | 90274769cf79 | crypto: hisilicon/hpre - add 'CURVE25519' algorithm | Y |
+ | 3e90efd12959 | hwrng: hisi - add HiSilicon TRNG driver support | Y |
+ | 6e57871c3b75 | crypto: hisilicon/trng - add version to adapt new algorithm | Y |
+
+* zlib、gzip算法调用
+
+ 加载hisi_zip.ko后，通过crypto子系统acomp接口实现压缩解压缩功能。
+
+ 接口路径：<linux/include/crypto/acompress.h>
+
+* DH算法调用
+
+ 加载hisi_hpre.ko后，通过crypto子系统KPP接口实现密钥协商功能。
+
+ 接口路径：<linux/include/crypto/kpp.h>
+
+ 规格限制：HPRE硬件设备支持DH算法规格如下表。
+
+ DH group1/2/5/14/15/16模幂长度
+
+ | group | 模值(bits) |
+ | ------- | ---------- |
+ | group1 | 768 |
+ | group2 | 1024 |
+ | group5 | 1536 |
+ | group14 | 2048 |
+ | group15 | 3072 |
+ | group16 | 4096 |
+
+* RSA算法调用
+
+ 加载hisi_hpre.ko后，通过crypto子系统AKCIPHER接口实现加解密与签名功能。
+
+ 接口路径：<linux/include/crypto/akcipher.h>
+
+ 规格限制：HPRE硬件设备支持RSA算法规格如下表。
+
+ RSA密钥位宽
+
+ | 模式 | 密钥位宽(bits) |
+ | ---- | ---------------------- |
+ | 标准 | 1024、2048、3072、4096 |
+ | CRT | 1024、2048、3072、4096 |
+
+* ECDH算法调用
+
+ 加载hisi_hpre.ko后，通过crypto子系统KPP和ECDH接口实现基于椭圆曲线的密钥协商功能。
+
+ 接口路径：<linux/include/crypto/kpp.h>
+
+ < linux/include/crypto/ecdh.h>
+
+ 规格限制：HPRE硬件设备支持ECDH算法的椭圆曲线规格如下表所示。
+
+ ECDH椭圆曲线规格
+
+ | 曲线名称 | 密钥位宽(bits) |
+ | ------------------- | -------------- |
+ | ECC_CURVE_NIST_P192 | 192 |
+ | ECC_CURVE_NIST_P224 | 224 |
+ | ECC_CURVE_NIST_P256 | 256 |
+ | ECC_CURVE_NIST_P384 | 384 |
+ | ECC_CURVE_NIST_P521 | 521 |
+
+* X25519算法调用
+
+ 加载hisi_hpre.ko后，通过crypto子系统CURVE25519接口实现基于椭圆曲线curve25519的密钥协商功能。
+
+ 接口路径：<linux/include/crypto/curve25519.h>
+
+ 规格限制：HPRE硬件设备支持X25519算法的椭圆曲线规格如下表所示。
+
+ X25519椭圆曲线规格
+
+ | 曲线名称 | 密钥位宽(bits) |
+ | ---------- | -------------- |
+ | Curve25519 | 256 |
+
+* SKCIPHER算法调用
+
+ 加载hisi_sec2.ko后，通过crypto子系统SKCIPHER接口实现加解密功能。
+
+ 接口路径：<linux/include/crypto/skcipher.h>
+
+ 规格限制：SEC硬件设备支持SKCIPHER算法规格如下表。
+
+ SKCIPHER算法规格
+
+ | SKCIPHER算法名称 | 设置key长(bits) |
+ | ---------------- | --------------- |
+ | ecb(aes) | 128、192、256 |
+ | cbc(aes) | 128、192、256 |
+ | xts(aes) | 256、512 |
+ | ecb(des3_ede) | 192 |
+ | cbc(des3_ede) | 192 |
+ | cbc(sm4) | 128 |
+ | xts(sm4) | 256 |
+
+* AEAD算法调用
+
+ 加载hisi_sec2.ko后，通过crypto子系统AEAD接口实现加解密功能。
+
+ 接口路径：<linux/include/crypto/aead.h>
+
+ 规格限制：SEC硬件设备支持AEAD算法规格如下表。
+
+ AEAD算法规格
+
+ | AEAD算法名称 | 设置key长(bits) | 设置author key长(bits) | Author长度(bits) |
+ | ------------------------------ | --------------- | ---------------------- | ---------------- |
+ | authenc(hmac(sha1),cbc(aes)) | 128、192、256 | 0~512 | 1~160 |
+ | authenc(hmac(sha256),cbc(aes)) | 128、192、256 | 0~512 | 1~256 |
+ | authenc(hmac(sha512),cbc(aes)) | 128、192、256 | 0~1024 | 1~512 |
+
+* drbg算法调用
+
+ 加载hisi-trng-v2.ko后，通过crypto子系统drbg接口实现获取随机数功能。
+
+ 接口路径：<linux/include/crypto/drbg.h>
+
+ 规格限制：只支持seed大小为384bits，最大获取随机数长度为4095*128bits。
+
+* 真随机数获取
+
+ 加载hisi-trng-v2.ko后，支持通过/dev/hwrng获取TRNG设备产生的真随机数。用户从/dev/random中获取的随机数有部分是TRNG设备产生的真随机数
+
+#### 5、加速器支持热迁移功能
+
+* 特性介绍
+
+ 加速器热迁移主要配合KVM-QEMU完成直通加速器VF设备的VM和VM之间的动态热迁移，在热迁移的过程中保证业务的不中断和用户不感知。因为openeuler是5.10的内核，没有合入linux主线最新的热迁移框架，当前openeuler使用的是V1版的热迁移（祥见下面patch）适配qemu 6.2.0到8.0之间的版本，qemu 8.x的版本已经不在支持V1版的热迁移。
+
+* 涉及代码与使能
+
+ | commitid | subject | openeuler enabled（Y/N） |
+ | ------------ | ----------------------------------------------------------- | ------------------------ |
+ | a0464f0b70f9 | vfio/hisilicon: add acc live migration driver | Y |
+ | e073afaff8c1 | crypto: hisilicon/qm - support the userspace task resetting | Y |
+
+* 示例
+
+ zip热迁移：
+
+ ~~~
+ modprobe hisi_zip
+ 创建vf：
+ echo 0 > /sys/devices/pci0000:30/0000:30:00.0/0000:31:00.0/sriov_numvfs
+ echo 2 > /sys/devices/pci0000:30/0000:30:00.0/0000:31:00.0/sriov_numvfs
+
+ 绑定vfio:
+ echo 0000:31:00.1 > /sys/bus/pci/drivers/hisi_zip/unbind
+ echo vfio-pci > /sys/devices/pci0000:30/0000:30:00.0/0000:31:00.1/driver_override
+ echo 0000:31:00.1 > /sys/bus/pci/drivers_probe
+
+ echo 0000:31:00.2 > /sys/bus/pci/drivers/hisi_zip/unbind
+ echo vfio-pci > /sys/devices/pci0000:30/0000:30:00.0/0000:31:00.2/driver_override
+ echo 0000:31:00.2 > /sys/bus/pci/drivers_probe
+
+ 启动迁出端：
+ qemu-system-aarch64 -machine virt,gic-version=3 -enable-kvm -cpu host -m 2G -smp 1 \
+ -kernel /home/Image -initrd /home/shan/minifs.cpio.gz -nographic \
+ -append "rdinit=init console=ttyAMA0 earlycon=pl011,0x9000000 kpti=off cma=2G" \
+ -device vfio-pci,host=31:00.1,x-enable-migration=true,x-pre-copy-dirty-page-tracking=off \
+ -monitor stdio -serial telnet:0.0.0.0:1111,server,nowait -net none
+
+ 启动迁入端：
+ qemu-system-aarch64 -machine virt,gic-version=3 -enable-kvm -cpu host -m 2G -smp 1 \
+ -kernel /home/Image -initrd /home/shan/minifs.cpio.gz -nographic \
+ -append "rdinit=init console=ttyAMA0 earlycon=pl011,0x9000000 kpti=off cma=2G" \
+ -device vfio-pci,host=31:00.2,x-enable-migration=true,x-pre-copy-dirty-page-tracking=off \
+ -monitor stdio -serial telnet:0.0.0.0:2222,server,nowait -net none -incoming tcp:0:6666
+
+ 迁出端vm加载加速器驱动：
+ insmod hisi_zip.ko （可跑加速器业务，目前openEuler VM仅支持内核态业务）
+
+ host迁出端控制台启动迁移:
+ migrate tcp:0.0.0.0:6666
+ ~~~
+
+#### 6、加速器支持RAS复位特性
+
+* 特性介绍
+
+ Reliability—可靠性 、Availability—可用性、Serviceability—可服务性简称RAS，RAS是用于保障HAC设备的可靠性，即当HAC出现硬件错误时，尽最大可能不影响业务连续性与正确性。加速器RAS特性主要包括设备停流、缓存现场、复位、恢复业务。当加速器设备发生硬件错误时会触发RAS中断，在保证用户（UADK接口或者内核Crypto接口的调用者）业务连续性和正确性的前提下，中断处理程序完成对硬件错误的纠正。
+
+* 使涉及代码与能
+
+ | commitid | subject | openeuler enabled（Y/N） |
+ | ------------ | ------------------------------------------------------------ | ------------------------ |
+ | b67202e8ed30 | crypto: hisilicon/qm - add state machine for QM | Y |
+ | dbdc1ec31fc0 | crypto: hisilicon - add device error report through abnormal irq | Y |
+ | 6c6dd5802c2d | crypto: hisilicon/qm - add controller reset interface | Y |
+ | 1f5c9f34f0cc | crypto: hisilicon/hpre - add controller reset support for HPRE | Y |
+ | c4aab24448a3 | crypto: hisilicon - enable new error types for QM | Y |
+ | ed278023708b | crypto: hisilicon/hpre - add two RAS correctable errors processing | Y |
+ | 141876c252a4 | crypto: hisilicon/sec2 - add controller reset support for SEC2 | Y |
+ | 1db0016e0d22 | crypto: hisilicon/qm - do not reset hardware when CE happens | Y |
+
+
+#### 7、加速器支持FLR复位功能
+
+* 特性介绍
+
+ 加速器设备支持通过PCI驱动框架注册设备驱动，提供基于PCI设备的FLR复位功能，完成Function级别的复位，同时实现软件和硬件恢复到初始化的状态，在复位场景下，保证业务流合理停止处理（合理停止：停流时用户会被通知，用户对未完成的任务进行相应处理，用户可以选择，在复位完成后，基于初始状态的function设备继续进行业务，或也可以直接退出业务处理，其中用户是指UADK接口或者内核Crypto接口的调用者）
+
+* 涉及代码与使能
+
+ | commitid | subject | openeuler enabled（Y/N） |
+ | ------------ | ------------------------------------------------------------ | ------------------------ |
+ | 7ce396fa12a9 | crypto: hisilicon - add FLR support | Y |
+ | 38cd3968bf28 | crypto: hisilicon/qm - adjust reset interface | Y |
+ | 7ed83901326f | crypto: hisilicon/qm - add stop queue by hardware | Y |
+ | e3ac4d20e936 | crypto: hisilicon/qm - enable PF and VFs communication | Y |
+ | 3cd53a27c2fc | crypto: hisilicon/qm - add callback to support communication | Y |
+ | 760fe22cf5e9 | crypto: hisilicon/qm - update reset flow | Y |
+
+* 示例
+
+ ~~~
+ zip pf reset:
+ echo 1 > /sys/bus/pci/devices/0000:31:00.0/reset
+
+ zip vf reset:
+ echo 1 > /sys/bus/pci/devices/0000:31:00.1/reset
+ ~~~
+
+#### 8、加速器设备支持低功耗特性
+
+* 对于加速器设备，硬件上支持对单个PF设备进行电源的打开与关闭。用户可以通过Device SysFS(/sys/devices/.../power/control)对单个PF设备进行低功耗控制配置，如果使能‘auto’策略，设备将在被使用时（内核与用户态应用在调用Crypto或Warpdrive接口获取硬件资源）自动进入运行状态，如果使能了‘on’策略，那么该设备就一直处于运作状态，不进行任何功耗控制。由于PCIE协议要求在D3cold电源状态下VF不应该使能起来，因此在使能VF时不进入下电状态，此时依赖芯片本身支持的clock-gating来降低功耗。
+
+* 涉及代码与使能
+
+ | commitid | subject | openeuler enabled（Y/N） |
+ | ------------ | ------------------------------------------------------------ | ------------------------ |
+ | d7ea53395b72 | crypto: hisilicon - add runtime PM ops | Y |
+ | 607c191b371d | crypto: hisilicon - support runtime PM for accelerator device | Y |
+ | ed5fa39fa8a6 | crypto: hisilicon - enable zip device clock gating | Y |
+ | 3d845d497b23 | crypto: hisilicon - enable sec device clock gating | Y |
+ | ea5202dff79c | crypto: hisilicon - enable hpre device clock gating | Y |
+
+* 示例
+
+ zip设备配置低功耗策略
+
+ ~~~
+ cat /sys/bus/pci/devices/0000:31:00.1/power/runtime_status
+ echo auto > /sys/bus/pci/devices/0000:31:00.1/power/control
+ cat /sys/bus/pci/devices/0000:31:00.1/power/runtime_status
+ ~~~
+
+#### 9、支持获取硬件随机数特性
+
+* 特性介绍
+
+ 芯片TRNG模块提供硬件随机数算法，内核TRNG驱动（drivers/crypto/hisilicon/trng）提供Crypto RNG算法，往Kernel Crypto子系统进行注册，同时注册TRNG真随机数设备驱动到HWRANDOM子系统。这样，通过内核CRYPTO RNG接口与/dev/random接口可分别使用芯片TRNG所提供的DRBG与TRNG真随机数。
+
+* 涉及代码与使能
+
+ | commitid | subject | openeuler enabled（Y/N） |
+ | ------------ | ----------------------------------------------------------- | ------------------------ |
+ | 3e90efd12959 | hwrng: hisi - add HiSilicon TRNG driver support | Y |
+ | 6e57871c3b75 | crypto: hisilicon/trng - add version to adapt new algorithm | Y |
+
+
+
+* 示例
+
+ ~~~
+ cat /dev/hwrng
+ cat /dev/random
+ ~~~
+
+
+
+## UADK 模块介绍
+* 详情可以参考UADK用户手册 https://gitee.com/openeuler/uadk/wikis/%E4%BD%BF%E7%94%A8%E6%96%87%E6%A1%A3…
--
2.30.0
1
0