How leviidev/podium works
Podium is an iOS app that emulates an iPod touch running iOS 6.1.6. The main user journey is to obtain or import firmware, inspect its IPSW contents and compatibility, prepare guest system and persistent storage, then start and interact with the emulated device. The graph includes firmware installation and guest-storage management alongside CPU execution and device I/O. Several runtime subsystems are represented at directory level because their wiring was not sampled; those uncertain links are omitted rather than inferred.
Main entry points: RootFilesystemPreparer.swift Root filesystem preparation · ARMv7CPU.swift ARMv7 CPU · FirmwareLibrary.swift Firmware library · EmulatorCore.swift Emulator core
Components 25
App and firmware
- App root
Podium/App/RootView.swift - Firmware library
Podium/Firmware/Storage/FirmwareLibrary.swift - Firmware download
Podium/Firmware/Download - IPSW inspection
Podium/Firmware/Parsing/IPSWParser.swift - ZIP reader
Podium/Firmware/Parsing/ZipArchiveReader.swift
Guest preparation
- Root filesystem preparation
Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift - HFS+ filesystem builder
Podium/Firmware/RootFilesystem/RootFilesystemBuilder.swift - Debian installer
Podium/Firmware/RootFilesystem/DebianPackageInstaller.swift - IPA installer
Podium/Firmware/RootFilesystem/IPAInstaller.swift - Persistent guest storage
Podium/Emulator/Storage/PersistentGuestStorage.swift
Emulation runtime
- Emulator core
Podium/Emulator/EmulatorCore.swift - Emulation session
Podium/Emulator/EmulationSession.swift - ARMv7 CPU
Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift - ARM and Thumb decoding
Podium/Emulator/CPU/ARMv7/ARMDecoder.swift - Thumb decoding
Podium/Emulator/CPU/ARMv7/ThumbDecoder.swift - Native code translation
Podium/Emulator/CPU/JIT/JITEngine.swift - Dynamic binary translation
Podium/Emulator/CPU/DBT/DBTEngine.swift - Guest memory bus
Podium/Emulator/Memory/MemoryBus.swift
Virtual devices
- iPod platform devices
Podium/Emulator/Platform - Display scanout
Podium/Emulator/Display
User interface
- Firmware screens
Podium/UI/Firmware - Emulator controls
Podium/UI/Emulator - Guest framebuffer view
Podium/Rendering/GuestFramebufferView.swift - Settings
Podium/UI/Settings/SettingsScreen.swift
Other components
- User
Connections 29
- User → App root: opens app
Podium/App/RootView.swift - App root → Firmware library: provides library
Podium/App/RootView.swift - App root → Emulator core: provides emulator
Podium/App/RootView.swift - App root → Firmware screens: shows screens
Podium/App/RootView.swift - Firmware screens → Firmware library: manages firmware
- Firmware library → IPSW inspection: parses firmware
Podium/Firmware/Storage/FirmwareLibrary.swift - IPSW inspection → ZIP reader: reads archive
Podium/Firmware/Parsing/IPSWParser.swift - Firmware library → Firmware download: downloads firmware
- Firmware library → Root filesystem preparation: prepares guest image
- Root filesystem preparation → IPSW inspection: inspects firmware
Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift - Root filesystem preparation → ZIP reader: extracts archive entries
Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift - Root filesystem preparation → HFS+ filesystem builder: builds volume
Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift - Root filesystem preparation → Debian installer: installs packages
Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift - Root filesystem preparation → IPA installer: installs apps
Podium/Firmware/RootFilesystem/RootFilesystemPreparer.swift - Settings → Firmware library: manages firmware
Podium/UI/Settings/SettingsScreen.swift - Settings → Persistent guest storage: manages guest files
Podium/UI/Settings/SettingsScreen.swift - Persistent guest storage → Root filesystem preparation: prepares and edits image
Podium/Emulator/Storage/PersistentGuestStorage.swift - Settings → Emulator core: checks busy state
Podium/UI/Settings/SettingsScreen.swift - Emulator controls → Emulator core: controls emulation
- Emulator core → Emulation session: runs session
- ARMv7 CPU → ARM and Thumb decoding: decodes ARM code
Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift - ARMv7 CPU → Thumb decoding: decodes Thumb code
Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift - ARMv7 CPU → Native code translation: requests compiled blocks
Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift - ARMv7 CPU → Dynamic binary translation: uses translated execution
Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift - ARMv7 CPU → Guest memory bus: accesses guest memory
Podium/Emulator/CPU/ARMv7/ARMv7CPU.swift - Emulator core → ARMv7 CPU: runs guest CPU
- Emulator core → iPod platform devices: configures platform
- iPod platform devices → Display scanout: provides display output
- Guest framebuffer view → Display scanout: renders framebuffer
Podium/Rendering/GuestFramebufferView.swift