diff --git a/docs/transparent-validation/rte/revision-history.md b/docs/transparent-validation/rte/revision-history.md index 64ac739dc1..add2e373fe 100644 --- a/docs/transparent-validation/rte/revision-history.md +++ b/docs/transparent-validation/rte/revision-history.md @@ -1,5 +1,12 @@ # Revision history +## v1.1.1 + +* Footprint of Q5 adapted to the recommended footprint of + [Si9435bdy](https://www.vishay.com/docs/72245/si9435bd.pdf) +* Refactored the USB data lines routes to have more equal length +* Changed board version to v1.1.1 on PCB and the schematics + ## v1.1.0 * added `Open hardware` logo diff --git a/docs/transparent-validation/rte/v1.1.0/flashing-guide.md b/docs/transparent-validation/rte/v1.1.0/flashing-guide.md index 61dd3b958f..c96ef058f3 100644 --- a/docs/transparent-validation/rte/v1.1.0/flashing-guide.md +++ b/docs/transparent-validation/rte/v1.1.0/flashing-guide.md @@ -3,86 +3,67 @@ This document describes how to set up external flashing for the devices using RTE. -## NS5x/7x 12th Generation - -### Prerequisites +## Prerequisites * [Prepared RTE](../v1.1.0/quick-start-guide.md) -* WSON8 probe - - ![](../../../images/ch341a_rec/wson8_probe.jpg) - -### Flashing - -> Note: the `flash.sh` script, used in this chapter, is available only in 0.8.1 -> or newer RTE OS releases, check [meta-rte](https://github.com/3mdeb/meta-rte) -> for more inf.. - -1. Unscrew the bottom cover of the laptop. -1. Disconnect the battery - - > All power must be removed from the laptop during flashing. - ![](../../../images/ns5x_7x_battery_unplugged.jpg) +## Connection to SPI header -1. Localize the flash chip. +To prepare the stand for flashing follow the steps described below: - ![](../../../images/ns5x_7x_without_bottom_cover.jpg) +1. Open the platform cover. -1. Take the WSON8 probe and locate the white dot on the needles side. The dot - indicates the first reference pin that should be connected to the pin on the - flash chip also marked with a dot. +2. Connect the 6-pin from the flashing device (WSON8, Pomona clip, jumper wires) + to the SPI header on RTE. - ![](../../../images/ch341a_rec/wson8_probe2.jpg) +```text + SPI header 6 pin header + Vcc pin 1 (Vcc) + GND pin 2 (GND) + CS pin 4 (CS) + SCLK pin 6 (CLK) + MISO pin 5 (MISO) + MOSI pin 3 (MOSI) +``` -1. Connect the cables coming out from the WSON8 probe to the - [SPI header](specification.md) according to the pictures and table - below. +```text + ______ + > | | +Vcc 3.3V ----1 2---- GND + | | + MOSI ----3 4---- CS + | | + MISO ----5 6---- CLK + |______| +``` - - Top view of flash chip: +## Platform-specific steps - ![](../../../images/rte-v1.1.0-flash_chip_NS50_70PU.jpg) +To find more specific information, regarding recovery of a given platform, +navigate to a recovery section in the documentation for a specific platform: - - Table with all required connections: +1. [Supported hardware](https://docs.dasharo.com/variants/overview/) +2. Choose a vendor. For example, `Protectli` +3. Navigate to the `Recovery` section - | RTE SPI header | Flash Chip | - |:--------------:|:----------:| - | Vcc | VCC | - | CS | CS# | - | MISO (SO) | SO (IO1) | - | GND | VSS | - | SCLK | SCLK | - | MOSI (SI) | SI | +For example: - > Note: both the SPI header and the WSON8 probe have 8-pin headers. - Pins marked as NC on the RTE board and as IO2 and IO3 on the flash chip - do not require a connection. +* [Protectli recovery + guide](https://docs.dasharo.com/unified/protectli/recovery/) +* [NovaCustom recovery + guide](https://docs.dasharo.com/unified/novacustom/recovery/) - - Example connection appearance: +## Remote flashing - ![](../../../images/rte-v1.1.0-WSON8-SPI-header.jpg) +To remotely initiate flashing via RTE, use the `osfv_cli` tool. -1. Login to RTE via `ssh` or `minicom`. -1. Connect and hold the WSON8 probe to the flash chip. -1. Read the flash chip by executing the following command on RTE: +Example flashing command: - ```bash - ./flash.sh read dump.rom - ``` +`osfv_cli rte --rte_ip= flash write --rom ` -1. If the reading was successful, the output from the command above should - contain the phrase `Verifying flash... VERIFIED.`. Only after the entire - script has been executed, the WSON8 probe can be disconnected. -1. Connect and hold again the WSON8 probe to the flash chip. -1. Write the flash chip by executing the following command on RTE: +More information about `osfv_cli`: - ```bash - ./flash.sh write coreboot.rom - ``` +* [osfv-scripts repository](https://github.com/Dasharo/osfv-scripts/) -1. If the writing was successful, the output from the command above should - contain the phrase `Verifying flash... VERIFIED.`. Only after the entire - script has been executed, the WSON8 probe can be disconnected. -1. Reconnect the battery and screw in the bottom cover. -1. Power on the device. If the platform is booting up and basic functionalities - are working, the entire procedure was successful. +* [osfv_cli + documentation](https://github.com/Dasharo/osfv-scripts/blob/main/osfv_cli/README.md)