{"id":28732001,"url":"https://github.com/armbian/autotests","last_synced_at":"2025-06-15T19:40:42.750Z","repository":{"id":36688454,"uuid":"229637858","full_name":"armbian/autotests","owner":"armbian","description":"Armbian automated testings","archived":false,"fork":false,"pushed_at":"2021-12-13T10:30:49.000Z","size":208,"stargazers_count":18,"open_issues_count":0,"forks_count":9,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-05-01T11:38:32.696Z","etag":null,"topics":["automation","automation-testing","qa","qatools","stress-test"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/armbian.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-12-22T22:13:26.000Z","updated_at":"2023-02-17T16:07:54.000Z","dependencies_parsed_at":"2022-07-19T02:17:13.231Z","dependency_job_id":null,"html_url":"https://github.com/armbian/autotests","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/armbian/autotests","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armbian%2Fautotests","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armbian%2Fautotests/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armbian%2Fautotests/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armbian%2Fautotests/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/armbian","download_url":"https://codeload.github.com/armbian/autotests/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/armbian%2Fautotests/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260040552,"owners_count":22949853,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","automation-testing","qa","qatools","stress-test"],"created_at":"2025-06-15T19:40:35.251Z","updated_at":"2025-06-15T19:40:42.721Z","avatar_url":"https://github.com/armbian.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch3 align=center\u003e\u003ca href=\"#armbian-build-tools\"\u003e\u003cimg src=\".github/armbian-logo.png\" alt=\"Armbian logo\" width=\"144\"\u003e\u003c/a\u003e\u003cbr\u003e\nauto testing\u003c/h3\u003e\n\n# TL;DR\nScript can be installed on any Debian based Linux device on your network. Adapt the configuration-file to your requirements, start the test procedure and wait until its done. Check the logs/ for errors and summary in /reports\n\n\n## Privacy concerns\nIt runs locally in your network, no data is sent anywhere. Icons come from the internet.\n\n\n# Getting started\n\nClone, edit userconfig/configuration.sh and run the script. Script will scan your local network (if SUBNET is defined) otherwise it will cycle on IPs you have defined in HOSTS variable.\n\nIt will create logins based on the configuration file and run different tests/ to see if the board is working properly. You can start with predefined credentials or use your own.\n\nAll you need to do is configure the configuration file, hook up the power and network cable and you are ready for running the test.\n\nThat's it.\n\n## Prerequisites\n\nDownload the latest armbian image for your board(s). We recommend to use .torrent because this does the file integrity check for you automatically. [Write the data to the SDcard](https://docs.armbian.com/User-Guide_Getting-Started/#how-to-prepare-a-sd-card)\n\nPut the SDcard into your device, power it up and let it sit for 1-2 minutes, to do the standard initial setup.\n\n## Prepare your system\n\n1. Go to a folder where you want to store it. The following command will create a folder called 'autotests'. Clone the sources from Github and open the folder autotests:\n```\napt install git\ngit clone https://github.com/armbian/autotests\ncd autotests\n./go.sh\n```\n \n2. Edit `userconfig/configuration.sh`  \n\t- change number of passes (optional)\n\t- change stress time in seconds (optional)  \n\nWhat is your device(s) IP-Address or do you have a dedicated subnet for your devices.\nTo find the device, check your router or use [this tool](http://angryip.org/), to find your boards IP-Address(es).\n\t- set IP-Address (HOSTS) or Subnet (Examle: 192.168.0.1/24)\n\t- set WLAN_SSID and password (2,4 and/or 5,0GHz)\n\t- set BLUEDEV MAC-Address of a Blueooth device (Android phone for example)\n\nHow to find the Bluetooth MAC-Address on your mobile or Linux device with BT? Put your phone's BT to discoverable mode and run:\n\n`hcitool scan` \n\non a Linux computer that has a BT-Dongle. On an Android device you find the MAC-Address in the phones settings/about the phone/Status.\n\n3. Run :+1: :\nThe script will display which board gets tested\n```\n./go.sh\n```\n4. Once finished, go to `/autotests/logs` and check latest report.`\n\n\n# What this tool does?\n\nIt Connects to the host(s) or all Armbian hosts in your subnet and runs the tests found in folder tests in alphabetical order.\n\nExample report:\n\n\u003ctable class=\"TFtable\" cellspacing=0 width=100% border=0\u003e \u003ctr\u003e\u003ctd align=right rowspan=2\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/hashtag.png\u003e\u003c/td\u003e\u003ctd align=center rowspan=2\u003eBoard\u003cbr\u003e/\u003cbr\u003e Cycle\u003c/td\u003e\u003ctd rowspan=2\u003eVersion / distribution \u003cbr\u003eKernel / variant\u003c/td\u003e\n\u003ctd align=center rowspan=1\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/lan.png\u003e\u003cbr\u003e\u003csmall\u003eLan\u003c/small\u003e\u003c/td\u003e\u003ctd align=center rowspan=1\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/wifi.png\u003e\u003cbr\u003e\u003csmall\u003e2.4Ghz\u003c/small\u003e\u003c/td\u003e\u003ctd align=center rowspan=1\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/wifi.png\u003e\u003cbr\u003e\u003csmall\u003e5Ghz\u003c/small\u003e\u003c/td\u003e\u003ctd align=center rowspan=1\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/memory.png\u003e\u003cbr\u003e\u003csmall\u003ememory\u003c/small\u003e\u003c/td\u003e\u003ctd align=center rowspan=1\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/storage.png\u003e\u003cbr\u003e\u003csmall\u003estorage\u003c/small\u003e\u003c/td\u003e\u003ctd align=center rowspan=2\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/bluetooth.png\u003e\u003cbr\u003e\u003csmall\u003eBT\u003c/small\u003e\u003c/td\u003e\u003ctd align=center rowspan=2\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/fire.png\u003e\u003cbr\u003e\u003csmall\u003eStress 6s\u003c/small\u003e\u003c/td\u003e\u003ctd align=center rowspan=2\u003e\u003cbr\u003e\u003csmall\u003eDVFS (Mhz)\u003c/small\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd align=middle colspan=3\u003eIperf send/receive (MBits/s)\u003c/td\u003e \u003ctd align=middle colspan=2\u003eIO read/write (MBits/s)\u003c/td\u003e\u003c/tr\u003e\n\n\u003ctr\u003e\u003ctd align=right rowspan=3\u003e\u0026nbsp;1\u0026nbsp;\u003c/td\u003e \u003ctd colspan=10\u003eCubietruck ###.###.###.200\u003c/td\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e \u003ctd align=center\u003e1/2\u003cbr\u003e\u003csmall\u003e19:16:37\u003c/small\u003e\u003c/td\u003e \u003ctd\u003e20.02.1 (bionic)\u003cbr\u003eLinux 5.4.26-sunxi stable\u003c/td\u003e\u003ctd align=center\u003e\u003csmall\u003esun7i-dwmac\u003c/small\u003e 550 - 728\u003cbr\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003csmall\u003ebrcmfmac\u003c/small\u003e \u003cbr\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/na.png\u003e\u003c/td\u003e\u003ctd align=center\u003e358 - 342\u003c/td\u003e\u003ctd align=center\u003e388 - 8\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/checked.png\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/checked.png\u003e\u003c/td\u003e\u003ctd align=center\u003e480 - 960\u003c/td\u003e\u003c/tr\u003e\n\n\u003ctr\u003e \u003ctd align=center\u003e2/2\u003cbr\u003e\u003csmall\u003e19:21:22\u003c/small\u003e\u003c/td\u003e \u003ctd\u003e20.02.1 (bionic)\u003cbr\u003eLinux 5.4.26-sunxi stable\u003c/td\u003e\u003ctd align=center\u003e\u003csmall\u003esun7i-dwmac\u003c/small\u003e 521 - 744\u003cbr\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003csmall\u003ebrcmfmac\u003c/small\u003e \u003cbr\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/na.png\u003e\u003c/td\u003e\u003ctd align=center\u003e357 - 340\u003c/td\u003e\u003ctd align=center\u003e386 - 11\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/checked.png\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/checked.png\u003e\u003c/td\u003e\u003ctd align=center\u003e480 - 960\u003c/td\u003e\u003c/tr\u003e\n\n\u003ctr\u003e\u003ctd align=right rowspan=3\u003e\u0026nbsp;2\u0026nbsp;\u003c/td\u003e \u003ctd colspan=10\u003eTinkerboard ###.###.###.204\u003c/td\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e \u003ctd align=center\u003e1/2\u003cbr\u003e\u003csmall\u003e19:25:24\u003c/small\u003e\u003c/td\u003e \u003ctd\u003e20.02.1 (bionic)\u003cbr\u003eLinux 5.4.20-rockchip stable\u003c/td\u003e\u003ctd align=center\u003e\u003csmall\u003erk_gmac-dwmac\u003c/small\u003e 941 - 908\u003cbr\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003csmall\u003ertl8723bs\u003c/small\u003e 24\u003cbr\u003e\u003csmall\u003emt7601u\u003c/small\u003e 99\u003cbr\u003e\u003csmall\u003ert2800usb\u003c/small\u003e 109\u003cbr\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/na.png\u003e\u003c/td\u003e\u003ctd align=center\u003e696 - 742\u003c/td\u003e\u003ctd align=center\u003e698 - 70\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/checked.png\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/checked.png\u003e\u003c/td\u003e\u003ctd align=center\u003e600 - 1800\u003c/td\u003e\u003c/tr\u003e\n\n\u003ctr\u003e \u003ctd align=center\u003e2/2\u003cbr\u003e\u003csmall\u003e19:29:41\u003c/small\u003e\u003c/td\u003e \u003ctd\u003e20.02.1 (bionic)\u003cbr\u003eLinux 5.4.20-rockchip stable\u003c/td\u003e\u003ctd align=center\u003e\u003csmall\u003erk_gmac-dwmac\u003c/small\u003e 941 - 906\u003cbr\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003csmall\u003ertl8723bs\u003c/small\u003e 3\u003cbr\u003e\u003csmall\u003emt7601u\u003c/small\u003e 105\u003cbr\u003e\u003csmall\u003ert2800usb\u003c/small\u003e 113\u003cbr\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/na.png\u003e\u003c/td\u003e\u003ctd align=center\u003e692 - 740\u003c/td\u003e\u003ctd align=center\u003e731 - 68\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/checked.png\u003e\u003c/td\u003e\u003ctd align=center\u003e\u003cimg width=20 src=https://raw.githubusercontent.com/armbian/autotests/master/icons/checked.png\u003e\u003c/td\u003e\u003ctd align=center\u003e600 - 1800\u003c/td\u003e\u003c/tr\u003e\n\u003c/table\u003e\n\n# Which tests are executed?\n\n| test name | function |\n|:-|:-|\n|0000-read-board-data.bash| Read board OS information|\n|0001-nigtly-stable-switch.bash| Switching between nightly and stable, odd/even|\n|0002-update-and-upgrade.bash| Upgrade all packages|\n|0008-connect-wireless-devices-on-2.4Ghz.bash|Connects wireless devices on 2.4G band|\n|0013-iperf-on-all-wired-interfaces.bash|Check speed on all wired devices|\n|0014-iperf-on-all-wireless-interfaces.bash|Check speed on all wireless devices|\n|0015-connect-wireless-devices-on-5.0Ghz.bash|Connects wireless devices on 5G band|\n|0017-iperf-on-all-wireless-interfaces.bash|Check speed on all wireless devices|\n|0018-io-tests-memory.bash| Determine maximum memory random write speed|\n|0019-io-tests-drive.bash| Determine maximum SD/eMMC random write speed|\n|0111-bluetoth.bash|Ping Bluetooth device to check basic BT functionality|\n|0115-strong-stressing.bash|Running heavy stressing for n seconds|\n|0116-dvfs.bash|Get min and max CPU temperature to see if DVFS is operational|\n|0119-7-zip-benchmark.bash.disabled|Run 7Zip benchmark|\n|9999-reboot.bash|Reboot the board|\n\n\n## To do's:\n- [x] parallel processing\n- [x] implement official SBC-bench with access to full logs\n- [ ] improve errors catching  \n- [x] implement iperf queue to prevent colisions on network testing\n- [ ] create JSON data export for single board and together  \n- [ ] common data collecting  \n- [ ] support custom test board https://forum.armbian.com/topic/10841-the-testing-thread  \n\n![Semantic description of image](https://forum.armbian.com/uploads/monthly_2019_09/IMG_0031.thumb.JPG.25382da99ba09c22c27cf8d274141b8b.JPG \"Image Title\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farmbian%2Fautotests","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farmbian%2Fautotests","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farmbian%2Fautotests/lists"}