基于 Raspberry Pi Zero 2W 的智能电子极轴镜系统，用于天文摄影中的精确极轴校准。
English | 中文
- 主控: Raspberry Pi Zero 2W
- 操作系统: Raspberry Pi OS
- 摄像头: IMX327 MIPI 传感器
- 显示屏: 2.4寸 SPI LCD
- 通信: WiFi 无线控制
- ✅ 实时视频预览
- ✅ Web 远程控制
- ✅ 基础极轴校准
- ✅ 相机参数调整
- ⏳ SPI 屏幕显示
- ⏳ 自动板块求解
- ⏳ 移动 App 控制
- ⏳ 校准数据管理
- ⏳ INDI 驱动支持
- ⏳ 赤道仪控制
- ⏳ 多设备联动
- 🔭 精确校准: 高精度极轴校准算法
- 📱 远程控制: Web 界面和移动 App
- 🖥️ 本地显示: 2.4寸 SPI LCD 实时显示
- 🌐 生态集成: 支持 INDI 协议
- 处理器: Raspberry Pi Zero 2W (ARM Cortex-A53)
- 相机: IMX327 传感器 (1920x1080)
- 显示: 2.4寸 SPI LCD (240x320)
- 软件: Python 3.10+ + FastAPI
- Python 3.10+
- Poetry 1.2+
- Raspberry Pi Zero 2W (Raspberry Pi OS)
# 克隆项目
git clone https://github.com/OG-star-tech/OGScope.git
cd OGScope
# 安装依赖（使用 Poetry）
poetry install
# 激活虚拟环境
poetry shell
# 运行程序
python -m ogscope.main开发板一键部署、WiFi 热点与 **/debug/system** 等以 docs/development/wifi-nm.md 与 docs/development/README.md 为准。
启动后访问: http://raspberrypi.local:8000 或 http://:8000
- 文档索引（按主题 A–E 分组） | English — 板上运维、API/契约、外部集成、调试与贡献等全部入口
- 快速开始 | English
- 开发指南（部署与调试） | English
用户手册、组装指南等扩展文档尚未纳入仓库；请以 文档索引 为准。
详见 开发指南（中文） / Development Guide (English)；其他主题见 文档索引。
当前推荐流程详见 开发指南：
- 在本地 IDE 编写代码
- 手动上传代码到开发板
- 使用
systemd重启并验证服务
OGScope/
├── ogscope/
│ ├── domain/ # 领域层（camera/analysis/network/system/shared）
│ ├── core/ # 核心契约编排（core/v1）
│ ├── web/ # FastAPI 入口与 API 路由（core/dev）
│ ├── platform/ # 平台与基础设施
│ │ ├── hardware/ # 设备驱动（相机、WiFi、GPIO 等）
│ │ ├── hardware_plane/ # 共享硬件平面（契约与编排）
│ │ ├── adapters/ # 边界适配层
│ │ ├── ui/ # SPI 屏本地界面（预留）
│ │ └── indi/ # INDI 集成（预留）
│ ├── algorithms/ # 算法模块
│ └── utils/ # 通用工具
├── web/spa/ # 前端源码（Vite + React）
├── web/static/analysis-lab/ # 前端构建产物
├── tests/ # 测试
├── docs/ # 文档
└── scripts/ # 部署/运维脚本
本项目采用 CC BY-NC-SA 4.0 许可证
- 署名 (BY): 必须标明原作者
- 非商业性使用 (NC): 禁止商业用途
- 相同方式共享 (SA): 衍生作品必须使用相同许可证
详见 LICENSE 文件
欢迎提交 Issue 和 Pull Request！详见 贡献指南