creotech-sayma-testsuite/README.md

32 lines
1.5 KiB
Markdown
Raw Normal View History

2021-06-18 15:49:39 +08:00
## Automatic Test Scripts
2021-04-28 21:57:58 +08:00
2021-06-18 15:49:39 +08:00
#### Shell
(Remember to **edit the settings** in `rp_ping_test` and `rp_shutdown` and the **test arguments** passed to `get_and_plot_sayma_data` according to your own setup!)
* `test_mlabs`: Run an automatically-timed test using M-Labs' current setup
* `test_creotech`: Run an automatically-timed test using Creotech's current setup
## Data Collection & Analytics Tools
#### Python
2021-04-28 21:57:58 +08:00
(To see detailed usage, add `--help` as an argument when running the script.)
* `rp_get_sayma_data.py`: Acquire and save data from RedPitayas over local network
2021-10-07 13:01:33 +08:00
* `plot_sayma_data.py`: Load saved data and output phase skew measurements and data plots
* `analyze_sayma_data.py`: Generate a data analysis report from saved data records
2021-04-28 21:57:58 +08:00
2021-06-18 15:49:39 +08:00
#### Shell
* `get_and_plot_sayma_data`: Acquire and analyse data from RedPitayas over local network
* `get_and_plot_remote_sayma_data`: Acquire and analyse data from remote RedPitayas via SSH (often over different networks) to the local file system
* Requires Python testsuite scripts present on the remote host
2021-04-28 21:57:58 +08:00
2021-06-18 15:49:39 +08:00
## System Utilities
#### Shell
2021-04-28 21:57:58 +08:00
* `mch_start`: Power on the MCH and start logging serial outputs from Metlino and Saymas
* `mch_stop`: Power off the MCH and stop logging serial outputs from Metlino and Saymas
2021-05-13 10:34:47 +08:00
* `rp_ping_test`: Loop to ping a RedPitaya until it succeeds
* The exit condition is where the RedPitaya is ready-to-use
* `rp_shutdown`: Shut down the OS of a RedPitaya and loop to ping it until it fails
* The exit condition is where the RedPitaya is ready for hardware power-off