# ti

**Repository Path**: buptybx/ti

## Basic Information

- **Project Name**: ti
- **Description**: https://github.com/wyfan0617/ti
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MSPM0 VS Code 开发环境一键安装器

面向 **TI MSPM0** 系列 MCU 的 VS Code 开发环境一键安装工具。运行一个 GUI 安装器，自动解压工具链、静默安装 TI SysConfig、配置环境变量、安装 VS Code 扩展并完成 CMake 工程配置，开箱即用。

支持在安装时自由选择：

- **芯片型号**：`MSPM0G3507` / `MSPM0G3519`
- **底层驱动方式**：`TI SysConfig + driverlib` / `逐飞（SeekFree）开源库`
- **安装位置**：任意目录（可浏览选择）
- **资源包位置**：可手动选择 `DevEnv.zip`

四种「芯片 × 驱动」组合各自生成独立工程目录，互不覆盖，可在同一台机器上并存。

---

## 目录结构

```
.
├── README.md
├── build.ps1                       # 构建脚本：编译 exe + 打包 DevEnv.zip
├── installer/
│   ├── InstallerScript.ps1         # 安装器主逻辑（GUI + 安装流程，PowerShell）
│   ├── launcher_src/               # C# 启动器源码（把 ps1 包装成 exe）
│   │   ├── Launcher.cs
│   │   ├── AssemblyInfo.cs
│   │   └── app.manifest
│   └── DevEnv/
│       └── MSPM0_VSCODE/           # 工程模板（随仓库分发的核心源码）
│           ├── CMakeLists.txt      # 按芯片/驱动参数化的构建配置
│           ├── CMakePresets.json
│           ├── source/             # driverlib + 逐飞库(zf_g3507/zf_g3519) + FreeRTOS
│           ├── include/            # 对应头文件
│           ├── linker/             # 各芯片链接脚本
│           ├── user/               # 用户代码目录
│           ├── .vscode/            # tasks / launch / c_cpp_properties 等
│           └── variants/           # 四种组合的配套文件（安装时按选择覆盖）
│               ├── sysconfig/{g3507,g3519}/
│               ├── zf/{g3507,g3519}/
│               └── vscode/{sysconfig,zf}_{g3507,g3519}/
```

> **不随仓库分发的大体积内容**（见 `.gitignore`）：ARM-GCC 工具链、CMake、Ninja、OpenOCD、TI MSPM0 SDK、SysConfig 安装包，以及打包好的 `DevEnv.zip`（约 489MB）和编译产物 `Install-MSPM0-Env.exe`。这些需按下文自行准备。

---

## 使用方式（终端用户）

1. 从本仓库的 [**Releases**](../../releases/latest) 页面下载 `Install-MSPM0-Env.exe` 和 `DevEnv.zip` 两个文件，放在**同一目录**下。
   （若想自行构建这两个文件，见下文「从源码构建」。）
2. 双击 `Install-MSPM0-Env.exe`，在弹出的窗口里：
   - 选择/确认 **资源包**（默认取同目录下的 `DevEnv.zip`，也可「浏览…」指定）；
   - 选择 **安装位置**（如 `D:\`，可「浏览…」）；
   - 选择 **芯片型号** 和 **底层驱动方式**；
   - 点 **开始安装**。
3. 安装完成后：
   - 工具链安装在 `<安装位置>\DevEnv\`；
   - 工程生成在 `<安装位置>\Project\<芯片>_<驱动>_VSCODE\`，例如 `D:\Project\MSPM0G3519_ZF_VSCODE\`；
   - 用 VS Code 打开该工程目录即可编译/调试。

### 前置要求

- Windows 10/11
- 已安装 **VS Code**（安装器会调用 `code --install-extension` 自动装扩展，需要能访问扩展市场）
- 自动安装的 VS Code 扩展：`ms-vscode.cpptools`、`ms-vscode.cmake-tools`、`marus25.cortex-debug`、`mcu-debug.peripheral-viewer`、`eclipse-cdt.memory-inspector`、`actboy168.tasks`

### 重复安装 / 多工程并存

- **不同组合**（如先 `3507+逐飞`，后 `3519+逐飞`）生成不同的工程目录，互不影响；第二次安装若检测到工具链环境已存在，会**自动跳过重装**，仅生成新工程（数十秒完成）。
- **相同组合**再次安装会覆盖该组合自己的工程目录 —— 若其中有你写的代码，请先自行备份。

---

## 从源码构建

### 1. 准备 DevEnv 目录

`build.ps1` 会把 `installer/DevEnv/` 整个目录打包成 `DevEnv.zip`。仓库里已包含工程模板 `MSPM0_VSCODE/`，你还需要把以下第三方工具链/SDK 放进 `installer/DevEnv/`，最终结构如下：

```
installer/DevEnv/
├── 10 2021.10/                       # arm-none-eabi-gcc 工具链（GNU Arm Embedded 10.3-2021.10）
├── cmake-4.2.3-windows-x86_64/       # CMake
├── ninja/                            # Ninja
├── OpenOCD-20260121-0.12.0/          # OpenOCD
├── TI/
│   └── mspm0_sdk_2_10_00_04/         # TI MSPM0 SDK（需含 .metadata/product.json、source/ti、source/third_party）
├── sysconfig-1.27.1_4634-setup.exe   # TI SysConfig 安装包（支持 --mode unattended 静默安装）
└── MSPM0_VSCODE/                     # 工程模板（仓库已提供）
```

> 各工具链/SDK 请从对应官方渠道获取（Arm、Kitware、Ninja、OpenOCD、TI）。目录名需与上面完全一致，安装器与 `build.ps1` 按这些固定名字识别；若版本不同，需同步修改 `installer/InstallerScript.ps1` 顶部的 `$script:ToolRoots`、`$script:SdkDirName`、`$script:SysConfigDirName` 等常量。

### 2. 构建

在仓库根目录执行：

```powershell
powershell -ExecutionPolicy Bypass -File build.ps1
```

脚本会：
1. 用 .NET Framework 自带的 `csc.exe` 把 `installer/InstallerScript.ps1` 作为内嵌资源编译进 `installer/Install-MSPM0-Env.exe`；
2. 校验 `installer/DevEnv/` 内容齐全后，打包成 `installer/DevEnv.zip`。

可选参数：`-SkipZip`（只编译 exe）、`-SkipExe`（只打包 zip）。

构建产物即 `installer/Install-MSPM0-Env.exe` + `installer/DevEnv.zip`，分发时放同一目录即可。

### 命令行 / 静默安装

exe 与脚本都支持命令行参数，可用于无人值守安装：

```powershell
Install-MSPM0-Env.exe -InstallRoot "D:\" -Chip MSPM0G3519 -DriverMode ZF -PackagePath ".\DevEnv.zip"
```

| 参数 | 说明 |
| --- | --- |
| `-InstallRoot` | 安装根目录（其下创建 `DevEnv\` 与 `Project\`） |
| `-Chip` | `MSPM0G3507` 或 `MSPM0G3519` |
| `-DriverMode` | `SYSCONFIG` 或 `ZF`（逐飞库） |
| `-PackagePath` | 资源包 `DevEnv.zip` 路径（默认取 exe 同目录） |
| `-ValidatePackageOnly` | 只校验资源包结构，不安装 |
| `-LogPath` / `-SilentLog` | 日志文件路径 / 不在控制台输出 |

---

## 工作原理

- **exe 本体**是一个极简 .NET 启动器：把内嵌的 `InstallerScript.ps1` 释放到临时目录，再以 `powershell.exe -NoProfile -ExecutionPolicy Bypass -File` 执行，并透传全部命令行参数。
- **安装逻辑**全部在 `InstallerScript.ps1`（WinForms GUI + 安装流程）：
  1. 校验 `DevEnv.zip` 结构；
  2. 工具链/SDK 已存在则跳过，否则解压 + 静默安装 SysConfig；
  3. 按「芯片 × 驱动」把工程模板解压为独立目录，并从 `variants/` 覆盖对应的 `ti_msp_dl_config.*`、`*.syscfg`、`.vscode` 配置；
  4. 写工程 `.env`、写用户环境变量；
  5. 安装 VS Code 扩展；
  6. 执行 CMake Configure。
- **工程模板** `CMakeLists.txt` 通过 `MSPM0_CHIP` / `MSPM0_DRIVER_MODE` 两个变量选择启动文件、链接脚本、芯片宏、源码集合（driverlib 或逐飞库），互斥切换。

---

## 说明

- MSPM0G3519 的逐飞库使用逐飞官方 `MSPM0G3519_Library` 仓库源码；其 SysConfig 源文件（`.syscfg`）上游与 3507 版本内容相同（上游遗留问题），本项目改用 TI 官方 G3519 空白模板作为种子，`ti_msp_dl_config.c/h` 仍为逐飞已生成的完整外设初始化代码（详见 `variants/zf/g3519/empty.syscfg` 内注释）。
- 本仓库不含、也不分发任何第三方工具链/SDK 二进制，请从各自官方渠道获取并遵守其许可证。