# PyOCD 的基本使用

## 1. 基本命令

- erase
- flash
- gdbserver

## 2. pack 管理

PyOCD 可以使用 .pack 文件（CMSIS-Packs），许多芯片尤其是国产芯片，只提供 .pack 文件来支持开发和调试。

PyOCD 通过 --pack 指定 .pack 文件。

## 3. 指定芯片型号

使用 --target 参数指定烧录芯片型号：

```bash
pyocd erase --chip --target stm32f103rc
```

如果需要指定国产新，则需要结合 --pack 参数，例如：

```bash
pyocd erase --chip --target n32l406cb --pack <"/Path/To/Nationstech.N32L40x_DFP.0.9.0.pack">
```

## 4. 擦除芯片

使用 erase 命令擦除芯片，需要指定擦除方法，如：--chip。

```bash
# 擦除整个芯片
pyocd erase --chip --target <Target Chip Name> --pack <"/Path/To/Nationstech.N32L40x_DFP.0.9.0.pack">
```

## 5. 烧写芯片

使用 flash 命令烧写新，需要指定烧写的起始地址和要烧写的程序。

```bash
pyocd.exe flash --base-address <Program Start Address> <"/Path/To/Program.hex"> --target <Target Chip Name> --pack <"/Path/To/Nationstech.N32L40x_DFP.0.9.0.pack">
```

## 6. GDB Server 调试

使用 gdbserver 命令启动 gdbserver 服务，然后可以使用 gdb 客户端进行连接调试。

```bash
pyocd gdbserver --port 50000 --telnet-port 50001 --target <Target Chip Name> --pack <"/Path/To/Nationstech.N32L40x_DFP.0.9.0.pack">
```

## 7. 外部参考资料

1. [PyOCD Command reference](https://pyocd.io/docs/command_reference.html)