How sam-astro/astro8-computer works
Astro-8 is a 16-bit computer project with a desktop emulator, an Armstrong compiler, an assembly programming path, and a Logisim circuit. The main workflow is a user running a program through the emulator, where the compiler can translate Armstrong source and the emulator provides the computer runtime, display, and audio. VSSynth is a substantial internal audio layer; the repository also includes webcam capture and console-formatting helpers. Some runtime wiring is only partially excerpted, so unsampled relationships are omitted.
Main entry points: main.cpp Astro-8 emulator · Synthesizer.h Audio synthesizer · colorprint.h Colored console output · Instrument.h Instruments
Components 22
Computer runtime
- Astro-8 emulator
Astro8-Emulator/main.cpp - Computer circuit
cpu-circuit.circ
Programming languages
- Armstrong compiler
Astro8-Emulator/armstrong-compiler.cpp - Assembly support
Astro8-Emulator/assembler.cpp
Audio synthesis
- Audio synthesizer
Astro8-Emulator/VSSynth/Synthesizer.h - Sound generators
Astro8-Emulator/VSSynth/SoundGenerator.h - Instruments
Astro8-Emulator/VSSynth/generators/Instrument.h - Note sequencer
Astro8-Emulator/VSSynth/generators/Sequencer.h - ADSR envelopes
Astro8-Emulator/VSSynth/utils/Envelope.h - Instrument patches
Astro8-Emulator/VSSynth/utils/Patches.h - Note frequencies
Astro8-Emulator/VSSynth/utils/Notes.h - Waveforms
Astro8-Emulator/VSSynth/utils/Waveforms.h - WAV output
Astro8-Emulator/VSSynth/middleware/WAVWriter.h - Audio middleware
Astro8-Emulator/VSSynth/SynthMiddleware.h
Runtime support
- Colored console output
Astro8-Emulator/colorprint.h - Console colors
Astro8-Emulator/color.hpp - String operations
Astro8-Emulator/strops.cpp - Pixel processing
Astro8-Emulator/processing.h - Webcam capture
Astro8-Emulator/escapi.cpp
Other components
- Program user
- SDL audio and display
- Audio output
Connections 19
- Program user → Astro-8 emulator: runs programs
README.md - Astro-8 emulator → Armstrong compiler: compiles source
Astro8-Emulator/main.cpp - Program user → Computer circuit: uses circuit
README.md - Astro-8 emulator → Audio synthesizer: configures playback
Astro8-Emulator/main.cpp - Audio synthesizer → Sound generators: samples generators
Astro8-Emulator/VSSynth/Synthesizer.h - Audio synthesizer → Audio middleware: processes samples
Astro8-Emulator/VSSynth/Synthesizer.h - Instruments → Sound generators: extends
Astro8-Emulator/VSSynth/generators/Instrument.h - Note sequencer → Instruments: queues notes for
Astro8-Emulator/VSSynth/generators/Sequencer.h - Instruments → ADSR envelopes: uses envelopes
Astro8-Emulator/VSSynth/generators/Instrument.h - Instrument patches → ADSR envelopes: defines envelopes
Astro8-Emulator/VSSynth/utils/Patches.h - Instrument patches → Waveforms: builds patches
Astro8-Emulator/VSSynth/utils/Patches.h - WAV output → Audio middleware: implements
Astro8-Emulator/VSSynth/middleware/WAVWriter.h - Audio synthesizer → Audio output: outputs audio
Astro8-Emulator/VSSynth/Synthesizer.h - Astro-8 emulator → Webcam capture: captures frames
Astro8-Emulator/main.cpp - Astro-8 emulator → SDL audio and display: draws and plays audio
Astro8-Emulator/main.cpp - Colored console output → Console colors: uses colors
Astro8-Emulator/colorprint.h - Colored console output → String operations: uses string operations
Astro8-Emulator/colorprint.h - Colored console output → Pixel processing: uses pixel processing
Astro8-Emulator/colorprint.h - Astro-8 emulator → Pixel processing: processes pixels
Astro8-Emulator/main.cpp