How frozsgy/ceng336-hw works
Project type and purpose
• This repository is not a web app or microservice suite but a collection of embedded‐systems coursework and a supporting utility.
• It contains three “Take Home Exam” modules (THE1 and THE2 in PIC18F8722 assembly, THE3 in C) plus a Python-based “Timer Calculator” for computing PIC18F8722 timer register values.
File structure
• Top level: LICENSE, README.md, three exam folders (THE1, THE2, THE3) and one tool folder (“Timer Calculator”).
• THE1 & THE2 each contain an .asm source and PDF spec; THE3 has main.c and PDF spec.
• “Timer Calculator” holds a README, main.py (CLI entrypoint) and timer.py (core logic).
Mine the README for technical stack
• All embedded code targets the PIC18F8722 microcontroller, developed in MPLABX.
• Assembly assignments (interrupts, timers), C assignment (number-guessing game with timers/interrupts).
• The Python tool runs on the host to pre-compute timer values for the same PIC.
Main components
a. Exam Modules
• THE1 Module (MPLABX + PIC18F8722 assembler)
• THE2 Module (MPLABX + PIC18F8722 assembler with interrupts/timers)
• THE3 Module (MPLABX + PIC18F8722 in C with RTOS-style constructs)
b. Timer Calculator Tool
• CLI layer (main.py)
• Core logic layer (timer.py)
• Output (recommended register settings)
c. External/Supporting Components
• MPLABX IDE & XC-Compiler toolchain
• PIC18F8722 hardware (or simulator)
Relationships and interactions
• Each THEx folder → assembled/compiled by MPLABX → loaded onto PIC18F8722 → exercises specific peripherals (timers, interrupts, I/O).
• Timer Calculator: user invokes main.py → calls timer.py to compute register values → user copies results into MPLABX projects.
Architectural patterns & design principles
• Separation by assignment: each exam is a self-contained component.
• In the Python tool: clear layering of CLI vs. business logic.
• Consistent use of per-module README + PDF spec for documentation.
Recommended elements
• Component names (THE1, THE2, THE3, Timer Calculator CLI, Timer Logic)