How void-sg/logic_sim_suite works
OBSIDIAN is a browser-based digital logic simulator backed by a FastAPI service. The principal workflow is selecting a converter, arithmetic, comparator, multiplexer, or circuit-view page; submitting logic inputs to the API; and presenting the returned result or circuit layout. The graph preserves both ordinary logic operations and IC-style circuit layouts. Source excerpts establish backend routing and several simulator dependencies; frontend-to-API wiring and some backend implementations were not shown, so those links are omitted or marked unverified.
Main entry points: main.py FastAPI app · circuit_router.py Circuit routes · circuit_models.py Circuit models · mux_router.py Mux route
Components 21
Browser interface
- Logic pages
frontend - Converter engine
frontend/converter-engine.js - Circuit viewer
frontend/circuit-viewer.js
API routing
- FastAPI app
backend/main.py - Conversion route
backend/convert.py - Arithmetic route
backend/arithmetic.py - Compare route
backend/compare.py - Mux route
backend/mux_router.py - Circuit routes
backend/circuit_router.py
Logic simulators
- Code conversion
backend/code_conversions.py - Adder subtractor
backend/adder_subtractor.py - Comparator
backend/comparator.py - Multiplexer
backend/mux.py
Circuit layouts
- 8:1 mux layout
backend/circuit_mux.py - 4:1 mux layout
backend/circuit_standalone_mux.py - Comparator layout
backend/circuit_comparator.py - Adder layout
backend/circuit_adder_subtractor.py - Converter schematic
hardware/code_converter_4bit/code_converter_4bit.kicad_sch
Data contracts
- Circuit models
backend/circuit_models.py - API schemas
backend/schemas.py
Other components
- User
Connections 27
- User → Logic pages: chooses operation
- Logic pages → FastAPI app: submits inputs
- FastAPI app → Conversion route: registers route
backend/main.py - FastAPI app → Arithmetic route: registers route
backend/main.py - FastAPI app → Compare route: registers route
backend/main.py - FastAPI app → Mux route: registers route
backend/main.py - FastAPI app → Circuit routes: registers routes
backend/main.py - Conversion route → Code conversion: calls logic
backend/convert.py - Arithmetic route → Adder subtractor: calls logic
backend/arithmetic.py - Compare route → Comparator: calls logic
backend/compare.py - Mux route → Multiplexer: calls simulator
backend/mux_router.py - Circuit routes → 8:1 mux layout: dispatches layout
backend/circuit_router.py - Circuit routes → 4:1 mux layout: dispatches layout
backend/circuit_router.py - Circuit routes → Comparator layout: dispatches layout
backend/circuit_router.py - Circuit routes → Adder layout: dispatches layout
backend/circuit_router.py - 8:1 mux layout → Multiplexer: reuses logic
backend/circuit_mux.py - 4:1 mux layout → Multiplexer: reuses logic
backend/circuit_standalone_mux.py - Comparator layout → Comparator: reuses logic
backend/circuit_comparator.py - Adder layout → Adder subtractor: reuses logic
backend/circuit_adder_subtractor.py - 8:1 mux layout → Circuit models: builds response
backend/circuit_mux.py - 4:1 mux layout → Circuit models: builds response
backend/circuit_standalone_mux.py - Comparator layout → Circuit models: builds response
backend/circuit_comparator.py - Adder layout → Circuit models: builds response
backend/circuit_adder_subtractor.py - Mux route → API schemas: uses contract
backend/mux_router.py - Circuit routes → API schemas: uses contract
backend/circuit_router.py - Circuit viewer → FastAPI app: requests layouts
- Converter engine → FastAPI app: requests conversion