We have introduced a new tool called Stretch Diagnostics to assist when debugging an issue. The tool runs a suite of tests to check for correct device configurations, sensor values, software package versions, etc.
It isn’t yet comprehensive but can serve as a first step when working with Hello Robot support to diagnose an issue.
To install the tool run:
pip3 install hello-robot-stretch-diagnostics
The stretch_diagnostic_check.py
tool has numerous options. To start, we recommend running:
stretch_diagnostic_check.py --simple
stretch_diagnostic_check.py --report
stretch_diagnostic_check.py --zip
...
----------- Complete -------------
Zip file available at: /home/hello-robot/stretch_user/log/diagnostic_check/diagnostic_check_stretch-re1-1021_20230310133635.zip
The --simple
command will run a suite of system and configuration checks (logged under ~/stretch_user/log/diagnostic_check
).
The --report
command will generate a succinct report of the test results.
The --zip
command will generate a zip file of the test results that can be emailed to Hello Robot support.
Below is a snippet of what a report looks like after running the --simple
suite:
Note: There are number of test suites in addition to --simple
. These are more complex and best done with the guidance of Hello Robot support
Note: It is OK for some tests to fail (and be flagged red). The meaning of Pass/Fail can be ambiguos depending on the test. Contact Hello Robot support to determine if there is an issue with your robot.