文件
phonerail/.claude/r2/pcb_blade.py
T

666 行
39 KiB
Python
原始文件 Blame 文件历史

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。
# -*- coding: utf-8 -*-
u"""R2 刀片 PCB(M4):板框 + 分区参考 + 摆位常量。
/c/Python314/python .claude/r2/pcb_blade.py # 只算 + 自检
/c/Python314/python .claude/r2/pcb_blade.py --outline # 画/重画板框(幂等)
/c/Python314/python .claude/r2/pcb_blade.py --verify # 读回校验板框 + 挖槽区域
/c/Python314/python .claude/r2/pcb_blade.py --slots # 只重画两条排线槽(layer 12 填充)
## 坐标系
**板左下角 = (0, 0),x 向右、y 向上**(EasyEDA PCB 里 y 向上为正,见方案 §22.5)。
这正好是方案 §3.1 那张分区图的坐标,图里的数可以直接抄。
⛔ **2026-09-11 用户拍板:98×76 → 90×68**(方案 §34)。
⛔⛔ **2026-09-11 晚 用户拍板:主板转 180°,两条排线槽挪到顶部**(方案 §35)。
接口边(J600 / J1401 / 侧键)朝**上**,服务带(C60 + 两条槽 + J3)在板子**顶部**,
手机远端边贴着金手指区上沿(y 11.0)。与手机绑定的一切(七个孔 / 两条槽 / J4 / J5 / K1~K4)
一律经 `phone_xy()` 从本体坐标 (u, v) 推,**不许写死、不许自己算旋转**。
```
y 68.00 ┬──────────────────────────────────┬─────────────┐
│ 服务带 12.34 尾插槽 / C60 / 电池槽 │ 功率列 19.4 │
y 55.66 ┼──── 接口边(朝上)─────────────────┤ U3/Rs1 (顶) │
│ │ eFuse │
│ 小米8 主板 67.09 × 44.66(转 180)│ L / Buck │
│ │ Cin / F1(底)│
y 11.00 ┼──────────────────────────────────┴─────────────┤
│ 金手指区 11mm(槽体 ~9mm 要让开,这一带不许放件) │
y 0.00 ┴───────────────── 板边(卡边)──────────────────┘
x 0 1.5 ─── 手机主板 ─── 68.59 70.59 ─ 功率列 ─ 90
```
## 板框的底边是**断开**的
金手指的防呆缺口画在封装 `EDGE-64P-P1.00_PCIE-X4-GF` 的板框层里(方案 §22.3),
所以这里画的底边必须在缺口口部让开一段:断点 x 由 `fp_edge.notch_mouth()` + `J1_X` 算出,
**不要手抄**。两段拼起来才是一个闭合板框;拼不上 DRC 会报开口。
## ⛔ 不用 pcb_PrimitiveArc
实测(方案 §22.4):`pcb_PrimitiveArc.create()` 在**封装编辑器里画得出但读不回、删不掉**,
在 **PCB 文档里干脆什么都不画**(返回值仍然是成功的)。⇒ 四角 R2 用折线近似,
弦高误差 < 0.01 mm。
"""
import io
import json
import math
import os
import sys
sys.stdout.reconfigure(encoding='utf-8')
HERE = os.path.dirname(os.path.abspath(__file__))
# ⚠ 顺序不能反:`.claude` 下有同名的 R1 脚本(pcb_pour / pcb_rules / pcb_place),
# 先插 .claude 再插 HERE 的话,`import pcb_pour` 会拿到 R1 那一份,
# 而且**不报错**,只在调到 R2 专有的函数时才炸。
sys.path.insert(0, os.path.dirname(HERE))
sys.path.insert(0, HERE)
from eda import run # noqa: E402
import fp_edge # noqa: E402
# ⛔⛔ 2026-09-14 起脚本指向 **`BLADE-PCB_1`**(用户新布局,71×62、金手指居中)。
# 原 `BLADE-PCB`(3b9c4e39c8d164db,89.5×67,J1_X 45)已出 Gerber、冻结;
# 它那一版的脚本与缓存存档在 `archive_blade_R_0914/`,要改它先把这几个常量换回去。
PCB = 'c575a2e854057614' # BLADE-PCB_1(R 版:'3b9c4e39c8d164db' BLADE-PCB)
MIL = fp_edge.MIL
# ── 板框(mm,出处 方案 §3.1)─────────────────────────────────────────
BX0 = 0.5 # ⛔ 2026-09-14 晚:板框左沿 x(原点不再是板角)。70×58 时保持 J1_X=35.5 居中而不挪任何件/线 ⇒ 板框整体右移 0.5
BW, BH = 70.0, 55.5 # 2026-09-14 晚:主板南移 2.5 后 58 → 55.5; 2026-09-14 晚 用户要求 70×58(槽改顶边开口,见 TOP_NOTCH);此前 71×62;R 版 89.5×67。 2026-09-14 BLADE-PCB_1 按新摆位收(outline_blade1.py);R 版 89.5×67。 2026-09-11 由 98×76 压缩;2026-09-12 深夜 90×68 → 89.5×67(用户拍板)
# ⛔ 2026-09-12 深夜这次只裁**东侧 0.5** 和**北侧 1.0**,器件 / 金手指 / 舌头一律不动:
# · 南边不能裁 —— y=0 就是金手指所在的板边(指尖在 y=1.30),从南裁等于切金手指。
# · 西边不裁 —— 保持居中就得全板西移(899 段铜 + 346 孔 + 164 件),无现成工具、
# 还会作废一批 `_blade_*.json` 缓存;用户拍板改为接受偏心(现为 **0.25**,板宽的 0.3%)。
# · **东侧为什么只裁 0.5 而不是 1.0**:卡点是 `VO_P`(4 A 主通道,宽 1.283)那条铜的
# 东沿到 **88.391**。裁到 89.0 时铜面界 88.5,而 88.391 + 0.15 = 88.541 > 88.5
# ⇒ `INA_ALERT` 的贴边竖线在 y≈54.1~54.25 处**无解,收线宽也救不了**(0.279/0.20/0.15 全试过)。
# 唯一的外层出路是少裁 0.5:铜面界 89.0 时窗口 [88.68, 88.86] 宽 0.18,够走。
# 裁到 89.0 则必须把那段 12.4 mm 挪到 L15 内层(多 2 个换层孔 + 在 GND 内层切一道缝),
# 而多裁的 0.5 mm 只多省 0.6% 面积 —— 用户拍板不拿地平面完整性换。
# · 67 零越界:北侧最高的 `J3.4` 焊盘顶在 66.400,新铜面边界 66.5 刚好让过(余 0.10)。
# 再往 66.5 走就开始撞 `J3` / `R63` / `EDL_EN`。
# ⚠ `IF_Y` 跟手机走(= PHONE_ORG[1]+PHONE_WH[1] = 55.66)、**不跟 BH**,所以改 BH 只是
# 把服务带从 12.34 压到 **11.34** —— 正好是 §34 算过的下限「C60 本体 11 + 0.34」,
# 手机投影与两条排线槽都不受影响。再压就放不下 C60。
# ⚠ 判据教训:算东侧窗口时**只看过孔会得出错误结论**。第一版漏了 `VO_P` 那条 1.283 宽的铜
# (只按它的过孔东沿 88.055 算),得出「裁 1.0 可行」;按线段实际占用逐 y 重扫才发现无解。
CORNER_R = 2.0
# ── 金手指两侧的台阶(2026-09-12 用户指出「金手指两侧没有开槽,插不进插槽」)──────────
# PCI-E 卡在金手指那一段是「凸」字形:只有舌头伸进插槽,两侧板材必须收到槽体顶面以上。
# 刀片原来是一整块 90×68 的圆角矩形,底边一条直线 ⇒ 塑料体(39 mm,两端封闭)会顶住
# x<27 / x>63 的板材,**插不到底**。
# 舌头原为 36.0(用户拍板,比金手指 33.70 两侧各多 1.15);台阶高 12.0(槽体 ~9,余 3)。
# ⛔ 2026-09-12 晚:**36.0 插不进去**。SolidWorks 量厂商 STEP 里 `PCIE-64P11L` 的
# 顶面内环(= 卡槽开口)得 **35.08**(x ±17.540,中间 0.78 是防呆键筋),
# 36.0 比它宽 **0.92**,舌头两端会压在腔的端壁上 —— 这也解释了干涉扫描里
# 「刀片底边停在塑料体顶面、插入深度 d=0」的现象。⇒ 用户拍板收到 **34.5**。
# · 金手指铜 28.15~61.85(33.70 宽)⇒ 两侧余量 1.15 → **0.40**,
# 仍大于 DRC 的板边规则 0.3(`pcb_rules` 只把 ≤0.2 的格子归一到 MINC,
# 0.254/0.3 那几格是孔/板边相关、不动),可做。
# · 对插槽开口留 (35.08−34.5)/2 = **0.29/侧**。
# ⚠ 35.08 是**厂商 STEP 的标称值、不含公差**,待卡尺实测复核(PROGRESS 待办 ⭐①)。
# 内凹角必须倒圆角:外形铣刀下不去直角,取 R1.0。
# ⚠ 台阶 12.0 > 手机主板落点 y0 = 11.0 ⇒ 主板投影底边在舌头两侧**悬空 1.0 mm**
# (左 x 1.50~27.00 / 右 x 63.00~68.59)。7 个定位孔最南 y=14.46 全在板材上、
# 主板靠 M1.6 尼龙立柱固定而不是靠边缘托住 ⇒ 无害,但 selfcheck 的分区断言要按舌头口径判。
TONGUE_X0, TONGUE_X1 = 18.25, 52.75 # 2026-09-14 跟 J1_X 35.5 居中(R 版 27.75 / 62.25)。 34.5 宽(2026-09-12 晚由 36.0 收窄,见上)
# ⛔ 2026-09-12 深夜 用户拍板:台阶高 **12.0 → 9.9**(「让舌头变短」)。
# `STEP_H` 是**台阶切掉的高度**:y <= STEP_H 只有舌头(x TONGUE_X0~X1)有板材,y > STEP_H 是全宽板主体。
# ⇒ 降低它 = 舌头变短、两侧原本被切掉的部分**恢复成板材** ⇒ **板材反而多 115.5 mm²**
# (两侧切掉 660.0 → 544.5),外接尺寸 89.5×67 不变。想减面积的话方向是反的,别搞错。
# ## 9.9 是下限,再低就出结构问题
# · **桥宽** = STEP_H − NOTCH_D = 9.9 − 8.3 = **1.60**:缺口从板边往上挖 8.3 深,
# 缺口顶到台阶肩部这段板材是**舌头左右两半唯一的连接**。8.31 时桥宽只有 0.01 ⇒ 等于切断
# (那个数只保证「缺口不被切开」,没保证「缺口上方还有板材」—— 定档时踩过这个坑)。
# · **肩部余量** = STEP_H − 插入深度 8.00 = **1.90**(零件本地坐标:塑料体顶面 10.000 / 槽底 2.000)。
# 8.31 时只剩 0.31,太浅。⚠ 别拿底板坐标的 z=12.33 算这个数,那是另一套坐标系。
# · **丝印** 带上沿 9.40,离肩部正好 0.5(= silk_blade.EDGE)。
# ## 实判:丝印与 J1 位号都不会被铣掉
# 丝印 8.40~9.40 完全在舌头内;J1 位号 9.56~10.70 **跨过肩部线**,但下半在舌头上、
# 上半在全宽主体上,四角都有板材。⚠ `silk_blade` 会因「离轮廓 0」多报 1 条越框 ——
# 那是判据保守(轮廓线穿过文字框),不是真悬空;J1 已在 KEEP 白名单,算法不会乱挪它。
STEP_H = 9.9
STEP_R = 1.0 # 台阶内凹角(铣刀半径,嘉立创外形最小 R0.5,取 1.0 稳)
CORNER_SEG = 8 # 每个 R2 圆角用几段折线
OUTLINE_W = 0.15
# 金手指阵列中心。**居中**:刀片 98 宽、插槽体只有 39,居中让两侧悬臂等长
# (左边是手机主板、右边是功率列,两头都不轻)。⚠ 底板的 5 个插槽必须按同一个数摆。
# ⛔ 2026-09-12 深夜:原来是 `BW / 2.0`(跟着板宽居中)。板宽 90→89 之后那会算出 44.5,
# **金手指连同舌头整体平移 0.5,全板器件与 64 根线立刻对不上**。这次是「只裁东侧、
# 器件不动」,所以把它**解耦成常数 45.0**(= 原来的 90/2,金手指绝对位置一点没变)。
# 代价是金手指不再严格居中:左 45.00 / 右 44.50,偏心 **0.25** = 板宽的 0.3%,用户已拍板接受。
# ⚠ 以后再改 BW,J1_X **不会**自动跟着走 —— 要居中就手动改这个数,并且记住那意味着全板平移。
BX1 = BX0 + BW # 板框右沿 x
J1_X, J1_Y, J1_ROT = 35.5, 0.0, 0 # 2026-09-14 BLADE-PCB_1 居中 = BX0 + BW/2(R 版 45.0)
# ── 小米8 主板的落点 + 定位孔(板级事实,摆位/布线/铺铜都从这里取)────────
# 主板 67.09 × 44.66,长边水平、**接口边(v=0,J600/J1401/侧键都在上面)朝下**。
# ⛔ 2026-09-11 晚:**主板转 180°**(接口边朝上,方案 §35)。`PHONE_ORG` 仍是手机投影矩形的
# **左下角**(板坐标),但本体 (u, v) → 板 (x, y) 要经 `phone_xy()`:u 从右往左、v 从上往下。
# y 的取法:手机远端边贴金手指区上沿 11.0(原来 C60 也是贴这条线放的,同一条禁布规则);
# 接口边 = 11 + 44.66 = 55.66,上面 12.34 的服务带放 C60(本体 11)+ 两条槽 + J3。
# x 不变(1.5):H6/H7(u≈64.7)转过来落在左边,螺钉头离板边 2.2 − 1.6 = 0.6 以上。
# ⚠ SIM 卡托在 u 大的那一端(mi8_mech 注释:轮廓 70.3 含卡托 3.3)⇒ 转过来在**左边**,
# 装着卡托的话会伸出板左沿 ~1.8 mm(机箱侧壁要让)。
# ⛔ 2026-09-14 晚 用户要求「主板南移,进一步缩小」:y 11.0 → **8.5**(南移 2.5 = 上限)。
# 上限来自插槽:刀片坐到槽底时塑料体顶面在刀片 y = 8.0(厂商 STEP 本地 z 10.000 − 槽底 2.000),塑料体沿 x 占 J1_X±19.5,
# 正好在主板投影下 ⇒ 主板远端边留 0.5 到塑料体顶。台阶 STEP_H 9.9 以下舌头两侧没板材 ⇒ 主板那一段悬空 1.4(selfcheck 上限 1.5)。
PHONE_ORG = (1.5, 8.5)
PHONE_WH = (67.09, 44.66)
PHONE_ROT = 180
IF_Y = round(PHONE_ORG[1] + PHONE_WH[1], 3) # 接口边(v=0)在板上的 y:55.66
def phone_xy(u, v):
u"""主板本体坐标 (u, v) → 刀片板坐标 (x, y)。**唯一的旋转实现**,别处不许自己算。
PHONE_ROT = 180:本体绕投影中心转半圈 ⇒ x = 右沿 − u,y = 上沿 − v(接口边 v=0 在上)。"""
if PHONE_ROT == 180:
return (round(PHONE_ORG[0] + PHONE_WH[0] - u, 3), round(PHONE_ORG[1] + PHONE_WH[1] - v, 3))
return (round(PHONE_ORG[0] + u, 3), round(PHONE_ORG[1] + v, 3))
# ⛔ **主板定位孔**。整个 §3.2 的高度预算 / §21.1 的槽距结论都建立在
# 「螺丝把主板压在刀片上、螺柱间隙 1.0 mm」(R1 §22.3e 的中框式焊盘)之上 ——
# 没有这几个孔,`K1~K4` 那四个裸铜盘就没有压力,整套接触方式不成立。
# 孔位是实测值(`.claude/mi8_mech.json` 的 `holes`,u/v 本体坐标)。
# 直径沿用 R1 已经定稿的一组(`pcb2_place.py`):
# 主板自己的孔 **Φ2.0**(用户卡尺)⇒ 配 **M1.6 尼龙立柱**(M2 螺杆塞 Φ2.0 没余量),
# 刀片这一侧是螺钉过孔,取 M1.6 的通孔 **Φ1.8 NPTH**。
# ⚠ R1 载板上 `H5` 没打(撞 EDL 座),**刀片上七个孔全都够得开**(实测最近焊盘 3.06 mm
# 是 H1 到 K2),所以七个全打。
HOLE_D = 1.8
HOLE_KEEP = 2.2 # 螺钉头避让(M1.6 尼龙螺钉头 Ø3.2 + 余量)
HOLE_VIA_KEEP = 1.5 # 孔到过孔/铜的最小中心距(孔半径 0.9 + 过孔半径 0.3 + 净距)
def phone_holes():
u"""{名字: (x, y)},刀片坐标。"""
# ⛔ 2026-09-15 BLADE-PCB_1 新摆位:用户在板上挪过 H2 / H3(与 mi8_mech 推算的不再一致)⇒ 板面为准,
# 有读回快照 `_blade_holes_live.json` 就用它。
live = os.path.join(HERE, '_blade_holes_live.json')
if os.path.exists(live):
return {k: tuple(v) for k, v in json.load(io.open(live, encoding='utf-8')).items()}
m = json.load(io.open(os.path.join(os.path.dirname(HERE), 'mi8_mech.json'),
encoding='utf-8'))
return {k: phone_xy(u, v) for k, (u, v) in m['holes'].items()}
# ── 排线穿板槽(2026-09-09 用户拍板:屏蔽窗去掉、器件全到 B 面、给两条排线开槽)──
# ⛔ **屏蔽罩避让窗已删**。它是「屏蔽罩轮廓没实测所以全挖」的保守项,而 R1 §22.3e 的
# 定稿是「载板不挖空:用户实测贴合面元件全低于 1 mm」。去掉之后 L2 地平面整块、
# 板子恢复刚度,B 面手机投影 67×44 全部可放件(高度预算见 pcb_place.H_B_*)。
#
# **排线走法**(照搬 R1 `pcb2_place.SLOTS`,2026-09-06 实测排线:电池 8×38、尾插 18×55):
# J600/J1401 在主板朝上那一面 → 朝接口边(y=29)走 → 翻过板边落到刀片 A 面
# → 到接口边外侧 2.7 mm 的槽 → 穿板 → **U 形折回,贴着 B 面往 +y 走**到手机投影下方的
# `J5` / `J4`。折回是绕 x 轴翻 180°:x 不变、y 镜像 —— 而立创底层正是「先 y 镜像再转」
# (方案 §25.3),所以 `J5`/`J4` 在底层 **rot 0** 就是对的(R1 §25.16 v4 同一结论)。
# ⚠ 槽是 **layer 12 (MULTI) 的填充 = 挖槽区域**(`pcb_PrimitiveFill`),不是板框内环。
# DRC 认它(「挖槽区域 到 导线」),内层铺铜也会给它让反焊盘。
# ⚠ J1401 的 x 取设计文档 §22.3b 的**本体中心 53.58**(±0.3),不是 `mi8_mech.json`
# `contacts_up.J1401 = 48.76` —— 那是座子西端(两者差 4.82 ≈ 半本体 6.1 − 1.3)。
# TP1204/1205 两份数据吻合到 0.1,说明坐标系相同、只是 J1401 取的点不同。
# 按 53.58 定,尾插车道西沿 47.6 正好让开 H4 螺钉头 (44.9 + 2.2),与 R1 自洽。
J600_U = 23.77 # 电池座中心(两份数据一致;§22.3b 标 ±2,槽放宽到 12)
J1401_U = 53.58 # 尾插座本体中心(§22.3b,±0.3)
# 槽的 y 区间:接口边外侧 1.2~4.2,中心离边 2.7(R1 同)。**跟着接口边走**。
# ⛔ 2026-09-11 晚主板转 180°:接口边朝上 ⇒ 槽在接口边**以北**(顶部服务带里),
# 排线翻过接口边 → 穿槽 → 在 B 面 U 形折回、往 **−y** 走到 J5 / J4。
SLOT_Y = (round(IF_Y + 1.2, 3), round(IF_Y + 4.2, 3))
SLOT_RIB = 2.0 # 槽顶到板边留的肋(顶边导轨也咬在这条肋上)
SLOT_W = {'BAT': 12.0, 'TAIL': 20.0} # 排线 8 / 18,各留余量
FLEX_W = {'BAT': 8.0, 'TAIL': 18.0}
SLOT_R = 1.0 # 槽内圆角(铣刀半径,嘉立创内槽最小 R0.5)
# ⛔ 2026-09-14 晚:板高 58 < 槽顶 59.86 + 肋 ⇒ **两条槽改成从顶边开口的缺口**(用户拍板)。
# 缺口画进板框折线(不再是 layer 12 挖槽区域),底部两个内角 R=SLOT_R;外角(与顶边相交处)直角。
# 代价:顶边 70 里 32 mm 是开口,顶部导轨只能咬 x 0.5~5.0 / 25.0~38.8 / 50.8~70.5 三段。
TOP_NOTCH = True
def flex_x():
u"""两条排线的中心 x(刀片坐标)。"""
return {'BAT': phone_xy(J600_U, 0.0)[0], 'TAIL': phone_xy(J1401_U, 0.0)[0]}
def flex_slots():
u"""{名字: (x0, y0, x1, y1)},刀片坐标,铣穿。"""
out = {}
for k, cx in flex_x().items():
w = SLOT_W[k]
out[k] = (round(cx - w / 2, 3), SLOT_Y[0], round(cx + w / 2, 3), SLOT_Y[1])
return out
def mill_cuts():
u"""板上全部铣穿的内槽 [(x0,y0,x1,y1)] —— 布线 / 铺铜 / 摆位都从这里取障碍。
TOP_NOTCH 时槽一直开到板外(y1 = BH + 1),障碍语义不变。"""
if TOP_NOTCH:
return [(a, b, c, BH + 1.0) for (a, b, c, d) in flex_slots().values()]
return list(flex_slots().values())
def slot_check():
u"""槽不许啃到螺钉孔避让圈,两条槽之间要留肋,槽不许进手机投影。"""
bad = []
for k, w in flex_slots().items():
for hn, (hx, hy) in phone_holes().items():
dx = max(w[0] - hx, 0.0, hx - w[2])
dy = max(w[1] - hy, 0.0, hy - w[3])
if math.hypot(dx, dy) < HOLE_KEEP:
bad.append(u'槽 %s 离螺钉孔 %s 只有 %.2f < %.1f' % (k, hn, math.hypot(dx, dy), HOLE_KEEP))
if w[1] < IF_Y:
bad.append(u'槽 %s 底 %.1f 进了手机投影(接口边 %.1f)' % (k, w[1], IF_Y))
if not TOP_NOTCH and w[3] > BH - SLOT_RIB:
bad.append(u'槽 %s 顶 %.1f 离板边不到 %.1f 的肋' % (k, w[3], SLOT_RIB))
s = flex_slots()
a, b = sorted(s.values())
rib = b[0] - a[2]
if rib < 3.0:
bad.append(u'两槽之间只剩 %.1f mm 肋(要 >= 3)' % rib)
return bad
# 分区(只是参考矩形,画在文档层,摆位脚本从这里取)
PHONE_X1 = round(PHONE_ORG[0] + PHONE_WH[0], 3) # 手机右沿 68.59
POWER_X0 = round(PHONE_X1 + 2.0, 3) # 功率列西沿 70.59(离手机 2 mm)
ZONES = {
'finger': (TONGUE_X0, 0.0, TONGUE_X1, STEP_H), # 舌头(唯一伸进插槽的那块):不许放件
'service': (BX0, IF_Y, POWER_X0, BH), # 服务带(2026-09-11 晚起在顶部):C60 / 两条排线槽 / J3
'phone': (PHONE_ORG[0], PHONE_ORG[1], PHONE_X1, round(PHONE_ORG[1] + PHONE_WH[1], 3)),
'power': (POWER_X0, STEP_H, BX1, BH), # 功率列
}
def corner(cx, cy, a0, a1, r=None):
u"""圆角折线点列(角度 deg,逆时针)。`r` 省略时用 `CORNER_R`(板四角)。
⛔⛔ 2026-09-12 晚修的 bug:这里原来**写死 `CORNER_R`**,而台阶那两个内凹角
调用时只把 `STEP_R` 用在了**弧心偏移**上 ⇒ 弧心 (TONGUE_X0−1.0, 11.0) 配半径 2.0,
弧的终点落在 x = 26.75+2.0 = **28.75** 而不是 27.75,于是舌头侧边变成一条
从 (28.75, 11.0) 斜到 (27.75, 0.0) 的**斜线** —— 舌头尖端 34.5 宽,到 y=11 处
只剩 **32.5**。几何校验、DRC 在旧尺寸下都不报(斜边最大只到 x=28.0,够不着线),
**把舌头收窄之后才显形**:x=28.50 的 +12V / PRSNT# 在 y>8.25 处被斜边切到板外。
⇒ 教训:**参数传进去了不等于用上了**;`STEP_R` 只影响弧心、不影响半径,
而这类错误画出来的形状仍然“看着像个圆角”,靠截图也看不出来。"""
rr = CORNER_R if r is None else r
pts = []
for k in range(CORNER_SEG + 1):
a = math.radians(a0 + (a1 - a0) * k / CORNER_SEG)
pts.append((cx + rr * math.cos(a), cy + rr * math.sin(a)))
return pts
def outline_pts():
u"""板框点列(逆时针,从舌头左下角起,闭合)。**凸字形**:底边只剩舌头那一段。
⚠ 相邻重合点必须去掉:圆角的首点和前一条直边的终点是同一个点,留着就会生成
一条**零长度线段**,编辑器会静默把它吃掉(下发 41 段读回 37 段),
于是「读回条数 != 期望」变成一个没完没了的假警报。这正是 CLAUDE.md 里
原理图那条「零长度导线」坑的 PCB 版。
⛔ 第一段必须仍是底边 `(TONGUE_X0, 0) -> (TONGUE_X1, 0)`:`segments()` 和
`outline_polygon()` 都按这个前提把防呆缺口插进去。
"""
r, ri, hs = CORNER_R, STEP_R, STEP_H
pts = [(TONGUE_X0, 0.0), (TONGUE_X1, 0.0)] # 舌头底边(缺口在中间断开)
pts += [(TONGUE_X1, hs - ri)]
pts += corner(TONGUE_X1 + ri, hs - ri, 180, 90, ri) # 右侧台阶内凹角(半径必须传 ri)
x0, x1 = BX0, BX1
pts += [(x1 - r, hs)]
pts += corner(x1 - r, hs + r, 270, 360) # 右下外角
pts += [(x1, BH - r)]
pts += corner(x1 - r, BH - r, 0, 90) # 右上
if TOP_NOTCH: # 顶边自右向左,逐个绕进缺口
for (a, b, c, _d) in sorted(flex_slots().values(), reverse=True):
R = SLOT_R
pts += [(c, BH), (c, b + R)]
pts += corner(c - R, b + R, 0, -90, R) # 缺口右下内角
pts += [(a + R, b)]
pts += corner(a + R, b + R, 270, 180, R) # 缺口左下内角
pts += [(a, BH)]
pts += [(x0 + r, BH)]
pts += corner(x0 + r, BH - r, 90, 180) # 左上
pts += [(x0, hs + r)]
pts += corner(x0 + r, hs + r, 180, 270) # 左下外角
pts += [(TONGUE_X0 - ri, hs)]
pts += corner(TONGUE_X0 - ri, hs - ri, 90, 0, ri) # 左侧台阶内凹角(半径必须传 ri)
pts += [(TONGUE_X0, 0.0)]
out = [pts[0]]
for q in pts[1:]:
if abs(q[0] - out[-1][0]) > 1e-9 or abs(q[1] - out[-1][1]) > 1e-9:
out.append(q)
if abs(out[0][0] - out[-1][0]) > 1e-9 or abs(out[0][1] - out[-1][1]) > 1e-9:
out.append(out[0])
assert abs(out[0][0] - out[-1][0]) < 1e-9 and abs(out[0][1] - out[-1][1]) < 1e-9, u'板框点列没有闭合'
return out
def notch_break():
u"""底边要断开的区间(板坐标 mm)。"""
ml, mr = fp_edge.notch_mouth()
return round(J1_X + ml, 4), round(J1_X + mr, 4)
def segments():
u"""板框全部线段。底边在缺口口部断开。"""
pts = outline_pts()
segs = []
for a, b in zip(pts, pts[1:]):
segs.append((a[0], a[1], b[0], b[1]))
# 第一段是底边 (r,0)->(BW-r,0),切成两段
bl, br = notch_break()
x0, y0, x1, y1 = segs[0]
assert (y0, y1) == (0.0, 0.0) and x0 < bl < br < x1, u'底边不是第一段或断点跑出去了'
segs[0:1] = [(x0, 0.0, bl, 0.0), (br, 0.0, x1, 0.0)]
# ⚠ 排线槽**不在这里**:它们是 layer 12 的填充(挖槽区域),见 push_slots()
return segs
def notch_pts():
u"""缺口的点列(板坐标),**自左向右**:口部左 → 导入角 → 左壁 → 顶半圆 → 右壁 → 口部右。
几何仍然只有 `fp_edge` 一个出处,这里只做「封装坐标 + J1_X」的平移和顺序调整。
"""
hw = fp_edge.NOTCH_W / 2.0
ml, mr = notch_break()
cx = J1_X + fp_edge.NOTCH_CX
top = fp_edge.NOTCH_D - hw
pts = [(ml, 0.0), (cx - hw, fp_edge.LEAD_IN), (cx - hw, top)]
for k in range(fp_edge.ARC_SEG, -1, -1): # 半圆从左(π)走到右(0)
a = math.pi * k / fp_edge.ARC_SEG
pts.append((cx + hw * math.cos(a), top + hw * math.sin(a)))
pts += [(cx + hw, fp_edge.LEAD_IN), (mr, 0.0)]
out = [pts[0]]
for q in pts[1:]:
if abs(q[0] - out[-1][0]) > 1e-9 or abs(q[1] - out[-1][1]) > 1e-9:
out.append(q)
return out
def outline_polygon():
u"""**一条闭合折线**的完整板框点列:圆角矩形 + 底边中间的金手指防呆缺口。
⛔ 为什么不用 `segments()` 那 37 段线(2026-09-09,M7):
`pcb_PrimitiveLine` 在嘉立创里是**导线(铜)**,不是图形线 —— 选中它属性面板写的是
「导线」,还带网络 / 网络长度,`图层` 那一格 `data-value=11` 但**显示是空的**
(下拉里只有铜层,板框层不在选项里)。渲染成品红、DRC 也不报,
所以四道几何校验全过,而**客户端根本不把它当板框**:
自动布线一路弹「请先绘制板框!」。板框要用 `pcb_PrimitivePolyline`(折线)画。
"""
pts = outline_pts() # 闭合,第一段是底边 (r,0)->(BW-r,0)
bl, br = notch_break()
assert pts[0][1] == 0.0 and pts[1][1] == 0.0 and pts[0][0] < bl < br < pts[1][0], u'底边不是第一段或断点跑出去了'
return [pts[0]] + notch_pts() + list(pts[1:])
def polygon_src(pts):
u"""点列 -> pcb_MathPolygon.createPolygon 的源数组(mil,显式闭合)。"""
a = [mil(pts[0][0]), mil(pts[0][1])]
for q in pts[1:]:
a += ['L', mil(q[0]), mil(q[1])]
if pts[0] != pts[-1]:
a += ['L', mil(pts[0][0]), mil(pts[0][1])]
return a
def rrect_pts(x0, y0, x1, y1, r, seg=6):
u"""圆角矩形闭合点列。内槽必须圆角:铣刀下不去直角,嘉立创内槽最小 R0.5。"""
pts = []
for cx, cy, a0 in ((x1 - r, y0 + r, 270), (x1 - r, y1 - r, 0),
(x0 + r, y1 - r, 90), (x0 + r, y0 + r, 180)):
for k in range(seg + 1):
a = math.radians(a0 + 90.0 * k / seg)
pts.append((cx + r * math.cos(a), cy + r * math.sin(a)))
out = [pts[0]]
for q in pts[1:]:
if abs(q[0] - out[-1][0]) > 1e-9 or abs(q[1] - out[-1][1]) > 1e-9:
out.append(q)
out.append(out[0])
return out
def selfcheck():
bl, br = notch_break()
assert round(br - bl, 4) == round(fp_edge.NOTCH_W + 2 * fp_edge.LEAD_IN, 4), (bl, br)
# 金手指必须整个落在板内,且不侵占服务带
for pin in ('A1', 'A32'):
x, y, w, h = fp_edge.pad_geom(pin)
ax = J1_X + x
assert BX0 + 0.5 < ax < BX1 - 0.5, u'%s 跑出板外: x=%.2f' % (pin, ax)
top = fp_edge.EDGE_CLR + fp_edge.LONG_L
assert top < ZONES['finger'][3], u'手指顶到服务带'
assert fp_edge.NOTCH_D < ZONES['finger'][3], u'缺口比金手指区还深'
# 分区不许互相重叠(除了 finger/service 只共边)
z = ZONES
assert z['service'][1] == z['phone'][3] == IF_Y
# ⚠ 台阶之后 finger 区只剩舌头那一块(x TONGUE_X0~TONGUE_X1)。手机投影 y0=11.0
# 低于台阶 12.0,但它在舌头正上方那一段是有板材的;两侧那 1 mm 是**有意的悬空**
# (定位孔最南 14.46 全在板材上,主板靠尼龙立柱固定)⇒ 只判「不压舌头」。
# 主板投影底边在舌头两侧的**悬空量**(有意为之,见 STEP_H 处的说明):只判别超标。
_hang = max(0.0, STEP_H - z['phone'][1])
assert _hang <= 1.5, u'主板投影底边悬空 %.2f mm 过多(台阶 %.1f vs 主板 y0 %.2f)' % (
_hang, STEP_H, z['phone'][1])
assert min(v[1] for v in phone_holes().values()) > STEP_H, u'有定位孔落进台阶切掉的区域'
assert fp_edge.EDGE_CLR + fp_edge.LONG_L < STEP_H, u'金手指比台阶还高'
assert z['phone'][2] <= z['power'][0], u'手机投影压进功率列'
assert z['service'][2] <= z['power'][0], u'服务带压进功率列'
assert z['phone'][3] <= BH, u'手机投影超出板顶'
# 台阶:金手指与防呆缺口必须整个落在舌头里,内凹角要铣得出来
_fx0 = J1_X + fp_edge.PIN_X['A1'] - fp_edge.FW / 2
_fx1 = J1_X + fp_edge.PIN_X['A32'] + fp_edge.FW / 2
assert TONGUE_X0 < _fx0 and _fx1 < TONGUE_X1, u'金手指 %.2f~%.2f 超出舌头 %.1f~%.1f' % (_fx0, _fx1, TONGUE_X0, TONGUE_X1)
_bl, _br = notch_break()
assert TONGUE_X0 < _bl < _br < TONGUE_X1, u'防呆缺口超出舌头'
assert STEP_R >= 0.5, u'台阶内凹角 R%.1f 铣刀下不去' % STEP_R
assert TONGUE_X1 - TONGUE_X0 < BW, u'舌头没窄于板宽,等于没开台阶'
bad = slot_check()
assert not bad, u'排线槽校核不过: %s' % bad
return True
def call(js, timeout=180):
r = run(js, timeout=timeout)
if not r.get('success'):
raise RuntimeError(json.dumps(r, ensure_ascii=False)[:800])
return r['result']
def mil(v):
return round(v * MIL, 4)
def push_outline():
u"""画板框:**一条闭合折线**(`pcb_PrimitivePolyline`),含金手指缺口。
顺带把层 11 上遗留的**导线**全删掉 —— M4b~M6 一直是用 `pcb_PrimitiveLine`
画的,那是铜,客户端不认(见 `outline_polygon()` 的说明)。
"""
src = polygon_src(outline_polygon())
js = ("await eda.dmt_EditorControl.openDocument('%s');" % PCB +
"await new Promise(r=>setTimeout(r,2500));" +
"const oldL = (await eda.pcb_PrimitiveLine.getAll()||[]).filter(l=>l.layer===11)"
".map(l=>l.primitiveId).filter(i=>i.length<=20);" +
"if (oldL.length) await eda.pcb_PrimitiveLine.delete(oldL);" +
"const oldP = (await eda.pcb_PrimitivePolyline.getAll()||[])"
".filter(p=>p.getState_Layer()===11).map(p=>p.getState_PrimitiveId());" +
"if (oldP.length) await eda.pcb_PrimitivePolyline.delete(oldP);" +
"const poly = await eda.pcb_MathPolygon.createPolygon(%s);" % json.dumps(src) +
"const r = await eda.pcb_PrimitivePolyline.create('', 11, poly, %s);" % mil(OUTLINE_W) +
"await eda.pcb_Document.save();" +
"return {delLine: oldL.length, delPoly: oldP.length, made: !!r,"
" now: (await eda.pcb_PrimitivePolyline.getAll()||[])"
".filter(p=>p.getState_Layer()===11).length};")
r = call(js, timeout=300)
print(u'板框折线: 建 %s(删旧导线 %d / 旧折线 %d);层 11 上现有折线 %d 条'
% (u'成功' if r['made'] else u'失败', r['delLine'], r['delPoly'], r['now']))
if not r['made'] or r['now'] != 1:
raise SystemExit(u'!! 板框没画成')
return r
PUSH_SLOTS_JS = u"""
await eda.dmt_EditorControl.openDocument('%s');
await new Promise(r=>setTimeout(r,2500));
const S = %s;
let del = 0;
for (const f of await eda.pcb_PrimitiveFill.getAll())
if (f.getState_Layer() === 12) { await eda.pcb_PrimitiveFill.delete(f.getState_PrimitiveId()); del++; }
let made = 0, fail = [];
for (const [name, src] of S) {
const poly = await eda.pcb_MathPolygon.createPolygon(src);
const r = await eda.pcb_PrimitiveFill.create(12, poly);
if (r) made++; else fail.push(name);
}
await eda.pcb_Document.save();
const now = (await eda.pcb_PrimitiveFill.getAll()).filter(f => f.getState_Layer() === 12).length;
return {del, made, fail, now};
"""
def slot_src(x0, y0, x1, y1):
u"""圆角矩形 -> pcb_MathPolygon 的点列源(mil,显式闭合)。照抄 R1 pcb2_place.slot_poly。"""
pts = rrect_pts(x0, y0, x1, y1, SLOT_R)
a = [mil(pts[0][0]), mil(pts[0][1])]
for p in pts[1:]:
a += ['L', mil(p[0]), mil(p[1])]
return a
def push_slots():
# TOP_NOTCH:槽已经画进板框折线,这里只负责把旧的 layer 12 挖槽区域删光(S 为空)
S = [] if TOP_NOTCH else [[k, slot_src(*w)] for k, w in sorted(flex_slots().items())]
r = call(PUSH_SLOTS_JS % (PCB, json.dumps(S)), timeout=300)
print(u'排线槽(layer 12 挖槽区域): 建 %d / 失败 %s(删旧 %d);板上现有 %d 个'
% (r['made'], r['fail'] or u'无', r['del'], r['now']))
for k, w in sorted(flex_slots().items()):
print(u' %-5s x %.2f~%.2f y %.2f~%.2f (%.1f × %.1f,排线 %.0f 宽)'
% (k, w[0], w[2], w[1], w[3], w[2] - w[0], w[3] - w[1], FLEX_W[k]))
if r['now'] != len(S):
raise SystemExit(u'!! 槽没建全')
return r
def verify():
u"""读回板框折线,逐点和 `outline_polygon()` 对账 + 校验闭合与外接矩形。"""
r = call("await eda.dmt_EditorControl.openDocument('%s');"
"await new Promise(r=>setTimeout(r,2000));"
"const ps = (await eda.pcb_PrimitivePolyline.getAll()||[])"
".filter(p=>p.getState_Layer()===11);"
"const line11 = (await eda.pcb_PrimitiveLine.getAll()||[])"
".filter(l=>l.layer===11).length;"
"const fills = (await eda.pcb_PrimitiveFill.getAll()).filter(f=>f.getState_Layer()===12).length;"
"return {n: ps.length, poly: ps.length ? ps[0].getState_Polygon() : null,"
" line11, fills};" % PCB, timeout=180)
bad = []
if r['n'] != 1:
bad.append(u'层 11 上有 %d 条折线(应为 1 条)' % r['n'])
# ⚠ 层 11 上**允许**留 16 条导线:那是 J1 金手指封装内部的缺口线(fp_edge 画的),
# 删不掉也不必删 —— 板框已经由折线自己闭合,它们只是重复的图形。
if r['line11'] not in (0, 16):
bad.append(u'层 11 上还有 %d 条导线(只该剩 J1 封装那 16 条或 0 条)' % r['line11'])
want_fills = 0 if TOP_NOTCH else len(flex_slots())
if r['fills'] != want_fills:
bad.append(u'layer 12 挖槽区域 %d 个 != %d' % (r['fills'], want_fills))
pts = []
src = r['poly']
if isinstance(src, dict):
src = src.get('pointArr') or src.get('points') or src.get('polygon') or src
if isinstance(src, list):
i, cur = 0, None
while i < len(src):
if src[i] == 'L' or src[i] == 'l':
i += 1
continue
if isinstance(src[i], (int, float)) and i + 1 < len(src) and isinstance(src[i + 1], (int, float)):
pts.append((src[i] / MIL, src[i + 1] / MIL))
i += 2
else:
i += 1
want = outline_polygon()
if pts:
xs = [p[0] for p in pts]
ys = [p[1] for p in pts]
if abs(min(xs) - BX0) > 0.01 or abs(max(xs) - BX1) > 0.01 or abs(min(ys)) > 0.01 or abs(max(ys) - BH) > 0.01:
bad.append(u'板框外接矩形 %.2f~%.2f x %.2f~%.2f != 0~%.1f x 0~%.1f'
% (min(xs), max(xs), min(ys), max(ys), BX1, BH))
if abs(pts[0][0] - pts[-1][0]) > 0.01 or abs(pts[0][1] - pts[-1][1]) > 0.01:
bad.append(u'折线首尾不重合:%s vs %s' % (pts[0], pts[-1]))
if abs(len(pts) - len(want)) > 1:
bad.append(u'点数 %d != %d' % (len(pts), len(want)))
print(u'读回板框折线 1 条 / %d 点,外接 %.2f~%.2f x %.2f~%.2f;'
u'层 11 遗留导线 %d 条;挖槽区域 %d 个'
% (len(pts), min(xs), max(xs), min(ys), max(ys), r['line11'], r['fills']))
else:
bad.append(u'读不回折线点列(原始值 %s)' % str(r['poly'])[:120])
if bad:
print(u'[X] 校验不过:')
for b in bad:
print(u' ' + b)
else:
print(u'[OK] 板框是一条闭合折线(缺口在里面),外接矩形对上,挖槽区域齐')
return bad
PUSH_HOLES_JS = u"""
await eda.dmt_EditorControl.openDocument('%s');
await new Promise(r=>setTimeout(r,2500));
const H = %s, D = %s;
for (const p of await eda.pcb_PrimitivePad.getAll()) {
const num = p.getState_PadNumber();
if (typeof num === 'string' && /^H[1-7]$/.test(num))
await eda.pcb_PrimitivePad.delete(p.getState_PrimitiveId());
}
let k = 0;
for (const [name, x, y] of H) {
// layer 12 = 多层;metallization=false ⇒ NPTH。参数位序照抄 R1 pcb2_place.py
await eda.pcb_PrimitivePad.create(12, name, x, y, 0, ['ELLIPSE', D, D], '',
['ROUND', D], 0, 0, 0, false);
k++;
}
await eda.pcb_Document.save();
return {made: k, now: (await eda.pcb_PrimitivePad.getAll())
.filter(p => /^H[1-7]$/.test(String(p.padNumber))).length};
"""
def push_holes():
hs = phone_holes()
arr = [[k, round(v[0] * MIL, 4), round(v[1] * MIL, 4)] for k, v in sorted(hs.items())]
r = call(PUSH_HOLES_JS % (PCB, json.dumps(arr), round(HOLE_D * MIL, 4)), timeout=300)
print(u'主板定位孔: 下发 %d 个 / 读回 %d 个,NPTH Φ%.1f(⚠ 必须配 M1.6 尼龙立柱)'
% (r['made'], r['now'], HOLE_D))
return r
if __name__ == '__main__':
selfcheck()
if '--holes' in sys.argv:
push_holes()
for k, v in sorted(phone_holes().items()):
print(u' %-3s (%6.2f, %6.2f)' % (k, v[0], v[1]))
sys.exit(0)
bl, br = notch_break()
# ⚠ 必须 %.1f:2026-09-12 深夜板宽变成 89.5 之后,原来的 %.0f 把它印成「90」,
# 而板宽正是这次改动的主角 —— 下个会话一眼看过去会以为没改成。
print(u'刀片 %.1f x %.1f,四角 R%.1f;金手指中心 x=%.2f(偏心 %.2f)'
% (BW, BH, CORNER_R, J1_X, abs(J1_X - (BX0 + BW / 2.0))))
print(u'底边断点: %.2f ~ %.2f(缺口口部)' % (bl, br))
print(u'金手指跨度: x %.2f ~ %.2f,指顶 y=%.2f,缺口顶 y=%.2f'
% (J1_X + fp_edge.PIN_X['A1'] - fp_edge.FW / 2,
J1_X + fp_edge.PIN_X['A32'] + fp_edge.FW / 2,
fp_edge.EDGE_CLR + fp_edge.LONG_L, fp_edge.NOTCH_D))
for k, z in ZONES.items():
print(u' %-8s x %6.2f~%6.2f y %6.2f~%6.2f' % (k, z[0], z[2], z[1], z[3]))
for k, w in sorted(flex_slots().items()):
print(u' 槽 %-5s x %6.2f~%6.2f y %6.2f~%6.2f' % (k, w[0], w[2], w[1], w[3]))
if '--outline' in sys.argv:
push_outline()
push_slots()
verify()
elif '--slots' in sys.argv:
push_slots()
verify()
elif '--verify' in sys.argv:
verify()