colognechip_gatemate_evb: add SD card support

Author: mmicko

litex_boards/platforms/colognechip_gatemate_evb.py

@@ -124,6 +124,23 @@ def usb_pmod_io(pmod):
         ),
     ]
 
+def pmods_sdcard_io(pmod):
+    return [
+        # SDCard PMOD:
+        # - https://store.digilentinc.com/pmod-microsd-microsd-card-slot/
+        ("spisdcard", 0,
+            Subsignal("clk",  Pins(f"{pmod}:3")),
+            Subsignal("mosi", Pins(f"{pmod}:1"), Misc("PULLUP=true")),
+            Subsignal("cs_n", Pins(f"{pmod}:0"), Misc("PULLUP=true")),
+            Subsignal("miso", Pins(f"{pmod}:2"), Misc("PULLUP=true")),
+        ),
+        ("sdcard", 0,
+            Subsignal("data", Pins(f"{pmod}:2 {pmod}:4 {pmod}:5 {pmod}:0"), Misc("PULLUP=true")),
+            Subsignal("cmd",  Pins(f"{pmod}:1"), Misc("PULLUP=true")),
+            Subsignal("clk",  Pins(f"{pmod}:3")),
+            Subsignal("cd",   Pins(f"{pmod}:6")),
+        ),
+]
 # Platform -----------------------------------------------------------------------------------------
 
 class Platform(CologneChipPlatform):

litex_boards/targets/colognechip_gatemate_evb.py

@@ -124,13 +124,23 @@ def main():
     parser.add_target_argument("--sys-clk-freq",   default=24e6, type=float, help="System clock frequency.")
     parser.add_target_argument("--flash",          action="store_true",      help="Flash bitstream.")
     parser.add_target_argument("--with-spi-flash", action="store_true",      help="Enable SPI Flash (MMAPed).")
+    sdopts = parser.target_group.add_mutually_exclusive_group()
+    sdopts.add_argument("--with-spi-sdcard",       action="store_true",      help="Enable SPI-mode SDCard support.")
+    sdopts.add_argument("--with-sdcard",           action="store_true",      help="Enable SDCard support.")
     args = parser.parse_args()
 
     soc = BaseSoC(
         sys_clk_freq   = args.sys_clk_freq,
         toolchain      = args.toolchain,
         with_spi_flash = args.with_spi_flash,
         **parser.soc_argdict)
+
+    soc.platform.add_extension(colognechip_gatemate_evb.pmods_sdcard_io("PMODA"))
+    if args.with_spi_sdcard:
+        soc.add_spi_sdcard()
+    if args.with_sdcard:
+        soc.add_sdcard()
+
     builder = Builder(soc, **parser.builder_argdict)
     if args.build:
         builder.build(**parser.toolchain_argdict)