win下使用vscode插件编译出错

kojak · 发表于昨天 11:23

# Telink Development Tool CMake 转换问题

- 报告日期：2026-10-26
- 插件：Telink Development Tool（扩展 ID `telink.tlk`）v1.4.3
- 严重程度：阻塞级（Windows 下每次转换工程必现）

## 1. 摘要

在 Windows 10 上使用 Telink Development Tool 将 Telink IoT Studio (Eclipse) 工程转换为 CMake 工程后，存在两个可稳定复现的缺陷：

| 编号 | 问题                                                            | 结果                                                          |
| ---- | --------------------------------------------------------------- | ------------------------------------------------------------- |
| 1    | `-DTOOLCHAIN_PATH` 直接使用 Windows 反斜杠路径，模板未规范化    | `cmake configure` 失败，无法生成构建系统                      |
| 2    | 转换后的 post-build 脚本仍按 Eclipse 产物名和旧构建目录深度编写 | `.bin` 不生成，`tl_check_fw2.exe` 无法执行，烧录/校验流程中断 |

两个问题与具体业务代码无关，针对TC_BLE_SINGLE_SDK 转换后均可复现。

## 2. 环境

| 项目           | 值                                                                      |
| -------------- | ----------------------------------------------------------------------- |
| 操作系统       | Windows 10 Pro 10.0.19045（x64）                                        |
| VSCode 扩展    | Telink Development Tool`telink.tlk` 1.4.3                               |
| CMake          | 3.23.5（由插件安装/管理）                                               |
| 生成器         | Unix Makefiles                                                          |
| Make           | `C:\Users\\.Telink_Tools\tc32_130_Windows\bin\make.exe`                 |
| 工具链         | TC32-GCC Toolchain（`tc32_130_Windows`），`tc32-elf-gcc` 4.5.1-tc32-1.3 |
| SDK            | Telink B85`tc_ble_single_sdk`（SDK 版本 `tc_ble_single_sdk_V3.4.3.0`）  |
| Eclipse 工程   | `project/tlsr_tc32/B85/.project`，工程名 `tc_ble_single_sdk_B85`        |
| 转换后目录     | `/CMakeLists.txt`、`/cmake_configs/tc_ble_single_sdk_B85_cmake.json`    |
| CMake 模板版本 | 1.3.0（configure 日志输出）                                             |
| 活动 Target    | `825x_ble_sample`                                                       |

相关 VSCode 配置：

```json
"tlk.TC32-GCC Toolchain": "C:\\Users\\<user>\\.Telink_Tools\\tc32_130_Windows\\tc32"
```

## 3. 复现步骤

1. 安装 Telink Development Tool 1.4.3、CMake 3.23.5、TC32 工具链。
2. 在 VSCode 中打开 Telink B85 SDK，使用插件把 `project/tlsr_tc32/B85` 转换为 CMake 工程。
3. 将活动 Target 设为 `825x_ble_sample`，执行 Build（或 `cmake configure`）。
4. 观察到问题 1，configure 中断。
5. 临时规避问题 1 后再次 Build，观察到问题 2，`.bin` 未生成。

## 4. 问题一：configure 失败（反斜杠路径）

### 4.1 现象

`cmake configure` 在 `project()` 处报错：

```text
-- The ASM compiler identification is GNU
-- Found assembler: C:\Users\<user>\.Telink_Tools\tc32_130_Windows\tc32/bin/tc32-elf-gcc.exe
Error: CMake Error at cmake_builds/.../CMakeFiles/3.23.5/CMakeASMCompiler.cmake:1 (set):
  Syntax error in cmake code at
    .../CMakeFiles/3.23.5/CMakeASMCompiler.cmake:1
  when parsing string
    C:\Users\<user>\.Telink_Tools\tc32_130_Windows\tc32/bin/tc32-elf-gcc.exe
  Invalid character escape '\U'.
Call Stack (most recent call first):
  CMakeLists.txt:124 (project)
```

### 4.2 根因

1. 插件在 `out/cmakeBuild.js` 中拼接 configure 参数时直接使用设置值，未做路径规范化，也未加引号：
   
   ```js
   `-DTOOLCHAIN_PATH=${params.toolchainPath}`
   ```
   
   `params.toolchainPath` 来自 `tlk.TC32-GCC Toolchain` 设置。Windows 下该值由目录选择器写入，使用反斜杠，例如：
   
   ```text
   C:\Users\<user>\.Telink_Tools\tc32_130_Windows\tc32
   ```
2. 生成的 `CMakeLists.txt` 直接把该值拼进编译器路径：
   
   ```cmake
   set(CMAKE_ASM_COMPILER ${TOOLCHAIN_PATH}/bin/tc32-elf-gcc${SUFFIX})
   ```
3. CMake 在执行 `project()` 时需要保存并回读编译器信息，于是写出：
   
   ```cmake
   set(CMAKE_ASM_COMPILER "C:\Users\<user>\.Telink_Tools\tc32_130_Windows\tc32/bin/tc32-elf-gcc.exe")
   ```
   
   CMake 字符串中 `\U` 不是合法转义，回读该文件时即报 `Invalid character escape '\U'`。
4. 补充：`CMakeASMCompiler.cmake` 会在执行 `CMakeLists.txt` 之前被读取。因此仅修改工具链设置或模板，已有的旧构建目录仍会复现同一错误，必须删除一次对应的 `cmake_builds/<project>/<toolchain>` 目录。

### 4.3 影响

- Windows 用户每次转换新工程都会在第一次 configure 失败。
- 设置路径位于用户目录（`.Telink_Tools`）时必现；只要路径中出现 `\U`、`\t`、`\n` 等序列都可能触发同类错误，不仅是 `\U`。

### 4.4 建议修复

任选其一即可，建议同时做防御：

1. **扩展侧（推荐）**：构造 `-D` 参数前统一转换分隔符，并加引号：
   
   ```js
   const toolchainPath = params.toolchainPath.replace(/\\/g, '/');
   `-DTOOLCHAIN_PATH=${toolchainPath}`
   ```
2. **模板侧（推荐）**：在 `CMakeLists.txt` 使用前规范化：
   
   ```cmake
   if(DEFINED TOOLCHAIN_PATH AND NOT TOOLCHAIN_PATH STREQUAL "")
       file(TO_CMAKE_PATH "${TOOLCHAIN_PATH}" TOOLCHAIN_PATH)
   endif()
   ```
3. 修复后建议插件自动清理或提示清理包含旧 `CMakeASMCompiler.cmake` 的构建目录，避免用户升级后仍无法 configure。

kojak · 发表于昨天 11:23

## 5. 问题二：`.bin` 不生成、post-build 校验失败

### 5.1 现象

编译和链接成功，生成 `<target>.elf`，但 post-build 阶段报错，`.bin` 不存在：

```text
tc32-elf-objcopy.exe: 'tc_ble_single_sdk_B85.elf': No such file
tl_check_fw.sh: line 21: ../../../../script/tl_check_fw/tl_check_fw2.exe: No such file or directory
grep: 825x_ble_sample.bin: No such file or directory
no SDK version found at the end of firmware, please check sdk_version.c and sdk_version.h
```

该 target 在 `cmake_configs/tc_ble_single_sdk_B85_cmake.json` 中的配置为：

```json
"post_build": ["${CMAKE_CURRENT_SOURCE_DIR}/project/tlsr_tc32/B85/../../../script/tl_check_fw/tl_check_fw.sh   825x_ble_sample   tc_ble_single_sdk_B85"]
```

`obj_copy` 为空数组，因此 `.bin` 完全由该 post-build 脚本生成；脚本第一步失败后，`.bin` 一定缺失。

### 5.2 根因 A：ELF 产物名不一致

- 原 Eclipse 工程名为 `tc_ble_single_sdk_B85`，原构建产物是 `tc_ble_single_sdk_B85.elf`。
- SDK 的 post-build 脚本按该前提编写（`script/tl_check_fw/tl_check_fw.sh`）：

```bash
  tc32-elf-objcopy -v -O binary $2.elf  $1.bin
  # $1 = 825x_ble_sample（target）
  # $2 = tc_ble_single_sdk_B85（Eclipse 工程名）
  ```
- 转换后的 CMake 工程按 target 命名产物（`add_executable(${TARGET_NAME} ...)`），实际为 `825x_ble_sample.elf`。
- 插件自身也是按 `<target>.elf` / `<target>.bin` 查找产物（`getActiveElf` / `getActiveBin` / `targetOutputDir()`），因此不能简单地把产物改名为工程名，否则会影响插件的产物浏览、烧录和调试。
- 转换器把 Eclipse 的 post-build 命令原样写入 json，没有把 `$2.elf` 改写为 target 产物名，导致 objcopy 输入不存在。

`script/bin_append_crc/bin_append.sh` 存在同样写法。

### 5.3 根因 B：脚本内相对路径的目录深度不匹配

脚本通过相对路径调用辅助工具：

```bash
../../../../script/tl_check_fw/tl_check_fw2.exe
```

这假设 post-build 的工作目录比 SDK 根目录深 4 层：

```text
<SDK>/cmake_builds/<project>/<toolchain>/<target>
```

而生成配置的 `target_output_layout` 为 `legacy`，模板把工作目录设为：

```text
<SDK>/cmake_builds/<project>/<toolchain>          # 只深 3 层
```

因此 `../../../../script` 被解析到 `<父目录>/script`，而不是 `<SDK>/script`。实测：

```bash
# 在 legacy 构建目录中
ls ../../../../script/tl_check_fw/   # No such file
ls ../../../script/tl_check_fw/      # OK
```

即脚本是按旧布局（4 层，等价于 `per_target`）编写的，与默认的 `legacy` 布局不一致。

### 5.4 影响

- 所有带 post-build 校验/CRC 追加的 target 都不会生成 `<target>.bin`。
- 插件的“获取 Active Bin”、烧录、校验、SDK 版本检查均不可用。
- 同一 SDK 的 13 个 target 全部受影响。

### 5.5 建议修复

建议在转换阶段解决，而不是要求用户逐个修改 SDK 脚本：

1. **首选：显式传递产物路径。** 模板在 post-build 中把 ELF 的绝对路径传给脚本，例如使用 `$<TARGET_FILE<img src="static/image/smiley/default/shy.gif" smilieid="8" border="0" alt="" />{TARGET_NAME}>`，或设置环境变量（如 `TLK_TARGET_ELF` / `TLK_TARGET_BIN`）。脚本优先使用显式路径，`$1.elf` 作为兼容回退。
2. **次选：转换时改写脚本。**
   - `$2.elf` → `$1.elf`（CMake target 产物名）；
   - 把 `(../)+script/...` 改为基于脚本自身目录的路径，例如 `$SCRIPT_DIR/...`；
   - 对所有参数加引号。
3. **不建议只改布局。** 把 `target_output_layout` 设为 `per_target` 只能修正问题 B 的目录深度，无法修正问题 A 的产物名，仍会失败。
4. 模板中的 post-build 工作目录建议明确为 target 输出目录，并保证脚本不依赖相对层级。

## 6. 本地临时规避与验证结果

为继续项目开发，本地做了如下临时修补（仅用于验证，不代表正式修复方案）：

1. 将 `tlk.TC32-GCC Toolchain` 改为正斜杠：
   `C:/Users/<user>/.Telink_Tools/tc32_130_Windows/tc32`
2. 在生成的 `CMakeLists.txt` 中注入：

```cmake
   if(DEFINED TOOLCHAIN_PATH AND NOT TOOLCHAIN_PATH STREQUAL "")
       file(TO_CMAKE_PATH "${TOOLCHAIN_PATH}" TOOLCHAIN_PATH)
   endif()
   ```

```

3. 把两个 post-build 脚本改为使用 target 产物名和脚本自身目录：

- `script/tl_check_fw/tl_check_fw.sh`
   - `script/bin_append_crc/bin_append.sh`

```bash
   SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
   tc32-elf-objcopy -v -O binary "$1.elf" "$1.bin"
   "$SCRIPT_DIR/tl_check_fw2.exe" "$1.bin"
   ```
4. 删除旧构建目录中损坏的 `CMakeASMCompiler.cmake` 后重新 configure。

验证结果：

| 项目                                     | 结果                               |
| ---------------------------------------- | ---------------------------------- |
| `cmake configure`                        | 通过，13 个 target 全部生成        |
| `cmake --build --target 825x_ble_sample` | 通过                               |
| `825x_ble_sample.elf`                    | 158,430 字节                       |
| `825x_ble_sample.bin`                    | 55,300 字节（已生成）              |
| `tl_check_fw2.exe`                       | 执行成功，输出`output done!`       |
| SDK 版本检查                             | 识别到`tc_ble_single_sdk_V3.4.3.0` |

## 7. 期望

1. 在后续版本的 Telink Development Tool 中修复上述两个转换问题，Windows 下新建/转换工程开箱即用。

TL_XINSHENG · 发表于 9 小时前

[IDE工具] win下使用vscode插件编译出错