feat: new stm32 using cpp

Author: Charliechen114514

codes_and_assets/.gitignore

@@ -0,0 +1,6 @@
+# =========================
+# Clangd
+# =========================
+.clangd/
+compile_commands.json
+.cache/

codes_and_assets/cpp/0_StartEveryThing/.clang-format

@@ -0,0 +1,111 @@
+# Qt-style clang-format
+# Based on Qt coding style with slight modern C++ friendliness
+
+BasedOnStyle: LLVM
+
+Language: Cpp
+Standard: c++20
+
+# =========================
+# 缩进 & 基础排版
+# =========================
+IndentWidth: 4
+TabWidth: 4
+UseTab: Never
+
+ContinuationIndentWidth: 8
+IndentCaseLabels: true
+IndentCaseBlocks: false
+IndentGotoLabels: false
+
+AccessModifierOffset: -4
+
+# =========================
+# 大括号风格（Qt 风格）
+# =========================
+BreakBeforeBraces: Custom
+BraceWrapping:
+  AfterClass: true
+  AfterStruct: true
+  AfterUnion: true
+  AfterEnum: true
+  AfterFunction: true
+  AfterNamespace: true
+  AfterControlStatement: false
+  BeforeElse: true
+  BeforeCatch: true
+  IndentBraces: false
+
+# =========================
+# 行宽 & 自动换行
+# =========================
+ColumnLimit: 100
+AllowAllArgumentsOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false
+BinPackArguments: false
+BinPackParameters: false
+
+PenaltyBreakBeforeFirstCallParameter: 1
+
+# =========================
+# 指针 & 引用（Qt 习惯）
+# =========================
+PointerAlignment: Right
+ReferenceAlignment: Right
+DerivePointerAlignment: false
+
+# =========================
+# 空格规则
+# =========================
+SpaceBeforeParens: ControlStatements
+SpaceBeforeAssignmentOperators: true
+SpaceAfterCStyleCast: true
+SpaceBeforeRangeBasedForLoopColon: true
+
+SpacesInAngles: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SpacesInCStyleCastParentheses: false
+
+# =========================
+# if / for / while 格式
+# =========================
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: Inline
+
+
+# =========================
+# include 排序（Qt 项目常用）
+# =========================
+SortIncludes: true
+IncludeBlocks: Regroup
+IncludeCategories:
+  - Regex: '^<Qt.*>'
+    Priority: 1
+  - Regex: '^<Q.*>'
+    Priority: 2
+  - Regex: '^<.*>'
+    Priority: 3
+  - Regex: '^".*"'
+    Priority: 4
+
+# =========================
+# 命名空间
+# =========================
+NamespaceIndentation: All
+CompactNamespaces: false
+
+# =========================
+# 注释
+# =========================
+AlignTrailingComments: true
+ReflowComments: true
+KeepEmptyLinesAtTheStartOfBlocks: false
+
+# =========================
+# 其他 Qt / 工程实践
+# =========================
+InsertTrailingCommas: Wrapped
+Cpp11BracedListStyle: true
+FixNamespaceComments: true

codes_and_assets/cpp/0_StartEveryThing/.gitignore

@@ -0,0 +1,6 @@
+.pio
+.vscode/.browse.c_cpp.db*
+.vscode/c_cpp_properties.json
+.vscode/launch.json
+.vscode/ipch
+compile_commands.json

codes_and_assets/cpp/0_StartEveryThing/.vscode/extensions.json

@@ -0,0 +1,10 @@
+{
+    // See http://go.microsoft.com/fwlink/?LinkId=827846
+    // for the documentation about the extensions.json format
+    "recommendations": [
+        "platformio.platformio-ide"
+    ],
+    "unwantedRecommendations": [
+        "ms-vscode.cpptools-extension-pack"
+    ]
+}

codes_and_assets/cpp/0_StartEveryThing/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+    "emeraldwalk.runonsave": {
+        "commands": [
+            {
+                "match": "\\.(c|cpp|h|hpp)$",
+                "cmd": "workbench.action.tasks.runTask Generate compile_commands"
+            }
+        ]
+    }
+}

codes_and_assets/cpp/0_StartEveryThing/.vscode/tasks.json

@@ -0,0 +1,15 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Generate compile_commands",
+            "type": "shell",
+            "command": "${workspaceFolder}/tools/auto_gen_db.ps1",
+            "problemMatcher": [],
+            "group": {
+                "kind": "none",
+                "isDefault": false
+            }
+        }
+    ]
+}

codes_and_assets/cpp/0_StartEveryThing/include/README

@@ -0,0 +1,37 @@
+
+This directory is intended for project header files.
+
+A header file is a file containing C declarations and macro definitions
+to be shared between several project source files. You request the use of a
+header file in your project source file (C, C++, etc) located in `src` folder
+by including it, with the C preprocessing directive `#include'.
+
+```src/main.c
+
+#include "header.h"
+
+int main (void)
+{
+ ...
+}
+```
+
+Including a header file produces the same results as copying the header file
+into each source file that needs it. Such copying would be time-consuming
+and error-prone. With a header file, the related declarations appear
+in only one place. If they need to be changed, they can be changed in one
+place, and programs that include the header file will automatically use the
+new version when next recompiled. The header file eliminates the labor of
+finding and changing all the copies as well as the risk that a failure to
+find one copy will result in inconsistencies within a program.
+
+In C, the convention is to give header files names that end with `.h'.
+
+Read more about using header files in official GCC documentation:
+
+* Include Syntax
+* Include Operation
+* Once-Only Headers
+* Computed Includes
+
+https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html

codes_and_assets/cpp/0_StartEveryThing/include/gpio/gpio.hpp

@@ -0,0 +1,83 @@
+#pragma once
+#include <stm32f1xx_hal.h>
+
+// 枚举端口
+enum class PortName
+{
+    A,
+    B,
+    C
+};
+
+// 编译期函数，返回 GPIO_TypeDef*
+
+enum class Mode
+{
+    Input,
+    Output
+};
+enum class Pull
+{
+    None,
+    Up,
+    Down
+};
+
+template <PortName Port, uint16_t Pin> class GPIO
+{
+public:
+    static GPIO_TypeDef *getPort(PortName port)
+    {
+        switch (port) {
+            case PortName::A:
+                return GPIOA;
+            case PortName::B:
+                return GPIOB;
+            case PortName::C:
+                return GPIOC;
+        }
+        return nullptr; // 不会发生
+    }
+    static void init(Mode mode, Pull pull = Pull::None)
+    {
+        GPIO_TypeDef *port = getPort(Port);
+
+        // 使能端口时钟
+        if (Port == PortName::A)
+            __HAL_RCC_GPIOA_CLK_ENABLE();
+        else if (Port == PortName::B)
+            __HAL_RCC_GPIOB_CLK_ENABLE();
+        else if (Port == PortName::C)
+            __HAL_RCC_GPIOC_CLK_ENABLE();
+
+        GPIO_InitTypeDef gpioInit{};
+        gpioInit.Pin = Pin;
+
+        if (mode == Mode::Output) {
+            gpioInit.Mode = GPIO_MODE_OUTPUT_PP;
+            gpioInit.Speed = GPIO_SPEED_FREQ_HIGH;
+        }
+        else {
+            gpioInit.Mode = GPIO_MODE_INPUT;
+            if (pull == Pull::Up)
+                gpioInit.Pull = GPIO_PULLUP;
+            else if (pull == Pull::Down)
+                gpioInit.Pull = GPIO_PULLDOWN;
+            else
+                gpioInit.Pull = GPIO_NOPULL;
+        }
+
+        HAL_GPIO_Init(port, &gpioInit);
+    }
+
+    static void set() { getPort(Port)->BSRR = Pin; }
+    static void reset() { getPort(Port)->BRR = Pin; }
+    static void toggle()
+    {
+        if (read())
+            reset();
+        else
+            set();
+    }
+    static bool read() { return (getPort(Port)->IDR & Pin) != 0; }
+};

codes_and_assets/cpp/0_StartEveryThing/include/system_clock/system_clock.h

@@ -0,0 +1,30 @@
+#pragma once
+#include <stdint.h>
+
+namespace system_clock {
+
+
+void system_clock_init();
+/**
+ * @brief delay the global system for given miliseconds
+ * 
+ * @param delay_ms 
+ */
+void system_delay_ms(uint32_t delay_ms);
+
+/**
+ * @brief delay the global system for given museconds
+ * 
+ * @param us 
+ */
+void system_delay_us(uint32_t us);
+
+/**
+ * @brief  provide the current frequency of system clock 
+ * 
+ * @return uint32_t , the raw Systicks Frequency
+ */
+uint32_t provide_application_sysfreq();
+}
+
+

codes_and_assets/cpp/0_StartEveryThing/lib/README

@@ -0,0 +1,46 @@
+
+This directory is intended for project specific (private) libraries.
+PlatformIO will compile them to static libraries and link into the executable file.
+
+The source code of each library should be placed in a separate directory
+("lib/your_library_name/[Code]").
+
+For example, see the structure of the following example libraries `Foo` and `Bar`:
+
+|--lib
+|  |
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |  |- library.json (optional. for custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html
+|  |
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |
+|  |- README --> THIS FILE
+|
+|- platformio.ini
+|--src
+   |- main.c
+
+Example contents of `src/main.c` using Foo and Bar:
+```
+#include <Foo.h>
+#include <Bar.h>
+
+int main (void)
+{
+  ...
+}
+
+```
+
+The PlatformIO Library Dependency Finder will find automatically dependent
+libraries by scanning project source files.
+
+More information about PlatformIO Library Dependency Finder
+- https://docs.platformio.org/page/librarymanager/ldf.html