How prabinpanta0/digital-logic-circuits-fundamentals works
Project type and purpose
• This is a modular Lua‐based simulation library for fundamental digital logic circuits and arithmetic operations.
• Its primary goal is educational: to demonstrate how basic gates compose into adders, multipliers, and subtractors.
File structure
• Top-level files:
• gates_2inputs.lua – basic 2-input gate implementations (AND, OR, NOT, XOR)
• gates_3inputs.lua – extended 3-input gates
• half_adder.lua, full_adder.lua – elementary adders
• multi-bit_adder.lua, multi-bit_multiplier.lua, multi-bit_sub.lua – composite multi-bit arithmetic modules
• No frontend/backend split—this is a library of modules.
• No deployment or build scripts—each file runs under Lua.
README insights
• Confirms the layering: basic gates → half/full adder → multi-bit circuits.
• Emphasizes modularity, truth-table validation, and reusability.
• Outlines future components, indicating an extensibility pattern.
Main components & dependencies
a. Base Layer:
• Basic Gates Module (gates_2inputs.lua)
• Extended Gates Module (gates_3inputs.lua)
b. Adder Layer:
• Half Adder (half_adder.lua) → depends on 2-input gates
• Full Adder (full_adder.lua) → depends on half_adder + gates_2inputs
c. Multi-bit Arithmetic Layer:
• Multi-bit Adder (multi-bit_adder.lua) → chains full adders
• Multi-bit Multiplier (multi-bit_multiplier.lua) → uses multi-bit adder + shift-and-add logic
• Multi-bit Subtractor (multi-bit_sub.lua) → two’s complement + multi-bit adder
Relationships & interactions
• Data/Control Flow: input bit arrays feed into base gates → adder circuits → multi-bit arithmetic modules.
Architectural patterns & principles
• Layered architecture: foundational gates at bottom, composite circuits above.
• Modular design: each file exposes a Lua table/module for reuse.
• Single-responsibility: each file focuses on one circuit type.
Technologies & environment
• Lua runtime (no external frameworks)
• Modules communicate via returned tables of functions
• Clear rectangles labeled with file names and module roles
Final advice
• Be exhaustive: represent each .lua module as a distinct component.
• Modular reuse: show how gates feed into adders and adders into multi-bit circuits.
• A title (“Digital Logic Simulation Library Architecture”) and a brief caption to clarify purpose.