# Super Depth-of-Field Microscope / 超景深显微镜

> An open-source motorized focus-stacking digital microscope.
> 一台开源的、电机驱动自动对焦合成（focus-stacking）数码显微镜。

[![Hardware License: CERN-OHL-S-2.0](https://img.shields.io/badge/Hardware-CERN--OHL--S--2.0-blue.svg)](./LICENSE-hardware.md)
[![Firmware License: MIT](https://img.shields.io/badge/Firmware-MIT-green.svg)](./LICENSE-firmware.txt)

---

## ⚠️ 发布前请先补全（占位符说明）

本仓库由整理脚本自动生成，文中所有 `<...>` 都是**待你填写的占位符**。请在发布到 GitHub / Hackaday.io 之前替换它们。下面「项目信息待办」列了需要你提供的内容。

---

## 1. 项目简介 / Overview

**中文：**
<一句话介绍：这是一台超景深数码显微镜，通过步进电机驱动 Z 轴（镜头/载物台）逐层移动，在不同焦平面拍摄多张图像，再用景深合成算法叠加成一张全程清晰的图像，从而突破单次成像的景深限制。>

**English:**
<One-line intro: An open-source super depth-of-field digital microscope. A stepper motor drives the Z axis to capture images at multiple focal planes, which are then combined via focus-stacking to produce a single fully-in-focus image, overcoming the depth-of-field limit of a single exposure.>

- **放大倍率 / Magnification:** `<例如 20×–200×，待填>`
- **有效景深 / Effective DoF:** `<待填>`
- **Z 轴行程 / Z travel:** `<待填 mm>`
- **典型用途 / Use cases:** `<PCB 检修 / 焊点检查 / 昆虫与材料观察 / 教学演示，待填>`

## 2. 主要特性 / Features

- 电机驱动 Z 轴自动调焦，支持等步距连续拍摄（focus stacking）
- 限位开关实现 Z 轴硬/软限位与回零
- 铝型材 + 钣金结构，刚性好、易复制
- 工业相机 + 可换镜头，成像质量高
- 全套机械设计开源，提供中性 STEP 格式

## 3. 硬件构成 / Hardware (from CAD assembly)

> 以下根据装配体 `超景深显微镜.SLDASM` 推断，请核对并补全型号。

| 子系统 | 关键件 | 说明 / 待填 |
|---|---|---|
| 控制器 | Arduino Mega 2560 (+ 扩展盾板) | `<固件见 /firmware，待补>` |
| 运动 | NEMA 17 步进电机 (39mm) | `<驱动器型号？A4988/DRV8825/TMC2208？待填>` |
| 限位 | 限位开关 ×N | Z 轴上下限位/回零 |
| 成像 | 海康 MV-CS200-10UM(UC) 工业相机 | `<2000 万像素，接口 USB3，待确认>` |
| 镜头 | `<镜头型号 / 倍率，待填>` | 镜头底座 1/2/3 见 CAD |
| 照明 | 灯板 (LED) | `<电压/功率，待填>` |
| 结构 | 铝型材、底板、立柱、夹片等 | 见 /cad |

## 4. 仓库结构 / Repository Layout

```
.
├── README.md                 本文件
├── LICENSE-hardware.md        硬件设计许可证 (CERN-OHL-S-2.0)
├── LICENSE-firmware.txt       固件/代码许可证 (MIT)
├── bom/BOM.csv               物料清单 (待补全)
├── cad/                      SolidWorks 原始零件 (.SLDPRT/.SLDASM)
│   └── standard-parts/       标准件（螺钉螺母等，GB 标准）
├── mechanical-step/          中性 STEP 格式（跨软件可打开）★对外复现用
├── firmware/                 Arduino 固件 (待补)
├── docs/                     装配/使用说明、接线图 (待补)
└── images/                   实物照片、渲染图、显微样张 (待补)
```

## 5. 复现指南 / How to Build

> 待补全。建议至少包含：BOM 采购 → 打印/加工结构件 → 机械装配 → 接线 → 烧录固件 → 相机软件设置 → 拍摄与景深合成流程。

景深合成可用开源软件：**[Hugin/enfuse]**、**[Helicon Focus(商业)]**、Python 的 OpenCV/`focus-stack` 等。`<选定后在此说明>`

## 6. 许可证 / License

- **机械/硬件设计**（CAD、STEP、结构）：**CERN-OHL-S v2.0**（强 copyleft，衍生设计须同样开源）。见 [`LICENSE-hardware.md`](./LICENSE-hardware.md)。
- **固件与上位机代码**：**MIT**。见 [`LICENSE-firmware.txt`](./LICENSE-firmware.txt)。

### 第三方件声明（重要）
以下模型为**第三方/标准件**，版权归原方所有，**不在本项目开源授权范围内**，仅为装配参考：
- `NEMA 17 Stepper Motor 39mm`、`MV-CS200-10UMUC`（海康相机）、`USB_Type_B`、`Mega With Narrow Shield Assembly`（Arduino）、`标准件/` 内的 GB 标准螺钉螺母。
- 如需重新分发，请确认其各自来源的许可条款。`<请核实这些模型的下载来源>`

## 7. 作者与引用 / Author & Citation

- 作者 / Author: `<你的名字或网名 / 团队，待填>`
- 单位 / Affiliation: `<学校/实验室，可选>`
- 联系 / Contact: `<邮箱或主页，可选>`
- 项目主页 / Project page: `<Hackaday.io 链接，发布后回填>`

如果本项目对你有帮助，欢迎注明出处并回链。

---

## 📋 项目信息待办（请回答后我来替换占位符）

1. 一句话定义 + 放大倍率/景深/Z 行程
2. 步进电机驱动器型号、相机/镜头确切型号、照明参数
3. 是否有固件/上位机代码？路径在哪？
4. 作者署名信息
5. 这些 CAD 是否原创；第三方模型下载来源
6. 景深合成用什么软件