# lceda_plugin_nocopy

**Repository Path**: favorite/lceda_plugin_nocopy

## Basic Information

- **Project Name**: lceda_plugin_nocopy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[简体中文](#) | [English](./README.en.md) | [繁體中文](./README.zh-Hant.md) | [日本語](./README.ja.md) | [Русский](./README.ru.md)

# Charlie-Richard LED Matrix Placer

EasyEDA Pro / 嘉立创EDA 专业版 PCB 元件自动放置插件，支持 Charlieplex LED 矩阵、机械键盘、可寻址 LED 灯带、七段数码管、去耦电容等 7 种布局场景。

---

## 截图

![](./images/1.png)
![](./images/2.png)
![](./images/3.png)
![](./images/4.png)

---

## 安装

1. 从 Releases 页面下载最新的 `charlie-matrix_v*.eext` 文件
2. 打开 EasyEDA Pro，进入 **扩展管理器 → 从文件安装**
3. 选择下载的 `.eext` 文件，点击安装
4. 重启 EasyEDA Pro（或刷新扩展列表）

安装后，打开任意 PCB 文件，顶部菜单栏将出现 **Charlie Matrix** 菜单。

---

## 打开工具

**PCB 编辑器** → 顶部菜单 **Charlie Matrix** → **Open LED Placer…**

工具将在右侧面板以 iframe 形式打开，包含 7 个标签页。所有设置会**自动保存**到浏览器 localStorage，下次打开时自动恢复。

---

## 功能标签页

### ⬡ Charlie — Charlieplex LED 矩阵

用 N 个 GPIO 引脚驱动 N×(N−1) 个 LED，无需额外移位寄存器。

| 字段 | 说明 |
|------|------|
| Pin Count | GPIO 引脚数（3–16），LED 数量自动计算 |
| Component UUID | LED 元件的 EasyEDA UUID（在元件库中右键复制） |
| Designator Prefix | 位号前缀，如 `LED` → `LED1`, `LED2`… |
| Layer | 放置层（Top / Bottom） |
| Layout Mode | matrix（布线最优）/ grid / circle / spiral |
| Pitch / Radius | 间距（mm）或圆形半径（mm） |
| Origin X / Y | 放置起点坐标（mm） |
| Angle | 旋转角度（°） |

**Preview** — 显示预览表格（引脚分配）和画布示意图
**Place** — 在 PCB 上放置所有 LED

**C Driver 代码生成** — 根据当前引脚数自动生成包含 LUT 和驱动函数的 C 头文件，可一键复制。

**限流电阻**（可展开面板）：
- 输入 Vcc、LED 正向电压 Vf、目标电流 If
- 自动计算阻值并四舍五入到 E24 系列
- 支持单独放置电阻元件（需填写电阻 UUID）

---

### ⌨ Keyboard — 机械键盘开关

将键盘开关按行列矩阵放置。

| 字段 | 说明 |
|------|------|
| Rows / Cols | 行数 / 列数 |
| Switch UUID | 开关元件 UUID |
| Switch Type | 2pin（标准）/ 3pos（含中间固定脚） |
| Pitch X / Y | 水平 / 垂直间距（mm），标准键间距 19.05 mm |
| Origin X / Y | 放置起点 |
| Diode UUID | 防鬼键二极管 UUID（留空则不放置） |
| Diode Offset X / Y | 二极管相对于开关的偏移量（mm） |

---

### ◉ WS2812 — 可寻址 LED（单线）

放置 WS2812B / WS2812C 等单线可寻址 LED，自动标注 DIN/DOUT 信号网络。

| 字段 | 说明 |
|------|------|
| Count | LED 数量 |
| Component UUID | WS2812 元件 UUID |
| Layout | linear / matrix / circle |
| Cols（matrix）| 每行列数 |
| Pitch / Radius | 间距或半径（mm） |
| Net Prefix | 链路网络前缀，如 `LED` → `LED_DIN_1`, `LED_DOUT_1`… |

---

### ★ APA102 — 可寻址 LED（双线）

支持 APA102（Clock+Data）和 SK6812（单线，含 W 白光焊盘）。

| 字段 | 说明 |
|------|------|
| Chip Type | apa102 / sk6812 |
| Count | LED 数量 |
| Component UUID | 元件 UUID |
| CIN/COUT Net（APA102）| 时钟链路网络名 |
| W Net（SK6812）| 白光 W 焊盘网络名 |
| Layout / Pitch / Radius | 同 WS2812 |

---

### ⊕ Fiducial — 基准点 & 安装孔

**基准点**（Fiducial Marks）：
- 3-corner（板角三点）/ 4-corner（四角）
- 支持设置 UUID、边距（mm）、放置层

**安装孔**（Mounting Holes）：
- 孔径：M2 / M2.5 / M3 / M4
- 布局：2-hole（左右对称）/ 4-corner（四角）
- 支持设置 UUID、边距（mm）

两类元件共用同一放置层设置。

---

### ▦ 7-Seg — 七段数码管

将多位七段数码管阵列排布，并自动分配 SEG/DIG 网络。

| 字段 | 说明 |
|------|------|
| Digit Count | 位数（1–8） |
| Common | CA（共阳）/ CC（共阴） |
| Has DP | 是否包含小数点段 |
| SEG Net Prefix | 段选网络前缀（如 `SEG`） |
| DIG Net Prefix | 位选网络前缀（如 `DIG`） |
| Component UUID | 数码管元件 UUID |
| Pitch X / Y | 水平 / 垂直间距（mm） |

---

### ⚡ Decoup — 去耦电容

在 IC 引脚附近批量放置去耦电容。

| 字段 | 说明 |
|------|------|
| Count | 电容数量 |
| Component UUID | 电容元件 UUID |
| IC X / Y | IC 中心坐标（mm） |
| Direction | above / below / left / right（相对 IC 的方向） |
| Distance | IC 边缘到电容的距离（mm） |
| Spacing | 电容之间的间距（mm） |
| Start Number | 位号起始编号 |

---

## 通用说明

### 获取元件 UUID

在 EasyEDA Pro 元件库中找到目标元件，右键 → **复制 UUID**，粘贴到对应字段。

### 坐标系

所有坐标均以**毫米（mm）**为单位，与 EasyEDA Pro PCB 编辑器坐标系一致（原点在左上角）。

### 设置持久化

所有字段的值在修改后自动保存，关闭面板后重新打开仍可恢复上次的设置。点击右上角 **Reset All** 可恢复所有字段到默认值。

---

## 开发者构建

如需从源码构建：

```bash
cd pro-api-sdk
npm install
npm run build
# → build/dist/charlie-matrix_v1.0.0.eext
```

仅编译 TypeScript（不打包）：

```bash
npm run compile
```

仅构建 iframe UI：

```bash
npm run iframe:build
```

---

## 开源许可

MIT License