From da54bd60af60e1e6e1b92c272972f87c25f3234b Mon Sep 17 00:00:00 2001 From: Maxim Polyakov Date: Mon, 9 Jan 2023 23:48:04 +0300 Subject: [PATCH] Documentation: Update information about intelp2m MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change-Id: I80d5fb5d46b50193e8fecc647d9052a2e29af93f Signed-off-by: Maxim Polyakov Reviewed-on: https://review.coreboot.org/c/coreboot/+/71757 Tested-by: build bot (Jenkins) Reviewed-by: Filip LewiƄski Reviewed-by: David Hendricks --- Documentation/util.md | 4 +- Documentation/util/intelp2m/gopackages.png | Bin 11594 -> 0 bytes Documentation/util/intelp2m/index.md | 359 ++++++++++++--------- util/README.md | 4 +- 4 files changed, 215 insertions(+), 152 deletions(-) delete mode 100644 Documentation/util/intelp2m/gopackages.png diff --git a/Documentation/util.md b/Documentation/util.md index f902ba4fdd..e6d1402c8a 100644 --- a/Documentation/util.md +++ b/Documentation/util.md @@ -70,8 +70,8 @@ into a format which can be used in coreboot's verb table `Go` `C` * __intelmetool__ - Dump interesting things about Management Engine even if hidden `C` -* __intelp2m__ - convert the configuration DW0/1 registers value from -an inteltool dump to coreboot macros. `go` +* __intelp2m__ - Convert the inteltool register dump to gpio.h with GPIO +configuration for porting coreboot to your motherboard. `Go` * __inteltool__ - Provides information about the Intel CPU/chipset hardware configuration (register contents, MSRs, etc). `C` * __intelvbttool__ - Parse VBT from VGA BIOS `C` diff --git a/Documentation/util/intelp2m/gopackages.png b/Documentation/util/intelp2m/gopackages.png deleted file mode 100644 index fb81a1ce1f38dc5e5bee584a103adeb0dc371907..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11594 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 inteltool.log +``` + +After this step, you can generate `gpio.h`: + +```bash +./intelp2m -file ../inteltool/inteltool.log +``` + +More details in the help: + +```bash ./intelp2m -h -./intelp2m -file /path/to/inteltool.log ``` ## Platforms -It is possible to use templates for parsing inteltool.log files. -To specify such a pattern, use the option `-t