Google Git
Sign in
testsuite-smarthome-matter / ui-automator / 6ed2f8dc639051be1cd937b4bbc64a2a1555f7a1
commit6ed2f8dc639051be1cd937b4bbc64a2a1555f7a1[log] [tgz]
authorTimmatt <timmatt@google.com>Sat Feb 17 02:27:57 2024 -0800
committerCopybara-Service <copybara-worker@google.com>Sat Feb 17 02:28:36 2024 -0800
tree8be62d5e8815b121ea9b18eb69cfc775c155fd60
parent5e897f7bd9bebd967052df3bb8318746508704ff [diff]
copy branch master from staging to prod

PiperOrigin-RevId: 607926563
1 file changed
tree: 8be62d5e8815b121ea9b18eb69cfc775c155fd60
  1. ui_automator/
  2. .gitignore
  3. CHANGELOG.md
  4. CONTRIBUTING.md
  5. LICENSE
  6. MANIFEST.in
  7. README.md
  8. requirements.txt
  9. setup.py
README.md

Google Home UI Automator

Google Home Automator can help you automating your Google Home App.

Getting Started

Prerequisites

Python 3

You need a python 3 environment to run the script. Google Home UI Automator requires python 3.11 or newer.

Android phone

  1. turn on User Debugging mode on your android phone.
  2. connect your android phone to computer.

Google Home App

  1. You need to install Google Home App on your Android phone.
  2. Login to your Google Home App.
  3. Make sure the Google Home App's version is between 3.1.1.14 and 3.10.1.6(latest public version). Or 3.12.4.1, 3.13.46.1.

NOTE: Please select the correct Google account on Google Home App.

Installation

  1. clone this repo.

    $ git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator

  2. cd to the folder.

  3. Run pip install .

Usage

Commissioning Matter device

$ ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME
  • DEVICE_NAME: desired Matter device, e.g. m5stack
  • PAIRING_CODE: pairing code of your Matter device, e.g. 34970112332
  • ROOM_NAME: room that is going to be assigned, e.g. Office

Decommissioning Matter device

$ ui-automator --decommission DEVICE_NAME
  • DEVICE_NAME: display name of commissioned Matter device on GHA, e.g. m5stack

Regression Test

$ ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat <REPEAT_TIMES>] [--hub <HUB_VERSION>] [--dut <MODEL>,<TYPE>,<PROTOCOL>] [--fw <DEVICE_FIRMWARE>]
  • flag --regtest is required
  • regression test need to be used with flag --commission
  • regression test now only supports commissioning/decommissioning cycle
  • defaultly, regression test will run until users use keyboard interrupt to stop the process
  • optionally add --repeat to run regression test in limited times
    • REPEAT_TIMES: repeated times for regression test
  • optionally add --hub to include hub version in produced test report
    • HUB_VERSION: version of hub for controlling devices on GHA
  • optionally add --dut to include device under test in produced test report
    • MODEL: Model of the device. e.g. X123123
    • TYPE: Type of the device. e.g. LIGHT
    • PROTOCOL: Used protocol of the device. e.g. MATTER
  • optionally add --fw to include device firmware in produced test report
    • DEVICE_FIRMWARE: Firmware of test device.

Roadmap

  • [x] Commissioning Matter device
  • [x] Decommissioning Matter device
  • [x] Regression test of cycling commissioning/decommissioning
  • [ ] Support regression test for devices that need additionally manual operations after decommissioning to recover to BLE commissioning mode
  • [ ] Share Fabric
  • [ ] Get pairing code when sharing fabric

Notice

  • While UI Automation is processing, interfering android phone with any UI operation might fail the automation.

Report issue

  • Click here to report any encountered issues.

Disclaimer

This project is not an official Google project. It is not supported by Google and Google specifically disclaims all warranties as to its quality, merchantability, or fitness for a particular purpose.