Q: What's a .hc file? What does it do?
A: A .hc file is a HoneyCrisp program format containing hexadecimal machine code plus a load address header. Programs load directly into memory and can auto-run without manual WOZMON entry.
Q: What's a .hcstate file?
A: A .hcstate file stores a full emulator snapshot, including CPU registers, RAM, and execution state. It allows exact session restoration.
Q: How do I save and load emulator states?
A: Click "Save State" to download a .hcstate file. Use "Load State" to restore it. You can also enable auto-restore in Settings.
Q: What are the keyboard controls?
A:
Ctrl+H → Hard Reset
Ctrl+S → Soft Reset
Ctrl+E → Clear Screen
Ctrl+C → Break
Ctrl+F → Fullscreen
Ctrl+B → Program Library
Standard typing maps directly. Enter = Return.
Q: What are the technical specifications?
A:
CPU: MOS 6502 (~1 MHz, adjustable up to 10×)
Memory: 4KB–48KB configurable
Display: 40×24 text terminal
Monitor: WOZMON ($FF00–$FFFF)
BASIC: $E000–$EFFF (≥8KB RAM)
ACI: Cassette interface at $C100–$C1FF
Q: What is the memory layout?
A:
$0000–$00FF: Zero Page
$0100–$01FF: Stack
$0200–$CFFF: RAM
$C100–$C1FF: Cassette Interface
$D000–$DFFF: I/O
$E000–$EFFF: BASIC (optional through load in the Program Library)
$FF00–$FFFF: WOZMON (System Monitor PROM)
Q: What is the Program Library?
A: A built-in collection of programs with search, categories, and favorites. Programs load instantly and many auto-run.
Q: Can I load my own programs?
A: Yes. Use the file loader (.hc, .bas, .txt), drag-and-drop files onto the terminal, or save memory back to .hc files.
Q: What is the Tape File Loader?
A: An emulation of the Apple-1 Cassette Interface. Supports loading and saving .WAV/.AIFF tape files using real Apple-1 encoding.
Important: Set CPU speed to 1.00× for tape operations.
Q: What does the Threshold setting do?
A: Adjusts cassette decode sensitivity. Lower (15–25%) helps weak signals; higher reduces noise.
Q: What settings are available?
A:
- RAM size (4KB–48KB)
- Terminal theme
- Auto-restore session
Q: Can I control CPU speed?
A: Yes. Adjustable from 0.25× to 10×. Use 1.00× for accurate timing.
Q: Browser requirements?
A: Any modern browser with JavaScript (ES6+), HTML5 Canvas, and the File API. No installation required.
Q: Why is the interface minimal?
A: To prioritize performance, maintain simplicity, and preserve a terminal-style experience.
Q: How do I get programs or source code?
A: Use the Program Library or export your own via Save RAM. Source code is available via the GitHub link on the main page.
Q: How do I run programs?
A: Load from the Program Library, open a file, or enter code via WOZMON.
BASIC requires ≥8KB RAM and can be started with E000R.
(OR started with E2B3R if loading a BASIC program into the enviromental RAM.)
More questions coming soon...
© 2026 Landon Smith