How havenoverflow/gscemu works
gscemulator is a Python/Unicorn emulator for Google's GSC, with Haven/Cr50 as its implemented target. The main workflow is launching the emulator, initializing its chip model and firmware, then running it and interacting with the Cr50 console over UART. The graph groups the chip’s CPU, security, storage, and peripheral models, plus shared runtime support. Some subsystem wiring is visible through the component registry and imports; unsampled implementation details and the TBC chip targets are not expanded.
Main entry points: __init__.py Component registry · emulator.py Haven emulator · uart.py UART console · m3.py Cortex-M3 and interrupts
Components 34
Runtime and setup
- CLI launcher
main.py - Haven emulator
src/haven/emulator.py - Emulator context
lib/emulator_context.py - Emulation helpers
lib/helpers.py - Logger
lib/logger.py - Runtime settings
env.py - Thread and Unicorn locks
lib/threadutils.py - Unicorn execution thread
lib/ucthread.py - Component registry
src/haven/components/__init__.py - Firmware initialization
src/haven/init_utils.py - Firmware images
src/haven/fw - Endorsement certificates
src/haven/endorsement_cert.py
CPU and execution
- Execution hooks
src/haven/hooks.py - Cortex-M3 and interrupts
src/haven/components/m3.py - Register definitions
src/haven/components/regdefs/registers.py - Pinmux registers
src/haven/components/regdefs/pinmux_registers.py - Fuse registers
src/haven/components/regdefs/fuse_registers.py
Security engines
- Cryptographic engine
src/haven/components/crypto.py - Key manager
src/haven/components/keymgr.py - Random generator
src/haven/components/trng.py - Time and lifecycle
src/haven/components/timels.py
Chip state
- Flash memory
src/haven/components/flash.py - Fuse storage
src/haven/components/fuse.py - Global security
src/haven/components/globalsec.py - Power management
src/haven/components/pmu.py
Peripherals and pins
- Pin signal model
lib/pindevice.py - Pin multiplexing
src/haven/components/pinmux.py - GPIO
src/haven/components/gpio.py - SPI slave
src/haven/components/sps.py - UART console
src/haven/components/uart.py - USB
src/haven/components/usb.py - Debug port
src/haven/components/swdp.py - Application processor model
src/haven/ap_emu.py
Other components
- Operator
Connections 42
- Operator → CLI launcher: launches
README.md - CLI launcher → Haven emulator: creates
main.py - Haven emulator → Emulator context: initializes
src/haven/emulator.py - Haven emulator → Component registry: registers components
src/haven/emulator.py - Haven emulator → Firmware initialization: loads firmware
src/haven/emulator.py - Firmware initialization → Firmware images: loads images
- Firmware initialization → Endorsement certificates: installs certificates
src/haven/init_utils.py - Haven emulator → Execution hooks: installs hooks
src/haven/emulator.py - Haven emulator → Application processor model: initializes model
src/haven/emulator.py - Haven emulator → UART console: accepts UART input
src/haven/emulator.py - Haven emulator → Unicorn execution thread: starts execution
src/haven/emulator.py - Operator → UART console: uses console
README.md - Component registry → Cortex-M3 and interrupts: registers
src/haven/components/__init__.py - Component registry → Cryptographic engine: registers
src/haven/components/__init__.py - Component registry → Key manager: registers
src/haven/components/__init__.py - Component registry → Random generator: registers
src/haven/components/__init__.py - Component registry → Time and lifecycle: registers
src/haven/components/__init__.py - Component registry → Flash memory: registers
src/haven/components/__init__.py - Component registry → Fuse storage: registers
src/haven/components/__init__.py - Component registry → Global security: registers
src/haven/components/__init__.py - Component registry → Power management: registers
src/haven/components/__init__.py - Component registry → Pin multiplexing: registers
src/haven/components/__init__.py - Component registry → GPIO: registers
src/haven/components/__init__.py - Component registry → SPI slave: registers
src/haven/components/__init__.py - Component registry → UART console: registers
src/haven/components/__init__.py - Component registry → USB: registers
src/haven/components/__init__.py - Component registry → Debug port: registers
src/haven/components/__init__.py - Haven emulator → Register definitions: loads definitions
src/haven/emulator.py - Haven emulator → Pinmux registers: loads definitions
src/haven/emulator.py - Component registry → Fuse registers: imports definitions
- Emulator context → Thread and Unicorn locks: creates mutex
lib/emulator_context.py - Emulator context → Unicorn execution thread: creates thread
lib/emulator_context.py - Unicorn execution thread → Logger: logs failures
lib/ucthread.py - Runtime settings → Logger: configures
env.py - Pin multiplexing → Pin signal model: models pin signals
src/haven/components/pinmux.py - Application processor model → Pin multiplexing: uses
src/haven/ap_emu.py - Application processor model → SPI slave: uses
src/haven/ap_emu.py - GPIO → Pin signal model: models pin signals
src/haven/components/gpio.py - SPI slave → Pin signal model: models pin signals
src/haven/components/sps.py - Cryptographic engine → Cortex-M3 and interrupts: references CPU
src/haven/components/crypto.py - UART console → Cortex-M3 and interrupts: references CPU
src/haven/components/uart.py - Execution hooks → Cortex-M3 and interrupts: references CPU
src/haven/hooks.py