# Welcome to the wiRedPanda Wiki ![wiRedPanda Logo](https://raw.githubusercontent.com/GIBIS-UNIFESP/wiRedPanda/master/app/resources/icons/128x128/wpanda.png) **wiRedPanda** is a free, open-source digital logic circuit simulator that makes learning and teaching digital circuits fun and accessible. Whether you're a student, educator, or hobbyist, wiRedPanda provides an intuitive environment to design, simulate, and understand digital logic circuits. ## Quick Start ### πŸŽ“ **For Users & Learners** - πŸš€ **New to wiRedPanda?** β†’ [Download and Installation](https://github.com/GIBIS-UNIFESP/wiRedPanda/releases) - 🎯 **Learning digital logic?** β†’ [Learning Path](#learning-path) - πŸ”¬ **Understanding how simulation works?** β†’ [Simulation Guide](Simulation.md) ### 🀝 **For Contributors** - 🌍 **Help with translations** (no coding required) β†’ [Translation Guide](How-to-translate.md) - πŸ‘¨β€πŸ’» **Code contributions** (beginner-friendly) β†’ [Development Setup](How-to-setup-environment.md) - πŸ”§ **Advanced development** (custom elements) β†’ [Element Creation Guide](How-to-create-a-new-logic-element.md) - πŸ“š **Git workflows** (essential for contributors) β†’ [Git Guide](Git-Guide.md) ## Features ✨ **What makes wiRedPanda special:** - **Intuitive Interface**: Drag-and-drop circuit design with real-time simulation - **Educational Focus**: Perfect for learning digital logic fundamentals - **Cross-Platform**: Available on Windows, Linux, and macOS - **Open Source**: Free forever, with community-driven development - **Multilingual**: Available in multiple languages - **Extensive Library**: Logic gates, flip-flops, displays, and more ## Learning Path New to digital logic? Follow this structured approach to master the fundamentals: ### 🎯 Phase 1: Binary Logic Fundamentals **Estimated Duration:** 2-3 weeks Master the building blocks of digital systems: - **Number Systems**: Binary, Decimal, Hexadecimal, Octal conversions - **Boolean Algebra**: Logic operations, truth tables, De Morgan's laws - **Basic Gates**: AND, OR, NOT, NAND, NOR, XOR - **Binary Arithmetic**: Addition, subtraction, two's complement **Practice Projects**: Build basic gates, create truth tables ### 🎯 Phase 2: Combinational Logic **Estimated Duration:** 3-4 weeks Learn circuits without memory: - **Multi-level Logic**: Combining gates for complex functions - **Multiplexers & Demultiplexers**: Data routing and selection - **Encoders & Decoders**: Data conversion circuits - **Adders & Subtractors**: Arithmetic circuit design **Practice Projects**: Full adder, 4-bit calculator, BCD decoder ### 🎯 Phase 3: Sequential Logic **Estimated Duration:** 4-5 weeks Explore circuits with memory and timing: - **Latches & Flip-Flops**: SR, D, JK, T flip-flops - **Registers**: Data storage and shift operations - **Counters**: Up/down, binary, BCD counters - **State Machines**: Finite state machine design **Practice Projects**: Digital clock, sequence detector, traffic light controller ## Project Gallery Get inspired by these project ideas, organized by difficulty: ### 🟒 Beginner Projects - **Half/Full Adder** - Learn basic arithmetic circuits - **3-input Majority Gate** - Practice Boolean logic - **7-Segment Display Driver** - Connect logic to visual output - **Simple Calculator** - 2-bit addition with display ### 🟑 Intermediate Projects - **BCD to 7-Segment Decoder** - Number system conversion - **4-bit Binary Counter** - Sequential logic with clock - **Multiplexed Display** - Time-sharing techniques - **Simple ALU** - Basic arithmetic and logic unit ### πŸ”΄ Advanced Projects - **Digital Clock** - Complete timing system - **Memory System** - RAM/ROM implementation - **CPU Components** - Instruction decoder, register file - **Communication Protocols** - UART, SPI simulation ## Getting Help Need assistance? Here are your resources: - πŸ“– **Documentation**: Browse the wiki pages for detailed guides - πŸ› **Bug Reports**: [Report issues](https://github.com/GIBIS-UNIFESP/wiRedPanda/issues) on GitHub - πŸ’¬ **Discussions**: [Join the community](https://github.com/GIBIS-UNIFESP/wiRedPanda/discussions) - πŸ“§ **Contact**: Reach out to the development team ### πŸ”§ **Common Issues & Quick Fixes** #### Installation Problems - **Qt version conflicts** β†’ Use Qt6 for latest features, Qt5 for compatibility - **Missing dependencies** β†’ Follow platform-specific setup in [Development Setup](How-to-setup-environment.md) - **Build errors** β†’ Ensure CMake and compiler versions match requirements #### Usage Issues - **Circuit not simulating** β†’ Check for unconnected inputs or invalid elements - **Unexpected behavior** β†’ Review [Simulation Guide](Simulation.md) for timing and feedback concepts - **Translation problems** β†’ Visit [Translation Guide](How-to-translate.md) for Weblate usage #### Contribution Challenges - **Git conflicts** β†’ Check [Git Guide](Git-Guide.md) for conflict resolution - **Code not compiling** β†’ Verify environment setup and dependencies - **Pull request feedback** β†’ Join [discussions](https://github.com/GIBIS-UNIFESP/wiRedPanda/discussions) for guidance ## Contributing to wiRedPanda Join our community and help make wiRedPanda even better: ### πŸ§‘β€πŸ’» Code Contributions - **Setup**: Follow our [development environment guide](How-to-setup-environment.md) - **Guidelines**: Check coding standards and contribution workflow - **Areas**: UI improvements, new elements, performance optimizations - **Process**: Fork β†’ Develop β†’ Test β†’ Pull Request ### 🌍 Translations - **Weblate**: Use our [web-based translation platform](How-to-translate.md) - **Languages**: Help us reach more students worldwide - **Process**: No technical skills required, just language fluency ### πŸ“ Documentation - **Wiki**: Improve tutorials, add examples, fix typos - **Tutorials**: Create learning materials and project guides - **Videos**: Educational content and feature demonstrations ### 🎨 Design & UX - **Icons**: Design new element icons and UI improvements - **Themes**: Create new visual themes - **Usability**: Suggest and implement UX improvements ### πŸ“’ Spread the Word - **Star the Project**: Give us a ⭐ on GitHub to show your support - **Share wiRedPanda**: Tell friends, classmates, and colleagues about this tool - **Social Media**: Share your projects and help us reach more learners --- ## Community Showcase Share your amazing wiRedPanda projects with the community! > **Want to feature your project here?** > Create a discussion in our [Cool Projects](https://github.com/GIBIS-UNIFESP/wiRedPanda/discussions/categories/cool-projects) section with: > > - Project name and description > - Screenshot or demo > - .panda file for others to explore > - Learning objectives (for educational projects) --- ## Stay Connected - 🌟 **GitHub**: [Star the repository](https://github.com/GIBIS-UNIFESP/wiRedPanda) - πŸ“’ **Releases**: [Get the latest version](https://github.com/GIBIS-UNIFESP/wiRedPanda/releases) - πŸ’¬ **Community**: [Join discussions](https://github.com/GIBIS-UNIFESP/wiRedPanda/discussions) --- **Ready to dive into digital logic?** Download wiRedPanda and start building circuits today! πŸš€ *With wiRedPanda, digital circuits are no longer intimidatingβ€”they're exciting, educational, and fun!* --- *Made with ❀️ by the wiRedPanda Community* *Licensed under GPL-3.0 | Β© 2025 GIBIS-UNIFESP*