xref: /aosp_15_r20/external/coreboot/util/amdtools/README.md (revision b9411a12aaaa7e1e6a6fb7c5e057f44ee179a49c)
1# amdtools
2Various tools for AMD platforms
3
4## A tool to update the SPI speed set in the EFS table
5This works for Stoney Ridge and Zen class AMD processors.
6 - update_efs_spi_speed
7
8## A set of tools to compare (extended) K8 memory settings.
9 - k8-compare-pci-space.pl
10 - k8-interpret-extended-memory-settings.pl
11 - k8-read-mem-settings.sh
12 - parse-bkdg.pl
13
14Before you can use them, you need to massage the relevant BKDG
15sections into useable data. Here's how.
16
17  1. First, you need to acquire a copy of the K8 BKDG. Go here:
18     Rev F: http://www.amd.com/us-en/assets/content_type/white_papers_and_tech_docs/32559.pdf
19  2. Make sure pdftotext is installed (it's in the poppler-utils
20     package on Debian/Ubuntu).
21  3. Run the bkdg through pdftotext:
22     `pdftotext -layout 32559.pdf 32559.txt`
23  4. Extract sections 4.5.15 - 4.5.19 from the file, and save it
24     separately, say as bkdg-raw.data.
25  5. Finally run the txt file through the parse-bkdg.pl script like so:
26     `parse-bkdg.pl < bkdg-raw.data > bkdg.data`
27
28Now we have the bkdg.data file that is used by the other scripts.
29
30If you want to test the scripts without doing all this work, you
31can use some sample input files from the 'example_input/' directory.
32