#tl;dr

- `pip install GitPython tqdm`
- `sudo apt install rhash`
-  do actions from `doc/download_assets.md`
- `make package-update`
- plug your phone to the USB port and power on (if turned off)
- `python3 ./firmware_update_test/update.py tarball_path`
- if your phone doesn't restart during the update - **restart it** manually

#Firmware update test

The aim of this test is to check the correctness of the service-desktop API and upgrade the phone software.

This test is based on Harness class and uses pyTest to verify the update process. It makes use of service-desktop API to upload a tarball update package to the phone's memory and execute the update. After a successful update the phone should reset and an update check will be performed. In the end, an update verification status will be shown in the console (along with the exit code).

#Usage

To be able to conduct the test (or just use the script as an update utility) a few prerequisites have to be met:

• Pure needs connected via USB
• Your Python version has to be at least 3.8
• Your Python virtual environment needs to be properly set up (as mentioned in PyTest's readme)

After all of the requirements are fulfilled, the script can be safely executed:

python3 ./update.py tarball_path

The serial port used by the phone will be detected automatically.

To obtain the tarball package use the proper CMake target: make package-update. The only requirement is having a properly configured API token and Python environment, required by the asset downloading script. Extended docs are here: doc/download_assets.md

Missing info: required python packages - GitPython and tqdm. Additionally: rhash