Anastasia Klimchuk submitted this change.

View Change



2 is the latest approved patch-set.
No files were changed between the latest approved patch-set and the submitted one.

Approvals: build bot (Jenkins): Verified Peter Marheine: Looks good to me, approved
doc: Add doc for supported boards and laptops

Change-Id: Iaae05ccd138fd8f7760823f867f3c7799018dc2e
Signed-off-by: Anastasia Klimchuk <aklm@flashrom.org>
Reviewed-on: https://review.coreboot.org/c/flashrom/+/82271
Reviewed-by: Peter Marheine <pmarheine@chromium.org>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
---
M doc/supported_hw/index.rst
A doc/supported_hw/supported_boards.rst
2 files changed, 20 insertions(+), 0 deletions(-)

diff --git a/doc/supported_hw/index.rst b/doc/supported_hw/index.rst
index ba77132..eebf394 100644
--- a/doc/supported_hw/index.rst
+++ b/doc/supported_hw/index.rst
@@ -8,3 +8,4 @@
supported_flashchips
supported_prog/index
supported_chipsets
+ supported_boards
diff --git a/doc/supported_hw/supported_boards.rst b/doc/supported_hw/supported_boards.rst
new file mode 100644
index 0000000..91b2899
--- /dev/null
+++ b/doc/supported_hw/supported_boards.rst
@@ -0,0 +1,19 @@
+========================
+Supported boards/laptops
+========================
+
+To see the list of all supported boards or laptops, check either ``struct board_info boards_known[]`` or ``struct board_info laptops_known[]``
+in the ``known_boards.c`` file in the source tree.
+
+If you have a flashrom repo cloned locally, you can look at the file in your repo, alternatively inspect the file
+`on the web UI of our GitHub mirror <https://github.com/flashrom/flashrom/blob/main/known_boards.c#L29>`_.
+
+If you can run flashrom locally, the command ``flashrom -L`` prints the list of all supported boards and laptops
+(see :doc:`/classic_cli_manpage` for more details on command line options). The output of this command is long, so you might
+want to save it to file or grep.
+
+Each board entry is described by the ``struct board_info`` in ``include/programmer.h`` which you can inspect in the same way, either in the local source tree or
+`in the GitHub web UI <https://github.com/flashrom/flashrom/blob/main/include/programmer.h#L207>`_.
+
+Note the ``enum test_state status`` of the board. ``OK`` means board is tested, ``NT`` means not tested, to see all possible
+test states check the ``enum test_state`` definition in ``include/flash.h``.

To view, visit change 82271. To unsubscribe, or for help writing mail filters, visit settings.

Gerrit-MessageType: merged
Gerrit-Project: flashrom
Gerrit-Branch: main
Gerrit-Change-Id: Iaae05ccd138fd8f7760823f867f3c7799018dc2e
Gerrit-Change-Number: 82271
Gerrit-PatchSet: 4
Gerrit-Owner: Anastasia Klimchuk <aklm@chromium.org>
Gerrit-Reviewer: Anastasia Klimchuk <aklm@chromium.org>
Gerrit-Reviewer: Peter Marheine <pmarheine@chromium.org>
Gerrit-Reviewer: Thomas Heijligen <src@posteo.de>
Gerrit-Reviewer: build bot (Jenkins) <no-reply@coreboot.org>