Add hardkernel-odroid-h4-plus placeholder docs #903
Conversation
philipandag
force-pushed
the
hardkernel-odroid-h4-plus-docs
branch
from
fa4d4e1
to
5f07834
Compare
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
philipandag
force-pushed
the
hardkernel-odroid-h4-plus-docs
branch
from
5f07834
to
e162fab
Compare
| 3. Build the firmware: | ||
|
|
||
| ```bash | ||
| ./build.sh odroid_h4 |
There was a problem hiding this comment.
IT DOES NOT WORK
Will we add this platform to the build script? It might as well be replaced with manual build instructions if not.
There was a problem hiding this comment.
We may add the platform to the build script.
There was a problem hiding this comment.
Working on it here: Dasharo/coreboot#564
philipandag
force-pushed
the
hardkernel-odroid-h4-plus-docs
branch
from
afb6187
to
12953f1
Compare
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
philipandag
force-pushed
the
hardkernel-odroid-h4-plus-docs
branch
from
12953f1
to
befecc5
Compare
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
| 3. Build the firmware: | ||
|
|
||
| ```bash | ||
| ./build.sh odroid_h4 |
There was a problem hiding this comment.
We may add the platform to the build script.
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
philipandag
force-pushed
the
hardkernel-odroid-h4-plus-docs
branch
from
746fa1f
to
07655bc
Compare
Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com> Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
| ``` | ||
| then follow the steps below: | ||
|
|
||
| === "Odroid H4" |
There was a problem hiding this comment.
I asked to remove those tabs, there are no variants of H4 that need any differentation.
| The settings of all the above options can be restored after a firmware | ||
| update. | ||
|
|
||
| ## Updating Dasharo |
There was a problem hiding this comment.
We should also mention DTS with DPP as we do for initial deployment. DTS with DPP is also designed to simplify updates.
| | **Storage devices** | microSD card SanDisk Ultra 16GB | | ||
| | | SATA disk (TBD) | |
There was a problem hiding this comment.
eMMC missing. There is no SD card slot on ODROID
There was a problem hiding this comment.
got the MMC model from parted -l: 525bdd0
The SD card was removed here: 8260fb1#diff-aba226de1a626cd8a9d58b90c784ba9974737b7f9c3d5822ef871d153042855fL21
| | Component | Description | | ||
| |--------------------------------|---------------------------------------------| | ||
| | **CPU** | Intel(R) Processor N97 | | ||
| | **RAM** | DDR5 SODIMM up to 4800MHz | |
There was a problem hiding this comment.
We provide a particular RAM module part number in other matrices. Please update
There was a problem hiding this comment.
cb30bef
Manufacturer & Part Number from dmidecode
| - [Releases](../../variants/hardkernel_odroid_h4/releases.md) | ||
| - [Hardware Configuration Matrix](../../variants/hardkernel_odroid_h4/hardware-matrix.md) | ||
| - [Test Matrix](./test-matrix.md#hardkernel-odroid-h4) |
There was a problem hiding this comment.
Many links are missing: firmware udpate, iitial deployment, recovery, building manual...
There was a problem hiding this comment.
Sorry, I've filled them later and forgot to update.
3f54856
| | 30. | [CPU status][CPU] | CPU | CPU001.001, CPU002.001, CPU003.001, CPU004.001| | ||
| | 31. | [Auto boot time-out][BMM] | BMM | All | | ||
|
|
||
| [CBO]: . |
There was a problem hiding this comment.
Wrong links, either remove or provide valid ones.
There was a problem hiding this comment.
Added links to dasharo-compatibility tests: 3bdfee0
We are missing documentation for:
- SATA
- RTD
- SET
- BMM
For RTD and BMM I have added links to related documentation but we don't have anything related to SATA support and setup menu CPU & RAM information afaik.
There was a problem hiding this comment.
Added links to dasharo-security tests: 783fadb
- USS test id is used for both Usb stack enable/disable and Ubuntu Server Suppoert. The suites are in different tets modules, so maybe it's not a problem?
There was a problem hiding this comment.
Dasharo-stability:a504e21
- No TPD documentation in dasharo docs
There was a problem hiding this comment.
Dasharo-performance: d866e42
Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>
Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>
Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>
| 1. Move the flash selector jumper to select the backup flash chip. If the | ||
| device does not boot from any of the flash chips, an external recovery | ||
| needs to be performed. In that case continue with the recovery instructions | ||
| for the ODROID H4 model. |
There was a problem hiding this comment.
@philipandag please link that section I guess you mean "External flashing"
There was a problem hiding this comment.
Probably this https://wiki.odroid.com/odroid-h4/hardware/restore_h4_bios#using_tool_and_soldering_skills and https://wiki.odroid.com/odroid-h3/hardware/restore_h3_bios_usbprogrammer#with_usb_programmer_module_ch341a.
Had to test this recovery and it worked (flashed only one SPI, second one recovered with flashrom -p internal)
There was a problem hiding this comment.
please link that section I guess you mean "External flashing"
Yes, the sections were renamed and I didn't update this sentence.
aa4abb3#diff-63d4fe5312d3d5c9d0e564e54adf0e43958113fb5d526eb698cd0ff31bd3dc79L19-L21
Do we want to give an URL to the instructions from wiki.odroid.com? If the point of this documentation is only to help the users maybe it would be better to only redirect them to the wiki instead of writing pretty much the same instructions again? I have added the URL to ODROID wiki instructions on flashing using the CH341A programmer as a second tab of the External Flashing section. a3a7f52
In that case maybe an URL to the dual-bios recovery method should also be referenced? The wiki tells how to do it on Windows and using the EFI shell, that might be useful to some users.
There was a problem hiding this comment.
If the point of this documentation is only to help the users maybe it would be better to only redirect them to the wiki instead of writing pretty much the same instructions again?
We can link only if instructions are followed without comment, adjustment, or modification. Otherwise, we should write our own, which does not require such additional information.
There was a problem hiding this comment.
The documentation on odroid wiki includes instructions on flashing from UEFI shell and Windows which weren't tested by us, so I can't tell if they would require any additional information. Some weird flashing software which you need to launch from a USB drive is used there. Flashing using flashrom is not described on the wiki, so it does not overlap with what we have in our documentation, it may be included as an additional source.
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
| with the path to the Dasharo image you want to flash, e.g. `hardkernel_odroid_h4_v0.9.0.rom`. | ||
|
|
||
| ```bash | ||
| sudo flashrom -p internal -w [path] --ifd -i bios |
There was a problem hiding this comment.
Are we sure particle flashing is what we should do for initial deployment? I have doubts because using partial flashing from AMI to Dasharo gave me no support for the network. Then partial flashing from Dasharo to Dasharo leads to serious bricking. The reset of CMOS + G3 helped, but I was pretty concerned when switching SPI to AMI, which didn't boot (it looks like a lack of CMOS reset). Let's make sure this section is robust.
There was a problem hiding this comment.
I have doubts because using partial flashing from AMI to Dasharo gave me no support for the network.
Any more details on it? iPXE has to be explicitly enabled in the setup.
Then partial flashing from Dasharo to Dasharo leads to serious bricking.
Happened to me as well, but also after AMI->Dasharo transition. This PR should fix the bricking: Dasharo/coreboot#569
There was a problem hiding this comment.
Any more details on it? iPXE has to be explicitly enabled in the setup.
After booting to DTS v2.0.0, I had no network interface. I cannot reproduce that now, but I should analyze it more deeply when testing over the next 1-2 days.
There was a problem hiding this comment.
It happened again while doing Dasharo->AMI transition:
bash-5.2# flashrom -p internal -w logs/rom.bin
flashrom v1.2-1037-g5b4a5b40 on Linux 6.6.21-yocto-standard (x86_64)
flashrom is free software, get the source code at https://flashrom.org
Using clock_gettime for delay loops (clk_id: 1, resolution: 1ns).
coreboot table found at 0x76933000.
Found chipset "Intel Alder Lake-N".
Enabling flash write... Warning: Setting BIOS Control at 0xdc from 0x8b to 0x89 failed.
New value is 0x8b.
SPI Configuration is locked down.
FREG0: Flash Descriptor region (0x00000000-0x00000fff) is read-write.
FREG1: BIOS region (0x00600000-0x00ffffff) is read-write.
FREG2: Management Engine region (0x00001000-0x00413fff) is read-write.
PR0: Warning: 0x00b00000-0x00ffffff is read-only.
At least some flash regions are write protected. For write operations,
you should use a flash layout and include only writable regions. See
manpage for more details.
OK.
Found Programmer flash chip "Opaque flash chip" (16384 kB, Programmer-specific) on internal.
Reading old flash chip contents... done.
Erasing and writing flash chip... Transaction error between offset 0x00b00000 and 0x00afffff (= 0x00b00000 + -1)!
Reading current flash chip contents... done. Looking for another erase function.
Looking for another erase function.
Looking for another erase function.
Looking for another erase function.
Looking for another erase function.
Looking for another erase function.
Looking for another erase function.
No usable erase functions left.
FAILED!
Uh oh. Erase/write failed. Checking if anything has changed.
Reading current flash chip contents... done.
Apparently at least some data has changed.
Your flash chip is in an unknown state.
Get help on IRC (see https://www.flashrom.org/Contact) or mail
flashrom@flashrom.org with the subject "FAILED: <your board name>"!-------------------------------------------------------------------------------
DO NOT REBOOT OR POWEROFF!This is my fault since I didn't remove all necessary locks before flashing, but the critical question is how to deal with such a situation correctly. PR0 range is weird, why it does not cover whole bios region?
There was a problem hiding this comment.
I guess one way to deal with the problem is to write Dasharo again, go to the setup menu, disable protection, and then do the recovery.
There was a problem hiding this comment.
During training, @mkopec also faced a similar issue with the lack of an Ethernet interface, it seem to be some problem with power cycles because after G3, things started to work correctly.
| the brick state using an [RTE](../../transparent-validation/rte/introduction.md) | ||
| and Dasharo open-source firmware. | ||
|
|
||
| ## Dual BIOS |
There was a problem hiding this comment.
This section could be improved based on my experience from recovery after bad initial deployment: https://github.com/Dasharo/docs/pull/903/files#r1788722185
There was a problem hiding this comment.
Although I'm not sure if this issue would arise when recovering. You had issues with the initial deployment of Dasharo flashing only the bios region. Here we are flashing the whole FW, so there shouldn't be any issues with ME or network interfaces being in some invalid state afterwards?
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
philipandag
force-pushed
the
hardkernel-odroid-h4-plus-docs
branch
from
783fadb
to
78c2068
Compare
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>
| This process can be performed using the Dasharo Tools Suite available in the | ||
| Dasharo Pro Package (formerly Dasharo Entry Subscription) instead. For | ||
| instructions on how to use the DTS instead check | ||
|
|
||
| This process can be performed using the Dasharo Tools Suite included in the Dasharo | ||
| Pro Package subscription (formerly Dasharo Entry Subscription) instead. For | ||
| instructions on how to use the DTS see the [DTS documentation](../../dasharo-tools-suite/documentation.md#firmware-update) |
No description provided.