If your Douro's tablet no longer boots due to data corruption on its internal drive (see 'Powering on and off the Douro'), then the drive may be recovered by flashing it to factory settings.
To do so, you will need a USB flash drive (8 GB or higher and preferably USB 3.0), a USB keyboard, and a computer to create the recovery USB drive with (Linux, Mac, or Windows).
Identify your tablet model
You can determine which model your tablet is by whether the USB port next to its power button is USB 2.0 (black) or 3.0 (blue). The ACP-1104 has one USB 3.0 port, the ACP-1103's are all USB 2.0.
Download the image
Download the appropriate Lamassu flashing utility image (around 3 GB):
ACP-1103 – lamassu-flash-utility-1103-732.img.xz
ACP-1104 – lamassu-flash-utility-1104-732.img.xz
The lamassu-machine version contained in the image is v7.3.2
Creating the recovery USB drive
Download and install Etcher (available for Linux, Mac, and Windows): https://balena.io/etcher/
Open Etcher, select the Lamassu image file, then select the destination USB drive and click flash.
WARNING: Be very careful when selecting the destination drive. Correctly point it to the destination USB drive and not to any other connected devices, as the command will result in full data loss to the destination.
Booting to the USB drive
Power off the Douro with a single press and release of the power button at the top of the tablet.
Insert the now flashed USB drive into the blue USB 3.0 port on the top of the Douro's tablet.
Connect a USB keyboard to one of the tablet's other ports.
Press the tablet's power button, then repeatedly hit the DEL key on the keyboard until the tablet boots into the BIOS settings screen.
Select the USB drive as the machine's boot drive by using the screenshots here.
Flashing the tablet
When the tablet boots into Debian and you are prompted for a username, type root and hit Enter.
For the password, type password and hit Enter. Note: nothing will show on the screen as you're typing, as password entry is hidden on Linux.
Drives may benefit from a full wipe of the SSD, prior to flashing. To wipe, carefully type the following onto the machine's tablet and hit Enter. The screen will go to a new line without output for about 15 minutes, and when complete return to a new command prompt.
dd if=/dev/zero of=/dev/sda bs=1M
To reflash the tablet's internal drive, type flash and hit enter.
The flashing process may take up to 30 minutes. See the screenshot below for the expected output:
When it's complete, type shutdown now and hit Enter.
Booting to the internal drive
Remove the USB drive but keep the keyboard attached. Press once on the tablet's power button, then repeated hit DEL on the keyboard to boot into the BIOS.
Reverse the changes you made earlier to the boot selection, re-enabling the mSATA drive as the first boot option.
In the BIOS, choose 'Save and exit', remove the keyboard, and close the machine door.
Pairing and updating
When fully booted, press the INIT button on the 'Congratulations' screen. Once initialised, create a new pairing code from your admin as you had done originally to pair the machine, press the Pair button and scan the pairing code.
The version contained on this machine image will be older than our latest release. Once paired to your admin, please use this article to retrieve the machine's device ID and contact support so that we may update your machine.