7be3fd486c | ||
---|---|---|
.. | ||
docs | ||
resources | ||
LICENSE | ||
Makefile | ||
OWNERS | ||
README.md | ||
requirements.txt | ||
start_venv.sh | ||
stress_test.proto | ||
stress_test.py | ||
stress_test_common.py |
README.md
OpenHST : Open sourced Hotword Stress Test tool
Hotword stress test tool is a python script to measure the Google Hotword performance on Android devices with simple test set up. The goal of OpenHST is making Google Hotword Stress Test tool as an open source project so that Android Partners can easily adapt on their development.
Overview
Prerequsite
Before setting up your HST test environment, please make sure to meet following preconditions.
- DSP hotword capability on test device (android handset)
- ADB connection between the test server and android handset
- Internet connection on android handset
- No screen lock setting on android handset
- Install Homebrew (Mac)
- Install pyenv for Linux and Mac.
- Install GNU make(3.81 above) on test machine (Linux, Mac, Windows)
Test environment setup
Please follow below steps to set up HST on your test machine and make sure that no error popped up during the installation.
Linux & Mac
- pyenv install 3.6.8
- pyenv shell 3.6.8
- make start
- chmod +x ./start_venv.sh
- source env/bin/activate
- ./start_venv.sh
- make proto-compile
Windows
- install python3.7.5
- make start
- .\env\Scripts\activate
- pip3 install -r requirements.txt
- Download protoc.ext (3.11.4 version) from github
- Decompress protoc-3.11.4-win64.zip and copy bin/protoc.exe to env/ folder
- Decompress protoc-3.11.4-win64.zip and copy include/* under env/include folder
- make proto-compile
Voice model training
Before conducting stress test, voice model should be trained with the recorded tts sound.
- Please follow the guide in "Train voice model" chapter in OEM Hotword Stress Test with OpenHST
Stress Test
Please refer to the guide in "Run Stress Test" chapter in OEM Hotword Stress Test with OpenHST and run the hotword stress test.
- python stress_test.py --test_name dsp_trigger_and_screen_off --num_iterations 3000 --output_root test_out
- Over 95% pass ratio from 3000 test cycle would be fair enough to declare that the device passed the hotowrd stress test
Contacts
Join our mailing list for discussions and announcements.