Posts on Hoshitori's Blog

使用STM32CubeMX2+CLion时的注意事项

Tue, 11 Aug 2026 10:56:41 +0800

最近入手了一块 NUCLEO-C562RE 开发板，需要用到新的 STM32CubeMX2 开发环境。本来想着都是 CMake 编译，环境也大差不差，依葫芦画瓢就可以了，结果出现编译失败和下载失败的问题。稍微踩坑后解决，故编写本文。

本次复现环境为STM32CubeMX2 1.1.1 + CLion 2026.1.2

编译失败

排查

用 STM32CubeMX2 生成 CMake 工程后，使用 CLion 打开。加载生成的预设debug_GCC_NUCLEO-C562RE。

结果 CMake 输出报错：

1
2


CMake Error at CMakeLists.txt:12 (add_executable):
 No SOURCES given to target: STM32C5

CMakeLists.txt 长这样：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


cmake_minimum_required(VERSION 3.30)
set(CMAKE_EXPORT_COMPILE_COMMANDS TRUE)
set(CMAKE_C_COMPILER_FORCED TRUE)
set(CMAKE_CXX_COMPILER_FORCED TRUE)

include(cmake/target.cmake)
include(cmake/${TOOLCHAIN_FILE})

project(STM32C5)

add_executable(STM32C5)

include(cmake/files.cmake)
include(cmake/flags.cmake)
include(cmake/components.cmake)

进入cmake/files.cmake查看生成的文件：

1
2
3


if(CMAKE_BUILD_TYPE STREQUAL "debug_GCC_NUCLEO-C562RE") 
 target_sources(${CMAKE_PROJECT_NAME} PRIVATE main.c main.h) 
endif()

这里看到 target_sources 前有一个条件判断，怀疑是CMAKE_BUILD_TYPE出现问题。在 CMakeLists.txt 中加入 debug 语句 message("Build type: " ${CMAKE_BUILD_TYPE})后发现输出Build type: ${presetName}。真相大白：就是因为CMAKE_BUILD_TYPE被错误地设置了。

原因

CMakePresets.json 中定义的是

1
2
3


"cacheVariables": {
 "CMAKE_BUILD_TYPE": "${presetName}"
}

CLion 把 preset 导入成只读的 CMake profile 时并没有解析这个 variable，Build type 直接变成了 ${presetName}，执行命令的时候就把这个字面量原样传给了 -DCMAKE_BUILD_TYPE。files.cmake中什么都没有添加。

解决办法

在 CLion 里复制一份 preset，然后手动改 CMAKE_BUILD_TYPE：

打开 设置 -> 构建、执行、部署 -> CMake
选中 debug_GCC_NUCLEO-C562RE 预设，点击复制
复制出来的配置里把 构建类型 改成 debug_GCC_NUCLEO-C562RE
启用复制出来的配置
重新加载 CMake 项目并编译

下载失败

排查

编译没问题了，结果下载又报错……反复尝试后发现 STM32CubeProgrammer 能正常下载，但是 CLion 的 ST-LINK GDB Server 连不上。

搜了一下，有人遇到过一模一样的问题： ST-LINK GDB Server issue with STM32C5 | Community

回复说这个芯片的 CPU core 在 access port 1 上，需要加 -m 1 参数。

原因

参考手册的 Debug support（DBG）章节写了有两个 AP：

AP0：System debug access port，访问 DBGMCU 和系统 ROM 表
AP1：Cortex-M33 debug access port，访问内核的调试和 trace 功能

GDB Server 默认连的是 AP0，但内核在 AP1，所以找不到。STM32CubeProgrammer 估计是内置了这部分的处理逻辑，所以什么都不用改就连上了。

解决办法

打开 设置 -> 调试器 -> 调试服务器
选中 ST-LINK 配置
把 多核 -> 访问端口 改成 1
确定后重新调试

改完就正常了。

Java sun.font.TrueTypeFont源码分析

Mon, 01 Jun 2026 15:01:09 +0800

前言

最近在开发一个要和字体打交道的工具，写完后端实现后想着写个能可视化字体、选择并生成配置的GUI工具。但是遇到了一个问题：Java导出的Family name匹配不上Matplot端的，导致找不到字体。没办法，只能在Python端选择自己实现字体搜索算法了。在那之前，我们需要搞明白Java侧是怎么设置字体参数的。本次分析选择OpenJDK 27，源码在这里。

正文

进入TrueTypeFont类，首先看到了一堆tag。我们先不管他，往下翻找到我们关心的familyName字段。

1
2


private String localeFamilyName;
private String localeFullName;

可以看到没有familyName字段，说明它定义在父类里。那我们就顺着localeFamilyName找吧，反正都是要初始化的。

Ctrl+F搜索，下一个引用位置就是initNames函数。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88


protected void initNames() {
 byte[] name = new byte[256];
 ByteBuffer buffer = getTableBuffer(nameTag);
 if (buffer != null) {
 ShortBuffer sbuffer = buffer.asShortBuffer();
 sbuffer.get(); // format - not needed.
 short numRecords = sbuffer.get();
 /* The name table uses unsigned shorts. Many of these
 * are known small values that fit in a short.
 * The values that are sizes or offsets into the table could be
 * greater than 32767, so read and store those as ints
 */
 int stringPtr = sbuffer.get() & 0xffff;
 nameLocale = sun.awt.SunToolkit.getStartupLocale();
 short nameLocaleID = getLCIDFromLocale(nameLocale);
 languageCompatibleLCIDs =
 getLanguageCompatibleLCIDsFromLocale(nameLocale);
 for (int i=0; i<numRecords; i++) {
 short platformID = sbuffer.get();
 if (platformID != MS_PLATFORM_ID &&
 platformID != MAC_PLATFORM_ID) {
 sbuffer.position(sbuffer.position()+5);
 continue; // skip over this record.
 }
 short encodingID = sbuffer.get();
 short langID = sbuffer.get();
 short nameID = sbuffer.get();
 int nameLen = ((int) sbuffer.get()) & 0xffff;
 int namePtr = (((int) sbuffer.get()) & 0xffff) + stringPtr;
 String tmpName = null;
 // only want MacRoman encoding and English name on Mac.
 if ((platformID == MAC_PLATFORM_ID) &&
 (encodingID != MACROMAN_SPECIFIC_ID ||
 langID != MACROMAN_ENGLISH_LANG)) {
 continue;
 }
 switch (nameID) {
 case FAMILY_NAME_ID:
 boolean compatible = false;
 if (familyName == null || langID == ENGLISH_LOCALE_ID ||
 langID == nameLocaleID ||
 (localeFamilyName == null &&
 (compatible = isLanguageCompatible(langID))))
 {
 buffer.position(namePtr);
 buffer.get(name, 0, nameLen);
 tmpName = makeString(name, nameLen, platformID, encodingID);
 if (familyName == null || langID == ENGLISH_LOCALE_ID){
 familyName = tmpName;
 }
 if (langID == nameLocaleID ||
 (localeFamilyName == null && compatible))
 {
 localeFamilyName = tmpName;
 }
 }

 break;
 case FULL_NAME_ID:
 compatible = false;
 if (fullName == null || langID == ENGLISH_LOCALE_ID ||
 langID == nameLocaleID ||
 (localeFullName == null &&
 (compatible = isLanguageCompatible(langID))))
 {
 buffer.position(namePtr);
 buffer.get(name, 0, nameLen);
 tmpName = makeString(name, nameLen, platformID, encodingID);
 if (fullName == null || langID == ENGLISH_LOCALE_ID) {
 fullName = tmpName;
 }
 if (langID == nameLocaleID ||
 (localeFullName == null && compatible))
 {
 localeFullName = tmpName;
 }
 }
 break;
 }
 }
 if (localeFamilyName == null) {
 localeFamilyName = familyName;
 }
 if (localeFullName == null) {
 localeFullName = fullName;
 }
 }
}

快速预览一下，这个方法大概干了这些事情：

读取Name Table到buffer
从buffer读取header
遍历nameRecord并解析元数据，这里是我们需要关注的地方。我们一步步来分析。

首先是读取到buffer，没什么好说的，只需要注意一下每个单位是uint16（两个byte）。

然后是从buffer读取header。header的结构如下：

1
2
3
4
5


{
 format: uint16,
 nameRecordNum: uint16,
 stringOffset: uint16
}

根据TrueType Reference Manual，对于TrueType文件format固定为0，所以源码中跳过了。

numRecords就是NameRecord结构体的个数；stringOffset是指字符串段的起始偏移。
我们只要seek到stringOffset + nameRecord.offset，就能拿到对应record存下的string。

读取stringPtr的这一行可能有一些迷惑，实际上就是把stringOffset映射成无符号的short（因为Java中不存在uint16，所以这里取低四位并转换为int，符号位就固定为0了）。

解析nameRecord需要的长度拿到了，接下来开始解析。每个NameRecord的结构如下：

1
2
3
4
5
6
7
8


{
 platformID: uint16,
 platformSpecificID: uint16,
 languageID: uint16,
 nameID: uint16,
 length: uint16,
 offset: uint16
}

platformID和platformSpecificID都是为了一些兼容性问题而设计的，我们不用管，大概看看就好了。感兴趣的话可以自行查看TrueType Reference Manual。

值得注意的是，platformID的取值为(0, 1, 3)，这里JDK只处理MS_PLATFORM_ID 和 MAC_PLATFORM_ID 的情况，也就是1和3。

languageID是标记这个nameRecord中nameID字段使用的语言。
还记得前面看到的localeFamilyName吗？就是通过这个字段实现的。nameTable中有多个标记familyName的record，只需要匹配languageID就能找到本地化的familyName了。

nameID标记了这个record里存的是什么信息，这里节选一部分主要使用到的字段。

nameID	描述	示例(思源黑体)
0	版权信息	© 2014-2021 Adobe (http://www.adobe.com/), with Reserved Font Name ‘Source’.
1	Family name	Source Han Sans SC
2	Sub-family name	Bold
3	唯一标识(FontName + Style + Version + Vendor)	2.004;ADBO;SourceHanSansSC-Bold;ADOBE
4	Full name	Source Han Sans SC Bold
5	版本号	Version 2.004;hotconv 1.0.118;makeotfexe 2.5.65603
6	PostScript name	SourceHanSansSC-Bold

我们可以发现，其实主要逻辑在这个大switch块。它匹配了FAMILY_NAME_ID(1)和FULL_NAME_ID(4)两个nameID，并且两个case的结构几乎一模一样。

第一步，检查当前familyName是否已被设置，如果是则跳过当前nameRecord。

第二步，检查languageID是否适配startupLocale。如果是，认为当前nameRecord是localized的，并保存到localeFamilyName或localeFullName字段。

第三步，读取对应的string，并保存到familyName或fullName字段。

所以看到这里其实已经真相大白了，我们通过java.awt.Font#getFamily拿到的就是ttf中第一个nameID == 1的记录，通过java.awt.Font#getFontName拿到的是ttf中第一个nameID == 4的记录。
想要实现一致的行为，我们只需要仿照这个去解析字体文件就可以了。我的目的是匹配对应字体文件，所以我选择在Java侧使用getFontName读取字体的Full name，在Python侧解析匹配nameID == 4并拿到字体名称。

后记

其实笔者一开始是直接从IntelliJ IDEA分析反编译后的class，写到一半觉得还是分析开源的比较好。同时我也发现不同JDK对字体的处理有许多不同，比如JBR直接在类里面定义了postScriptName字段，而OpenJDK则是选择重写了getPostscriptName方法并在调用时按需解析。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


/* Postscript name is rarely requested. Don't waste cycles locating it
 * as part of font creation, nor storage to hold it. Get it only on demand.
 */
@Override
public String getPostscriptName() {
 String name = lookupName(ENGLISH_LOCALE_ID, POSTSCRIPT_NAME_ID);
 if (name == null) {
 return fullName;
 } else {
 return name;
 }
}

所以……反射这些内部的状态还是能不用就不用吧。使用任何未公开API的方法和字段都是未定义行为XD

使用STM32CubeMX快速搭建适用于CLion的项目

Wed, 13 May 2026 18:39:57 +0800

环境安装

尝试在cmd中输入starm-clang或arm-none-eabi-gcc，如果没有出现……不是内部或外部命令，也不是可运行的程序或批处理文件则可跳过此部分。

工具链

下载并安装STM32CubeCLT。
安装MingW或Cygwin。

正文

在STM32CubeMX中配置完毕后，点击顶栏Project Manager -> Project，在右侧Project Settings -> Toolchain / IDE中选择CMake
GENERATE CODE
打开CLion，等项目加载完毕后找到顶栏的Debug，点击编辑 CMake 配置文件…，将默认的第一个配置文件禁用，并打开Debug - Debug和Release - Release预设
删除cmake-build-debug/CMakeCache.txt，并重新加载 CMake 项目（左上角可找到）
现在你可以编译项目了。

附录

重新选择编译器

打开根目录下的CMakePresets.json，将configurePresets[0].toolchainFile改为以下两个值之一：

GCC: ${sourceDir}/cmake/gcc-arm-none-eabi.cmake
ST Arm Clang: ${sourceDir}/cmake/starm-clang.cmake

用VSCode或其他文本编辑器打开根目录下的xxx.ioc(xxx为项目名)，找到ProjectManager.CompilerLinker并将其修改为以下两个值之一：

GCC: GCC
ST Arm Clang: Starm-Clang

删除cmake-build-debug/CMakeCache.txt，并重新加载 CMake 项目（左上角可找到）
现在你可以重新编译了。

GD32VW553立创开发板折腾日志1

Fri, 24 Apr 2026 17:56:05 +0800

最近入手了一块GD32VW553的开发板，到手价9.9。号称是有板载的2.4Ghz WiFi6 + BLE5.2支持，感觉买一个来玩玩很划算（？）

购买方式

首先去这里领取开发板优惠券，要求是发送到朋友圈并集5个赞。然后再去这里领取免邮券就可以9.9到手了。

到手开箱

除了开发板本体以外，还额外赠送了两个排针（x）除此以外居然是彩色丝印，给好评。（图片占位）

东西很小巧，但是对一个买来当玩具的人（我）来说肯定够用了。

扫描随板附送的说明书二维码，可以看到板子的官方文档。扫了一眼感觉还是不错的，适合慢慢从头学起。~~但是我是一个很没有耐心的人~~，所以看了一点就开始自己折腾了！以下是一些折腾的成果，附带一些官方教程里没有的东西。

新建工程

新建工程(官方IDE)

点击左上角File -> New -> C/C++ Project新建项目。不要点首页的Create GD Project!!!

然后选择C/C++ Managed Build，选择Project Type: GigaDevice RISC-V Project。输入项目名，在下一页中找到GD32VW553HMQ6就完成了。

创建完成之后并不会自动打开项目，需要手动关闭Welcome选项卡。

新建工程(VSCode)

从头移植

在扩展中搜索Embedded IDE并安装，随后新建项目

到GigaDevice资料下载处获取最新的GD32VW55x Firmware Library，解压。

将Firmware, Template和Utilities复制到项目下，删除Template下的xxx_project文件夹和Firmware\RISCV下的env_IAR, env_SES

新建src文件夹，将Template里的main.c和main.h移动到src内

右键项目资源，点击添加源文件夹，点击普通文件夹，将Firmware, Template, Utilities, src添加到项目

点击构建配置，将链接脚本路径设置为Firmware\RISCV\env_Eclipse\GD32VW553xM.lds，点击构建器选项右边的编辑按钮，在新打开的页面中选择链接器选项卡，在“不生成指定的二进制文件”中删除*.bin file

在页面中选择全局选项，在编译器附加选项后面加入-msmall-data-limit=8 -mdiv

点击C/C++属性，在包含目录中添加Firmware/GD32VW55x_standard_peripheral, Firmware/GD32VW55x_standard_peripheral/Include, Template, Utilities, src, Firmware/RISCV/stubs, Firmware/RISCV/drivers

在预处理器定义中添加USE_STDPERIPH_DRIVER, HXTAL_VALUE=40000000U

使用模板

EIDE其实是有GD32VW553的模板的，只需要进行如下操作就可以直接启动了。

新建工程(CLion)

要在Clion环境下编译，我们需要先安装对应的工具链。本文使用的是xPack GNU RISC-V Embedded GCC v15.2.0-1，下载win32-x64的包后解压加入环境变量，重启CLion。

新建C可执行文件项目

到GigaDevice资料下载处获取最新的GD32VW55x Firmware Library，解压。将Firmware, Template和Utilities复制到项目下，删除Template下的xxx_project文件夹和Firmware\RISCV下的env_IAR, env_SES文件夹。随后在项目根目录下新建src文件夹，将Template里的main.c和main.h移动到src内。

打开CMakeLists.txt，将内容更改为

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73


cmake_minimum_required(VERSION 3.16) 
set(CMAKE_SYSTEM_NAME Generic) 
set(CMAKE_SYSTEM_PROCESSOR riscv) 
 
set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY) 
set(CMAKE_EXECUTABLE_SUFFIX .elf) 
project(gd32vw553 C ASM) 
 
set(TOOLCHAIN_PREFIX "riscv-none-elf-") 
set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}gcc) 
set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PREFIX}g++) 
set(CMAKE_ASM_COMPILER ${TOOLCHAIN_PREFIX}gcc) 
set(CMAKE_OBJCOPY ${TOOLCHAIN_PREFIX}objcopy CACHE INTERNAL "objcopy tool") 
set(CMAKE_OBJDUMP ${TOOLCHAIN_PREFIX}objdump CACHE INTERNAL "objdump tool") 
set(CMAKE_SIZE ${TOOLCHAIN_PREFIX}size CACHE INTERNAL "size tool") 
set(CMAKE_AR ${TOOLCHAIN_PREFIX}ar) 
 
set(ARCH_FLAGS "-march=rv32imac_zicsr -mabi=ilp32 -mcmodel=medlow -msmall-data-limit=8 -mdiv") 
set(CMAKE_C_FLAGS "${ARCH_FLAGS} -fmessage-length=0 -fsigned-char -ffunction-sections -fdata-sections -std=gnu11") 
set(CMAKE_ASM_FLAGS "${ARCH_FLAGS} -x assembler-with-cpp") 
 
set(LDSCRIPT "${CMAKE_SOURCE_DIR}/Firmware/RISCV/env_Eclipse/GD32VW553xM.lds") 
set(CMAKE_EXE_LINKER_FLAGS
 "${ARCH_FLAGS} -T${LDSCRIPT} -Wl,--cref -Wl,--gc-sections \ --specs=nosys.specs --specs=nano.specs -nostartfiles -Wl,-Bstatic") 
 
if(CMAKE_BUILD_TYPE STREQUAL "Debug") 
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -g -gdwarf-2 -O0") 
else() 
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -O2") 
endif() 
 
add_definitions(
 -DUSE_STDPERIPH_DRIVER
 -DHXTAL_VALUE=40000000U
) 
 
include_directories(
 ${CMAKE_SOURCE_DIR}
 ${CMAKE_SOURCE_DIR}/src
 ${CMAKE_SOURCE_DIR}/Template
 ${CMAKE_SOURCE_DIR}/Utilities
 ${CMAKE_SOURCE_DIR}/Firmware/GD32VW55x_standard_peripheral/Include
 ${CMAKE_SOURCE_DIR}/Firmware/GD32VW55x_standard_peripheral
 ${CMAKE_SOURCE_DIR}/Firmware/RISCV/drivers
) 
 
set(FIRMWARE_DIR ${CMAKE_SOURCE_DIR}/Firmware) 
 
file(GLOB_RECURSE C_SOURCES
 "${FIRMWARE_DIR}/GD32VW55x_standard_peripheral/Source/*.c"
 "${FIRMWARE_DIR}/GD32VW55x_standard_peripheral/*.c"
 "${FIRMWARE_DIR}/RISCV/env_Eclipse/*.c"
 "${FIRMWARE_DIR}/RISCV/stubs/*.c"
 "${FIRMWARE_DIR}/RISCV/drivers/*.c"
 "${CMAKE_SOURCE_DIR}/Template/*.c"
 "${CMAKE_SOURCE_DIR}/Utilities/*.c"
 "${CMAKE_SOURCE_DIR}/src/*.c"
) 
 
set(ASM_SOURCES
 ${FIRMWARE_DIR}/RISCV/env_Eclipse/start.S
 ${FIRMWARE_DIR}/RISCV/env_Eclipse/entry.S
) 
 
add_executable(${PROJECT_NAME} ${C_SOURCES} ${ASM_SOURCES}) 
 
add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
 COMMAND ${CMAKE_OBJCOPY} -O ihex $<TARGET_FILE:${PROJECT_NAME}> ${PROJECT_NAME}.hex
 COMMAND ${CMAKE_OBJCOPY} -O binary -S $<TARGET_FILE:${PROJECT_NAME}> ${PROJECT_NAME}.bin
 COMMAND ${CMAKE_OBJDUMP} -xS $<TARGET_FILE:${PROJECT_NAME}> > ${PROJECT_NAME}.s
 COMMAND ${CMAKE_SIZE} $<TARGET_FILE:${PROJECT_NAME}>
 COMMENT "Post-build: generating hex, bin and disassembly"
)

加载CMake项目后点击小锤子即可编译。

如果你好奇CMake代码是怎么编写出来的，可以尝试对照3.2.1.从头移植理解一下^^

上手开发

更改GPIO

阅读代码发现，官方的示例中有非常完整的LED闪烁代码，但是接口定义和板子的不同。原理图告诉我们这个板子只有一个LED连接到GPIO：

可以发现LED1连接的是GPIOC的PIN13。打开Utilities\gd32vw553h_eval.h，进行以下更改

打开Utilities\gd32vw553h_eval.c，进行以下更改

打开src\main.c，进行以下更改

下载和调试

虽然板子留了JTAG接口且声称支持J-Link，但是芯片是RISC-V架构的。除非你的J-Link是花大价钱买的新款正版，不然洗洗睡吧。因本人没有支持RISC-V的J-Link，也没有购买官方的GD-Link，所以这里只介绍如何使用串口下载。

注意：以下工具均可在兆易MCU资源中心找到最新版本。

官方GUI工具

使用官方的GD32 All-In-One Programmer即可方便地通过串口烧录程序。下载并解压后，双击打开GD32AllInOneProgrammer.exe，调整以下红框处参数

将Port Name调整为CH340对应的串口号，将Baud Rate调整为512000。修改完成后，按住板子上的BOOT0按钮并轻按RESET按钮，此时MCU会进入BootLoader模式。现在你可以点击页面上的Connect按钮连接串口了。

连接完成且下方出现Device Information后，在右侧Download处点击Browse按钮，找到编译好的固件后Download，等待下方进度条跑满后，在没有按住BOOT0按钮的状态下再次轻按RESET按钮，此时固件烧录并启动成功。

嵌入IDE

使用官方的GD32_ISP_CLI配合各种脚本即可做到丝滑地编译+烧录。在进行以下操作前，请确保GD32_ISP_CLI.exe已在环境变量里。

VSCode(EIDE)

待补充

CLion(CMake)

在CMakeLists.txt中加入

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


set(COM_PORT 5) # 这里设置你的串口号

find_program(GD32_TOOL_PATH GD32_ISP_CLI.exe) 
get_filename_component(GD32_TOOL_DIR ${GD32_TOOL_PATH} DIRECTORY) 
add_custom_target(flash
 COMMAND GD32_ISP_CLI.exe -c --pn ${COM_PORT} --br 512000 -i GD32VW553HMQ6 -d --a 08000000 --fn ${CMAKE_BINARY_DIR}/${PROJECT_NAME}.bin --n || exit 0
 WORKING_DIRECTORY ${GD32_TOOL_DIR}
 DEPENDS ${PROJECT_NAME}
 COMMENT "Flashing via UART..."
)

随后选择构建目标flash，点击小锤子即可编译并烧录。

疑难解答

Q: 我正在尝试在其他工具链中使用这个CLI，为什么提示Init OptionBytes failed!？

A: 在目前最新的5.1.0.39034版本下，这个CLI工具依赖当前工作目录来获取OptionBytesXML。你需要想办法切换工作目录，或是把OptionBytesXML文件夹复制到当前目录下。

进阶SDK

要想使用蓝牙和WiFi，我们需要构建专用的SDK包。SDK内包括两个部分：MBL和MSDK。MBL就是我们固件的BootLoader，负责启动系统前的初始化工作。我们想要二次开发一般只需要修改MSDK部分，也就是MSDK\app文件夹内的代码。在执行以下操作前，请先下载GD32VW553系列Wi-Fi & BLE SDK, Nuclei RISC-V Embedded Toolchain(Baremetal/RTOS + Newlibc)和OpenOCD，并将工具链和OpenOCD添加至环境变量。

注意：以上工具可在兆易MCU资源中心和芯来工具链找到最新版本。

如果你想尝试使用更新版本的工具链，请务必检查目标平台是否为riscv-nuclei-elf！！ (为什么？)

注意：必须下载并将OpenOCD添加至环境变量，即使你使用串口下载。 (为什么？)

CLion(CMake)

打开项目GD32VW55x_RELEASE_V1.0.3g，点击设置 - 构建、执行、部署 - CMake，将CMake选项更改为-DCMAKE_TOOLCHAIN_FILE:PATH=scripts/cmake/toolchain.cmake。

打开MSDK\plf\src\uart\uart_config.h，将第81行的#define LOG_UART UART2改为#define LOG_UART USART0。

打开MBL\mainboot\mbl.c，将第48行的#define LOG_UART UART2改为#define LOG_UART USART0。

将120行的
gpio_mode_set(GPIOA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO_PIN_8);
改为
gpio_mode_set(GPIOA, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_PIN_8);
并同样修改122行的代码，配置上拉模式。

打开MSDK\plf\src\uart\uart.h，将58-64行的

1
2
3
4
5
6
7


#define USART0_TX_GPIO GPIOA
#define USART0_TX_PIN GPIO_PIN_0
#define USART0_TX_AF_NUM GPIO_AF_0

#define USART0_RX_GPIO GPIOA
#define USART0_RX_PIN GPIO_PIN_1
#define USART0_RX_AF_NUM GPIO_AF_0

改为

1
2
3
4
5
6
7


#define USART0_TX_GPIO GPIOB
#define USART0_TX_PIN GPIO_PIN_15
#define USART0_TX_AF_NUM GPIO_AF_8

#define USART0_RX_GPIO GPIOA
#define USART0_RX_PIN GPIO_PIN_8
#define USART0_RX_AF_NUM GPIO_AF_2

现在你应该能够编译MBL和MSDK了。编译完的固件bin在scripts\images文件夹下。

游戏反编译工程工作流

Sun, 15 Mar 2026 21:20:47 +0800

AssetRipper反编译注意Sprite Export Format选择Texture
打开工程使用2018.4.36f1
删除已经被反编译，但后续需要重新安装的依赖
在Packages/manifest.json里加入"com.unity.package-manager-ui": "2.0.13"
在Package Manager中添加TextMesh Pro 重启unity，然后执行Window - TextMeshPro - Import TMP Essential Resources。
修复项目中的TMP依赖。其中包括脚本依赖、Shader依赖。可能出现在Scene和Prefab中。
解决报错。
把逆向出来字体的MonoBehavior对TMP Script的依赖修复。
修复shader
修复某些素材被错误设置为Mesh Type: Tight
将Build target改为Android 如果遇到Texture2D不能正常显示（如预览为水蓝色）请设置Override for Android -> Max Size 4096
留意代码中有没有硬编码的MonoBehaviour引用，反编译后可能会错误地加入_0之类的后缀，这时候如果代码里用==判等就会出错（Timeline动画相关出错很可能是因为这个）

嵌入式Linux开发1

Fri, 23 Jan 2026 00:53:06 +0800

正文

如何关闭默认的HDMI输出

root@firefly:/# cat /sys/class/vtconsole/vtcon1/name (M) frame buffer device

root@firefly:/# echo 0 > /sys/class/vtconsole/vtcon1/bind

连接到WiFi

nmcli device wifi connect “SSID名称” password “密码”

LVGL Pro环境配置及初体验

Wed, 21 Jan 2026 04:44:36 +0800

啥是LVGL Pro

最近入手了一块STM32F103ZET6的开发板，用一周时间学习了外设基本知识并移植完FreeRTOS、电阻触摸屏和其他一些IO后决定开发LVGL。在经历完操蛋的LVGL 9.4移植后，我想起了LVGL官方大力推荐的Next-gen方案：LVGL Pro。这是一个让你可以使用XML编辑布局和样式并编译到C代码的工具链，我们可以看一下官方示例感受一下写法：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


<component>
 <previews>
 <preview width="320" height="240" style_pad_all="24" style_bg_color="0xaaa" />
 </previews>

 <styles>
 <style name="style_main" height="100%" flex_cross_place="center" pad_row="#unit_sm" />
 <style name="style_main_dark" text_color="#surface_primary_dark" />
 <style name="style_bar" width="#unit_md" flex_grow="1" />
 </styles>
 <api>
 <prop name="move" type="int" default="5000" />
 <prop name="day" type="string" default="Mon" />
 </api>
 <view extends="column">
 <style name="style_main" />
 <bind_style name="style_main_dark" subject="dark_theme" ref_value="1" />

 <bar min_value="0" max_value="10000" value="$move">
 <style name="style_bar" />
 </bar>

 <lv_label text="$day" style_text_font="geist_semibold_12" />
 </view>
</component>

看起来就像在写HTML呢。不管怎么样，至少肯定比对着C代码硬搓简单多了。上面的代码会生成以下C代码（已简化）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45


lv_obj_t * stat_col_create(lv_obj_t * parent, int32_t move, const char * day)
{
 LV_TRACE_OBJ_CREATE("begin");

 static lv_style_t style_main;
 static lv_style_t style_main_dark;
 static lv_style_t style_bar;

 static bool style_inited = false;

 if (!style_inited) {
 lv_style_init(&style_main);
 lv_style_set_height(&style_main, lv_pct(100));
 lv_style_set_flex_cross_place(&style_main, LV_FLEX_ALIGN_CENTER);
 lv_style_set_pad_row(&style_main, UNIT_SM);

 lv_style_init(&style_main_dark);
 lv_style_set_text_color(&style_main_dark, SURFACE_PRIMARY_DARK);

 lv_style_init(&style_bar);
 lv_style_set_width(&style_bar, UNIT_MD);
 lv_style_set_flex_grow(&style_bar, 1);

 style_inited = true;
 }

 lv_obj_t * column_0 = column_create(parent);
 lv_obj_set_name_static(column_0, "stat_col_#");

 lv_obj_add_style(column_0, &style_main, 0);
 lv_obj_bind_style(column_0, &style_main_dark, 0, &dark_theme, 1);
 lv_obj_t * bar_0 = bar_create(column_0);
 lv_bar_set_min_value(bar_0, 0);
 lv_bar_set_max_value(bar_0, 10000);
 lv_bar_set_value(bar_0, move, false);
 lv_obj_add_style(bar_0, &style_bar, 0);

 lv_obj_t * lv_label_0 = lv_label_create(column_0);
 lv_label_set_text(lv_label_0, day);
 lv_obj_set_style_text_font(lv_label_0, geist_semibold_12, 0);

 LV_TRACE_OBJ_CREATE("finished");

 return column_0;
}

而且LVGL Pro还支持可视化。简直香爆了！值得一提的是，要在本地使用LVGL Pro的话是需要订阅的，想免费用只能在网页端编辑开源项目。下面是订阅价格表（2026/1/21）：

准备工作

安装WSL2

打开控制面板 - 程序 - 程序和功能或Win+R输入appwiz.cpl，点击启用或关闭Windows功能，勾选以下三项：

如果其中没有Hyper-V，可先尝试进行后续步骤再尝试以下方案：打开终端管理员，粘贴以下代码

1
2
3
4
5


$pkgs = Get-ChildItem "$env:SystemRoot\servicing\Packages\*Hyper-V*.mum" | Select-Object -ExpandProperty Name
foreach ($pkg in $pkgs) {
 dism /online /norestart /add-package:"$env:SystemRoot\servicing\Packages\$pkg"
}
dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /All

安装LVGL Pro

前往Releases页面下载并安装编辑器，随后新建一个项目。编辑器将自动完成Podman镜像拉取和后续工作。如果在这里遇到WSL2不能启动的问题，请打开cmd输入wsl查看报错并自行搜索解决方法。

配置Podman镜像源

在开始菜单中找到podman-machine-default或打开终端输入wsl -d podman-machine-default。在WSL中输入sudo vi /etc/containers/registries.conf.d/999-podman-machine.conf，按i进入编辑模式并将配置修改为

1
2
3
4
5


unqualified-search-registries = ["docker.io"]

[[registry]]
prefix = "docker.io"
location = "docker.1ms.run"

按esc退出编辑模式，输入:wq保存并退出编辑器。

集成至现有项目

如果你顺利完成了以上操作，不出意外的话可以开始编辑UI、查看预览了。如果你遇到了其他问题，可以跳转至踩坑小节或在评论区询问~

当你完成了UI的设计，点击右上角的按钮即可生成.c/.h文件。接下来，我们只需要在嵌入式工程的CMakeLists.txt中加入相关配置引入子目录即可。以下是我的目录结构：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


/
├─Core
│ └─Usr
│ └─Lvgl
│ └─Project
│ ├─CMakeLists.txt
│ ├─Project.c
│ └─Project.h
├─Middlewares
│ └─lvgl
└─CMakeLists.txt

/CMakeLists.txt：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# ...

# 添加UI项目为子项目
add_subdirectory(${CMAKE_CURRENT_LIST_DIR}/Core/Usr/Lvgl/Project)

# lib-ui为子项目的CMakeLists.txt中设置的默认项目名
# 为子项目提供lvgl环境
target_include_directories(lib-ui PRIVATE
 Middlewares/
)

# 让当前项目依赖子项目
target_link_libraries(${CMAKE_PROJECT_NAME}
 lib-ui
)

# ...

然后在你的嵌入式项目中进行以下调用：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


#include "Lvgl/Project/Project.h"

void StartLvglTask(void *argument) {
 lv_init();
 lv_tick_set_cb(osKernelGetTickCount);
 lv_port_disp_init();
 lv_port_indev_init();
 // 以上为驱动初始化

 Project_init(NULL); // 初始化UI项目
 lv_obj_t *main_screen = main_create(); // 创建屏幕
 lv_screen_load(main_screen); // 加载屏幕

 // 如果不使用screens，也可以直接添加components到默认屏幕
 // appbar_create(lv_scr_act(), "Text");

 for (;;) {
 lv_timer_handler();
 osDelay(5);
 }
}

踩坑

WSL2提示无法配置网络(networkingMode Nat)

参考WSL2 无法连接互联网 - Microsoft Q&A

升级版本

从1.0.1升级到1.0.2后出现编译错误的情况，需要进入%appdata%\lvgl-editor删除resources文件夹。

浏览器和URI fragment的虐恋

Mon, 08 Dec 2025 20:06:47 +0800

最近在写博客的时候，经常需要引用到外部的链接。为了方便读者定位，我不断寻找着增加跳转精度的方法…

碎碎念：如果你在本博客文章发现了点击后无法定位的链接，那证明实在是没办法做到了！

啥是URI fragment？

Shadow DOM冷知识

Sun, 07 Dec 2025 02:58:33 +0800

前言

需求

在编写本站的友链页面，实现可插入html的展示区时，遇到了一个问题：如果在里面写CSS，是可以覆盖全局样式的！

1
2
3
4


a {
 color: #8ec6ff;
    text-decoration: underline;
}

这就很尴尬了。一刀切限制用户使用类型选择器不仅增加了开发成本还要人工审核，毕竟风格统一的页面匹配类型进行修改样式的操作还是挺常用的。那么有没有什么好方法能做到CSS只能在某个作用域下生效呢？当然是使用Shadow DOM啦。

使用传统的Shadow DOM

如果你在搜索引擎查找“Shadow DOM”，那么大概会搜到如下的使用方法：
（使用影子 DOM - Web API | MDN）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


<div class="shadow-host">
 <template class="shadow-template">
 <style>
 /* 这里是样式 */
 </style>
 <!-- ... -->
 </template>
</div>
<script>
 (function attachShadowDOM(root) {
 // 1. 找到所有的template
 const templates = document.querySelectorAll('template.shadow-template');
 templates.forEach(template => {
 // 2. 创建Shadow DOM并挂载
 const host = template.parentElement;
 const shadow = host.attachShadow({
 // 3. 设置模式 (open表示外部可以通过shadowRoot属性访问Shadow DOM，closed表示不可以)
 mode: 'open'
 });

 // 4. 将template内容插入shadow root
 shadow.innerHTML = template.innerHTML;
 });
 })(document);
</script>

运行一下，确实可以用。那就写点东西吧…

1
2
3
4
5
6
7
8
9


<template class="shadow-template">
 <style>
 /* 这里是样式 */
 </style>

 <script>
 alert("success!");
 </script>
</template>

运行。呃，为什么没弹窗？按F12查看元素，发现确实是成功创建了Shadow DOM。

把Shadow DOM挂到body下也没用。好吧，看来是不能在Shadow DOM里面插入代码。那咋办呢？

使用声明式Shadow DOM

打开上面MDN的链接，把语言切换到英语，你会发现Creating a shadow DOM中多了一段Declaratively with HTML：

Creating a shadow DOM via JavaScript API might be a good option for client-side rendered applications. For other applications, a server-side rendered UI might have better performance and, therefore, a better user experience. In such cases, you can use the <template> element to declaratively define the shadow DOM. The key to this behavior is the enumerated shadowrootmode attribute, which can be set to either open or closed, the same values as the mode option of attachShadow() method.
― Using shadow DOM - Web APIs | MDN

好吧。。中文页面万年不更新。
根据文中所说的，我们把他改成声明式的试试看：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


<div class="shadow-host">
 <template class="shadow-template" shadowrootmode="open">
 <style>
 /* 这里是样式 */
 </style>

 <script>
 alert("success!");
 </script>
 </template>
</div>

<!-- 注意：attachShadowDOM方法已被移除 -->

打开网页…弹窗居然生效了？！没错，仅仅是改成声明式Shadow DOM就已经做到了执行script。至此，简介中的问题已经找到答案了。

兼容性

但是，写前端有一个脑子里一定要有的问题：这个功能能否在大部分浏览器工作？

根据Declarative Shadow DOM | Can I use…，声明式Shadow DOM的兼容性如下：

可以看到覆盖率还是挺高的。如果你的网站比较现代，完全不用考虑polyfill！

兼容Chrome 90-110

先来挑个软柿子捏吧。Can I use的Partial Support描述是Uses an older non-standard attribute called shadowroot instead of the standardized shadowrootmode attribute. 那我们直接给模板加上旧参数：

1

<template class="shadow-template" shadowrootmode="open" shadowroot="open"></template>

打开Chrome 90测试一下，成功了。

兼容Chrome 53-89

再往下的版本就得回滚到Shadow DOM v1了。

可以看到，最低可以支持到Chrome 53。先把之前的代码还原：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


<script>
 (function attachShadowDOM(root) {
 // 1. 找到所有的template
 const templates = document.querySelectorAll('template.shadow-template');
 templates.forEach(template => {
 // 2. 创建Shadow DOM并挂载
 const host = template.parentElement;
 const shadow = host.attachShadow({
 // 3. 设置模式 (open表示外部可以通过shadowRoot属性访问Shadow DOM，closed表示不可以)
 mode: 'open'
 });

 // 4. 将template内容插入shadow root
 shadow.innerHTML = template.innerHTML;
 });
 })(document);
</script>

因为是polyfill，我们需要加入判断。只有在浏览器不支持shadowRootMode或shadowRoot属性的时候才运行代码：

1
2
3
4
5


const supportsDeclarativeShadowDOM = HTMLTemplateElement.prototype.hasOwnProperty('shadowRootMode') || HTMLTemplateElement.prototype.hasOwnProperty('shadowRoot');
if (!supportsDeclarativeShadowDOM) {
 console.log('Polyfilling Shadow DOM for friends cards');
 ...
}

现在，在Chrome 89及以下应该也能正常加载到DOM了。但是还有一个遗留问题我们没有解决：<script>块还是被忽略的。在解决这个问题之前，我们先看看脚本在成功加载的声明式Shadow DOM中是什么表现：

1
2
3
4
5
6
7
8


<div id="test">Shadow DOM Content</div>
<div class="shadow-host">
 <template shadowrootmode="open">
 <script>
 document.getElementById('test').style.color = 'red';
 </script>
 </template>
</div>

打开浏览器，可以看到：

Shadow DOM Content

这说明Shadow DOM里面拿到的document和外部是一样的，无需做任何封装。那就好办了，直接把里面的所有script都挂载到真实DOM：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


const scripts = shadow.querySelectorAll("script");
if (!scripts) {
 return;
}

// To execute scripts inside non-declarative shadow DOM, we need to move them to light DOM
scripts.forEach(shadowScript => {
 const script = document.createElement("script");
 script.textContent = shadowScript.textContent;
 template.parentElement.appendChild(script);
});

这里为什么不直接shadowScript.cloneNode(true)后挂载呢？~~因为我试了不行~~。尝试寻找答案无果，就先这样吧。

差点忘了，我们还需要支持外部script的加载和module、defer和async等参数。那就再加上几行：

1
2
3
4
5
6
7


if (shadowScript.src) script.src = shadowScript.src;
if (shadowScript.integrity) script.integrity = shadowScript.integrity;
if (shadowScript.crossOrigin) script.crossOrigin = shadowScript.crossOrigin;

if (shadowScript.type) script.type = shadowScript.type;
if (shadowScript.defer) script.defer = shadowScript.defer;
if (shadowScript.async) script.async = shadowScript.defer;

测试一下，没有任何问题了！

完整代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58


<div class="shadow-host">
 <template class="shadow-template" shadowrootmode="open" shadowroot="open">
 <style>
 /* 这里是样式 */
 </style>

 <script>
 alert("success!");
 </script>
 </template>
</div>

<script>
 (function attachShadowDOM(root) {
 const supportsDeclarativeShadowDOM = HTMLTemplateElement.prototype.hasOwnProperty('shadowRootMode') || HTMLTemplateElement.prototype.hasOwnProperty('shadowRoot');
 if (!supportsDeclarativeShadowDOM) {
 console.log('Polyfilling Shadow DOM');


 // 1. 找到所有的template
 const templates = document.querySelectorAll('template.shadow-template');
 templates.forEach(template => {
 // 2. 创建Shadow DOM并挂载
 const host = template.parentElement;
 const shadow = host.attachShadow({
 // 3. 设置模式 (open表示外部可以通过shadowRoot属性访问Shadow DOM，closed表示不可以)
 mode: 'open'
 });

 // 4. 将template内容插入shadow root
 shadow.innerHTML = template.innerHTML;

 // 5. 为了了执行Shadow DOM内的脚本，我们需要将它们移动到真实 DOM
 const scripts = shadow.querySelectorAll("script");
 if (!scripts) {
 return;
 }

 scripts.forEach(shadowScript => {
 const script = document.createElement("script");
 script.textContent = shadowScript.textContent;

 // 支持外部脚本
 if (shadowScript.src) script.src = shadowScript.src;
 if (shadowScript.integrity) script.integrity = shadowScript.integrity;
 if (shadowScript.crossOrigin) script.crossOrigin = shadowScript.crossOrigin;

 // 支持module, defer和async
 if (onloadElement.type) script.type = onloadElement.type;
 if (onloadElement.defer) script.defer = true;
 if (onloadElement.async) script.async = true;

 template.parentElement.appendChild(script);
 });
 });
 }
 })(document);
</script>

剩下的工作？

实际上，到这一步还是不能实现需求。回想一下，我们需要在Shadow DOM内写JS，目的就是为了控制里面的元素对吧？然而我们刚刚测试的时候只是控制了外面的元素。我们可以试着把<div id=“test”>放到Shadow DOM内，试一下还能不能实现：

1
2
3
4
5
6
7
8


<div class="shadow-host">
 <template shadowrootmode="open" shadowroot="open">
 <div id="test">Shadow DOM Content</div>
 <script>
 document.getElementById('test').style.color = 'red';
 </script>
 </template>
</div>

测试一下：

Shadow DOM Content

哈哈，果然爆炸了。

打开F12，发现报错为Uncaught TypeError: Cannot read properties of null (reading 'style')。
可能你会说，改成document.querySelector('.shadow-host').shadowRoot.getElementById('test')不就好了？确实，你说得对，但是这样做十分麻烦！想象一下，当你编写一个组件，却需要不断查看它的父布局实现细节…这真的耦合过头了！我们还是希望能够提供一个API，使得组件能在内部直接访问到shadowRoot。但截至2025/12/11日笔者写下这段话时，还没有任何能做到在声明式Shadow DOM中直接获取shadowRoot的浏览器API。我们需要想办法了。

那么，这个问题就留到下一篇博客解决吧。

20251205

Fri, 05 Dec 2025 03:45:15 +0800

现在是凌晨的三点四十五分。我躺在上铺的床上，久久不能入睡。

恍惚间，我好像通过这个上下床回到了很久之前。在我比较小的时候，家里也是这种上下铺的双人床，那时候我和现在一样有一个宜家抱枕。这么多和现在一样的事情，可其实一切都不同了。小的时候我总是很开心，那时家里也比较有钱，日子过得无忧无虑。我还记得我有两个iPad 2，每天都热衷于使用FaceTime和爸爸视频通话。那时候真好啊！感觉对世上的一切都充满了兴趣。我会躺在双层床上，用被子把自己蒙住，然后躲起来玩手机。最重要的是，当时的我心里没有一点压力。现在我倒是可以自由地玩手机了，不过也找不到以前的快乐了。

打字的时候床铺震动了一下，不知为何我回想起了亲人离世时回老家的动车。我躺在上铺，一边难过，一边对未来充满了迷茫。或许是根本不敢相信这种事情真的发生了吧…虽然已经做了准备但是还是…。直到现在都无法接受。无法相信。虽然没有号啕大哭的悲伤，但是心会痛。很难受。

为什么我见你最后一面的时候没有多陪陪你呢？奶奶。痛苦结束了。希望您在那里可以和爷爷一起幸福。不要担心我。

似乎我一直都没有做好身为人类的职责，总是在逃避。逃避亲情，逃避友情。我是一个胆小的人。胆小到每天都担心着又有人会离开我。我好怕。

给过我承诺的人和没有给的人，变成了一个个默默离开、分道扬镳的人。虽说人生本就是无限条道路，能交叉就已经很幸运了。但是离别果然还是好痛，好寂寞。这种感情也没法很好的表达出来…只能在像这样的每个夜晚默默回忆、默默哭泣。

我不是一个诚实的人。甚至对自己也如此。

一直以来都是这样吗？我也不知道答案了。

或许上面一句也是谎言吗，也许吧？

晚安。

编写中断服务程序时是否需要保存外部函数的形参？

Wed, 03 Dec 2025 10:24:18 +0800

前言

在学习8051中断时，我发现有这么一种写法：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


unsigned int _n;
void delay(unsigned int n) {
 _n = n;
 while (_n--);
}

void isr_INT0() interrupt 0 {
 unsigned int n;
 EA = 0;
 n = _n; // 保护现场
 EA = 1;

 doSomething();
 delay(5000);

 EA = 0;
 _n = n; // 恢复现场
 EA = 1;
}

直觉告诉我，这种写法可能不必要…8051的参数传递类似x86里的__fastcall，参数是尽可能优先通过寄存器传递的。（文档）就算在delay函数中发生了中断，寄存器的值也应该会跟着断点一起保存…吧？口说无凭，我们得想个办法验证一下。

本次复现环境为μVision5.38.0.0 with Microchip AT89C51

尝试

我们仿照上面的代码，但是不对n进行保护现场：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


#include <REGX51.H>

void delay(unsigned int n) {
 while (n--);
}

void isr_INT0() interrupt 0 {
 delay(5000);
}

void main() {
 delay(15000);
 while(1);
}

用Keil编译之前，我们先进行一些设置，让他输出带汇编的Listing文件：

单击Project - Options for Target ‘Target 1’或图标
进入Listing选项卡，勾选C Compiler Listing并勾选Conditional、Symbols和Assembly Code

修改好之后再编译，我们就会得到一些lst文件。用任意文本编辑器打开main.lst，观察一下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67


line level source

 1 #include <REGX51.H>
 2
 3 void delay(unsigned int n) {
 4 1 while (n--);
 5 1 }
 6
 7 void isr_INT0() interrupt 0 {
 8 1 delay(5000);
 9 1 }
 10
 11 void main() {
 12 1 delay(15000);
 13 1 while(1);
 14 1 }

ASSEMBLY LISTING OF GENERATED OBJECT CODE

 ; FUNCTION _delay (BEGIN)
 ; SOURCE LINE # 3
;---- Variable 'n' assigned to Register 'R6/R7' ----
0000 ?C0001:
 ; SOURCE LINE # 4
0000 EF MOV A,R7
0001 1F DEC R7
0002 AC06 MOV R4,AR6
0004 7001 JNZ ?C0008
0006 1E DEC R6
0007 ?C0008:
0007 4C ORL A,R4
0008 70F6 JNZ ?C0001
 ; SOURCE LINE # 5
000A 22 RET
 ; FUNCTION _delay (END)

 ; FUNCTION isr_INT0 (BEGIN)
0000 C0E0 PUSH ACC
0002 C0D0 PUSH PSW
0004 75D000 MOV PSW,#00H
0007 C004 PUSH AR4
0009 C006 PUSH AR6
000B C007 PUSH AR7
 ; SOURCE LINE # 7
 ; SOURCE LINE # 8
000D 7F88 MOV R7,#088H
000F 7E13 MOV R6,#013H
0011 120000 R LCALL _delay
 ; SOURCE LINE # 9
0014 D007 POP AR7
0016 D006 POP AR6
0018 D004 POP AR4
001A D0D0 POP PSW
001C D0E0 POP ACC
001E 32 RETI
 ; FUNCTION isr_INT0 (END)

 ; FUNCTION main (BEGIN)
 ; SOURCE LINE # 11
 ; SOURCE LINE # 12
0000 7F98 MOV R7,#098H
0002 7E3A MOV R6,#03AH
0004 120000 R LCALL _delay
0007 ?C0005:
 ; SOURCE LINE # 13
0007 80FE SJMP ?C0005
 ; FUNCTION main (END)

看起来有点乱，稍微解释一下吧！

从 20行开始，就是转换后方便阅读的汇编代码。
;开头的句子是注释，相当于C语言中的//。
从左开始数的第一列是指令地址，你有没有发现从上往下看这一列是递增的呢？
第二列是指令(Instruction)，这是可以查表的，想了解可以看看官方文档或者本文末尾附录。操作码里包括了操作码(OpCode)和操作数(Operands)。
第三列是助记符，顾名思义就是帮助你记住操作码对应功能的东西。
最后一列就是操作数了。他们以逗号分隔开。

那么…

阅读汇编

delay函数

我们可以清楚地看到， C0001是delay函数的入口点，那我们就一行行分析一下。首先，这里提到n被保存到了R6和R7里面。那么R6是啥，R7又是啥呢？

没错，他们都是寄存器，数据范围是8位。我们的函数参数是unsigned int，是16位的，刚好需要两个寄存器。接下来往下看， MOV A, R7是什么意思呢？查阅官方文档可以看到，这其实就是赋值操作，相当于A = R7。那么A又是啥呢？

哈哈，还是寄存器。不过A是特殊的，叫做累加器(Accumulator)。累加器的用处就是进行一些运算。和我们要找的东西没关系，我们快速过一遍吧。 DEC R7把R7减去1， MOV R4, AR6把AR6（R6）赋值给R4。 JNZ是Jump if Not Zero，累加器不为0的时候跳转。在这里意思就是如果R7不为0，就跳转到 C0008。 ORL A,R4的意思是A |= R4，既按位逻辑或。这里的R4是上面的R6，而R6是我们一开始传进来的实参。反正带着源码看，虽然不能完全理解但也大概知道是做了些什么事情了。我们还是回到主题上吧。

经过刚刚的分析，我们可以发现delay函数至少使用了这些寄存器：

R4
R6
R7
A(累加器)

中断函数

该看下一个函数了。紧挨着delay的就是我们写的中断函数，因为这是中断发生后最先到达的地方，所以大概率编译器会在这里使用魔法吧。快速扫一眼，马上就发现和刚刚的函数不一样：第一行就有一个 PUSH操作。还是老样子，我们打开官方文档：

The PUSH instruction increments the stack pointer and stores the value of the specified byte operand at the internal RAM address indirectly referenced by the stack pointer. No flags are affected by this instruction.

意思就是，PUSH指令会将寄存器中的值压入栈中。这好像有点接近我们要找的东西了，继续往下看，程序依次将 ACC、PSW、AR4、AR6、AR7入栈。

等等，好像看到什么熟悉的东西了？ACC、AR4、AR6、AR7，这不就是delay函数用到的寄存器吗！再往下看， LCALL完delay马上又把这些寄存器POP了回去。这个不就是我们开始手写的保护现场吗！事已至此，我们已经找到了标题这个问题的答案了。编译器会自动帮我们进行一部分保护现场的工作，所以编写中断服务程序时无需保存外部函数的形参。~~好耶可以少写一堆代码了！~~

官方文档

是的…做了这么多才发现另一个官方文档中有写。

When required, the contents of ACC, B, DPH, DPL, and PSW are saved on the stack at function invocation time.

All working registers used in the interrupt function are stored on the stack if a register bank is not specified with the using attribute.

The working registers and special registers that were saved on the stack are restored before exiting the function.

The function is terminated by the 8051 RETI instruction.

― User's Guides for Keil C51 Development Tools

这里的第二点就是上面得到的结论：C51编译器会自动将中断函数中调用的函数所使用的所有寄存器保存至栈上。知道了这点之后也有一些别的启发，比如不能在中断函数中调用太多函数导致爆栈等等。

碎碎念：其实也不能说做的都是无用功，能直接从最底层的汇编理解编译器做了些什么，然后自己找出答案的过程还是很有趣的！

补充：在SDCC中的行为

以上的分析全部基于Keil C51 Compiler，在SDCC中稍有不同。在SDCC Compiler User Guide中有明确的指引：

SDCC allows interrupt service routines to be coded in C, with some extended keywords.
1
2
3
4
void timer_isr (void) __interrupt (1) __using (1)
{
 ...
}
The optional number following the __interrupt keyword is the interrupt number this routine will service. When present, the compiler will insert a call to this routine in the interrupt vector table for the interrupt number specified. If you have multiple source files in your project, interrupt service routines can be present in any of them, but a prototype of the isr MUST be present or included in the file that contains the function main. The optional (8051 specific) keyword __using can be used to tell the compiler to use the specified register bank when generating code for this function.

― SDCC Compiler User Guide (4.5.15): 3.8.1 Interrupt Service Routine - General Information

An interrupt function using a non-zero bank will assume that it can trash that register bank, and will not save it. Since high-priority interrupts can interrupt low-priority ones on the 8051 and friends, this means that if a high-priority ISR using a particular bank occurs while processing a low-priority ISR using the same bank, terrible and bad things can happen. To prevent this, no single register bank should be used by both a high priority and a low priority ISR. This is probably most easily done by having all high priority ISRs use one bank and all low priority ISRs use another. If you have an ISR which can change priority at runtime, you’re on your own: I suggest using the default bank zero and taking the small performance hit. It is most efficient if your ISR calls no other functions. If your ISR must call other functions, it is most efficient if those functions use the same bank as the ISR (see note 1 below); the next best is if the called functions use bank zero. It is very inefficient to call a function using a different, non-zero bank from an ISR.
― SDCC Compiler User Guide (4.5.15): 3.10 Functions using private register banks

阅读以上信息我们可得知：

可以显式使用__using (regbank)来切换中断函数要使用的寄存器组
当regbank非0时，你需要手动维护寄存器
当regbank为默认值(0)时，编译器会自动保存寄存器

所以，当不指定__using时，你同样无需为外部函数的形参保护现场。如果你指定了其他寄存器组，编译器会为了优化效率假定你已经处理好了一切工作，这时才需要手动保存。

附录：8051所有指令码

展开内容

指令码	占用字节	助记符	操作数
00	1	NOP
01	2	AJMP	addr11
02	3	LJMP	addr16
03	1	RR	A
04	1	INC	A
05	2	INC	direct
06	1	INC	@R0
07	1	INC	@R1
08	1	INC	R0
09	1	INC	R1
0A	1	INC	R2
0B	1	INC	R3
0C	1	INC	R4
0D	1	INC	R5
0E	1	INC	R6
0F	1	INC	R7
10	3	JBC	bit, offset
11	2	ACALL	addr11
12	3	LCALL	addr16
13	1	RRC	A
14	1	DEC	A
15	2	DEC	direct
16	1	DEC	@R0
17	1	DEC	@R1
18	1	DEC	R0
19	1	DEC	R1
1A	1	DEC	R2
1B	1	DEC	R3
1C	1	DEC	R4
1D	1	DEC	R5
1E	1	DEC	R6
1F	1	DEC	R7
20	3	JB	bit, offset
21	2	AJMP	addr11
22	1	RET
23	1	RL	A
24	2	ADD	A, #immed
25	2	ADD	A, direct
26	1	ADD	A, @R0
27	1	ADD	A, @R1
28	1	ADD	A, R0
29	1	ADD	A, R1
2A	1	ADD	A, R2
2B	1	ADD	A, R3
2C	1	ADD	A, R4
2D	1	ADD	A, R5
2E	1	ADD	A, R6
2F	1	ADD	A, R7
30	3	JNB	bit, offset
31	2	ACALL	addr11
32	1	RETI
33	1	RLC	A
34	2	ADDC	A, #immed
35	2	ADDC	A, direct
36	1	ADDC	A, @R0
37	1	ADDC	A, @R1
38	1	ADDC	A, R0
39	1	ADDC	A, R1
3A	1	ADDC	A, R2
3B	1	ADDC	A, R3
3C	1	ADDC	A, R4
3D	1	ADDC	A, R5
3E	1	ADDC	A, R6
3F	1	ADDC	A, R7
40	2	JC	offset
41	2	AJMP	addr11
42	2	ORL	direct, A
43	3	ORL	direct, #immed
44	2	ORL	A, #immed
45	2	ORL	A, direct
46	1	ORL	A, @R0
47	1	ORL	A, @R1
48	1	ORL	A, R0
49	1	ORL	A, R1
4A	1	ORL	A, R2
4B	1	ORL	A, R3
4C	1	ORL	A, R4
4D	1	ORL	A, R5
4E	1	ORL	A, R6
4F	1	ORL	A, R7
50	2	JNC	offset
51	2	ACALL	addr11
52	2	ANL	direct, A
53	3	ANL	direct, #immed
54	2	ANL	A, #immed
55	2	ANL	A, direct
56	1	ANL	A, @R0
57	1	ANL	A, @R1
58	1	ANL	A, R0
59	1	ANL	A, R1
5A	1	ANL	A, R2
5B	1	ANL	A, R3
5C	1	ANL	A, R4
5D	1	ANL	A, R5
5E	1	ANL	A, R6
5F	1	ANL	A, R7
60	2	JZ	offset
61	2	AJMP	addr11
62	2	XRL	direct, A
63	3	XRL	direct, #immed
64	2	XRL	A, #immed
65	2	XRL	A, direct
66	1	XRL	A, @R0
67	1	XRL	A, @R1
68	1	XRL	A, R0
69	1	XRL	A, R1
6A	1	XRL	A, R2
6B	1	XRL	A, R3
6C	1	XRL	A, R4
6D	1	XRL	A, R5
6E	1	XRL	A, R6
6F	1	XRL	A, R7
70	2	JNZ	offset
71	2	ACALL	addr11
72	2	ORL	C, bit
73	1	JMP	@A+DPTR
74	2	MOV	A, #immed
75	3	MOV	direct, #immed
76	2	MOV	@R0, #immed
77	2	MOV	@R1, #immed
78	2	MOV	R0, #immed
79	2	MOV	R1, #immed
7A	2	MOV	R2, #immed
7B	2	MOV	R3, #immed
7C	2	MOV	R4, #immed
7D	2	MOV	R5, #immed
7E	2	MOV	R6, #immed
7F	2	MOV	R7, #immed
80	2	SJMP	offset
81	2	AJMP	addr11
82	2	ANL	C, bit
83	1	MOVC	A, @A+PC
84	1	DIV	AB
85	3	MOV	direct, direct
86	2	MOV	direct, @R0
87	2	MOV	direct, @R1
88	2	MOV	direct, R0
89	2	MOV	direct, R1
8A	2	MOV	direct, R2
8B	2	MOV	direct, R3
8C	2	MOV	direct, R4
8D	2	MOV	direct, R5
8E	2	MOV	direct, R6
8F	2	MOV	direct, R7
90	3	MOV	DPTR, #immed
91	2	ACALL	addr11
92	2	MOV	bit, C
93	1	MOVC	A, @A+DPTR
94	2	SUBB	A, #immed
95	2	SUBB	A, direct
96	1	SUBB	A, @R0
97	1	SUBB	A, @R1
98	1	SUBB	A, R0
99	1	SUBB	A, R1
9A	1	SUBB	A, R2
9B	1	SUBB	A, R3
9C	1	SUBB	A, R4
9D	1	SUBB	A, R5
9E	1	SUBB	A, R6
9F	1	SUBB	A, R7
A0	2	ORL	C, /bit
A1	2	AJMP	addr11
A2	2	MOV	C, bit
A3	1	INC	DPTR
A4	1	MUL	AB
A5		reserved
A6	2	MOV	@R0, direct
A7	2	MOV	@R1, direct
A8	2	MOV	R0, direct
A9	2	MOV	R1, direct
AA	2	MOV	R2, direct
AB	2	MOV	R3, direct
AC	2	MOV	R4, direct
AD	2	MOV	R5, direct
AE	2	MOV	R6, direct
AF	2	MOV	R7, direct
B0	2	ANL	C, /bit
B1	2	ACALL	addr11
B2	2	CPL	bit
B3	1	CPL	C
B4	3	CJNE	A, #immed, offset
B5	3	CJNE	A, direct, offset
B6	3	CJNE	@R0, #immed, offset
B7	3	CJNE	@R1, #immed, offset
B8	3	CJNE	R0, #immed, offset
B9	3	CJNE	R1, #immed, offset
BA	3	CJNE	R2, #immed, offset
BB	3	CJNE	R3, #immed, offset
BC	3	CJNE	R4, #immed, offset
BD	3	CJNE	R5, #immed, offset
BE	3	CJNE	R6, #immed, offset
BF	3	CJNE	R7, #immed, offset
C0	2	PUSH	direct
C1	2	AJMP	addr11
C2	2	CLR	bit
C3	1	CLR	C
C4	1	SWAP	A
C5	2	XCH	A, direct
C6	1	XCH	A, @R0
C7	1	XCH	A, @R1
C8	1	XCH	A, R0
C9	1	XCH	A, R1
CA	1	XCH	A, R2
CB	1	XCH	A, R3
CC	1	XCH	A, R4
CD	1	XCH	A, R5
CE	1	XCH	A, R6
CF	1	XCH	A, R7
D0	2	POP	direct
D1	2	ACALL	addr11
D2	2	SETB	bit
D3	1	SETB	C
D4	1	DA	A
D5	3	DJNZ	direct, offset
D6	1	XCHD	A, @R0
D7	1	XCHD	A, @R1
D8	2	DJNZ	R0, offset
D9	2	DJNZ	R1, offset
DA	2	DJNZ	R2, offset
DB	2	DJNZ	R3, offset
DC	2	DJNZ	R4, offset
DD	2	DJNZ	R5, offset
DE	2	DJNZ	R6, offset
DF	2	DJNZ	R7, offset
E0	1	MOVX	A, @DPTR
E1	2	AJMP	addr11
E2	1	MOVX	A, @R0
E3	1	MOVX	A, @R1
E4	1	CLR	A
E5	2	MOV	A, direct
E6	1	MOV	A, @R0
E7	1	MOV	A, @R1
E8	1	MOV	A, R0
E9	1	MOV	A, R1
EA	1	MOV	A, R2
EB	1	MOV	A, R3
EC	1	MOV	A, R4
ED	1	MOV	A, R5
EE	1	MOV	A, R6
EF	1	MOV	A, R7
F0	1	MOVX	@DPTR, A
F1	2	ACALL	addr11
F2	1	MOVX	@R0, A
F3	1	MOVX	@R1, A
F4	1	CPL	A
F5	2	MOV	direct, A
F6	1	MOV	@R0, A
F7	1	MOV	@R1, A
F8	1	MOV	R0, A
F9	1	MOV	R1, A
FA	1	MOV	R2, A
FB	1	MOV	R3, A
FC	1	MOV	R4, A
FD	1	MOV	R5, A
FE	1	MOV	R6, A
FF	1	MOV	R7, A

外出日记1

Tue, 02 Dec 2025 23:23:33 +0800

前些日子实在是很无聊，于是有了“哪怕一秒也好，我想从这个世界逃离”的想法。结果…

莫名其妙就走了十多公里…不过虽然很累，但是能去到基本上没有人的地方还是特别开心的。仔细想想，上一次像这样放松独处、完全把时间留给自己是多久以前了呢？似乎是高中那会吧。总之久违地感受到了平静。

出发时还是下午，到达山顶的时候已经天黑了，明明本来想着拍一点落日的。不过感觉也挺好看的，就还是拍了一些照片😌

虽然这些照片没有精美的构图、看起来不怎么样，但是那一刻为了记录此刻的心情，我还是按下了快门键。这也许就是我出门的意义吧？

使用移动设备编写并预览博客文章

Tue, 02 Dec 2025 04:32:21 +0800

经常会有电脑不在身边但想写点什么打发时间的场景，但是因为富文本内容和扩展语法没法看到自己写了些什么、看上去怎么样…

在某天发现Obsidian是跨平台的之后，我突然悟了！为什么不能在手机上部署一个一模一样的环境呢？说干就干！

准备工作

安装Termux

Hugo作为一个headless cli是需要Linux环境运行的，Termux正好提供这样一个环境。如果你还没有安装的话可以尝试ZeroTermux，可以省去一些配置上的麻烦。

安装Obsidian

官网/下载

这里主要是需要一个能方便编辑markdown的编辑器，如果你有其他喜欢的大概也是可以用的。

配置Obsidian

打开Obsidian，新建一个仓库，仓库位置选择Device storage，在Document下新建一个文件夹，随后点击使用此文件夹。

为Termux提供储存权限

打开Termux，安装完bootstrap后输入

1

termux-setup-storage

不出意外的话会有一个提示框，点击允许即可。尝试输入cd /sdcard/Documents，如果没有Permission denied的提示就完成啦。

将文档目录链接到home下

这一步是为了方便自己的，毕竟谁也不想每次打开都cd一次吧（笑）我们可以把博客目录链接到home，这样每次打开Termux都可以直接启动部署。

1
2


cd ~
ln -s /sdcard/Documents/yourblog

然后ls一下，看看有没有新的文件夹出现吧。

安装Hugo

因为Termux的软件源里本来就有hugo，所以这一步十分简单：

1
2


pkg update
pkg install hugo

需要注意的是，如果你使用了官方版本的Termux可能会出现在某些网络环境下载不下来的情况，可以自行搜索Termux更换镜像源 后继续操作。

安装Git并克隆项目

1
2


pkg install git
git clone heres.your/repo.git ~/yourblog

~~如果你忘记clone到刚刚链接的目录，就mv过去吧~~

启动Hugo服务

1
2


cd ~/yourblog
hugo server -D --noBuildLock

这里解释一下最后一个参数，hugo为了防止server和build同时进行或类似的竞态情况默认是有lock机制的。翻看源码发现使用的库是lockedfile，底层为syscall.Flock。这在大部分情况下都工作得很好，然而/sdcard下使用的是FUSE文件系统，不支持flock操作。

让Termux能够后台运行

现在，你已经可以回到Obsidian中编辑博客，随后在浏览器中预览了！但是如果你把Termux放到后台再打开localhost:1313，大概率会因为后台被冻结而失败。可以尝试以下方法：

进入设置，找到耗电管理，把Termux的电池计划改为无限制/完全允许后台行为
进入后台划卡页面，下拉Termux锁定
进入权限管理，给Termux自启动权限
在Termux中输入termux-wake-lock，然后给予后台留存的特殊权限

如果你不知道以上具体的操作，可以参考这里。

20251202

Tue, 02 Dec 2025 03:42:53 +0800

如果把后退比作前进的话，那我一直都在奔跑着吧。一无是处到这种程度，也是一种才能吧。让人心生嫉妒又是谁的错呢。假装笑着的时候又在想着什么呢。

不断重复着不知从何处听来的陈词，为预制的情绪罐头流下眼泪。这样的人生是否有存在的价值呢。从来都记不住教训，自大的悲剧循环上演。这样的自己到底是可怜还是可笑呢。

被自我厌弃的幽默感、偶尔存在的正义。被刺痛了还能继续虚伪地说着那些找补的话语吗？还真是唯独在这方面有着天赋。日复一日的自说自话，是否也期待着被人所读懂？…并没有？真可怜啊！粘在脸上取不下来的面具，看来你和他共存的很好嘛。也许一直是一体的吧，却也偶尔歇斯底里地憎恨着它。

你到底咋了？自怜的小丑牌先生。那样的神色倒像是你的刻意伪装。忍不住露出獠牙了吧？听我这么说果然还是愤怒了吧？不自知的伪善者。明明没少做伤害他人的事，却又执意表演完美受害者。可惜并没有人为这出独角戏买账。痛苦和求死欲是朋友。一直到死去都否认自己吧。装作不在意，却忍不住在没有人的地方一直回想；总觉得自己待遇不公，又没法鼓起勇气保护自己。胆小鬼是没有人权的。将真心话包裹在1000层的玩笑中，为了抹去罪恶假装忏悔着。这种想法似乎也只在夜晚出现呢。不这么做的话就没法安定不是吗？不这么做的话就得不到爱不是吗？那还真是辛苦了！

假装听着他人的劝告，像宠物一样附和。你怕的是无法被理解的观点吗？还是只想装装样子、试图用讨好拉近关系呢？贫瘠的精神混合附带着谄媚的话语，是你的拿手菜吗？对待讨厌的家伙也要装模作样吗？明明已经理解不了自己的行为了吧？明明已经变成自己讨厌的样子了吧？为了保住尊严，还是否定了自己的内心吗？这样下去离彻底失去人性也不远了吧？

总说着自己很累了，可又从来没有放过自己。明明最恨你的人是自己吧？请不要幻想能够被救赎啊。很清楚吧，期待过的事情最终会变成什么样子。擅自期待着、编织着那样的谎言安慰自己。至少你活下来了。……算了。胆小鬼是没有勇气去死的。

就连你也觉得因为这种小事烦恼是一种幸福吗？请不要再来找我了，自大的先生。反正失败是必然的。那样想着，又流下了不被理解的泪水。分析过后给他贴一个病态的标签吧。

还在生我的气吗？天真的孩子。大家一直以来都是这么认为的。我只是把他毫无保留地告诉了你，你却认为我有病。数年后想起，你是否会发觉我思想的超前性呢。是否会觉得自己太过幼稚呢。不。我才不会变成你那样的生物。这样啊。那就再见了。

反正也没有人会像我一样爱你。

Learning Chord Symbol

Mon, 24 Nov 2025 00:26:47 +0800

观前提醒：本文仅涉及简单的和弦，不涉及复合和弦(Polychords)相关内容。

你是否有过这样的疑惑：吉他谱手型图旁边的字母是什么意思？别人扒谱视频里的罗马数字又是啥？怎么最后还有一坨标记？

本文的写作目标是让你以最小的思考成本搞懂以上问题！

从最简单的开始…

首先，我们需要知道和弦是什么！简单地来说，和弦就是一组三个及以上的音同时或依次播放。前者叫柱式和弦(Block Chord)，后者叫分解和弦(Broken Chord)。
没看懂？来个例子吧。

思考

小调为什么是降三级、降六级、降七级？

调内和弦

Sat, 22 Nov 2025 17:33:41 +0800

调内和弦(Diatonic)，顾名思义就是和弦中的每个构成音都在调内。本文以三和弦为例，整理了一些调式的调内和弦和他们的功能。如您发现内容有误，还请告知修改，非常感谢！

自然大调

对于自然大调，在五线谱上先构建一级大三和弦然后按依次向上平移即可得到所有调内和弦，如下所示（点击1=C可以移调）：

和弦试听

整理音程关系后我们可以发现其中I，IV，V级为大三和弦，II，III，VI级为小三和弦，VII级为减三和弦。接下来我们需要思考一个问题：他们分别代表了什么功能？

首先，I，IV，V级是我们再熟悉不过的TSD和弦，分别代表了主功能、下属功能和属功能。那么剩下的四个和弦呢？

啊…我识谱能力太差了。我们可以试着把他们进行转位，把所有音移到同一个八度内，看看能不能看出什么或听出什么：

如果你的音感/注意力较好，应该已经听/看出来一些相似了！

发现了吗？II级和弦和IV级和弦有两个音是一样的！相似情况还有III级和I级、III级和V级、VI级和I级、VII级和II级。那我们是不是可以认为这些和弦具有相同的功能呢？答案是肯定的！

2m和4M一样都是下属功能，6m和1M一样都是主功能。3m比较特殊，他同时和1M、5M相似，所以既可以作为主功能也可以作为属功能。

等等，是不是少了什么？VII级和弦去哪里了？……哦，我知道了。7dim和2m相似，所以7dim也是下属功能吗？

先说结论：7dim为属功能。虽然7dim和2m相似，但是他并不和真正的、最原始的下属功能和弦4M相似。可以看到事实上他们两个只有一个音相同，显然不能作等效处理。

那怎么办呢？聪明的你一定想到了：他是一个减三和弦，那么他一定会有一个三全音！那么哪里还有三全音呢？学习TSD的时候提到，属功能一般会使用属七和弦来增加回到一级的解决感，那么带着“7dim为属功能”的答案，我们把五级的属七和弦（也叫大小七和弦）和七级的减三和弦摆在一起看看，顺便写一下七级的减七和弦：

哦，懂了！这下，所有调内和弦的功能都找到了！我把他做成了一个表格：

整理表格

级数	名称	和弦性质	功能
1	1M(I)	大三和弦	主
2	2m(IIm)	小三和弦	下属
3	3m(IIIm)	小三和弦	主/属
4	4M(IV)	大三和弦	下属
5	5M(V)	大三和弦	属
6	6m(VIm)	小三和弦	主
7	7dim(VII°)	减三和弦	属

碎碎念：以前觉得这些东西好难背，各种功能看到就头大。知道了是怎么推出来的之后发现其实好像也不是特别难了！

自然小调

接下来我们看看自然小调。有了大调的经验，直接把所有和弦写出来看看再说！

和弦试听

自然小调的TSD和自然大调的一样，也分别是I、IV、V级。我们照样按老方法给他们配对：

整理表格

级数	名称	和弦性质	功能
1	1m(Im)	小三和弦	主
2	2dim(II°)	减三和弦	下属
b3	b3M(bIII)	大三和弦	主
4	4m(IVm)	小三和弦	下属
5	5m(Vm)	小三和弦	属
b6	b6M(bVI)	大三和弦	主/下属
b7	b7M(bVII)	大三和弦	属

值得一提的是，自然小调中的V级属功能是一个小和弦。他的调内七和弦5m7没有三全音，类似自然大调属功能导向主音的听感有但不多，所以一般不怎么用来导向终止。来感受一下！

小调↓

大调↓

你觉得哪个的解决感更强呢？可能因为分解和弦的缘故听不太出来，你可以试着用鼠标分别点击上方第三个和第一个和弦标记，感受一下V级到I级听感的差别。

那么，如果我就是想要大调那样的强解决感怎么办？其实很简单！我们把V级的小七和弦改成同根音的属七和弦就行了。也就是把和弦的三音（调式的VII级音）升半音，让他和根音的关系变成大三度、和七音的关系变成增四度（三全音）：

听听看，是不是感觉回一级前紧张了很多！
等等，我们标题不是调内和弦吗？把调式的七级音升高半音那还是调内吗？嗯，你说对了！

和声小调

没错，把自然小调的VII级音升高半音就变成了和声小调。

和弦试听

整理表格

级数	名称	和弦性质	功能
1	1m(Im)	小三和弦	主
2	2dim(II°)	减三和弦	下属
b3	b3aug(bIII+)	增三和弦	属?
4	4m(IVm)	小三和弦	下属
5	5M(V)	大三和弦	属
b6	b6M(bVI)	大三和弦	主/下属
7	7dim(VII°)	减三和弦	属

这里有一个很特殊的和弦：增三和弦，它非常难使用！以至于虽然它是和声小调的调内和弦，但是多数需要属功能的情况都会使用自然小调中的大三和弦代替。不过它在流行/爵士音乐中有一些特殊用法，比如作为经过和弦之类的。我也不是很清楚这方面所以就不赘述了XD以后学到了可能会另外开一篇？

初次见面

Fri, 21 Nov 2025 20:12:31 +0800

ようこそー！👋

嗨！这里是Hoshitori，也可以叫我沙茶！我目前是一名大二的学生。

开此blog的契机是买了个腾讯云服务器然后闲置了，正好试着写一些篇幅较长的个人思考，也锻炼一下语言组织能力和消磨时间。欢迎你和我交朋友呀！！

本博客可能包含的内容：

编程

展开内容

~~虽然本人几乎只对软件感兴趣，不过目前专业为嵌入式相关！~~

经常使用的语言有Python/Kotlin/Java，勉强能写一点的有JavaScript/TypeScript/C#/Golang/C（按熟练度降序排名），正在龟速学习Rust…

以及我对逆向/ctf相关感兴趣，虽然很菜学不明白就是了（躺）

一般来说我只有想做某个项目才会编程，所以这部分内容不一定会很多（甚至可能根本不会发）！

乐理

展开内容

因为对创作音乐有强烈的欲望，目前已经学习乐理基础知识，正在从零学习四部和声相关知识中！我并没有什么音乐天赋，所以可能会把一些~~学习过程中突然开智想到的~~常识性的知识加上正确率未知的个人感悟写成文章，主要是记录用。不过也非常欢迎勘误和交流！

希望有一天能把自己想说的话用音乐传递给大家！

音乐推荐

展开内容

我喜欢VOCALOID和日本流行音乐，也听一些旋律性强的电子音乐！如果有让我产生共鸣或我单纯觉得好听的歌，我会po到博客上！

以下为个人偏好，想到啥写啥不分先后 »

术力口成分

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


n-buna
ナユタン星人
いよわ
キノシタ
すりぃ
西沢さんP
Orangestar
ナナホシ
MIMI
kemu
柊マグネタイト
OSTER project
駄菓子O型
ピノキオピー

J-POP成分

1
2
3
4
5
6
7


ヨルシカ
ZUTOMAYO
Mili
Mrs. GREEN APPLE
P丸様。
ARuFa
CHiCO

音游曲师成分

1
2
3
4
5
6
7


Sta
litmus*
Cranky
ああああ
梅干茶漬け
翡乃イスカ
Mameyudoufu

深夜emo产物

可能会有自我厌弃等负能产出，不会在首页显示，希望没有影响到你的心情(^_<)

fin

感谢你的访问，更感谢你看到这里！