kukucaicndy/embedded_ai_skills/symbol

创建空符号 → 添加引脚/形状/文本 → 创建器件 → 在原理图中使用

const personalLib = await eda.lib_LibrariesList.getPersonalLibraryUuid();
const symbolUuid = await eda.lib_Symbol.create(personalLib, "nice!nano v2");
// symbolUuid = "57ad2c820a1646eb8a6cfa1ff35c8922"

// 打开符号编辑器
await eda.lib_Symbol.openInEditor(symbolUuid, personalLib);
// 创建矩形主体
// ⚠️ 符号编辑器 Y 轴向上增长（数学坐标系），topLeftY 是矩形最高点
//    矩形从 topLeftY 向下延伸 height，所以 topLeftY=130 → 覆盖 y=-130~130
await eda.sch_PrimitiveRectangle.create(-80, 130, 160, 260, 0, 0, null, null, null, null, null);
// 创建引脚
// SCH_PrimitivePin.create(x, y, pinNumber, pinName?, rotation?, pinLength?, pinColor?, pinShape?, pinType?)
// ⚠️ 重要：(x, y) 是引脚连接点（圆点）的位置，不是引脚端点
//    连接点应该放在矩形边缘上，引脚从连接点向外延伸
// ⚠️ 重要：rotation 参数会被 API 反转存储
//    传 0 → 存储 180 → 引脚向左延伸（适合左侧引脚）
//    传 180 → 存储 0 → 引脚向右延伸（适合右侧引脚）
//    左侧引脚: x = 矩形左边缘, rotation=0 (传0→存180→向左延伸)
//    右侧引脚: x = 矩形右边缘, rotation=180 (传180→存0→向右延伸)
// ⚠️ 重要：符号编辑器 Y 轴向上增长。y=-110 在矩形中间偏上位置（屏幕上方），
//    与原理图编辑器的直觉相反（原理图 Y 轴向下增长）。
await eda.sch_PrimitivePin.create(-80, -110, "1", "D0", 0, 20, null, "None", "BI");
await eda.sch_PrimitivePin.create(80, -110, "13", "D10", 180, 20, null, "None", "BI");
// 创建方向标识圆点（指示引脚 1 位置，在矩形左上角内部）
// 圆点坐标 (-70, 120)：X 比左边缘 (-80) 略靠内，Y 在矩形顶部内侧
await eda.sch_PrimitiveCircle.create(-70, 120, 5, null, null, null, null, null);

const deviceUuid = await eda.lib_Device.create(personalLib, "nice!nano v2", undefined, {
  symbolType: "sch",
  symbol: { uuid: symbolUuid, libraryUuid: personalLib },
});

// 搜索自定义器件（需指定个人库 UUID）
const results = await eda.lib_Device.search("nice!nano v2", personalLib);
// 放置器件
await eda.sch_PrimitiveComponent.create(
  { libraryUuid: personalLib, uuid: results[0].uuid },
  x, y, "", 0, false, true, true
);

SCH_PrimitivePin.create(
  x: number,                              // 引脚连接点 X 坐标（圆点位置，放在矩形边缘）
  y: number,                              // 引脚连接点 Y 坐标
  pinNumber: string,                      // 引脚编号（如 "1", "2"）
  pinName?: string,                       // 引脚名称（如 "D0", "VCC"）
  rotation?: number,                      // 旋转角度: 0, 90, 180, 270（⚠️ 传入值与存储值相反，见下方说明）
  pinLength?: number,                     // 引脚长度（从连接点向外延伸）
  pinColor?: string | null,               // 引脚颜色，null=默认
  pinShape?: ESCH_PrimitivePinShape,      // 引脚形状，"None"|"Clock"|"Inverted"|"Inverted Clock"
  pinType?: ESCH_PrimitivePinType         // 引脚类型
)

SCH_PrimitiveRectangle.create(
  topLeftX: number,       // 左上角 X
  topLeftY: number,       // 左上角 Y（⚠️ Y 轴向上增长，topLeftY 是矩形最高点，向下延伸 height）
  width: number,          // 宽度
  height: number,         // 高度（从 topLeftY 向下延伸）
  cornerRadius?: number,  // 圆角半径
  rotation?: number,      // 旋转角度
  color?: string | null,  // 边框颜色
  fillColor?: string | null, // 填充颜色
  lineWidth?: number | null, // 线宽 1-10
  lineType?: ESCH_PrimitiveLineType | null,
  fillStyle?: ESCH_PrimitiveFillStyle | null
)

# 创建空符号到个人库
./scripts/draw_cli.py create-symbol "器件名称"
 
# 在编辑器中打开符号
./scripts/draw_cli.py open-symbol <symbolUuid> <libUuid>
 
# 从符号创建器件
./scripts/draw_cli.py create-device <名称> <symUuid> <libUuid>
 
# 一键构建符号（创建+打开+等待编辑）
./scripts/draw_cli.py build-symbol "器件名称"
 
# 搜索器件（默认系统库，指定个人库 UUID）
./scripts/draw_cli.py search "nice!nano v2" 5 --lib <libraryUuid>

     ───┐ D0              GND ├───
     ───┤ D1              VCC ├───
     ───┤ D2              GND ├───
     ───┤ D3   ┌────────┐ RAW ├───
     ───┤ D4   │ 器件主体 │ VCC ├───
     ───┤ D5   │ 160×260 │ GND ├───
     ───┤ D6   └────────┘ RESET ├──
     ───┤ D7   连接点     D21 ├───
     ───┤ D8   x=-80/80   D20 ├───
     ───┤ D9              D19 ├───
     ───┤ D14             D18 ├───
     ───┘ D15             D16 └───
 
  引脚连接点 (x,y) 在矩形边缘，引脚线在外侧
  名称文本在矩形内部，编号在引脚线上方
  左侧 (rotation=0): 名称在引脚线右侧（矩形内），偏移 +30
  右侧 (rotation=180): 名称在引脚线左侧（矩形内），偏移 -30

PIN2 (正确):  引脚连接点(-80, 90), 名称ATTR(-50, 90) → 名称在矩形内部 ✅
PIN1 (异常):  引脚连接点(-80, 110), 名称ATTR(-103, 110) → 名称在矩形外部 ❌

# 修正左侧引脚名称位置（名称在引脚线右侧，矩形内，左对齐）
./scripts/draw_cli.py set-pin-labels-position --side left --offset 30
 
# 修正右侧引脚名称位置（名称在引脚线左侧，矩形内，右对齐）
./scripts/draw_cli.py set-pin-labels-position --side right --offset 30

// 1. 获取所有 ATTR
const attrIds = await eda.sch_PrimitiveAttribute.getAllPrimitiveId();
// 2. 找到 Pin Name ATTR（必须用 parentPrimitiveId 匹配，不能只用 value）
const attr = await eda.sch_PrimitiveAttribute.get([attrId]);
// 3. 修改位置和对齐方式
const at = attr[0].toAsync();
at.setState_AlignMode(2);  // 左侧=2(左中)，右侧=8(右中)
at.setState_X(-50);
at.setState_Y(-pin.y);     // ⚠️ Y 坐标 = -pin.y（符号编辑器坐标系）
await at.done();