Architecture Overview

CHIPSEC Architecture

Core components

chipsec_main.py	main application logic and automation functions
chipsec_util.py	utility functions (access to various hardware resources)
chipsec/chipset.py	chipset detection
chipsec/command.py	base class for util commands
chipsec/defines.py	common defines
chipsec/file.py	reading from/writing to files
chipsec/logger.py	logging functions
chipsec/module.py	generic functions to import and load modules
chipsec/module_common.py	base class for modules
chipsec/result_deltas.py	supports checking result deltas between test runs
chipsec/testcase.py	support for XML and JSON log file output
chipsec/helper/helpers.py	registry of supported OS helpers
chipsec/helper/oshelper.py	OS helper: wrapper around platform specific code that invokes kernel driver

Commands

Implement functionality of chipsec_util.

CHIPSEC utilities provide the capability for manual testing and direct hardware access.

Warning

DIRECT HARDWARE ACCESS PROVIDED BY THESE UTILITIES COULD MAKE YOUR SYSTEM UNBOOTABLE. MAKE SURE YOU KNOW WHAT YOU ARE DOING!

Note

All numeric values in the instructions are in hex.

• List of Utility components
  • acpi_cmd module
  • chipset_cmd module
  • cmos_cmd module
  • config_cmd module
  • cpu_cmd module
  • decode_cmd module
  • deltas_cmd module
  • desc_cmd module
  • ec_cmd module
  • igd_cmd module
  • interrupts_cmd module
  • io_cmd module
  • iommu_cmd module
  • lock_check_cmd module
  • mem_cmd module
  • mmcfg_base_cmd module
  • mmcfg_cmd module
  • mmio_cmd module
  • msgbus_cmd module
  • msr_cmd module
  • pci_cmd module
  • reg_cmd module
  • smbios_cmd module
  • smbus_cmd module
  • spd_cmd module
  • spi_cmd module
  • spidesc_cmd module
  • tpm_cmd module
  • txt_cmd module
  • ucode_cmd module
  • uefi_cmd module
  • vmem_cmd module
  • vmm_cmd module

HAL (Hardware Abstraction Layer)

Useful abstractions for common tasks such as accessing the SPI.

• List of HAL components
  • acpi module
  • acpi_tables module
  • cmos module
  • cpu module
  • cpuid module
  • ec module
  • hal_base module
  • igd module
  • interrupts module
  • io module
  • iobar module
  • iommu module
  • locks module
  • mmio module
  • msgbus module
  • msr module
  • paging module
  • pci module
  • pcidb module
  • physmem module
  • smbios module
  • smbus module
  • spd module
  • spi module
  • spi_descriptor module
  • spi_jedec_ids module
  • spi_uefi module
  • tpm module
  • tpm12_commands module
  • tpm_eventlog module
  • ucode module
  • uefi module
  • uefi_common module
  • uefi_compression module
  • uefi_fv module
  • uefi_platform module
  • uefi_search module
  • virtmem module
  • vmm module

Fuzzing

• List of Fuzzing components
  • primitives module

CHIPSEC_MAIN Program Flow

1. Select OS Helpers and Drivers

   • Load Driver (optional)

2. Detect Platform

3. Load Configuration Files

4. Load Modules

5. Run Loaded Modules

6. Report Results

7. Cleanup

CHIPSEC_UTIL Program Flow

1. Select OS Helpers and Drivers

   • Load Driver (optional)

2. Detect Platform

3. Load Configuration Files

4. Load Utility Commands

5. Run Selected Command

6. Cleanup

Auxiliary components

• setup.py setup script to install CHIPSEC as a package

Executable build scripts

• <CHIPSEC_ROOT>/scripts/build_exe_*.py make files to build Windows executables