How havenoverflow/smiko works
Smiko is a collection of Google Security Chip research utilities: users provide firmware images or connect to a chip through supported hardware or TPM links, then inspect, extract, or modify firmware and chip state. Its main runtime branches are Smiko, RMASmoke, Shaft, firmware carving, and ChromeOS image/GPT tools. Edges are limited to relationships shown in excerpts or the README; unsampled implementations and integrations are not inferred.
Main entry points: vendor_cmds.c Smiko commands · shaft.c Shaft utility · image_tool.py ChromeOS image tools · rmasmoke.cc RMASmoke exploit
Components 26
Chip interaction
- Smiko commands
src/smiko/src/vendor_cmds.c - Nugget applications
src/smiko/include/app_nugget.h - Application transport API
src/smiko/include/application.h - USB transport
src/smiko/src/usb.c - TPM transport
src/smiko/src/trunks.c - Chip sysinfo
src/smiko/src/sysinfo.c - Firmware verification
src/smiko/src/verify.c - RMASmoke exploit
src/rmasmoke/src/rmasmoke.cc - TPM context
src/rmasmoke/include/tss_context.h
Firmware utilities
- Shaft utility
src/shaft/src/shaft.c - Flash transfer
src/shaft/src/transfer.c - MPSSE driver
src/shaft/src/mpsse.c - Rescue operations
src/shaft/src/rescue.c - Firmware carver
src/carver/src/carver.c
Image tooling
- ChromeOS image tools
lib/image_tool.py - Netboot settings
lib/netboot_firmware_settings.py - Flash map parser
lib/fmap.py - GPT utility
lib/pygpt.py
Shared formats
- Shared definitions
include/common.h - Signed header format
include/signed_header.h - Chip layout config
include/chip_config.h
Other components
- Researcher
- Firmware image
- Google Security Chip
- Debug accessory
- TPM link
Connections 22
- Researcher → Smiko commands: runs
README.md - Researcher → RMASmoke exploit: runs
README.md - Researcher → Shaft utility: runs
README.md - Researcher → Firmware carver: extracts with
src/carver/src/carver.c - Researcher → ChromeOS image tools: manipulates
lib/image_tool.py - Smiko commands → USB transport: sends commands
src/smiko/src/vendor_cmds.c - Smiko commands → TPM transport: sends commands
src/smiko/src/vendor_cmds.c - Smiko commands → Signed header format: validates headers
src/smiko/src/vendor_cmds.c - Smiko commands → Google Security Chip: interacts via SuzyQ
README.md - Smiko commands → TPM link: interacts via
README.md - RMASmoke exploit → TPM link: uses
README.md - RMASmoke exploit → TPM context: uses context
src/rmasmoke/src/rmasmoke.cc - Shaft utility → Flash transfer: uses
- Shaft utility → Rescue operations: supports rescue
- Flash transfer → MPSSE driver: uses driver
src/shaft/src/transfer.c - Shaft utility → Google Security Chip: accesses via Servo
README.md - Firmware carver → Firmware image: reads and carves
src/carver/src/carver.c - Firmware carver → Signed header format: parses header
src/carver/src/carver.c - ChromeOS image tools → GPT utility: uses GPT tools
lib/image_tool.py - ChromeOS image tools → Netboot settings: uses settings
lib/image_tool.py - Netboot settings → Flash map parser: uses map parser
lib/netboot_firmware_settings.py - ChromeOS image tools → Firmware image: manipulates