How gasmith/cosmac_bios works
Main Components
a) Hardware Layer:
• RAM (0x0000-0x7fff)
• EEPROM (0x8000-0xffff)
• EF3 Pin (UART receive)
• Q Pin (UART transmit)
• 4MHz Clock
b) Software Components:
• Stage 1 Loader
• BIOS Core
• Bit-banged UART Implementation
• EEPROM Programming Interface
• Memory Management
• Register Management
[Hardware Layer]
• ↑↓
[Memory Management Layer]
• ↑↓
[BIOS Core Layer]
• ↑↓
[Interface Layer]
Key Elements to Highlight
a) Memory Map (show as a side panel):
• 0x0000: Initial PC & Loader Target
• 0x0100: Toggled-in Loader Target
• 0x7fff: Stack (downward growth)
• 0x8000: EEPROM Loader Entry
• 0xfb00: BIOS Start
• 0xff00: BIOS VFT
• 0xfffc: BIOS Version
• 0xfffe: BIOS Checksum
b) Register Allocation (show as a side panel):
• R0-R7: System Registers
• R8-RF: General Purpose
• Bidirectional communication between UART and external world
• Stack growth direction
• Bootstrap process flow
• Memory access patterns
Final BIOS initialization
b) UART Implementation:
• Timing-critical nature (2400 baud)
• Half-duplex operation
• Pin connections
Component Relationships
• UART ↔ External Interface
• Memory Management ↔ Hardware
• BIOS Core ↔ Memory Management
• Bootstrap Process ↔ EEPROM
Technical Details
• Clock speed: 4MHz
• Baud rate: 2400
• Memory sizes
• Checksum verification points
BIOS core functionality
Use standardized symbols:
• Rectangles: Software components
• Diamonds: Decision points
Remember to indicate the test framework's position in the architecture, as it's a significant part of the project structure based on the file tree.