fpt: extend documentation

Signed-off-by: Daniel Maslowski <info@orangecms.org>

Author: orangecms

src/fpt.rs

@@ -1,8 +1,15 @@
+//! Flash Partition Table (FPT)
+//!
+//! Knowledge herein is solely based on independent analysis efforts.
+//! The expansion of the acronym FPT is confirmed by Intel in the appendix
+//! on ME Firmware Status Registers in
+//! <https://www.intel.com/content/dam/www/public/us/en/documents/technical-specifications/intel-power-node-manager-v3-spec.pdf>.
 //! For references regarding data structures and logic,
 //! see <https://github.com/peterbjornx/meimagetool> `...intelme/model/fpt/` (Java)
 //! and <https://github.com/linuxboot/fiano/blob/main/pkg/intel/me/structures.go>
 //! and <https://github.com/platomav/MEAnalyzer>
 //! and <https://github.com/corna/me_cleaner>
+//! and <https://github.com/mostav02/Remove_IntelME_FPT>.
 
 use core::{
     convert::Infallible,

src/ifd.rs

@@ -1,13 +1,27 @@
 //! Intel Flash Descriptor (IFD), which was extended over time; for reference,
 //! see <https://www.intel.com/content/dam/www/public/us/en/documents/datasheets/io-controller-hub-8-datasheet.pdf>
 //! and <https://edc.intel.com/content/www/us/en/design/ipla/software-development-platforms/client/platforms/alder-lake-mobile-p/intel-600-series-chipset-family-on-package-platform-controller-hub-pch-datash/002/>
+//! and <https://www.intel.com/content/www/us/en/content-details/710279/intel-600-series-and-intel-700-series-chipset-family-on-package-platform-controller-hub-pch-datasheet-volume-2-of-2.html>
 //! and <https://opensecuritytraining.info/IntroBIOS_files/Day2_02_Advanced%20x86%20-%20BIOS%20and%20SMM%20Internals%20-%20Flash%20Descriptor.pdf>
 //! and coreboot util/ifdtool
 //!
 //! NOTE: xxBA is the common abbreviation for _base address_.
 //! NOTE: The base addresses are compact values and really mean bits 4..11
 //! of 25-bit values, so we nead to expand them to get the real addresses.
 //! See the implementations for the calculations.
+//!
+//! | Section                      |
+//! | ---------------------------- |
+//! | Signature                    |
+//! | Descriptor Map               |
+//! | Components                   |
+//! | Regions                      |
+//! | Masters                      |
+//! | PCH Soft Straps              |
+//! | Reserved                     |
+//! | Management Engine VSCC Table |
+//! | Descriptor Upper Map         |
+//! | OEM Section                  |
 
 use std::fmt::Display;