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>

misc/config_tools/board_inspector/cli.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python3
+#
+# Copyright (C) 2021 Intel Corporation. All rights reserved.
+#
+# SPDX-License-Identifier: BSD-3-Clause
+#
+
+import sys, os
+import logging
+import subprocess
+import lxml.etree
+import argparse
+from importlib import import_module
+
+script_dir = os.path.dirname(os.path.realpath(__file__))
+sys.path.append(os.path.join(script_dir))
+
+def main(board_name, board_xml):
+    try:
+        # First invoke the legacy board parser to create the board XML ...
+        legacy_parser = os.path.join(script_dir, "legacy", "board_parser.py")
+        env = { "PYTHONPATH": script_dir }
+        subprocess.run([sys.executable, legacy_parser, args.board_name, "--out", board_xml], check=True, env=env)
+
+        # ... then load the created board XML and append it with additional data by invoking the extractors.
+        board_etree = lxml.etree.parse(board_xml)
+
+        # Clear the whitespaces between adjacent children under the root node
+        board_etree.getroot().text = None
+        for elem in board_etree.getroot():
+            elem.tail = None
+
+        # Finally overwrite the output with the updated XML
+        board_etree.write(board_xml, pretty_print=True)
+
+    except subprocess.CalledProcessError as e:
+        print(e)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    logging.basicConfig(level=logging.INFO)
+    parser = argparse.ArgumentParser()
+    parser.add_argument("board_name", help="the name of the board that runs the ACRN hypervisor")
+    parser.add_argument("--out", help="the name of board info file")
+    args = parser.parse_args()
+
+    board_xml = args.out if args.out else f"{args.board_name}.xml"
+    main(args.board_name, board_xml)