# cardputerVML **Repository Path**: aleckstygit/cardputer-vml ## Basic Information - **Project Name**: cardputerVML - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-21 - **Last Updated**: 2026-11-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Cardputer VML > 97 x 76 mm ESP32-S3 口袋 VML 计算机。EVT2 打样候选,2026-11-21。 Cardputer VML 在 Cardputer ADV 形态上做大屏、内置 CN470 LoRa,并把 GPS 明确排除。主控为 ESP32-S3-WROOM-1-N16R8(16 MB Flash + 8 MB PSRAM)。LoRa 使用 Ai-Thinker Ra-01(SX1278,470–510 MHz,20 dBm),板端 U.FL 经 10 cm IPEX 转后壳 SMA 母座,天线外置。 ## 产品规格 - 屏幕:Waveshare 2.0" 320 x 240 IPS,200 PPI,18P FPC,CST816D 触摸(I2C 0x15),模块 58.8 x 37.1 x 8.45 mm,4 x M2 孔距 48.20 x 35.00 mm。 - 键盘:56 键,物理 4 x 14,电气 7 x 8,键距 6.5 mm,TCA8418。 - 音频:ES8311、模拟 MEMS 麦克风、3.5 mm 耳机、NS4150B + 20 x 30 x 3 mm 扬声器。 - 存储:microSD,VMB 程序从 `/VML/*.vmb` 动态加载。 - 板载:BMI270、LTR-303ALS-01、PCF85063A + 超级电容、AH1815、ATECC608A。 - LoRa:Ra-01 / SX1278,CN470 470–510 MHz,U.FL + 外置 SMA;U24 负载开关,100 µF + 10 µF + 100 nF 储能。 - 外接:20-pin EXP(底边),5 V、3.3 V、USB、UART、SPI、I2C、LORA_CS、EXP_IO1..3。 - 结构:PCB 97 x 76 x 0.8 mm,4 层;4 x M2 板固定孔;外壳目标 17.2 mm。 ## 预览 ![正面](preview/cardputer-vml-front.png) ![背面内部布局](preview/cardputer-vml-back.png) ![厚度分解](preview/cardputer-vml-exploded.png) ## 交付文件 | 路径 | 内容 | | --- | --- | | `hardware/cardputer-vml.kicad_pro` | KiCad 10.0.8 工程入口 | | `hardware/cardputer-vml.kicad_sch` | 154 器件块原理图,A0 图幅,ERC 0/0 | | `hardware/cardputer-vml.net` | 133 网络的引脚级连接表 | | `hardware/cardputer-vml.dsn` | Specctra DSN,供 Freerouting 自动布线 | | `hardware/cardputer-vml.kicad_pcb` | 97 x 76 mm、4 层、0.8 mm PCB;154 器件 + 4 个 M2 孔 | | `hardware/CardputerVML.kicad_sym` | 本地符号库(含 M2 安装孔) | | `hardware/CardputerVML.pretty/` | 本地封装库;机械件与 Knowles 麦克风为本地封装,其余走 KiCad 官方 FPID | | `hardware/fp-lib-table`、`sym-lib-table` | 工程内库表,使用 `${KIPRJMOD}` | | `hardware/schematic.svg` / `.png` | 系统原理框图(EVT2) | | `hardware/wiring.svg` / `.png` | 连接器级接线图(EVT2) | | `hardware/pcb-f.svg` / `.png` | 顶层器件放置示意(非 Gerber 同源视图) | | `hardware/pcb-b.svg` / `.png` | 底层器件放置示意(非 Gerber 同源视图) | | `hardware/cardputer-vml-board.step` | 裸板 STEP(含走线、过孔、焊盘与丝印,不含器件 3D 模型) | | `preview/cardputer-vml-board.glb` | 带铜箔的裸板 GLB/GLTF 3D 预览 | | `preview/pcb-3d-top.png`、`pcb-3d-bottom.png` | KiCad 3D 渲染的顶/底面 | | `hardware/gerbers/` | Gerber、钻孔、钻孔图与 `README.txt` | | `enclosure/cardputer-vml.scad` | EVT2 参数化外壳:屏/PCB/电池/扬声器/键盘 M2 固定点、SMA 孔 | | `enclosure/cardputer-vml-assembly.stl` | OpenSCAD 实际导出的外壳装配 STL | | `docs/bom-evt2.csv` | EVT2 BOM(含 LoRa 与结构件) | | `docs/pos-f.csv`、`pos-b.csv` | 从最终 PCB 导出的顶层/底层贴片坐标(板坐标) | | `docs/pinout.md` | GPIO、I2C、EXP、J6、TCA9535、LoRa 射频链路 | | `docs/footprint-matrix.csv` | 逐器件封装审计(PASS / REVIEW / BLOCKED / FAIL) | | `docs/erc-evt2.txt`、`docs/drc-evt2.txt` | KiCad ERC/DRC 报告 | | `docs/production-readiness.md` | 量产就绪评估与出货门禁 | | `docs/release-manifest.md` | 关键交付文件 SHA-256 | | `firmware/include/cardputer_vml_board.h` | 由网表生成的 GPIO、TCA9535、LoRa 与 I2C 宏 | | `tools/autoroute.py` | DSN 导出 → Freerouting → SES 回导 → DRC | | `tools/apply_official_footprints.py` | 把生成板逐器件替换为官方封装(单进程批量) | | `tools/footprint_matrix.py` | 封装/引脚/供应商证据矩阵 | | `tools/check_design.py` | 模型级门禁:重叠、孔位、网表、BOM、固件映射 | | `tools/export_pos.py` | 从最终 PCB 导出贴片坐标 | | `tools/release_manifest.py` | 生成关键文件 SHA-256 清单 | ## 重新生成 所有生成器共用 `tools/design_data.py`。修改尺寸、器件或网络后运行: ```powershell python tools/generate_kicad.py & 'C:\Program Files\KiCad\10.0\bin\python.exe' tools/apply_official_footprints.py python tools/generate_docs.py python tools/generate_firmware.py python tools/render_preview.py & 'C:\Program Files\KiCad\10.0\bin\python.exe' tools\export_pos.py python tools/check_design.py python tools/footprint_matrix.py ``` `generate_kicad.py` 会重写 PCB 并清空布线;随后必须运行 `apply_official_footprints.py` 换回官方封装,再按 `python tools/autoroute.py` 重新布线。 ## KiCad 校验 ```powershell & 'C:\Program Files\KiCad\10.0\bin\kicad-cli.exe' sch erc --severity-all ` --format report --units mm --output docs\erc-evt2.txt hardware\cardputer-vml.kicad_sch & 'C:\Program Files\KiCad\10.0\bin\kicad-cli.exe' pcb drc --severity-all ` --format report --units mm --schematic-parity --refill-zones --save-board ` --output docs\drc-evt2.txt hardware\cardputer-vml.kicad_pcb ``` 当前结果: - ERC:**0 Errors / 0 Warnings**。 - 静态模型门禁:`check_design.py` 通过,154 器件 / 133 网络 / 649 引脚。 - 封装矩阵:**0 FAIL**,151 PASS,3 BLOCKED(J7、BT1、SPK1,均为供应商证据缺失)。 - DRC:当前 0 违规、467 未连接、0 原理图一致性问题;布线完成后必须达到 0/0/0,以 `docs/drc-evt2.txt` 为准。 ## 设计状态 这是 **EVT2 打样候选**,不是可出货版本。已完成的硬性项: - 所有非机械器件已替换为 KiCad 官方封装,逐脚网络保留。 - 屏、PCB、电池、扬声器、键盘都预留了 M2 固定点;电池不使用穿电芯螺丝。 - LoRa 内置,CN470,U.FL 转后壳 SMA,GPS 不装。 - J4 电池座已移出屏 FPC 区域,J3 EXP 已移到底边,避免 PTH 与 SMD 短路。 出货前仍未闭环: - J7 键盘 FPC 18 脚顺序、BT1 电池 MPN/线序/UN38.3、SPK1 扬声器 MPN/音腔图纸仍为 BLOCKED;J1 四触点映射已确认,首件需通断测试。 - 需要 Ra-01 原厂规格书归档、MK1 麦克风原厂封装图复核。 - 需要完成布线、铺铜、DRC 0/0、Gerber/BOM/坐标同源导出。 - 需要实机 bring-up、RF/EMC/ESD、电池安全、声学、跌落与外壳公差验证。 ## 关键决策 - 内置单 LoRa(Ra-01 / SX1278),不装 GPS;频段 CN470,天线外置 SMA。 - 不做 SMA 板端直插,改用 U.FL + IPEX 转 SMA,避免增加厚度。 - 4 x M2 PCB 固定孔采用非对称布置,避开 ESP32 天线净空、microSD 与扬声器。 - 屏 4 x M2、键盘 4 x M2 压板、扬声器 2 x M2 压条、电池 2 x M2 边缘压条,全部在 `enclosure/cardputer-vml.scad` 中参数化。