[board] Add RP-PICO board module

Author: andryblack

src/modm/board/rp_pico/board.hpp

@@ -0,0 +1,100 @@
+/*
+ *
+ * Copyright (c) 2022, Andrey Kunitsyn
+ *
+ * This file is part of the modm project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+// ----------------------------------------------------------------------------
+
+#pragma once
+
+#include <modm/architecture/interface/clock.hpp>
+#include <modm/platform.hpp>
+
+using namespace modm::platform;
+
+namespace Board
+{
+using namespace modm::literals;
+
+/// RP2040 running at 125MHz generated from the external 12MHz crystal
+/// @ingroup modm_board_rp_pico
+struct SystemClock
+{
+	static constexpr uint32_t Frequency = 125_MHz;
+	static constexpr uint32_t XOSCFrequency = 12_MHz;
+	static constexpr uint32_t PllSysFrequency = Frequency;
+	static constexpr uint32_t PllUsbFrequency = 48_MHz;
+	static constexpr uint32_t SysPLLMul = 125;
+	static constexpr uint32_t UsbPLLMul = 40;
+	static constexpr uint32_t RefFrequency = XOSCFrequency;
+	static constexpr uint32_t UsbFrequency = PllUsbFrequency;
+	static constexpr uint32_t SysFrequency = Frequency;
+	static constexpr uint32_t PeriFrequency = SysFrequency;
+
+	static bool inline enable()
+	{
+		ClockControl::disableResus();
+		ClockControl::enableExternalCrystal(XOSCFrequency);
+		ClockControl::disableAux<ClockControl::Clock::Sys>();
+		ClockControl::disableAux<ClockControl::Clock::Ref>();
+		// PLL SYS: 12MHz / 1 = 12MHz * 125 = 1500MHZ / 6 / 2 = 125MHz
+		ClockControl::initPll<ClockControl::Pll::Sys, 1, SysPLLMul, 6, 2>();
+		// PLL USB: 12MHz / 1 = 12MHz * 40  = 480 MHz / 5 / 2 =  48MHz
+		ClockControl::initPll<ClockControl::Pll::Usb, 1, UsbPLLMul, 5, 2>();
+
+		// CLK_REF = XOSC (12MHz) / 1 = 12MHz
+		ClockControl::configureClock<ClockControl::Clock::Ref, ClockControl::ClockSrc::Xosc,
+									 XOSCFrequency, RefFrequency>();
+		// CLK SYS = PLL SYS (125MHz) / 1 = 125MHz
+		ClockControl::configureClock<ClockControl::Clock::Sys, ClockControl::ClockSrc::PllSys,
+									 PllSysFrequency, SysFrequency>();
+		// CLK USB = PLL USB (48MHz) / 1 = 48MHz
+		ClockControl::configureClock<ClockControl::Clock::Usb, ClockControl::ClockSrc::PllUsb,
+									 PllUsbFrequency, UsbFrequency>();
+		// CLK PERI = clk_sys. Used as reference clock for Peripherals. No dividers so just select
+		// and enable Normally choose clk_sys or clk_usb
+		ClockControl::configureClock<ClockControl::Clock::Peri, ClockControl::ClockSrc::Sys,
+									 SysFrequency, PeriFrequency>();
+
+		ClockControl::updateCoreFrequency<Frequency>();
+		return true;
+	}
+};
+
+namespace usb
+{
+/// @ingroup modm_board_rp_pico
+using Device = Usb;
+}
+
+/// @ingroup modm_board_rp_pico
+/// @{
+// User LED
+using LedGreen = GpioOutput25;
+using Leds = SoftwareGpioPort<LedGreen>;
+
+using Button = GpioUnused;
+
+inline void
+initialize()
+{
+	SystemClock::enable();
+	SysTickTimer::initialize<SystemClock>();
+
+	LedGreen::setOutput();
+}
+
+inline void
+initializeUsbFs()
+{
+	usb::Device::initialize<SystemClock>();
+	usb::Device::connect<>();
+}
+/// @}
+
+}  // namespace Board

src/modm/board/rp_pico/board.xml

@@ -0,0 +1,15 @@
+<library>
+  <repositories>
+    <repository>
+      <path>../../../../repo.lb</path>
+    </repository>
+  </repositories>
+
+  <options>
+    <option name="modm:target">rp2040</option>
+    <option name="modm:platform:core:boot2">w25q080</option>
+  </options>
+  <modules>
+    <module>modm:board:rp-pico</module>
+  </modules>
+</library>

src/modm/board/rp_pico/module.lb

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+#
+# Copyright (c) 2022, Andrey Kunitsyn
+#
+# This file is part of the modm project.
+#
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+# -----------------------------------------------------------------------------
+
+def init(module):
+    module.name = ":board:rp-pico"
+    module.description = """\
+# Raspberry Pi Pico
+
+RP2040 Official System Development Board
+See https://www.raspberrypi.com/products/raspberry-pi-pico
+
+
+## Programming
+
+The RP2040 ships with a [UF2 bootloader in ROM](https://github.com/microsoft/uf2).
+
+To upload your application, connect the RP2040 via USB, convert the ELF to UF2
+format by calling `scons uf2` or `make uf2` and copy the generated `.uf2` file
+to the mounted virtual disk.
+"""
+
+def prepare(module, options):
+    if not options[":target"].partname.startswith("rp2040"):
+        return False
+
+    module.depends(
+        ":platform:clock",
+        ":platform:core",
+        ":platform:gpio",
+        ":platform:usb",
+        ":platform:clockgen")
+    return True
+
+def build(env):
+    env.outbasepath = "modm/src/modm/board"
+    env.substitutions = {
+        "with_logger": False,
+        "with_assert": env.has_module(":architecture:assert")
+    }
+    env.template("../board.cpp.in", "board.cpp")
+    env.copy('.')
+