Add hardkernel-odroid-h4-plus placeholder docs #903

philipandag · 2024-09-19T09:04:33Z

No description provided.

docs/variants/hardkernel_odroid_h4_plus/releases.md

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

philipandag · 2024-09-20T06:23:08Z

docs/unified/hardkernel/building-manual.md

+    3. Build the firmware:
+
+    ```bash
+    ./build.sh odroid_h4


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.

We may add the platform to the build script.

Working on it here: Dasharo/coreboot#564

docs/unified/hardkernel/initial-deployment.md

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

docs/unified/hardkernel/building-manual.md

miczyg1 · 2024-09-24T08:27:31Z

docs/unified/hardkernel/building-manual.md

+    3. Build the firmware:
+
+    ```bash
+    ./build.sh odroid_h4


We may add the platform to the build script.

docs/unified/hardkernel/building-manual.md

docs/unified/hardkernel/firmware-update.md

docs/unified/hardkernel/initial-deployment.md

docs/unified/hardkernel/recovery.md

docs/variants/hardkernel_odroid_h4_plus/hardware-matrix.md

mkdocs.yml

docs/unified/hardkernel/recovery.md

docs/unified/hardkernel/initial-deployment.md

Signed-off-by: Filip Gołaś <filip.golas@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>

miczyg1 · 2024-09-30T11:39:05Z

docs/variants/hardkernel_odroid_h4/building-manual.md

+    ```
+then follow the steps below:
+
+=== "Odroid H4"


I asked to remove those tabs, there are no variants of H4 that need any differentation.

docs/variants/hardkernel_odroid_h4/building-manual.md

miczyg1 · 2024-09-30T11:40:15Z

docs/variants/hardkernel_odroid_h4/firmware-update.md

+The settings of all the above options can be restored after a firmware
+update.
+
+## Updating Dasharo


We should also mention DTS with DPP as we do for initial deployment. DTS with DPP is also designed to simplify updates.

miczyg1 · 2024-09-30T11:41:44Z

docs/variants/hardkernel_odroid_h4/hardware-matrix.md

+| **Storage devices**            | microSD card SanDisk Ultra 16GB             |
+|                                | SATA disk (TBD)                             |


eMMC missing. There is no SD card slot on ODROID

got the MMC model from parted -l: 525bdd0

The SD card was removed here: 8260fb1#diff-aba226de1a626cd8a9d58b90c784ba9974737b7f9c3d5822ef871d153042855fL21

miczyg1 · 2024-09-30T11:49:19Z

docs/variants/hardkernel_odroid_h4/hardware-matrix.md

+| Component                      | Description                                 |
+|--------------------------------|---------------------------------------------|
+| **CPU**                        | Intel(R) Processor N97                      |
+| **RAM**                        | DDR5 SODIMM up to 4800MHz                   |


We provide a particular RAM module part number in other matrices. Please update

cb30bef
Manufacturer & Part Number from dmidecode

miczyg1 · 2024-09-30T11:57:25Z

docs/variants/hardkernel_odroid_h4/overview.md

+    - [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)


Many links are missing: firmware udpate, iitial deployment, recovery, building manual...

Sorry, I've filled them later and forgot to update.
3f54856

docs/variants/hardkernel_odroid_h4/recovery.md

docs/variants/hardkernel_odroid_h4/releases.md

miczyg1 · 2024-09-30T12:04:26Z

docs/variants/hardkernel_odroid_h4/test-matrix.md

+| 30. | [CPU status][CPU]                     | CPU           | CPU001.001, CPU002.001, CPU003.001, CPU004.001|
+| 31. | [Auto boot time-out][BMM]             | BMM           | All                                  |
+
+[CBO]: .


Wrong links, either remove or provide valid ones.

Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>

pietrushnic · 2024-10-01T08:27:50Z

docs/variants/hardkernel_odroid_h4/recovery.md

+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.


@philipandag please link that section I guess you mean "External flashing"

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)

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.

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.

docs/variants/hardkernel_odroid_h4/recovery.md

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

pietrushnic · 2024-10-05T22:21:27Z

docs/variants/hardkernel_odroid_h4/initial-deployment.md

+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


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.

pietrushnic · 2024-10-05T22:22:05Z

docs/variants/hardkernel_odroid_h4/recovery.md

+the brick state using an [RTE](../../transparent-validation/rte/introduction.md)
+and Dasharo open-source firmware.
+
+## Dual BIOS


This section could be improved based on my experience from recovery after bad initial deployment: https://github.com/Dasharo/docs/pull/903/files#r1788722185

philipandag requested a review from miczyg1 September 20, 2024 06:14

philipandag force-pushed the hardkernel-odroid-h4-plus-docs branch from fa4d4e1 to 5f07834 Compare September 20, 2024 06:16

philipandag commented Sep 20, 2024

View reviewed changes

docs/variants/hardkernel_odroid_h4_plus/releases.md Outdated Show resolved Hide resolved

philipandag added 9 commits September 20, 2024 08:19

docs: Add hardkernel-odroid-h4-plus placeholder files

f4aa311

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

mkdocs.yml: Add hardkernel odroid h4 pages

483e421

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4_plus/releases.md: Add

36190a4

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

unified/hardkernel/overview.md: Add

6603f8e

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

unified/hardkernel/building-manual.md: Add

4697210

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

unified/hardkernel/initial-deployment.md: Add

3b627e4

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

unified/hardkernel/firmware-update.md: Add

40e79d7

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

unified/hardkernel/recovery.md: Add

1d34c93

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

docs hardkernel: pre-commit

e162fab

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 September 20, 2024 06:20

philipandag marked this pull request as ready for review September 20, 2024 06:21

philipandag mentioned this pull request Sep 20, 2024

Hardkernel Odroid-H4 Dasharo (coreboot+UEFI) v0.9.0 - documentation Dasharo/dasharo-issues#875

Open

5 tasks

philipandag commented Sep 20, 2024

View reviewed changes

docs/unified/hardkernel/initial-deployment.md Outdated Show resolved Hide resolved

philipandag force-pushed the hardkernel-odroid-h4-plus-docs branch from afb6187 to 12953f1 Compare September 20, 2024 06:42

hardkernel_odroid_h4_plus/hardware-matrix.md: Add

befecc5

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 September 20, 2024 08:52

philipandag added 2 commits September 20, 2024 10:55

unified/hardkernel/test-matrix.md: Add only Dasharo Compatibility

48b99dd

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

unified/hardkernel/test-matrix.md: Add reference from script

ba5ee6c

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

miczyg1 requested changes Sep 24, 2024

View reviewed changes

pietrushnic reviewed Sep 24, 2024

View reviewed changes

docs/unified/hardkernel/recovery.md Outdated Show resolved Hide resolved

m-iwanicki reviewed Sep 26, 2024

View reviewed changes

docs/unified/hardkernel/initial-deployment.md Outdated Show resolved Hide resolved

docs: Move all odroid H4+ files from unified to variants

07655bc

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 September 30, 2024 09:42

philipandag and others added 3 commits September 30, 2024 11:49

hardkernel_odroid_h4/firmware_update.md: update flash command

718c7e3

Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com> Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/recovery.md: Describe using flash jumper

5c5403d

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/initial_deployment.md: Mention DTS

aa5f0b9

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/releases.md: Add newsletter subscribe url

e15fa98

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

miczyg1 requested changes Sep 30, 2024

View reviewed changes

philipandag and others added 6 commits September 30, 2024 14:27

hardkernel_odroid_h4/recovery.md: Reword dual bios recovery

7d161f3

Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>

Update docs/variants/hardkernel_odroid_h4/building-manual.md

b0c60d7

Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>

hardkernel_odroid_h4/building-manual.md: Remove tab

9e3c3c5

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/firmware_update.md: Mention DTS

b43a0ce

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/recovery.md: Remove tab

e044a73

Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>

hardkernel_odroid_h4/releases.md: Add note "Coming soon."

1a1ef2c

Co-authored-by: Michał Żygowski <michal.zygowski@3mdeb.com>

pietrushnic requested changes Oct 1, 2024

View reviewed changes

philipandag added 7 commits October 3, 2024 09:24

hardkernel_odroid_h4/hardware-matrix.md: Fix PSU

8260fb1

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/releases.md: Dasharo Pro Package

641d5ec

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/hardware-matrix.md: Add RAM model from dmidecode

cb30bef

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/hardware-matrix.md: Add eMMC from parted -l

525bdd0

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/overview.md: Add missing links

3f54856

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/recovery.md: Fix redirect to other section

aa4abb3

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

hardkernel_odroid_h4/recovery.md: URL to ODROID wiki recovery

a3a7f52

Signed-off-by: Filip Gołaś <filip.golas@3mdeb.com>

pietrushnic reviewed Oct 5, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add hardkernel-odroid-h4-plus placeholder docs #903

Add hardkernel-odroid-h4-plus placeholder docs #903

philipandag commented Sep 19, 2024

philipandag Sep 20, 2024 •

edited

Loading

miczyg1 Sep 24, 2024

miczyg1 Sep 30, 2024

miczyg1 Sep 24, 2024

miczyg1 Sep 30, 2024

philipandag Sep 30, 2024

miczyg1 Sep 30, 2024

philipandag Sep 30, 2024

miczyg1 Sep 30, 2024

philipandag Oct 3, 2024

miczyg1 Sep 30, 2024

philipandag Oct 3, 2024

miczyg1 Sep 30, 2024

philipandag Oct 3, 2024

miczyg1 Sep 30, 2024 •

edited

Loading

pietrushnic Oct 1, 2024

m-iwanicki Oct 1, 2024

philipandag Oct 3, 2024

pietrushnic Oct 3, 2024

pietrushnic Oct 5, 2024

pietrushnic Oct 5, 2024

		\| Storage devices \| microSD card SanDisk Ultra 16GB \|
		\| \| SATA disk (TBD) \|

Add hardkernel-odroid-h4-plus placeholder docs #903

Are you sure you want to change the base?

Add hardkernel-odroid-h4-plus placeholder docs #903

Conversation

philipandag commented Sep 19, 2024

philipandag Sep 20, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

miczyg1 Sep 30, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

philipandag Sep 20, 2024 •

edited

Loading

miczyg1 Sep 30, 2024 •

edited

Loading