---
# System prepended metadata

title: title

---

**Author(s):**  Zach Lin
**Date:**  2025/08/08
**Project/Object:** Lakr/Thermal  

---

# Abstract  
_A quick TL;DR of what bug was investigated, how you tested/fixed it, and the outcome._

---
# Topology & Architecture
```mermaid
%% Flowchart – visualize workflows or decision logic
graph TD
  A[Start] --> B{Is bug reproducible?}
  B -->|Yes| C[Run test suite]
  B -->|No| D[Review logs]
  C --> E[Collect metrics]
  D --> E
  E --> F[End]
```

```mermaid
%% Sequence Diagram – show message flows over time
sequenceDiagram
  participant Dev
  participant CI
  participant Prod
  Dev->>CI: Push code
  CI->>CI: Run tests
  CI-->>Dev: Report status
  CI->>Prod: Deploy if green
```

```mermaid
%% Mindmap – brainstorm or map debugging ideas (if supported)
mindmap
  root((Debugging Ideas))
    Tools
      Logs
      Debugger
    Tests
      Unit
      Integration
    Automation
      CI
      Monitoring
```


```mermaid
%% State Diagram – model system or bug-state transitions
stateDiagram
  [*] --> Idle
  Idle --> Testing
  Testing --> Fixed
  Fixed --> [*]
  Testing --> Failed
  Failed --> Testing
```
# Introduction & Background  
- Context: What system or module the bug appeared in  
- Symptoms & motivation: Why this bug matters (crash, data corruption, latency spike…)  
- Related work or prior incidents in similar environments

---

# Objectives & Hypothesis  
- **Objective:** What you aimed to validate or fix  
- **Hypothesis:** Example—“If I isolate the IRQ handler on core 2 under 800 MHz, latency drop will disappear.”

---

# Environment Configuration  
| Component        | Details                                      |
|------------------|----------------------------------------------|
| **Hardware**      | CPU, RAM, Board, Sensors, Peripherals, etc.  |
| **Firmware**      | Bootloader version, BIOS/UEFI revisions       |
| **OS & Kernel**   | Distribution, Kernel version, patches        |
| **Drivers**       | Custom or upstream drivers and versions      |
| **Toolchain**     | Compiler versions, build flags               |
| **Network/Storage** | Versions, configs, load conditions        |
| **Other dependencies** | Middleware, DBs, VMs, containers       |

*(Add notes on reproducibility, snapshots, rollback snapshots, etc.)*

---

# Variables & Controls  
| Type             | Variable              | Definition / Control Condition           |
|------------------|-----------------------|------------------------------------------|
| Independent       | (e.g., clock rate)     | Values tested (300 MHz, 600 MHz, etc.)    |
| Dependent         | (e.g., error rate)     | Measured output or failure mode           |
| Controlled        | (e.g., ambient temp)   | Kept constant or mitigated               |

---

# Methods & Procedure  
Narrative-style enumeration, e.g.:

1. Set system to *Env A*  
2. Trigger bug with input sequence X via tool Y  
3. Record output, logs, metrics  
4. Modify variable—repeat for each control condition  
5. Log reproducibility, triggers, regression tests

---

# Results & Observations  
- **Quantitative data:** Insert tables, perhaps:



| Column 1 | Column 2 | Column 3 |
| -------- | -------- | -------- |
| Text     | Text     | Text     |

