diff --git a/README.md b/README.md index 143d828cf226a1570788bf7dac9ca8281b8c55ae..de0a5116834d1a702aaf3037edb9e4a17471552c 100644 --- a/README.md +++ b/README.md @@ -119,7 +119,8 @@ for more information. ## OpenHarmony host tools To facilitate working with OpenHarmony systems, an image with various host tools -is provided. +is provided. The ACTS test suite for testing for OpenHarmony compatibility can +be included in this image. See [recipes-openharmony/tools/README.rst](recipes-openharmony/tools/README.rst) for more information. diff --git a/recipes-openharmony/tools/README.rst b/recipes-openharmony/tools/README.rst index 94f14cb5e2704b2604901dbfef66388c25ad2983..9888d47684f542bb41c4b3ecf457d7c0b456da85 100644 --- a/recipes-openharmony/tools/README.rst +++ b/recipes-openharmony/tools/README.rst @@ -25,6 +25,10 @@ Once that is in place, the `bitbake` command is simply:: DISTRO=oniro-openharmony-linux MACHINE=qemuarma7 bitbake openharmony-tools +The default configuration (as defined in +[local.conf.sample](conf/local.conf.sample)), enables building of ACTS and +inclusion in the `openharmony-tools` image. + Installation ************ @@ -46,3 +50,25 @@ In order to use the installed tools, you need to setup your shell environment $ . /opt/openharmony-tools/environment-setup-x86_64-oesdk-linux And with that, you will have access to `hdc` and `xdevice` commands. + + +Running ACTS +============ + +To run ACTS tests, you need to connect to the OpenHarmony target device (or +QEMU) using `hdc` and then run the tests using `xdevice` command. +(remember to setup the environment as show in the section above) + +As an example, running the `ActsContextTest.json` test case against QEMU target +(IP address 192.168.7.2), run + +.. code-block:: + + $ hdc tconn 192.168.7.2:35000 + Connect OK + $ xdevice run acts -l ActsContextTest + [2023-02-20 13:25:22,954] [Main] [INFO] [*************** xDevice Test Framework Starting ***************] + [2023-02-20 13:25:22,975] [Utils] [INFO] [The running command is: hdc_std -s tcp:8710 reset] + [2023-02-20 13:25:23,980] [Console] [INFO] [Input command: run -l ActsContextTest] + ... +