barnii77/explore_tiny_cpu
1
0
Fork 0
mirror of https://github.com/barnii77/explore_tiny_cpu.git synced 2026-06-06 03:16:20 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
an educational cpu explorer command line tool to help people understand how assembly and cpus work (heavily simplified)
11 commits 1 branch 0 tags 59 KiB
  • Python 56.5%
  • JavaScript 36.4%
  • CSS 4.4%
  • HTML 2.7%
Find a file
Exact
barnii77 ae34342ea7 pull apart index.html into index.html, style.css and script.js
2025-06-27 00:20:21 +02:00
index.html pull apart index.html into index.html, style.css and script.js 2025-06-27 00:20:21 +02:00
LICENSE Update LICENSE 2025-06-26 12:49:14 +02:00
main.py Rename explore_tiny_cpu.py to main.py 2025-06-26 17:17:34 +02:00
README.md Add index.html and README.md documentation for web debugger 2025-06-26 17:16:34 +02:00
script.js pull apart index.html into index.html, style.css and script.js 2025-06-27 00:20:21 +02:00
style.css pull apart index.html into index.html, style.css and script.js 2025-06-27 00:20:21 +02:00

README.md

explore_tiny_cpu

an educational cpu explorer command line tool to help people understand how assembly and cpus work (heavily simplified)

why

if you are anything like me, you have probably tried to explain how cpus work to people before. now, not everyone has a background of low level programming, and for js or python programmers, it can be really hard and tiring to try to explain this stuff. this is not to shit on them, they just don't have the right background. i hope this tool makes it easier for people to understand.

Web Debugger

A web-based interactive debugger is provided in index.html. Open this file in a modern web browser to explore the sample Fibonacci program visually. The interface includes:

  • Code view with the current instruction highlighted.
  • Register state panel showing A, B, PC, and ZF.
  • Memory view displaying memory in hex and ASCII.
  • Controls for stepping over instructions and resetting the program.