OrgACRN
/
acrn-hypervisor
mirror of https://github.com/projectacrn/acrn-hypervisor.git
1
0
Fork 0
Code Issues Releases Wiki Activity
acrn-hypervisor/misc/config_tools/board_inspector/README

15 lines
897 B
Plaintext
Raw Normal View History

acrn-config: generate board information on target board These tools run on the target board and genearate board information. usage: python3 board_parser.py <board_name> [--out board_info_file] sample: $ sudo python3 board_parser.py apl-up2 v1-v2: 1. allow board parameter for new board v2-v3: 1. add the usage descriptions for tools 2. add description of kernel cmd line for README 3. output informations to a xml type 4. coding as PEP8 guildline Tracked-On: #3480 Signed-off-by: Wei Liu <weix.w.liu@intel.com> Reviewed-by: Shuang Zheng shuang.zheng@intel.com Acked-by: Terry Zou <terry.zou@intel.com> Acked-by: Victor Sun <victor.sun@intel.com>
2019-07-30 09:00:54 +08:00
board_parser.py will collect all board related info and then generate a board info file for acrn-config host tool usage.
config_tools: rename python script 1. rename “cli.py” to “board_inspector.py”, and update the script name in README file. 2. rename “app.py” to “acrn_configurator.py”. Tracked-On: #6417 Signed-off-by: Kunhui-Li <kunhuix.li@intel.com>
2021-08-18 12:09:23 +08:00
usage: python3 board_inspector.py <board_name> [--out board_info_file]
acrn-config: generate board information on target board These tools run on the target board and genearate board information. usage: python3 board_parser.py <board_name> [--out board_info_file] sample: $ sudo python3 board_parser.py apl-up2 v1-v2: 1. allow board parameter for new board v2-v3: 1. add the usage descriptions for tools 2. add description of kernel cmd line for README 3. output informations to a xml type 4. coding as PEP8 guildline Tracked-On: #3480 Signed-off-by: Wei Liu <weix.w.liu@intel.com> Reviewed-by: Shuang Zheng shuang.zheng@intel.com Acked-by: Terry Zou <terry.zou@intel.com> Acked-by: Victor Sun <victor.sun@intel.com>
2019-07-30 09:00:54 +08:00
board_name : the name of board that run ACRN hypervisor, like apl-up2/nuc7i7dnb. It will be used as name of the board configurations folder which created by acrn-config host tool.
board-inspector: reorganize the scripts This patch reorganize the files of the board inspector as follows. 1. Rename the directory name from `target` to `board_inspector`, in order to align with the name used in ACRN documentation. 2. Move the scripts that generate the current board XML into the `legacy` sub-directory. The legacy nodes will be removed after transitioning to the new board XML schema completely, 3. Add the main script `cli.py` which is the command line interface of the board inspector. v1 -> v2: - Rename `run.py` to `cli.py`. Tracked-On: #5922 Signed-off-by: Junjie Mao <junjie.mao@intel.com>
2021-04-21 08:56:32 +08:00
board_info_file : (optional) the name of board info file. if it is not specified, a name of <board_name>.xml will be generated under the current working directory by default.
acrn-config: generate board information on target board These tools run on the target board and genearate board information. usage: python3 board_parser.py <board_name> [--out board_info_file] sample: $ sudo python3 board_parser.py apl-up2 v1-v2: 1. allow board parameter for new board v2-v3: 1. add the usage descriptions for tools 2. add description of kernel cmd line for README 3. output informations to a xml type 4. coding as PEP8 guildline Tracked-On: #3480 Signed-off-by: Wei Liu <weix.w.liu@intel.com> Reviewed-by: Shuang Zheng shuang.zheng@intel.com Acked-by: Terry Zou <terry.zou@intel.com> Acked-by: Victor Sun <victor.sun@intel.com>
2019-07-30 09:00:54 +08:00
Please run this script under native Linux environment with root privilege.
OS requirement:
doc: update the content about generating board xml Update the content about getting board xml from native enviroment in acrn_configuration_tool.rst and README. Tracked-On: #6134 Signed-off-by: Kunhui Li <kunhuix.li@intel.com>
2021-06-02 17:43:29 +08:00
Release: Ubuntu 18.04+
Tools: cpuid, rdmsr, lspci, lxml, dmidecode (optional)
config-tools: remove 'nomwait' from board_inspector's requirement This patch is about the bug that VMs can't idle. ACRN enables VM's C-state by extracting host's C-state table. The C-state table has two types of interfaces: system-IO and mwait. VMs just need one of them. ACRN can support both. Currently we are telling users to use the system-IO type. That is, by adding 'nomwait intel_idle.max_cstate=0' to host Linux's CMD line when using board_inspector. (The reaseon we were using system-IO is that mwait was buggy on Apollo Lake.) But recent tests show that system-IO is somehow buggy. Linux c-state driver(no matter intel_cstate or acpi_cstate) fails to enter idle state with system-IO. This can always be reproduced on native environments. MPERF counters show CPU cores are not in real idle state as expected. To enable C-state in VMs, we have to switch to mwait. As ACRN has already supported both system-IO and mwait, we don't have to modify any code. We just need to tell user to use mwait instead of system-IO. That is, don't add 'nomwait intel_idle.max_cstate=0' to host Linux's CMD line when using board_inspector. Just add 'intel_idle.max_cstate=0' Due to the Apollo Lake's mwait bug, 'nomwait' is still needed for Apollo Lake as an exception. Tracked-On: #7371 Reviewed-by: Junjie Mao <junjie.mao@intel.com> Signed-off-by: Zhou, Wu <wu.zhou@intel.com>
2022-04-27 09:41:35 +08:00
kernel cmdline: "iomem=relaxed intel_idle.max_cstate=0 intel_pstate=disable" or
"idle=nomwait iomem=relaxed intel_idle.max_cstate=0 intel_pstate=disable" for Apollo Lake