![20250404-DSC_1337.JPG](/static/img/4850d2415a1ced6a41b5b26ed3b0d48c.20250404-DSC_1337.webp)

暂未开工……

【赛博考古】Hewlett-Packard 34401A 6½ Multimeter

![](https://blog.polaristation.fun/static/img/2f831fc6d8253bbb9981c929edf45a45.CherryUSB.svg)
近日，从[**前一篇文章**](https://blog.polaristation.fun/post/letter_shell-segger_rtt)的原作者那边了解到了一个名为 **Letter Shell** 的轻量型终端，可以非常方便地移植部署到 STM32 上。但是，由于使用的是J-Link RTT Viewer作为命令行终端进行交互，如果需要使用通用的终端软件（例如**MobaXterm**）时，就必需要借助一个SEGGER RTT转Telnet的转换软件，感觉甚是不便。

正好最近在研究 **STM32** 的 **USB** 协议，**USB** 作为通用传输协议，可支持枚举非常多类型的设备，其中就有 **CDC（虚拟串口）** 设备，那么，我们是不是可以将 Letter Shell 终端对接到 USB 的 CDC 设备上就可以实现用**一根 USB 连接线**插入电脑后直接用**支持串口连接的终端软件**进行交互呢？

:::note{title="注"}
本文基于 **CherryUSB 1.4.4** 进行移植，开发环境使用 **VSCode EIDE + MakeFile + GCC编译器** ，类似开发环境的可以作为参考。

本文所有内容均基于STM32裸机开发，没有使用任何OS。

作者并非专业软件开发者，文中难免有些地方用词或说法不严谨，**仅供参考**，还请见谅。
:::


## 移植 CherryUSB 协议栈
本部分参考官方文档的[**基于现有demo快速验证>基于ST系列芯片**](https://cherryusb.readthedocs.io/zh-cn/latest/quick_start/demo.html)。

因为ST官方的USB协议栈中间层写的有些💩，所以我此次使用的是目前仍在持续更新的开源嵌入式USB主从协议栈—— [**CherryUSB**](https://cherryusb.readthedocs.io/zh-cn/latest/quick_start/start.html)。**官方文档写的还是比较详细的**，但因为要兼容很多平台的嵌入式设备所以显得有些零碎，如果只是要移植单一平台的话还需要来回翻找，初学者 ~~（没错就是我）~~ 看起来可能会有点晕，所以本篇会手把手一步步地介绍移植过程。

:::tip{title="提示"}
如果本身有较丰富开发经验的也可以直接参照官方文档进行移植，因为目前这个协议栈还在持续更新，所以**本篇博客并不能保证长期有效性**。

**此外还有一点需要注意**，截至本篇博客撰写时，前文所引用的[**官方文档网页**](https://cherryusb.readthedocs.io/zh-cn/latest/quick_start/start.html)仍是**1.4.3**版本的使用文档，而**GitHub仓库**目前已更新至**1.4.4**版本，两版本间的移植流程有细微区别，建议直接参考拉取的最新项目源码文件夹内的 **/docs/source/quick_start/** 文件夹下的文档进行移植。
:::

目前互联网上我找到的比较详细的几篇 **CherryUSB** 移植教程：

- [**在STM32G4上移植CherryUSB协议栈（usb_device）**](https://mdlzcool.github.io/post/fb4bb4c3.html)
- [**CherryUSB STM32F4 MSC+ACM HS ExPhy**](https://gitee.com/xundu-ren/cherry_f405_hsphy)
- [**CherryUSB移植笔记
APM32F407VGT6 DWC2移植**](https://club.rt-thread.org/ask/article/3e893614c58da7aa.html)

这几篇文章的作者分别使用 **CLion**、**Keil**、 **Visual Studio**  进行开发，前两篇分别涉及使用了`fsdev`和`dwc2`IP的STM32芯片，可以先阅读以上文章进行了解。

### 使用CubeMX创建工程
这边没有太多可说的，请直接参考[**官方文档**](https://cherryusb.readthedocs.io/zh-cn/latest/quick_start/demo.html)。

唯二需要注意的是本文的例程使用 **MakeFile+GCC** 进行编译，所以在“**Project Manager>Project**”部分的“**Toolchain/IDE**”需要选择“**MakeFile**”；以及**堆栈大小**需要给大些。

![image.png](/static/img/62b549fa9a1adc7f662108c8354edbea.image.webp)

### 拉取 CherryUSB 协议栈源码
首先确保电脑上已正确安装git，使用命令行将工作目录切换到用于保存CherryUSB源码的目录下，使用`git clone`命令拉取该项目GitHub仓库的源码：
```bash
git clone https://github.com/cherry-embedded/CherryUSB.git
```
如果没有科学上网环境，也可以使用Gitee仓库拉取：
```bash
git clone https://gitee.com/woodman_112/CherryUSB.git
```
这两个仓库**均由官方开发者维护**，但是GitHub仓库更新频率会更高些。

拉取的项目源码文件目录结构应当如下：
```
CherryUSB
├─.github
│  ├─ISSUE_TEMPLATE
│  └─workflows
├─class
│  ├─adb
│  ├─aoa
│  ├─audio
│  ├─cdc
│  ├─dfu
│  ├─hid
│  ├─hub
│  ├─midi
│  ├─msc
│  ├─template
│  ├─vendor
│  │  ├─net
│  │  ├─serial
│  │  ├─wifi
│  │  └─xbox
│  ├─video
│  └─wireless
├─common
├─core
├─demo
│  ├─adb
│  └─bootuf2
├─docs
│  ├─assets
│  └─source
│      ├─api
│      │  └─img
│      ├─class
│      ├─demo
│      ├─quick_start
│      │  └─img
│      ├─support
│      │  └─img
│      ├─tools
│      │  └─img
│      ├─usb
│      │  └─img
│      └─usbip
├─osal
│  └─idf
├─platform
│  ├─lvgl
│  ├─none
│  ├─nuttx
│  ├─rtthread
│  └─threadx
├─port
│  ├─aic
│  ├─bouffalolab
│  ├─ch32
│  ├─chipidea
│  ├─dwc2
│  ├─ehci
│  ├─fsdev
│  ├─hpm
│  ├─kinetis
│  ├─musb
│  ├─nuvoton
│  ├─ohci
│  ├─pusb2
│  │  ├─freertos
│  │  ├─rt-thread
│  │  └─standalone
│  ├─rp2040
│  ├─template
│  └─xhci
│      └─phytium
│          ├─freertos
│          └─rt-thread
├─third_party
│  ├─cherrymp
│  ├─cherryrb
│  ├─dhcp-server
│  ├─dns-server
│  ├─fatfs-0.14
│  │  └─source
│  │      └─port
│  ├─FreeRTOS-10.4
│  │  ├─include
│  │  └─portable
│  │      ├─GCC
│  │      │  ├─ARM_CM0
│  │      │  ├─ARM_CM3
│  │      │  ├─ARM_CM3_MPU
│  │      │  ├─ARM_CM4F
│  │      │  ├─ARM_CM4_MPU
│  │      │  └─ARM_CM7
│  │      │      └─r0p1
│  │      ├─IAR
│  │      │  ├─ARM_CM0
│  │      │  ├─ARM_CM3
│  │      │  ├─ARM_CM4F
│  │      │  ├─ARM_CM4F_MPU
│  │      │  └─ARM_CM7
│  │      │      └─r0p1
│  │      ├─MemMang
│  │      └─RVDS
│  │          ├─ARM_CM0
│  │          ├─ARM_CM3
│  │          ├─ARM_CM4F
│  │          ├─ARM_CM4_MPU
│  │          └─ARM_CM7
│  │              └─r0p1
│  ├─lwip-2.1.2
│  ├─nimble-1.6.0
│  │  ├─nimble
│  │  └─porting
│  │      ├─nimble
│  │      │  ├─include
│  │      │  │  ├─mem
│  │      │  │  ├─nimble
│  │      │  │  ├─os
│  │      │  │  ├─stats
│  │      │  │  ├─sysflash
│  │      │  │  └─sysinit
│  │      │  └─src
│  │      └─npl
│  │          └─freertos
│  │              ├─include
│  │              │  ├─console
│  │              │  ├─nimble
│  │              │  └─syscfg
│  │              └─src
│  └─zephyr_bluetooth-2.7.5
│      └─zephyr_bluetooth
└─tools
    ├─audacity
    ├─chryusb_configurator
    ├─packet capture
    ├─stm32_dfuse
    ├─test_srcipts
    └─uf2
```

### 拷贝所需代码到项目源码
拉取的项目源码中有非常多的文件，但是对于本部分，我们只需关注`class`、`common`、`core`、`port`这几个文件夹下的内容。

|文件夹名|用途|
|:-|:-:|
|class|**USB枚举设备类型**，里面有很多子文件夹，一个子文件夹对应一种USB设备类型，根据需要进行选择保留|
|common|CherryUSB内部使用的一些代码，**我们对里面的内容无需做任何更改**|
|core|CherryUSB核心代码，**我们对里面的内容无需做任何更改**|
|port|用于对接设备 **USB IP** 的相关代码，与设备所使用的 USB PHY 类型相关，要根据实际进行选择，**STM32** 中所使用的为 **`dwc2`** 和 **`fsdev`** 其中的一种，可根据 **CubeMX** 配置项或手册进行判断|

虽然有的教程说可以一股脑把全部CherryUSB源码都复制到项目目录下，但是为了保证项目目录的整洁，我个人还是建议仅保留需要的源码文件到项目内即可。

#### 1. **`class`文件夹**：
本文参考 CherryUSB 例程实现在单一USB端口上枚举CDC（虚拟串口）~~和MSC（大容量存储设备）两种不同~~类型的USB设备。所以`class`目录下理应只需要保留`cdc`~~和`msc`两个~~文件夹即可，但是`core`文件夹下的`usbh_core.h`头文件中包含了`hub`文件夹中的文件，所以不论需要枚举什么类型的设备`hub`文件夹都应当保留，不然编译时可能会出现“无法找到对应文件”的错误。
![image.png](/static/img/439757713f4d880549f1b9b268027708.image.webp)

#### 2. `common`文件夹
**不用删改，全部保留。**

#### 3. `core`文件夹
**不用删改，全部保留。**

#### 4. `port`文件夹
根据设备实际的 USB IP 来选择。这里介绍根据CubeMX中配置项来判断的方法。

##### 使用`fsdev`
- 如果**CubeMX**中“**Connectivity**”选项栏下为“**USB**”选项，则该芯片使用的 **USB IP 为`fsdev`**。这里以**STM32L443RCT6**为例:

![image.png](/static/img/8a61fa062cddfd67cb50e7741b630026.image.webp)

- 如果芯片是使用这个IP的话就直接保留`port`/`fsdev`文件夹即可，**不用做其他修改**。

- **最后保留的目录结构应当如下：**
```
CherryUSB
├─class
│  ├─cdc
│  
│  └─hub
├─common
├─core
└─port
   └─fsdev
```
- 将保留的源码放到项目目录下合适位置，并且在EIDE工程配置中将上述文件夹添加到源码目录和包含目录即可。

##### 使用`dwc2`
- 如果 **CubeMX** 中“**Connectivity**”选项栏下为“**USB_OTG_FS**”和“**USB_OTG_HS**”之中的两项或一项，则该芯片使用的 **USB IP 为`dwc2`**。这里以**STM32F401CEU6**为例:

![image.png](/static/img/2e6f7a68c739f1b9944e9ae4e6fc74e3.image.webp)

- 如果芯片是使用这个IP的话则需要注意，在`port`/`dwc2`文件夹下，有多个名为`usb_glue_xxx.c`的文件，这是用于对接不同MCU平台的代码，对于STM32仅需保留ST结尾的glue源码文件，不然会导致在编译时出现一堆“**未知变量类型**”或“**函数重复定义**”之类的奇怪错误。

![image.png](/static/img/90d251f14d3f6acb6380bc1184de4398.image.webp)

![image.png](/static/img/3d47b3e4367c20c344f9c51aa2810bf3.image.webp)

- **最后保留的目录结构应当如下：**
```
CherryUSB
├─class
│  ├─cdc
│  
│  └─hub
├─common
├─core
└─port
   └─dwc2
```
- 将保留的源码放到项目目录下合适位置，并且在EIDE工程配置中将上述文件夹添加到源码目录和包含目录即可。

:::tip{title="提示"}
对于使用了`dwc2`的 STM32 芯片这里还有一点需要注意，虽然有些型号的配置选项中有“**USB_OTG_HS**”选项，但是实际上 MCU 内集成的 USB PHY 仅支持 FS（Full Speed 12Mbps），而如果想要实现 HS（High Speed 480Mbps）必须要外挂支持 HS 的 PHY 芯片，并通过 ULPI（USB Link Power Interface）与 MCU 的 USB_OTG_HS 接口连接才能真正实现 High Speed USB。仅有少部分高端型号（F7、H7系列）拥有真正的内置HS USB PHY，而无需外挂PHY芯片来实现。
:::

### 添加 CherryUSB 协议栈初始化函数到main.c
将CherryUSB源码准备完毕后即可准备将初始化函数添加到main.c中，从而实现使用CherryUSB协议栈初始化STM32的USB外设，让电脑之类的主设备（Host）正确识别STM32所枚举的USB从设备（Device）。

在这一步我们需要关注CherryUSB源码根目录下的 **`cherryusb_config_template.h`** 文件和 **`demo`** 文件夹下的内容。

#### 编辑`usb_config.h`
将CherryUSB根目录下的`cherryusb_config_template.h`文件复制到 `Core`\ `Inc` 文件夹中，并重命名为`usb_config.h`。

该文件用于保存CherryUSB的配置参数，对此我们只需关注如下部分配置项：
```c
/* ================ USB Device Port Configuration ================*/

#ifndef CONFIG_USBDEV_MAX_BUS
#define CONFIG_USBDEV_MAX_BUS 1 // for now, bus num must be 1 except hpm ip
#endif

#ifndef CONFIG_USBDEV_EP_NUM
#define CONFIG_USBDEV_EP_NUM 8
#endif

/* When your chip hardware supports high-speed and wants to initialize it in high-speed mode, the relevant IP will configure the internal or external high-speed PHY according to CONFIG_USB_HS. */
// #define CONFIG_USB_HS

/* ---------------- FSDEV Configuration ---------------- */
//#define CONFIG_USBDEV_FSDEV_PMA_ACCESS 2 // maybe 1 or 2, many chips may have a difference

/* ---------------- DWC2 Configuration ---------------- */
/* (5 * number of control endpoints + 8) + ((largest USB packet used / 4) + 1 for
 * status information) + (2 * number of OUT endpoints) + 1 for Global NAK
 */
// #define CONFIG_USB_DWC2_RXALL_FIFO_SIZE (1024 / 4)
/* IN Endpoints Max packet Size / 4 */
// #define CONFIG_USB_DWC2_TX0_FIFO_SIZE (64 / 4)
// #define CONFIG_USB_DWC2_TX1_FIFO_SIZE (1024 / 4)
// #define CONFIG_USB_DWC2_TX2_FIFO_SIZE (64 / 4)
// #define CONFIG_USB_DWC2_TX3_FIFO_SIZE (64 / 4)
// #define CONFIG_USB_DWC2_TX4_FIFO_SIZE (0 / 4)
// #define CONFIG_USB_DWC2_TX5_FIFO_SIZE (0 / 4)
// #define CONFIG_USB_DWC2_TX6_FIFO_SIZE (0 / 4)
// #define CONFIG_USB_DWC2_TX7_FIFO_SIZE (0 / 4)
// #define CONFIG_USB_DWC2_TX8_FIFO_SIZE (0 / 4)

// #define CONFIG_USB_DWC2_DMA_ENABLE

/* ---------------- MUSB Configuration ---------------- */
// #define CONFIG_USB_MUSB_SUNXI
```
每一部分的作用注释已经标注清楚了。

##### 使用`fsdev`
- 如果设备使用的是 `fsdev` IP，那么需要在配置文件中实现以下宏：
```c
#ifndef CONFIG_USBDEV_EP_NUM
#define CONFIG_USBDEV_EP_NUM 8 // 设备支持的最大USB端点（End Point）数，STM32一般为8个，需要根据具体设备判断
#endif

/* ---------------- FSDEV Configuration ---------------- */
#define CONFIG_USBDEV_FSDEV_PMA_ACCESS 2 
```

##### 使用`dwc2`
- 如果设备使用的是 `dwc2` IP，那么需要在配置文件中实现以下宏：
```c
#ifndef CONFIG_USBDEV_EP_NUM
#define CONFIG_USBDEV_EP_NUM 8 // 设备支持的最大USB端点（End Point）数，STM32一般为8个，需要根据具体设备判断
#endif

/* ---------------- DWC2 Configuration ---------------- */
/* (5 * number of control endpoints + 8) + ((largest USB packet used / 4) + 1 for
 * status information) + (2 * number of OUT endpoints) + 1 for Global NAK
 */
#define CONFIG_USB_DWC2_RXALL_FIFO_SIZE (1024 / 4)
/* IN Endpoints Max packet Size / 4 */
#define CONFIG_USB_DWC2_TX0_FIFO_SIZE (64 / 4)
#define CONFIG_USB_DWC2_TX1_FIFO_SIZE (64 / 4)
#define CONFIG_USB_DWC2_TX2_FIFO_SIZE (64 / 4)
#define CONFIG_USB_DWC2_TX3_FIFO_SIZE (64 / 4)
#define CONFIG_USB_DWC2_TX4_FIFO_SIZE (64 / 4)
#define CONFIG_USB_DWC2_TX5_FIFO_SIZE (64 / 4)
#define CONFIG_USB_DWC2_TX6_FIFO_SIZE (64 / 4)
#define CONFIG_USB_DWC2_TX7_FIFO_SIZE (64 / 4)
#define CONFIG_USB_DWC2_TX8_FIFO_SIZE (64 / 4) 
// 这边FIFO_SIZE的配置仅为最基础配置，想要达到硬件的全部性能还需要自己尝试修改
```

#### 添加CherryUSB协议栈初始化函数
在CherryUSB源码中的`demo`目录下有很多“template”结尾的文件，这些都是开发者编写好的示例顶层函数，一般来说我们直接拿去用就行。

比如我这里是要实现USB CDC功能，那么就只要把`cdc_acm_template.c`文件复制到工程目录下就可以了，我是直接放到`main.c`文件的同目录下，另有一个`cdc_ecm_template.c`并不属于本例程的使用范畴。

:::tip{title="提示"}
CDC **ACM**（Abstract Control Model）和 **ECM**（Ethernet Networking Control Model）是两种可以实现CDC功能的USB通信子类协议，其区别在于：
- ACM：
    - 数据与AT指令通过独立通道传输，或混合在同一数据流中（需解析指令与数据的边界）。
    - 适用于需要双向控制指令交互的场景，例如通过AT指令配置蜂窝模块。
- ECM：
    - 直接封装以太网帧并通过USB批量传输端点发送，无需额外解析协议，操作系统视其为标准网卡。
    - 每个数据包独立传输，效率受限（相比改进版NCM协议）。
:::

在`cdc_acm_template.c`中有一个名为`void cdc_acm_init`的函数，这个就是整个协议栈的初始化函数，只要在`main.c`中的系统开机初始化阶段调用这个函数就可以正常初始化对应功能的USB协议栈。
```c
// CherryUSB协议栈初始化函数
void cdc_acm_init(uint8_t busid, uintptr_t reg_base)
{
    ...
}
```

因为这个 .c 文件没有对应的头文件来声明函数原型，所以可以直接在main.c中的系统初始化部分使用如下方法直接调用该函数：
```c
/* Initialize all configured peripherals */
...

/* USER CODE BEGIN 2 */

// USB Device CDC Init
extern void cdc_acm_init(uint8_t busid, uint32_t reg_base);
cdc_acm_init(0, USB_OTG_FS_PERIPH_BASE);

...
/* USER CODE END 2 */
```

添加完成后尝试进行编译，如果没有出现报错的话，那么理论上USB协议栈就已经可以正常工作了。此时如果将单片机的USB接口连接至电脑，应当会有设备插入的提示音，并且在（Windows）设备管理器的“端口（COM和LPT）”中应当就可以看到单片机枚举的CDC设备了。

![image.png](/static/img/335d5284e6b5a2378e5d8519b44ec699.image.webp)

并且如果你没有修改`cdc_acm_template.c`文件中开头部分的USB设备的描述符内容的话，在Windows 10的`设置`>`设备`>`蓝牙和其他设备`中应当能看到如下图所示的设备连接到你的电脑。

![image.png](/static/img/35bed7e06a106829966e32ee95e2dcde.image.webp)

如果结果和我截图中所示相符，那么恭喜你，CherryUSB协议栈已经移植成功，CDC功能已经可以正常运行了！

## 对接LetterShell终端与USB CDC
这部分的工作主要就两件：
1. 找到CDC的收发函数，并理清楚所需传入的参数；
2. 修改LetterShell的收发函数，将其与CDC的收发函数对接。

整合LetterShell和CherryUSB功能到STM32

![未标题-1.png](https://blog.polaristation.fun/static/img/ddb313478e20fb92263c6cbe1488f472.%C3%A6%C2%9C%C2%AA%C3%A6%C2%A0%C2%87%C3%A9%C2%A2%C2%98-1.webp)
最近了解到了Letter Shell这个轻量级的命令行，看了一下官方给出的例程，可以移植到SEGGER RTT上，于是尝试了一下，记录一下过程。



## 下载Letter Shell
首先从GitHub上拉取Letter Shell的源码：https://github.com/NevermindZZT/letter-shell   
**建议将Github上的说明文档仔细看一遍再参考我下面的教程。**

## 下载SEGGER RTT
然后从JLink的安装目录下将SEGGER RTT的库文件拷贝出来，库文件一般在**Jlink安装目录/Samples/RTT**下面
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/RTT目录.png)

## 移植SEGGER RTT
将RTT的库文件拷贝到你的工程里面，设置好文件路径，在文件中包含RTT的头文件**SEGGER_RTT.h** ，然后在main函数中调用SEGGER_RTT_printf()，随意打印一些东西，编译下载运行。插上Jlink，用J-Link RTT Viewer连接单片机，如果能够打印出东西，说明RTT已经移植成功。   
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/RTT测试.png)   
运行结果如下：   
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/RTT测试结果.png)   

## 移植Letter Shell
同样将Letter Shell的库文件拷贝到你的工程中，并设置好文件路径。   

### 新建shell_port.h和.c文件
shell_port.h和.c文件用于shell和外部接口的对接，包括读写函数和初始化shell的函数。这里是将shell对接到了RTT的通道0上面。我的这两个文件如下：

shell_port.h:
```c
    /**
    * @file shell_port.h
    * @author Letter (NevermindZZT@gmail.com)
    * @brief 
    * @version 0.1
    * @date 2019-02-22
    * 
    * @copyright (c) 2019 Letter
    * 
    */

    /*
        加在.rodata :
       _shell_command_start = .;
        KEEP (*(shellCommand))
        _shell_command_end = .;
    */

    #ifndef __SHELL_PORT_H__
    #define __SHELL_PORT_H__


    #include "shell.h"
    #include <stdbool.h>

    extern Shell rttShell;

    void rttShellInit(void);
    short rttShellRead(char *data, unsigned short len);
    short rttShellWrite(char *data, unsigned short len);
    #endif
```


shell_port.c:
```c
    /**
    * @file shell_port.c
    * @author Letter (NevermindZZT@gmail.com)
    * @brief 
    * @version 0.1
    * @date 2019-02-22
    * 
    * @copyright (c) 2019 Letter
    * 
    */

    #include "shell.h"
    #include "shell_port.h"
    #include "SEGGER_RTT.h"

    Shell rttShell;
    char rttShellBuffer[512];

    /**
    * @brief rtt shell写
    *
    * @param data 数据
    * @param len 数据长度
    *
    * @return short 实际写入的数据长度
    */
    short rttShellWrite(char *data, unsigned short len)
    {
        static int blocked = 0;
        unsigned int time  = HAL_GetTick();
        short avail        = 0;
        short write        = 0;
        short wrote        = 0;
        do {
            avail = SEGGER_RTT_GetAvailWriteSpace(0);
            if (avail <= 0) {
                if (blocked > 10) {
                    return 0;
                }
                HAL_Delay(1);
                blocked++;
            } else {
                blocked = 0;
                write   = avail >= len ? len : avail;
                SEGGER_RTT_Write(0, data, write);
                data += write;
                len -= write;
                wrote += write;
            }
        } while (len > 0 && HAL_GetTick() - time < 10);
        return wrote;
    }

    /**
    * @brief rtt shell读
    *
    * @param data 数据
    * @param len 数据长度
    *
    * @return short 实际读取的数据长度
    */
    short rttShellRead(char *data, unsigned short len)
    {
        return SEGGER_RTT_Read(0, data, len);
    }

    /**
    * @brief 用户shell初始化
    *
    */
    void rttShellInit(void)
    {
        rttShell.write = rttShellWrite;
        rttShell.read  = rttShellRead;
        shellInit(&rttShell, rttShellBuffer, 512);
    }

```  
### 修改shell_cfg.h
然后根据需要修改**shell_cfg.h**中的配置，我的配置如下：   
```c
/**
 * @file shell_cfg.h
 * @author Letter (nevermindzzt@gmail.com)
 * @brief shell config
 * @version 3.0.0
 * @date 2019-12-31
 * 
 * @copyright (c) 2019 Letter
 * 
 */

#include "main.h"

#ifndef __SHELL_CFG_H__
#define __SHELL_CFG_H__

#ifdef SHELL_CFG_USER
#include SHELL_CFG_USER
#endif

#ifndef SHELL_TASK_WHILE
/**
 * @brief 是否使用默认shell任务while循环
 *        使能此宏，则`shellTask()`函数会一直循环读取输入，一般使用操作系统建立shell
 *        任务时使能此宏，关闭此宏的情况下，一般适用于无操作系统，在主循环中调用`shellTask()`
 */
#define     SHELL_TASK_WHILE            0
#endif /** SHELL_TASK_WHILE */

#ifndef SHELL_USING_CMD_EXPORT
/**
 * @brief 是否使用命令导出方式
 *        使能此宏后，可以使用`SHELL_EXPORT_CMD()`等导出命令
 *        定义shell命令，关闭此宏的情况下，需要使用命令表的方式
 */
#define     SHELL_USING_CMD_EXPORT      1
#endif /** SHELL_USING_CMD_EXPORT */

#ifndef SHELL_USING_COMPANION
/**
 * @brief 是否使用shell伴生对象
 *        一些扩展的组件(文件系统支持，日志工具等)需要使用伴生对象
 */
#define     SHELL_USING_COMPANION       0
#endif /** SHELL_USING_COMPANION */

#ifndef SHELL_SUPPORT_END_LINE
/**
 * @brief 支持shell尾行模式
 */
#define     SHELL_SUPPORT_END_LINE      0
#endif /** SHELL_SUPPORT_END_LINE */

#ifndef SHELL_HELP_LIST_USER
/**
 * @brief 是否在输出命令列表中列出用户
 */
#define     SHELL_HELP_LIST_USER        0
#endif /** SHELL_HELP_LIST_USER */

#ifndef SHELL_HELP_LIST_VAR
/**
 * @brief 是否在输出命令列表中列出变量
 */
#define     SHELL_HELP_LIST_VAR         0
#endif /** SHELL_HELP_LIST_VAR */

#ifndef SHELL_HELP_LIST_KEY
/**
 * @brief 是否在输出命令列表中列出按键
 */
#define     SHELL_HELP_LIST_KEY         0
#endif /** SHELL_HELP_LIST_KEY */

#ifndef SHELL_HELP_SHOW_PERMISSION
/**
 * @brief 是否在输出命令列表中展示命令权限
 */
#define     SHELL_HELP_SHOW_PERMISSION  1
#endif /** SHELL_HELP_SHOW_PERMISSION */

#ifndef SHELL_ENTER_LF
/**
 * @brief 使用LF作为命令行回车触发
 *        可以和SHELL_ENTER_CR同时开启
 */
#define     SHELL_ENTER_LF              1
#endif /** SHELL_ENTER_LF */

#ifndef SHELL_ENTER_CR
/**
 * @brief 使用CR作为命令行回车触发
 *        可以和SHELL_ENTER_LF同时开启
 */
#define     SHELL_ENTER_CR              1
#endif /** SHELL_ENTER_CR */

#ifndef SHELL_ENTER_CRLF
/**
 * @brief 使用CRLF作为命令行回车触发
 *        不可以和SHELL_ENTER_LF或SHELL_ENTER_CR同时开启
 */
#define     SHELL_ENTER_CRLF            0
#endif /** SHELL_ENTER_CRLF */

#ifndef SHELL_EXEC_UNDEF_FUNC
/**
 * @brief 使用执行未导出函数的功能
 *        启用后，可以通过`exec [addr] [args]`直接执行对应地址的函数
 * @attention 如果地址错误，可能会直接引起程序崩溃
 */
#define     SHELL_EXEC_UNDEF_FUNC       0
#endif /** SHELL_EXEC_UNDEF_FUNC */

#ifndef SHELL_PARAMETER_MAX_NUMBER
/**
 * @brief shell命令参数最大数量
 *        包含命令名在内，超过16个参数并且使用了参数自动转换的情况下，需要修改源码
 */
#define     SHELL_PARAMETER_MAX_NUMBER  8
#endif /** SHELL_PARAMETER_MAX_NUMBER */

#ifndef SHELL_HISTORY_MAX_NUMBER
/**
 * @brief 历史命令记录数量
 */
#define     SHELL_HISTORY_MAX_NUMBER    5
#endif /** SHELL_HISTORY_MAX_NUMBER */

#ifndef SHELL_DOUBLE_CLICK_TIME
/**
 * @brief 双击间隔(ms)
 *        使能宏`SHELL_LONG_HELP`后此宏生效，定义双击tab补全help的时间间隔
 */
#define     SHELL_DOUBLE_CLICK_TIME     200
#endif /** SHELL_DOUBLE_CLICK_TIME */

#ifndef SHELL_QUICK_HELP
/**
 * @brief 快速帮助
 *        作用于双击tab的场景，当使能此宏时，双击tab不会对命令进行help补全，而是直接显示对应命令的帮助信息
 */
#define     SHELL_QUICK_HELP            1
#endif /** SHELL_QUICK_HELP */

#ifndef SHELL_KEEP_RETURN_VALUE
/**
 * @brief 保存命令返回值
 *        开启后会默认定义一个`RETVAL`变量，会保存上一次命令执行的返回值，可以在随后的命令中进行调用
 *        如果命令的`SHELL_CMD_DISABLE_RETURN`标志被设置，则该命令不会更新`RETVAL`
 */
#define     SHELL_KEEP_RETURN_VALUE     0
#endif /** SHELL_KEEP_RETURN_VALUE */

#ifndef SHELL_MAX_NUMBER
/**
 * @brief 管理的最大shell数量
 */
#define     SHELL_MAX_NUMBER            5
#endif /** SHELL_MAX_NUMBER */

#ifndef SHELL_PRINT_BUFFER
/**
 * @brief shell格式化输出的缓冲大小
 *        为0时不使用shell格式化输出
 */
#define     SHELL_PRINT_BUFFER          128
#endif /** SHELL_PRINT_BUFFER */

#ifndef SHELL_SCAN_BUFFER
/**
 * @brief shell格式化输入的缓冲大小
 *        为0时不使用shell格式化输入
 * @note shell格式化输入会阻塞shellTask, 仅适用于在有操作系统的情况下使用
 */
#define     SHELL_SCAN_BUFFER          0
#endif /** SHELL_SCAN_BUFFER */

#ifndef SHELL_GET_TICK
/**
 * @brief 获取系统时间(ms)
 *        定义此宏为获取系统Tick，如`HAL_GetTick()`
 * @note 此宏不定义时无法使用双击tab补全命令help，无法使用shell超时锁定
 */
#define     SHELL_GET_TICK()            HAL_GetTick()
#endif /** SHELL_GET_TICK */

#ifndef SHELL_USING_LOCK
/**
 * @brief 使用锁
 * @note 使用shell锁时，需要对加锁和解锁进行实现
 */
#define     SHELL_USING_LOCK            0
#endif /** SHELL_USING_LOCK */

#ifndef SHELL_MALLOC
/**
 * @brief shell内存分配
 *        shell本身不需要此接口，若使用shell伴生对象，需要进行定义
 */
#define     SHELL_MALLOC(size)          0
#endif /** SHELL_MALLOC */

#ifndef SHELL_FREE
/**
 * @brief shell内存释放
 *        shell本身不需要此接口，若使用shell伴生对象，需要进行定义
 */
#define     SHELL_FREE(obj)             0
#endif /** SHELL_FREE */

#ifndef SHELL_SHOW_INFO
/**
 * @brief 是否显示shell信息
 */
#define     SHELL_SHOW_INFO             1
#endif /** SHELL_SHOW_INFO */

#ifndef SHELL_CLS_WHEN_LOGIN
/**
 * @brief 是否在登录后清除命令行
 */
#define     SHELL_CLS_WHEN_LOGIN        1
#endif /** SHELL_CLS_WHEN_LOGIN */

#ifndef SHELL_DEFAULT_USER
/**
 * @brief shell默认用户
 */
#define     SHELL_DEFAULT_USER          "letter-shell"
#endif /** SHELL_DEFAULT_USER */

#ifndef SHELL_DEFAULT_USER_PASSWORD
/**
 * @brief shell默认用户密码
 *        若默认用户不需要密码，设为""
 */
#define     SHELL_DEFAULT_USER_PASSWORD ""
#endif /** SHELL_DEFAULT_USER_PASSWORD */

#ifndef SHELL_LOCK_TIMEOUT
/**
 * @brief shell自动锁定超时
 *        shell当前用户密码有效的时候生效，超时后会自动重新锁定shell
 *        设置为0时关闭自动锁定功能，时间单位为`SHELL_GET_TICK()`单位
 * @note 使用超时锁定必须保证`SHELL_GET_TICK()`有效
 */
#define     SHELL_LOCK_TIMEOUT          0 * 60 * 1000
#endif /** SHELL_LOCK_TIMEOUT */

#ifndef SHELL_USING_FUNC_SIGNATURE
/**
 * @brief 使用函数签名
 *        使能后，可以在声明命令时，指定函数的签名，shell 会根据函数签名进行参数转换，
 *        而不是自动判断参数的类型，如果参数和函数签名不匹配，会停止执行命令
 */
#define     SHELL_USING_FUNC_SIGNATURE  0
#endif /** SHELL_USING_FUNC_SIGNATURE */

#ifndef SHELL_SUPPORT_ARRAY_PARAM
/**
 * @brief 支持数组参数
 *        使能后，可以在命令中使用数组参数，如`cmd [1,2,3]`
 *        需要使能 `SHELL_USING_FUNC_SIGNATURE` 宏，并且配置 `SHELL_MALLOC`, `SHELL_FREE`
 */
#define     SHELL_SUPPORT_ARRAY_PARAM   0
#endif /** SHELL_SUPPORT_ARRAY_PARAM */

#endif

```  
### 调用shell   
首先初始化shell,直接调用刚才在shell_port.c中实现的函数：

```c
rttShellInit(); // 初始化RTT Shell
```
接下来就是调用shell任务。官方说明文档给出了调用shell任务的几种方式：
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/调用shell任务官方说明.png)   

因为我这边是裸机开发，所以我选择了调用**shellHandler**的方式，然后在whlie(1)中简单实现一个定时调度的状态机，给shellHandler分配了一个任务：   
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/shellHandler任务.png)  

### 编译报错 
如果在编译的时候，出现类似的错误：   
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/报错信息.png)   
参考官方文档的说明，添加对应的参数：
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/官方建议.png)  
因为我使用的是GCC编译器，所以在链接文件中添加如下内容：
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/解决方法.png)  
解决完上面的问题之后，编译下载，就可以在RTT Viewer中看到shell的界面了：
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/Letter-Shell界面.png)     
## 将RTT对接到终端
为了方便使用，我们可以选择将RTT对接到终端，这样就可以直接在终端中使用shell了。因为J-Link RTT Viewer中只能输入单个字符，不便于我们输入一长串指令，也不方便我们修改，所以对接到正经的终端中使用还是挺有必要的。   
这里我使用了Letter Shell官方推荐的rtt转发telnet工具**Rtt2Telnet**：https://github.com/mcujackson/Rtt2Telnet
设置好Rtt2Telnet的目标芯片和连接速度后，点击开启，就会在本地的6198端口上开启RTT转发，使用支持telnet连接的终端即可连接到RTT。我这里使用的是MobaXterm，配置成功的结果如下：   
![](https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/mobaxterm连接结果.png)

**原文链接：https://zxcli.fun/2025/04/26/将你的Letter-Shell对接到SEGGER-RTT上/**

**本文由原作者授权于本站联合发布**

将Letter Shell对接到SEGGER RTT上

![IMG_20250324_213130.jpg](https://blog.polaristation.fun/static/img/a25de38951619b73f03e64506173bf8b.IMG_20250324_213130.webp)

:::info{title="相关信息"}
在此鸣谢B站Up主“[**饭堂大妈**](https://space.bilibili.com/34883015)”以及“[**e萌工作室**](https://www.emoe.xyz/)”各位群友的鼎力支持！本次维修所用到的**相关资源链接在文末**提供，如有需要**请仔细阅读本文后再使用**。
:::

## 进度
- [x] 确保**基本功能**正常。
- [x] 找到相关教程或者自己摸索**进行校准**。
- [ ] 把外观整体**喷漆翻新**，以及制作新的**前面板贴纸**。

## 前言
近日在某黄色软件上淘了一台古董数字电桥，或者叫它综合测量仪也可以。

型号 **Zentech 3302** ，这个型号的电桥有很多马甲，使用的硬件基本一致，系统固件也大同小异，无非就是开机显示的品牌 Logo 有区别以及有一家使用的是全中文固件。目前就我已知的有6个不同牌子的同种型号电桥。

此外，与这台电桥同系列的其他型号所使用的硬件基本一致，**3302是全系功能最全的型号**，对于其他型号来说，只要**刷3302的固件**理论上就都能**实现一样的功能**。



该系列有以下几个型号，这里提供的是 **Chroma** 家提供的中文版参数概览文档（与Zentech 参数完全一致）:
<iframe src="/static/doc/3250_3252_3302-SC.pdf" width="600" height="800"></iframe>

以及该系列的用户手册（英文版）：
<iframe src="/static/doc/User's_Manual.pdf" width="600" height="800"></iframe>

## 拆解清理及方案分析
我买的这台机器总花费 **650CNY**（600单机无配件+50德邦物流运费），外观成色还算可以。到手之后确认开机正常，测量准确无误之后我就把它**拆开了**😋。~~（埋下伏笔）~~

这台机器的内部结构有些阴间，明明块头那么大里面却空的很.....

而且从里面厚厚一层的灰尘以及锈迹斑斑的螺丝可以看出这机器的工作时间应该不短，工作环境估计也算不上很好😥，尤其是电源部分，由于有风扇导致的空气流动所以积灰严重。不过好在这种古老的直插件和电路板大多都比较耐操,即便是这样了依旧能照常工作。

> 下图是机器上层的**电源**及**数字部分**，数字部分主要负责测量数据的处理、屏幕显示、按键识别以及外接设备交互（有几个接线被我拔了）。

![IMG_20250324_151205.jpg](https://blog.polaristation.fun/static/img/1aced3c56d8d5fcfcd97a1433e9072c0.IMG_20250324_151205.webp)

> 下图这张是机器底部的模拟采样部分，主要负责输出激励、回采外部输入信号并转换计算后传输给数字部分。由于是倒装的所以这块板子上几乎没有灰尘，非常干净。

![IMG_20250324_141425.jpg](https://blog.polaristation.fun/static/img/4a385bc9ab89d4a11c006435bb383b22.IMG_20250324_141425.webp)

### 主板接口拆解更换
![IMG_20250324_205730.jpg](https://blog.polaristation.fun/static/img/ddee04d7e4ebf148d7b7455a689528fe.IMG_20250324_205730.webp)

![IMG_20250327_192356.jpg](https://blog.polaristation.fun/static/img/412466d496119ede0b1f0c4b0c9b563d.IMG_20250327_192356.webp)

**这边RS232接口的电路其实是不全的，后续我还要把他补全，试一下使用上位机操作。**

### 方案分析
锐意制作中……

## 翻车实录？
好的，清灰结束，简单装机试一下😆。嚓电，揩鸡！好的屏幕轻松点亮😎。

但是…… なに？为什么屏幕测量参数变成乱码了😱？！

一定是我开机姿势不对，重启一下…… 还是不行，难道我打破了灰电平衡吗😅？

经过几次尝试插拔一些芯片、接口和断电重启后，故障依旧😵。

### 问题分析
经过跟群友交流猜测，这个现象有可能是系统固件里的数据出现了错误，比如字库存储位置读取错误导致显示的是乱码而非正常文字。

记得一开始拍的照片里贴了两片美纹纸的地方吗？那个是来自 **意法半导体ST** 的 **M27C4001** 紫外光擦除型 **EEPROM** ，容量 **4MB** 共两颗。这种芯片的特点就是在内部 **Die** 上有透明的开窗，可以直接从外部看到，而只要有一定强度的紫外线射入即可将芯片内部的数据擦除，而无需通电。

![IMG_20250402_135837.jpg](https://blog.polaristation.fun/static/img/172296dec1d036a470cca9e28c78e104.IMG_20250402_135837.webp)

众所周知一般的室内照明用荧光灯的工作原理是通过**电流激发灯管内的汞蒸气**，**产生紫外线**（主要为254nm的UVC）。这些紫外线**照射到**灯管内壁的**荧光粉涂层**上，从而**转化为可见光**。虽然一般来说灯管玻璃所采用**钠钙玻璃**可有效阻挡UVC和大部分UVB（波长 < 315nm），但仍有可能可能透射少量UVA（315~400nm）。

以及窗外日光中所携带的紫外线也有可能通过某些途径进入，所以就此分析有可能是由于有少量紫外线射入芯片内而导致系统固件中的某些部分产生了**位翻转（Bit Flip）**，从而导致了显示乱码的问题。

:::warning{title="注意"}
虽然事后证明这个并非是关键原因，但是一般的照明光照射此类 EEPROM 的确**有概率导致数据错误**，所以如果有使用此类芯片的话**一定要记得做好防护**，以防止数据丢失！
:::

### 复活失败
如此看来只要将正常的系统固件刷回去理论上就应该可以解决问题了，恰好B站上[**有位Up主**](https://space.bilibili.com/34883015)大概半个月之前刚刚发了这个系列的[**3250型电桥的刷固件升级+翻新的视频**](https://www.bilibili.com/video/BV1fE9VY1Er8)，于是我便联系上了他。

**Up主充分发扬了互联网精神，十分慷慨地将3302型号的固件无偿提供给了我，对此我致以最真挚的感谢和敬意🫡。**

之后，甚至发现Up主和我在同一个QQ电子交流群里，于是我便从他那里得到了两片**免费的刷好固件的EEPROM**😍。

虽然这么多巧合和好运让我坚信问题一定可以迎刃而解，**但现实并不会以人的意志而转移**。当我满怀期待的将新的ROM芯片换上开机后，想象中的**奇迹却并没有发生**，故障依旧😫。

## 死而复生
在排除了**系统固件错误**的可能后，之前翻新时的步骤里唯一有可能导致系统数据问题的操作只剩下**将小电池断电**的操作了🤨，毕竟原本使用的是直接焊死在主板上的小电池而非插拔式的，所以大概率原本设计的时候就不希望能够轻易将小电池取下导致主板断电🤔。

![IMG_20250324_211557.jpg](https://blog.polaristation.fun/static/img/6b6a0e30db11934e0b09d99ca3b68deb.IMG_20250324_211557.webp)

:::tip{title="提示"}
我这个版本的主板上**小电池正负极的丝印甚至是反**的🤬，如果不注意的话很有可能会把其他芯片一块带走。
:::

### 问题再分析
经过一番~~胡乱~~尝试，我发现：将小电池拔下后开机，屏幕测量部份显示的**乱码就出现了变化**，而如果再将电池安装回去则会**恢复之前的乱码**，现在我大概可以确定问题应该就出在小电池相关的电路上。

在小电池安装位旁边有4个芯片：DS1302、DS1210、2×SPI Flash。而从PCB来看小电池也只连接了 **DS1302** 和 **DS1210** 这两颗芯片，那么大概率问题就出在他们俩之间。

![IMG_20250402_141750.jpg](https://blog.polaristation.fun/static/img/ad6e3bd218e805234a5eb30fd485e19b.IMG_20250402_141750.webp)

**DS1302** 是一颗RTC时钟芯片，本身只是作为时间计量用，大概率不会对系统产生什么影响。但是 **DS1210** 就有点说头了，这是一颗“**非易失性存储控制芯片**”，根据芯片手册的电路描述来看它的作用是在电源输出不稳定或断电时**切换到小电池**为系统的 **SRAM** 供电用于**保持其内部的数据**🧐。

**本来我以为 SRAM 只是用于系统数据暂存的，但是从电路来看大概率里面有一些需要长期保存的数据，所以才设计了这么一个续命电路🙃。**

### 堂堂复活
而系统设置里恰好有一个“**内存管理（MEMORY MANAGEMENT）**”的选项，或许我可以通过重置来恢复😏？但是很逆天的是这个机器里面居然还有“**超管密码（Supervisor Password**）”，最关键的是设备使用手册里是不提供的，也就是说理论上只有生产厂家知道这个密码是什么😓。

好在于万能互联网上搜索后发现 CSDN 有个资源贴说有相关文件，在淘宝花了 **0.0005k** 巨款找的代下载后成功得到了这个机器的**超管密码**以及**还原出厂清零**的步骤😋：

> 1. 按“**System Setup**”键，进入系统设置快捷画面;
> 2. 按数字键“**0**”进入“**MEMORY MANAGEMENT**”，输入超管密码“**1470741035**”后按“**Enter**”键确认;
> 3. 按显示器右边最上面的“**DEFAULT RAM**”对应键后，再按“**Yes**”对应键;
> 4. 按显示器右边中间的“**DEFAULT DEUIATION**”对应键后，再按“**Yes**”对应键;
> 5. 按小数点“**·**”按键后，再按“**Yes**”对应键;
> - **完成上述5个步骤后关机，再重新开机完成清零。**

根据以上步骤执行后再重启机器，测量示数就**已经恢复正常**，但大概率**校准数据已经丢失**，精度应该是不能和一开始比的，不过至少是能用了。而且有了超密之后设置里的“**校准（Calibration）**”也可以使用了，如果能搞到校准流程的话就可以自己校准。

## 校准方法
目前还有在售的同方案电桥只有 **Chroma** 一家，其他的几个牌子基本都已销声匿迹，连联系方式都不知道怎那么取得。虽然 **Chroma** 提供仪器校准服务，但是不知道是否支持个人寄送校准，而且根据官网上的提供的大陆地区校准实验室校准能力列表，里面并不包含这个型号的设备。

![校准能力项目表.jpeg](https://blog.polaristation.fun/static/img/ee68501759efe7f10639031334939bea.%C3%A6%C2%A0%C2%A1%C3%A5%C2%87%C2%86%C3%A8%C2%83%C2%BD%C3%A5%C2%8A%C2%9B%C3%A9%C2%A1%C2%B9%C3%A7%C2%9B%C2%AE%C3%A8%C2%A1%C2%A8.webp)

既然如此，那就只能自己想办法校准了。好在经过一番摸索，我基本确定了这个仪器的校准流程。

### 校准前需要准备的工具
- **无感标准电阻**一个（我使用的是 **0.1%** 精度 **100R** 的），不过这个电阻的绝对精度其实不是很重要，如果有条件的话可以自己找温漂比较低的电阻自己标定，或者买之前找商家帮忙进行标定。不过注意一定要用无感电阻，因为要保证各个测试频率下的阻抗稳定性，所以一定要尽可能使用低寄生电感、寄生电容的标准被动元件，以确保频率响应一致。
![IMG_20250411_164712.jpg](https://blog.polaristation.fun/static/img/1dc90bba153967cd41af2fd468a53208.IMG_20250411_164712.webp)
- **六位半及以上的万用表**一台（非必须，但要保证精度），主要用于标定校准用被动元件的值。如果不是购买现成的标准电阻而进行自标定的话，还是有必要使用高精度的万用表。

### 校准流程
#### 1. 夹具短路/开路测试
- 按“**Main Index**”按键，进入功能主页；
![IMG_20250411_164147.jpg](https://blog.polaristation.fun/static/img/08a07fcfb0f863eda4661d9f2030250d.IMG_20250411_164147.webp)
- 按屏幕右侧第3功能键“**Transformer**”，进入变压器测量页面，屏幕显示内容应与下图类似。里面有“**Short**”和“**Open**”两个选项；
![IMG_20250411_164152.jpg](https://blog.polaristation.fun/static/img/998cb03520e259c6a3a991f71990cfb9.IMG_20250411_164152.webp)
- 这里以**短路测试**为例，点击“**Short**”对应功能键，进入短路测试；
![IMG_20250411_164158.jpg](https://blog.polaristation.fun/static/img/79692024ac41c8370426b347adb811b3.IMG_20250411_164158.webp)
- 将正负夹具可靠短路，根据屏幕上提示点击“**MULT - FREQ.**”进入多频测试模式，再点击“**Start/Trigger**”按键开始；
- 等待测试完毕后屏幕会显示“**Short Test Pass**”即表示测试完毕；
- **开路测试**流程同理。

#### 2. 交流测量校准
- 按“**System Setup**”按键，进入系统设置页；
![IMG_20250411_164023.jpg](https://blog.polaristation.fun/static/img/424cf2ce33d7c96235f12f8f1dacff41.IMG_20250411_164023.webp)
- 按屏幕右侧“**Calibration**”所对应的第1功能键，输入前文提到的超管密码“**1470741035**”，再按“**Enter**”进入校准页面；
![IMG_20250411_164029.jpg](https://blog.polaristation.fun/static/img/81dee8bb4be961a44d0c6fa881663472.IMG_20250411_164029.webp)
- 进入后屏幕显示内容应与下图类似，确保屏幕右侧第二行显示的为“**STD**”，即 **Standard** 标准校准模式；
![IMG_20250411_164036.jpg](https://blog.polaristation.fun/static/img/7d4e071447f0378bc47fb7454e04311e.IMG_20250411_164036.webp)
- 修改表格**左侧一列**校准用阻值为标准电阻的阻值，右侧一列的 **Q (PPM)** 值我不确定应该怎么设置，所以姑且保持默认（在我测试下来对校准结果没明显影响）；
- **将标准电阻用测试夹具夹好**，并且**夹具**应尽量**靠近电阻引脚的根部**，即靠近电阻本体的一端，减少引脚本身电阻带来的误差；

- 点击“**Correction**”键，设备会自动进行多频校准；
- 等待**大概5分钟**左右，交流校准流程全部结束即可。

#### ~~3. DCR测量校准~~ （暂时没搞定）
- 用 **2.** 中相同方法进入 **Calibration** 校准页面；
- 点击第二功能键将校准模式切换到“**DCR**”模式；
![IMG_20250411_164103.jpg](https://blog.polaristation.fun/static/img/735a077ff4315b83e8962c9761a16dbb.IMG_20250411_164103.webp)
- 使用按键区小键盘输入标准电阻的阻值（越精确越好）；
- 点击“**Correction**”键设备会自动进行校准；


## 资源链接
[**3302固件**](http://cloud.polaristation.fun/s/a4fb)

[**33xx系列繁中版用户手册**](http://cloud.polaristation.fun/s/x2Sj)

【赛博考古】Zentech 3302 电桥维修翻新记录

![IMG_20250320_154457.jpg](https://blog.polaristation.fun/static/img/9c2de0c01980cd41c23a54ae549acf80.IMG_20250320_154457.webp)

## 前言
你是否还在为高价定制模组线而苦恼？🤨

你是否还在为参差不齐的线材质量而烦躁？😣

那就把制作电源线的核心技术掌握在手中吧！从此实现模组线自由！🤗

不论是长度、材质、接口类型还是数量都由你自己来定，向预制线说不！😤

所有材料完全公开透明，从此不必再担心无良商家偷工减料！😎

真正的低成本和高质量，从 **ATX 电源模组线完全 DIY 指南**开始~🥰

:::tip{title="提示"}
其他使用 **类似5557连接端子** 的连接器和线也可以参考本教程。
:::


**事前声明：**
- 本文仅作为经验分享，最终成品效果由实际制作人的手艺决定；
- 本文适合**喜欢 DIY 的玩家**，如果无法接受可能的炸机那请买现成的模组线；
- 本文作者**不会对**任何可能由于最终成品线材质量问题而导致的**财产损失负责**；
- 本文内容**不适用**于 ATX 3.0 标准加入的 **12V HPWR** 接口（NVIDIA 40系显卡供电接口），

**注意事项：**
- 请**认真阅读**并理解每一条内容以确保最终成品质量；
- 请确保**拥有基本的电路常识**，不然可能会难以理解后面的某些内容；
- 请确保**拥有较好的动手能力**，这将帮助你完成后面每一个操作步骤；
- **请做好可能造成财产损失的心理准备**；

## 需要的工具

- **剥线钳**一支，自动手动均可（图里的是自动，但是我觉得其实没有手动的好用）

![IMG_20250320_155328.jpg](https://blog.polaristation.fun/static/img/867ad50387a0874455ef5fb9efb91731.IMG_20250320_155328.webp)

- **压线钳**一支

![IMG_20250320_160118.jpg](https://blog.polaristation.fun/static/img/cc6acfc5c94d9857fefffad9d7acd65f.IMG_20250320_160118.webp)

- **退针器**（非必须）
- **订书针**，可以替代退针器😋

![IMG_20250308_160139.jpg](https://blog.polaristation.fun/static/img/26c0b02193580f576e3ec4237cee6325.IMG_20250308_160139.webp)

- **手持万用表**一台，随便什么牌子能测通断和电压就行
- **灭火器一瓶，建议使用二氧化碳灭火器，确保压力表位于绿色区间，并且铅封完好可正常使用（以防万一）**

## 需要的材料

- **硅胶线** / **压纹线** / **其他什么线**（取决于你想用什么）**10m**起步，根据需求选择，线径 **16~18** **AWG** 均可（AWG数越小线径越粗），选择**多股铜镀镍/锡线芯**的线材，线材质量决定最终成品的质量，这里务必选择线径、材料合格的线材

![IMG_20250320_160537.jpg](https://blog.polaristation.fun/static/img/4f7bd0aa0fb0fb7ff2b0df21968cb8f1.IMG_20250320_160537.webp)

- **5557连接端子**（最好是半镀金的，可以降低接触电阻），端子分**高脚**和**低脚**，后面会介绍两者的区别

![IMG_20250320_145922.jpg](https://blog.polaristation.fun/static/img/376ed0b9bee753eefbaafd4c065f4e39.IMG_20250320_145922.webp)

- **连接器胶壳**，推荐 **JMT** 牌，类型根据需要自行选择，后面也会详细介绍各种接口类型

:::tip{title="提示"}
不想买新的胶壳的话可以把电源原配模组线上的胶壳拆出来，参考下文的**用订书针怎么代替退针器退针**，换线的时候我建议**以线为单位**，同一根线两头退针，然后换自己买的新线接上，可以最大程度上避免搞错顺序。
:::

![IMG_20250320_150531.jpg](https://blog.polaristation.fun/static/img/87d97df1c95ab7b1a0799a44f61c4ac6.IMG_20250320_150531.webp)

## 前置知识介绍

### 常见 ATX 模组电源接口线序
模组线接口线序的差异主要在**电源侧**的接口，因为这个接口是没有公用标准的，一般都是由厂家自行定义，所以切忌将不同品牌的模组线混用，那样有**极高概率会对硬件造成不可挽回的损失**。

而**设备侧**（主板和 PCIe 设备）的接口则是根据 Intel ATX 电源标准制做的，所有品牌**大致相同**。

此外，还有小概率会碰到**同品牌**电源模组**线序不同**的情况，所以制作线材时最保险的方法还是根据原装线材一根一根理清线序之后再一一对应安装。

这里仅介绍 Intel ATX 标准下的用电设备主要供电接口线序。

- 主板 24Pin 接口：


- CPU供电 4Pin 接口：


- 显卡供电 6Pin/8Pin/6+2Pin 接口：

| Pin Number | Description | Pin Number | Description |
|------------|-------------|------------|-------------|
| 1          | 12V         | 5          | GND         |
| 2          | 12V         | 6          | Sense0      |
| 3          | 12V         | 7          | GND         |
| 4          | Sense1      | 8          | GND         |

:::tip{title="提示"}
**PIN4 & PIN 8** 是 6+2PIN 中的 **2PIN** ，Sense 脚一般接地，有的电源可能不接，请根据电源原配的模组线进行判断。
:::

![image.png](https://blog.polaristation.fun/static/img/db13ab3ba26b2f415e0f8e53f498a767.image.webp)

### 5557 连接端子高低脚的作用
高脚的 5557 连接端子主要用于压接两根导线到同一个端子中，常见于显卡 6+2PIN 接口中，压接方法和低脚一致。

![IMG_20250320_201727.jpg](https://blog.polaristation.fun/static/img/8b98ce8118449610573f9664b56c26da.IMG_20250320_201727.webp)

### 用订书针怎么代替退针器退针

:::warning{title="注意"}
这一步有可能导致订书针**断在连接端子中**，导致这个端子**直接报废**，请仔细阅读以下内容，如果对自己的**动手能力**和**力道控制**没有信心那还是建议买成品的退针器，**使用成品退针器请参考卖家提供的使用教程**。
:::
- 先掰一根订书针。

![IMG_20250321_130036.jpg](https://blog.polaristation.fun/static/img/445628274ac80c7dae124f8d81a943ec.IMG_20250321_130036.webp)

- 然后弯成下图这样，在尖端最好稍微往外扩开一些，这样比较容易插入连接端子和胶壳的缝隙中。

![IMG_20250321_130413.jpg](https://blog.polaristation.fun/static/img/150d00b7620fe502e4ce7a691a956aa6.IMG_20250321_130413.webp)

- 把弯好的订书针插入连接端子两侧和胶壳的缝隙中。

![IMG_20250321_130606.jpg](https://blog.polaristation.fun/static/img/d8cfd45fa175dde29e940f0a54f3bf21.IMG_20250321_130606.webp)

![IMG_20250321_130611.jpg](https://blog.polaristation.fun/static/img/a5a06ff3da367c699c5d0bf4a9756459.IMG_20250321_130611.webp)
- 然后往里面按，这里可能要使比较大的劲，按到后面会明显感觉到碰到了一个东西挡住，这样就算给按到底了，我这个留在外面差不多这么多。

![IMG_20250321_130741.jpg](https://blog.polaristation.fun/static/img/11528d00fbffe53bf972542ed004cfc6.IMG_20250321_130741.webp)

- 按到底之后就可以从胶壳后方把线拽出来了，这一步也得要稍微使点劲，但是注意，要是用很大劲也拔不出来那可能是订书针没按到底，或者有一边没插到缝里，需要自行检查一下。

![IMG_20250321_130814.jpg](https://blog.polaristation.fun/static/img/db1dc31e2f71c4dc79a20e7f013e781a.IMG_20250321_130814.webp)

## 线材制作操作指南

### 剥线
- 剪取合适长度的线材，然后用剥线钳剥去大约 3~4mm 的线皮。

![IMG_20250320_150939.jpg](https://blog.polaristation.fun/static/img/9ad4a892d7ee241d262f111b0770ae73.IMG_20250320_150939.webp)

### 压接连接端子
- 将 5557 连接端子从铁片上掰下来，然后稍微将两边的压接脚位往中间捏一捏，这样比较方便把线卡在里面，之后用压线钳压接的时候不容易歪掉。

![IMG_20250308_160240.jpg](https://blog.polaristation.fun/static/img/3d73e5becacf5d80daea4be1b31276c9.IMG_20250308_160240.webp)

- 把线卡在 5557 连接端子里（这张图里的线剥得就有点长了）。

![A8443BC9B7288EA114CE6D510EC8ECC7.jpg](https://blog.polaristation.fun/static/img/01530f126fe4b202436d16484b5b520c.A8443BC9B7288EA114CE6D510EC8ECC7.webp)

- 根据图示放置连接端子到压线钳的 0.5 号卡位，最靠前的小直立脚位一定不要被压线钳压到，这个脚位是用于给连接端子在胶壳中限位的，如果被压倒的话插入胶壳后再往前推是能被推出胶壳的，这样在拔出线缆时连接端子可能会被卡在设备接口上，导致线从胶壳中被拽出来。

![9A4FC8B0A109CCD90E73AA3F270DDE91.jpg](https://blog.polaristation.fun/static/img/92dd4e1f3ea89ad4053306ad9f13d919.9A4FC8B0A109CCD90E73AA3F270DDE91.webp)

- 控制好端子位置，将压线钳压下，我的压线钳有限位器，没到底之前是没办法自己张开的，当压接到合适位置后会听到“**咔**”的一声限位器弹开，钳子才能张开。

:::tip{title="提示"}
压好的端子可能会卡在压线钳的槽位里，需要稍微使点劲把它拿出来，这个过程中要尽量避免把端子弄变形，多试几次应该能找到方法🤔。
:::

- 压接好的端子应当跟下图一样。

![2D0AD62BD77536366343856C36BB6B2D.jpg](https://blog.polaristation.fun/static/img/de03e316ab0443258b293f91ab814c05.2D0AD62BD77536366343856C36BB6B2D.webp)

- 如果不放心连接质量也可以在压接完后使用少量焊锡将线芯与连接端子焊接起来。

### 安装连接器胶壳
- 注意连接端子上的直立脚位应当与胶壳上的卡口朝向一致，如下图所示。

![IMG_20250320_151458.jpg](https://blog.polaristation.fun/static/img/550cd98a8fb1f2cd5ed09ee0288dab06.IMG_20250320_151458.webp)

- 插入后会有明显的段落感，当感觉插到底后往反方向拔一下确保已经完全卡到位。

![IMG_20250320_152051.jpg](https://blog.polaristation.fun/static/img/4e0d1eb929939ad0abaafe2f74ca1cb9.IMG_20250320_152051.webp)

![IMG_20250320_152017.jpg](https://blog.polaristation.fun/static/img/ede3d5a5a999b846edb4f981366a0fc2.IMG_20250320_152017.webp)

**重复以上步骤，确保线序正确即可做出完美的 DIY 模组线。**

## ~~炸机~~上机测试
终于到了激动人心的上机测试环节了🤓，但是先别着急☝，毕竟你也不想心里没底地直接莽上去吧😯？应该没有吧！？

这里介绍一个 ATX 标准电源通用的测试方法。

首先确保所有供电线都已经拔下来，短接 24Pin 主板供电接口 **PS-ON** 脚和 **GND** 来强制让电源开启输出（长城新款的模组电源甚至会有送一个专门的短接工具），然后测量每一路线缆的电压，CPU、GPU 供电均为 12V ，24Pin 主板供电接口电压种类比较多，最好仔细对应测量。



如果你已经测量好每一路电源并确保线序无误的话，就可以把线插上用电设备了。

**擦电，揩机！屏幕轻松点亮！**

**恭喜你，DIY 模组线、成功！！！**

## 线材质量测试（仅代表本人制作的线材）
### 直流阻抗
**测试条件：**
- 线材：18AWG
- 长度：75cm
- 连接端子：5557 冷压端子（未焊接）
- 测试仪器：RIGOL DM3058E 台式万用表，四线电阻模式（已自校准），开尔文夹

**测试结果：** 单根导线直流阻抗为 $19mΩ$
![IMG_20250320_191509.jpg](https://blog.polaristation.fun/static/img/2ec79e2a621ff5c2f4562e9e30335008.IMG_20250320_191509.webp)

### 机械抗拉强度（非专业测试，图一乐）
**测试条件**
- 线材：6PIN 显卡供电线，单根 18AWG

**测试结果：** 整线抗拉强度$＞ 5kg$