WayCa

wayca@openeuler.org

26 discussions

[PATCH 07/15] Complete the developing of hikptool ub_dfx function
by veega2022 07 Oct '23

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, &reg_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

高速网络系列～dpdk
by openEuler conference 11 Jul '23

11 Jul '23

您好！ 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

[PATCH 1/5] Add ECV doc
by Yicong Yang 10 Jul '23

10 Jul '23

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

[PATCH] Add docs for Wayca-Kunpeng-Virtualization
by chenxiang 04 Jul '23

04 Jul '23

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模块的运行过程。 +![图片说明](http://image.huawei.com/tiny-lts/v1/images/f9c15d24cad61500bfdb16269d1fd5a6_681x756.png@900-0-90-f.png) + +## 二、虚拟化特性介绍 +### 特性1：支持TRAP DELAY +- 特性介绍 + +TWE Delay是ARMv8.6扩展中一个可选特性，合入代码到内核中，进入系统后， +dmesg | grep "Delayed Trapping of WFE"有如下打印： + ![图片说明](http://image.huawei.com/tiny-lts/v1/images/d009110b52dc040b5611073c29077a32_564x34.png@900-0-90-f.png) + +- 内核配置 + +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上执行，达到优化性能的目的。 + +- 特性使能 + +使能配置项： + +CONFIG_PARAVIRT + +CONFIG_PARAVIRT_SPINLOCKS +- 特性测试 + + ![图片说明](http://image.huawei.com/tiny-lts/v1/images/5f7b317d487d58415c3c9b885bc73cf0_505x399.png@900-0-90-f.png) +- 涉及代码及使能 + +上游代码分支：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脏页热迁移： + +内核部分上游社区：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 | + +中断状态热迁移： + +上游社区仓库：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广播优化特性检测： + +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广播优化特性应用： + +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，内核日志打印如下： + +![图片说明](http://image.huawei.com/tiny-lts/v1/images/6ab98e4dcc5683631d35012ba1e0cad5_539x59.png@900-0-90-f.png) +- 涉及代码及使能 + +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| + + +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拓扑： + +进入虚拟机后：可用命令lscpu查看虚拟NUMA拓扑结构，可用numactl -H查看虚拟NUMA拓扑结构及节点上cpu、内存和node distances信息；可通过/sys/devices/system/node/查看虚拟NUMA拓扑及相关信息。 + +虚拟CPU拓扑： + +进入虚拟机后：可用命令lscpu查看虚拟CPU拓扑结构；可通过/sys/devices/system/cpu/cpux/topology 查看虚拟CPU拓扑信息。 + +虚拟cache拓扑： + +进入虚拟机后：可用命令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拓扑: + +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拓扑: + +上游社区代码仓： 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 拓扑: + +上游社区代码仓： 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拓扑: + +上游社区：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工具： + +yum install qemu-system-aarch64 +- qemu使用帮助： + +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 退出虚拟机； + +2.在host(主机)上查询qemu进程：ps -ef | grep qemu-system-aarch64 ，kill 掉对应的进程号虚拟机退出。 + +- qemu monitor控制台 + +在qemu monitor控制台中，可以完成很多常规操作，比如设备的增加删除、信息查询、获取虚拟机运行状态等。按 Ctrl A 松开后迅速按下 C 进入qemu monitor中，使用同样的方法退出qemu monitor进入虚拟机。 +在qemu monitor中输入help可以获取更多指令及其功能信息。 + ![图片说明](http://image.huawei.com/tiny-lts/v1/images/e0593736edeb022bd82d228e8076e6ee_1047x302.png@900-0-90-f.png) + +## 其他方法起虚拟机 +还可通过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

[PATCH 1/3] WayCa: add DPDK hns3 driver features description doc
by Huisong Li 29 Jun '23

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合入状态 <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合入状态 <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]。 VF与PF同步mbox消息，需要等待PF回复，默认等待时间为500ms。 若存在cpu调度原因PF可能未在500ms内回复VF的消息，从而导致VF命令发送超时而失败。此时，用户可通过增加此时间以规避问题出现。 | + + +- 用户态patch + +| Commit ID | Subject | Tag |OpenEuler合入状态 <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 Scattered (common) | hns3_recv_scattered_pkts hns3_xmit_pkts | 支持报文多BD发送和接收； 支持CKSUM、VLAN、PTP、LRO、TSO等offlaod； 功能齐全更通用 | >=19.11 | +| Scalar Simple | hns3_recv_pkts_simple hns3_xmit_pkts_simple |仅支持单BD报文收发； Tx只能工作在MBUF_FAST_FREE或者无offlaod能力模式； Rx不可工作在scattered场景和不支持LRO功能; 可运用于PTP场景；| >=20.11 | +| Vector Neon | hns3_recv_pkts_vec hns3_xmit_pkts_vec | Neon向量指令加速解析和填充描述符； 仅支持单BD报文收发； Tx只可工作在MBUF_FAST_FREE offload模式； 不可运行在PTP场景； Rx不支持LRO、VLAN、PTP等功能，接收队列深度有限制; Rx burst大小为1时不支持; 不支持上报流表的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合入状态 <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合入状态 <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合入状态 <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合入状态 <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 | + +## 性能 +### 测试组网： + +![](./images/perf_test_model_image.png) + + +### 环境配套 +|名称| 描述| +| :------------: | :------------ | +|服务器 |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 Advanced->MISC Config->Support Smmu->Enabled 关闭CPU动态调频 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测试如下： +![](./images/iofwd_image.png) + +- 用例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 (Bytes)|Line Rate `[1*100G`](Mpps)|Throughput (Mpps)|Line Rate (%)| +| :------------: | :------------: | :------------: | :------------: | +|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

Wayca sig 双周例会
by openEuler conference 27 Jun '23

27 Jun '23

您好！ 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

[Wayca v3 0/2] openEuler/Wayca
by Chengchang Tang 27 Jun '23

27 Jun '23

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

[PATCH] Added the accelerator WayCa SIG document.
by Hao Fang 24 May '23

24 May '23

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 insmod hisi_hpre.ko pf_q_num=16 insmod hisi_sec2.ko pf_q_num=16 | PF可用队列数 | +| vfs_num | 0~63 默认值为0 | insmod hisi_zip.ko vfs_num=1 insmod hisi_hpre.ko vfs_num=1 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 insmod hisi_hpre.ko uacce_mode=1 insmod hisi_sec.ko uacce_mode=1 | 用户态驱动开关 | + +### 二、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

[PATCH] Added the accelerator WayCa SIG document.
by Hao Fang 24 May '23

24 May '23

From: JiangShui Yang <yangjiangshui(a)h-partners.com> --- ...g-加速器-xxx技术用户使用指南.md | 39 -- ...Kunpeng-加速器-xxx模块特性介绍.md | 38 -- .../openEuler-WayCa-SIG-加速器介绍.md | 462 ++++++++++++++++++ 3 files changed, 462 insertions(+), 77 deletions(-) delete mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-加速器/Wayca-Kunpeng-加速器-xxx技术用户使用指南.md delete mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-加速器/Wayca-Kunpeng-加速器-xxx模块特性介绍.md create mode 100644 WayCa-Kunpeng-底软/Wayca-Kunpeng-加速器/openEuler-WayCa-SIG-加速器介绍.md 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 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-加速器/openEuler-WayCa-SIG-加速器介绍.md b/WayCa-Kunpeng-底软/Wayca-Kunpeng-加速器/openEuler-WayCa-SIG-加速器介绍.md new file mode 100644 index 0000000..62b4538 --- /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 insmod hisi_hpre.ko pf_q_num=16 insmod hisi_sec2.ko pf_q_num=16 | PF可用队列数 | +| vfs_num | 0~63 默认值为0 | insmod hisi_zip.ko vfs_num=1 insmod hisi_hpre.ko vfs_num=1 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 insmod hisi_hpre.ko uacce_mode=1 insmod hisi_sec.ko uacce_mode=1 | 用户态驱动开关 | + +### 二、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

1175135535
by 1175135535 24 May '23

24 May '23

1 0