The current repo belongs to Closed status, and some functions are restricted. For details, please refer to the description of repo status
4 Star 1 Fork 4

OpenHarmony / test_xdevice

Create your Gitee Account
Explore and code with more than 8 million developers,Free private repositories !:)
Sign up
Clone or Download
Sync branch
Notice: Creating folder will generate an empty file .keep, because not support in Git



XDevice, a core module of the OpenHarmony test framework, provides services on which test case execution depends.

XDevice consists of the following sub-modules:

  • command: enables command-based interactions between users and the test platform. It parses and processes user commands.
  • config: sets test framework configurations and provides different configuration options for the serial port connection and USB connection modes.
  • driver: functions as a test case executor, which defines main test steps, such as test case distribution, execution, and result collection.
  • report: parses test results and generates test reports.
  • scheduler: schedules various test case executors in the test framework.
  • environment: configures the test framework environment, enabling device discovery and device management.
  • testkit: provides test tools to implement JSON parsing, network file mounting, etc.
  • resource: provides the device connection configuration file and report template definitions.

Directory Structure

├── config                    # XDevice configuration
│     ├── user_config.xml    # XDevice environment configuration
├── resource                  # XDevice resources
│     ├── tools              # Burning tools
├── src                       # Source code
│     ├── xdevice
├── extension                 # XDevice extension
│     ├── src                # Source code of the extension
│     └──           # Installation script of the extension


The environment requirements for using this module are as follows:

  • Python version: 3.7.5 or later
  • pySerial version: 3.3 or later
  • Paramiko version: 2.7.1 or later
  • RSA version: 4.0 or later


  • Installing XDevice

    1. Go to the installation directory of XDevice.

    2. Open the console window and run the following command:

      python install
  • Installing the extension

    1. Go to the installation directory of the XDevice extension.

    2. Open the console and run the following command:

      python install
  • Modifying the user_config.xml file

    Configure information about your environment in the user_config.xml file.

    1. Configure the environment.

    • For devices that support hdc connection, refer to the following note to configure the environment.

      NOTE: ip/port: IP address and port of a remote device. By default, the parameter is left blank, indicating that the local device (IP address:; port: the one used for hdc startup) is used as the test device. sn: SN of the test devices specified for command execution. If this parameter is set to SN1, only device SN1 can execute the subsequent run commands. In this case, other devices are set as Ignored and not involved in the command execution. You can run the list devices command and check the value of Allocation to view the sn values. You can set multiple SNs and separate each two of them with a semicolon (;).

    • For devices that support serial port connection, refer to the following note to configure the environment.

      NOTE: type: device connection mode. The com mode indicates that the device is connected through the serial port. label: device type, for example, wifiiot serial: serial port

      • serial/com: serial port for local connection, for example, COM20
      • serial/type: serial port type. The value can be cmd (serial port for test case execution) or deploy (serial port for system upgrade). For the open-source project, the cmd and deploy serial ports are the same, and their com values are the same too. serial/baud_rate, data_bits, stop_bits and timeout: serial port parameters. You can use the default values.

    2. Set the test case directory.

    dir: test case directory

    3. Mount the NFS.

    NOTE: server: NFS mounting configuration. Set the value to NfsServer. server/ip: IP address of the mounting environment server/port: port number of the mounting environment server/username: user name for logging in to the server server/password: password for logging in to the server server/dir: external mount path server/remote: whether the NFS server and the XDevice executor are deployed on different devices. If yes, set this parameter to true. Otherwise, set it to false.

  • Specify the task type.

  • Start the test framework.

  • Execute test commands.

    Test framework commands can be classified into three groups: help, list, and run. Among them, run commands are most commonly used in the instruction sequence.


    Queries help information about test framework commands.

         use help to get information.  
         run:  Display a list of supported run command.
         list: Display a list of supported device and task record.  
         help run
         help list

    NOTE: help run: displays the description of run commands. help list: displays the description of list commands.


    Displays device information and related task information.

         This command is used to display device list and task record.  
          list history
          list <id>  
         list:         display device list
         list history: display history record of a serial of tasks
         list <id>:    display history record about task what contains specific id  
         list history
         list 6e****90

    NOTE: list: displays device information. list history: displays historical task information. list <id>: displays historical information about tasks with specified IDs.


    Executes test tasks.

         This command is used to execute the selected testcases.
         It includes a series of processes such as use case compilation, execution, and result collection.  
    usage: run [-l TESTLIST [TESTLIST ...] | -tf TESTFILE
                [TESTFILE ...]] [-tc TESTCASE] [-c CONFIG] [-sn DEVICE_SN]
                [-rp REPORT_PATH [REPORT_PATH ...]]
                [-respath RESOURCE_PATH [RESOURCE_PATH ...]]
                [-tcpath TESTCASES_PATH [TESTCASES_PATH ...]]
                [-ta TESTARGS [TESTARGS ...]] [-pt]
                [-env TEST_ENVIRONMENT [TEST_ENVIRONMENT ...]]
                [-e EXECTYPE] [-t [TESTTYPE [TESTTYPE ...]]]
                [-td TESTDRIVER] [-tl TESTLEVEL] [-bv BUILD_VARIANT]
                [-cov COVERAGE] [--retry RETRY] [--session SESSION]
                [--dryrun] [--reboot-per-module] [--check-device]
                [--repeat REPEAT]
                action task  
    Specify tests to run.
      positional arguments:
       action                Specify action
       task                  Specify task name,such as "ssts", "acts", "hits"

    NOTE: The structure of a basic run command is as follows:

    run [task name] -l module1;moudle2

    task name: task type. This parameter is optional. Generally, the value is ssts, acts, or hits. -l: test cases to execute. Use semicolons (;) to separate each two test cases. module: module to test. Generally, there is a .json file of the module in the testcases directory. In addition, other parameters can be attached to this command as constraints. Common parameters are as follows: -sn: specifies the devices for test case execution. If this parameter is set to SN1, only device SN1 executes the test cases. -c: specifies a new user_config.xml file. -rp: indicates the path where the report is generated. The default directory is xxx/xdevice/reports. Priority of a specified directory is higher than that of the default one. -tcpath: indicates the environment directory, which is xxx/xdevice/testcases by default. Priority of a specified directory is higher than that of the default one. -respath: indicates the test suite directory, which is xxx/xdevice/resource by default. Priority of a specified directory is higher than that of the default one. --reboot-per-module: restarts the device before test case execution.

  • View the execution result.

    After executing the run commands, the test framework displays the corresponding logs on the console, and generates the execution report in the directory specified by the -rp parameter. If the parameter is not set, the report will be generated in the default directory.

    Structure of the report directory (the default or the specified one)
         ├── result # Test case execution results of the module
         │     ├── module name.xml
         │     ├──  ... ... 
         ├── log # Running logs of devices and tasks
         │     ├── device 1.log
         │     ├── ... ...
         │     ├── task.log
         ├── summary_report.html # Visual report
         ├── summary_report.html # Statistical report
         └── ... ...

Repositories Involved

testing subsystem




Development self-test and the base library of XTS certification testing | 开发自测试与XTS认证测试基础库 expand collapse
Python and 4 more languages


No release





Load More
can not load any more


10d9f8b4 4838521 8bde8327 4838521