Factory reset

There might be situations in which a factory reset of the operating system of the HemiStereo NX 3D sensor might be necessary. The factory reset requires the HemiStereo NX to be still bootable, meaning you should still be able to get shell (and root) access (see Getting shell access) to set the sensor into “forced recovery” mode via software. If this is not possible anymore, the “forced recovery” mode must be set via hardware jumper. Please contact the support, we are happy to help you after examining the situation.

Note

If you experiencing issues with your sensor, please let us know about your experience (support). We are trying to avoid these situations during development, but of course will help you at highest priority if things go wrong.

Using the flash tool

Note

Currently the manual factory reset requires you to have a linux-powered host computer with root privileges available. If this is not the case, please let us know, we will figure out a way to help you.

First, get the archive, containing the root filesystem, the NVIDIA flash tool and some supporting scripts. We recommend using wget or curl - but you may as well just enter the link into your browser, it should start the download automatically. The link depends on your device, which is either containing an NVIDIA Jetson Nano (device name ends on N, e.g. HS-NX-180**N**) or an NVIDIA Jetson Xavier (device name ends on X, e.g. HS-NX-180**X**). If in doubt contact us with your serial number

Nano:

https://files.3dvisionlabs.com/hemistereo/recovery_nx_nano.tar.bz2

Xavier:

https://files.3dvisionlabs.com/hemistereo/recovery_nx_xavier.tar.bz2

For the further examples, the xavier package serves as example, please adapt the commands for the nano.

To begin the reset, reboot the HemiStereo NX sensor (e.g. by power cycle) and connect it to your host via micro-USB cable (the small port next to the ethernet). Also, the sensor should be connected to the internet for downloading the docker images for all default applications as well as the calibration files after the recovery. On the host, unpack the archive:

Note

Make sure you have sudo / super-user powers on your host machine, otherwise the next steps will fail

sudo tar --same-owner -xf recovery_nx_xavier.tar.bz2

Then go into the extracted directory and start sudo ./recovery.sh. Follow the instructions. You will need the sensor login-name and password as well as the sudo password. Also, the reboot step of the sensor is not automated, so please login to the sensor and reboot manually when prompted - using exactly the command given by the recovery script.

Note

The sensor will reboot automatically after the flash succeeds. Please be aware, that it will start to download all docker-images for the stereo-backend and other default apps thereafter. This will take some time, please leave it connected to the internet during that period.