From 07f57f4cf8b50d070c5bffa6c171017879f48259 Mon Sep 17 00:00:00 2001
From: Aadi Desai <21363892+supleed2@users.noreply.github.com>
Date: Fri, 3 Mar 2023 17:06:20 +0000
Subject: [PATCH] Add LiteX Module for TestRgb inc module docs

---
 testRGB.py | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 testRGB.py

diff --git a/testRGB.py b/testRGB.py
new file mode 100644
index 0000000..497a51d
--- /dev/null
+++ b/testRGB.py
@@ -0,0 +1,35 @@
+from migen import *
+
+from litex.soc.interconnect.csr import *
+from litex.soc.integration.doc import ModuleDoc
+
+# Test RGB Module ----------------------------------------------------------------------------------
+
+class TestRgb(Module, AutoCSR, ModuleDoc):
+    """
+    RGB LED Test Module
+
+    Set an RGB value and this SystemVerilog block will handle PWM pulse generation to set the on-board LED to that colour.
+    """
+    def __init__(self, platform, pads):
+        self.pads = pads
+        self._out = CSRStorage(size = 24, reset = 11206472, description="Led Output(s) Value (24-bit RGB)",
+        fields = [
+            CSRField("ledb", size = 8, description = "LED Blue Brightness"),
+            CSRField("ledg", size = 8, description = "LED Green Brightness"),
+            CSRField("ledr", size = 8, description = "LED Red Brightness"),
+        ])
+
+        # # #
+
+        leds = Signal(3)
+        self.comb += pads.eq(~leds)
+        self.specials += Instance("flipPwm",
+            i_clk = ClockSignal(),
+            i_rgb = self._out.storage,
+            o_ledr = leds[0],
+            o_ledg = leds[1],
+            o_ledb = leds[2]
+        )
+        platform.add_source("rtl/flipPwm.sv")
+