This document is a guide for the initial installation of Dasharo on a supported device. It assumes some knowledge about external flashing and is primarily aimed at technicians performing the initial installation and not for end users of the devices.
During the initial installation of Dasharo, you should deploy the supported Intel ME version (and configuration) on the device. Since vendor firmware has enabled Intel Boot Guard and BIOS Guard, it is not possible to do this from within the operating system and external flashing of the whole flash chip using a programmer like the CH341a is required.
Publicly released binaries do not contain the ME binary. If you need an Intel ME update for your device, contact us via an already established commercial support channel.
apt update apt upgrade sudo apt -y install flashrom
Steps for installing Dasharo BIOS:
Remove the bottom cover of the laptop.
Disconnect the primary battery. (1)
- Disconnect the CMOS battery. (2)
Attach a WSON-8 probe to the SPI flash chip. (3)
For TGL devices use SOIC clip instead of WSON
Backup the current firmware, in case you want to be able to restore it at some point:
flashrom -p ch341a_spi -r bios_backup.rom
Install Dasharo BIOS, replacing
[path]with the path to the firmware image you want to flash, e.g.
flashrom -p ch341a_spi -w [path]
Detach the WSON-8 probe.
- Connect the primary battery and reconnect the CMOS battery.
- Power on the laptop. The laptop may shut down once after training the memory.
EC firmware installation
Currently, the latest flashrom release lacks support for flashing ITE embedded controllers such as the ones present in NovaCustom laptops. Because of this, we need to build flashrom from source. Run the following commands on the target laptop:
Install build dependencies:
apt update apt upgrade apt install git build-essential debhelper pkg-config libpci-dev libusb-1.0-0-dev libftdi1-dev meson
Obtain source code:
git clone https://github.com/dasharo/flashrom.git cd flashrom
make sudo make install
Make a backup of the EC firmware:
Remember to store the backup on the separate device in case flashing fails.
flashrom -p ite_ec -r ec_backup.rom
Install the EC firmware:
Warning: After running this command, the internal keyboard and power button will stop responding until the device is power cycled (all power must be removed, including the internal battery). Be prepared to disconnect the battery after updating the EC.
Alternatively, you can boot up the laptop without the battery connected and power it from an AC adapter. Then, once the EC update is complete, disconnect the AC adapter to power off the laptop.
Run the following command, replacing
[path]with the path to the EC firmware you want to flash, e.g.
flashrom -p ite_ec -w [path]
Successful installation of Dasharo EC finishes the initial deployment process.
To ensure a smooth deployment process, it is recommended to use the latest version of DTS available from the releases page. Once you have obtained it, you can then proceed with following the Dasharo zero-touch initial deployment section procedure. This will help you set up Dasharo effectively and without manual intervention.
If something went wrong or EC installation was not done, the firmware will print an error string during boot:
In such case please follow the EC firmware update instructions for a specific board variant.