From 78c7a7b73cd88fb97ca76d6614026807ad33739e Mon Sep 17 00:00:00 2001 From: Eduard Kaverinskyi Date: Wed, 2 Apr 2025 14:20:46 +0200 Subject: [PATCH 1/3] docs/transparent-validation/rte/revision-history.md: add notes from v1.1.1 1. Footprint of Q5 adapted to the recommended footprint of Si9435bdy 2. Refactored the USB data lines routes to have more equal length. 3. Changed board version to v1.1.1 on PCB and the schematics Source: https://github.com/3mdeb/rte-schematics/pull/8 Signed-off-by: Eduard Kaverinskyi --- docs/transparent-validation/rte/revision-history.md | 7 +++++++ 1 file changed, 7 insertions(+) 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 From 86b2570927c6e96db93ac18e7990392c0bc8e43a Mon Sep 17 00:00:00 2001 From: Eduard Kaverinskyi Date: Wed, 2 Apr 2025 15:57:55 +0200 Subject: [PATCH 2/3] docs/transparent-validation/rte/v1.1.0/flashing-guide.md: rewrite guide Signed-off-by: Eduard Kaverinskyi --- .../rte/v1.1.0/flashing-guide.md | 106 +++++++----------- 1 file changed, 43 insertions(+), 63 deletions(-) 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..4dcec84160 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,66 @@ 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 flash header 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) From f801068dfb3c9150d0d1ac899256845b0823ca03 Mon Sep 17 00:00:00 2001 From: Eduard Kaverinskyi Date: Wed, 2 Apr 2025 16:24:49 +0200 Subject: [PATCH 3/3] docs/transparent-validation/rte/v1.1.0/flashing-guide.md: generalize fl. header Signed-off-by: Eduard Kaverinskyi --- docs/transparent-validation/rte/v1.1.0/flashing-guide.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) 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 4dcec84160..c96ef058f3 100644 --- a/docs/transparent-validation/rte/v1.1.0/flashing-guide.md +++ b/docs/transparent-validation/rte/v1.1.0/flashing-guide.md @@ -13,7 +13,8 @@ To prepare the stand for flashing follow the steps described below: 1. Open the platform cover. -2. Connect the 6-pin flash header to the SPI header on RTE. +2. Connect the 6-pin from the flashing device (WSON8, Pomona clip, jumper wires) + to the SPI header on RTE. ```text SPI header 6 pin header