util/amdtools/README.md

   1 # amdtools
   2 Various tools for AMD platforms
   3
   4 ## A tool to update the SPI speed set in the EFS table
   5 This 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
  14 Before you can use them, you need to massage the relevant BKDG
  15 sections 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
  28 Now we have the bkdg.data file that is used by the other scripts.
  29
  30 If you want to test the scripts without doing all this work, you
  31 can use some sample input files from the 'example_input/' directory.