OGScope - 电子极轴镜

基于 Raspberry Pi Zero 2W 的智能电子极轴镜系统，用于天文摄影中的精确极轴校准。

English | 中文

硬件平台

• 主控: Raspberry Pi Zero 2W
• 操作系统: Raspberry Pi OS
• 摄像头: IMX327 MIPI 传感器
• 显示屏: 2.4寸 SPI LCD
• 通信: WiFi 无线控制

功能特性

Phase 1 - 基础功能 (MVP)

• ✅ 实时视频预览
• ✅ Web 远程控制
• ✅ 基础极轴校准
• ✅ 相机参数调整

Phase 2 - 完整功能

• ⏳ SPI 屏幕显示
• ⏳ 自动板块求解
• ⏳ 移动 App 控制
• ⏳ 校准数据管理

Phase 3 - 生态集成

• ⏳ INDI 驱动支持
• ⏳ 赤道仪控制
• ⏳ 多设备联动

快速开始

环境要求

• Python 3.9+
• 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

Web 界面访问

启动后访问: http://raspberrypi.local:8000 或 http://:8000

开发

详见 开发文档

远程开发配置 (PyCharm Pro)

推荐使用 PyCharm 的文件同步功能进行开发：

1. 配置 SSH 连接到 Raspberry Pi Zero 2W
2. 设置文件自动同步到开发板
3. 在本地开发，远程测试硬件功能
4. 详细步骤见 PyCharm 文件同步开发指南

项目结构

OGScope/
├── ogscope/           # 主应用包
│   ├── core/         # 核心功能模块
│   ├── hardware/     # 硬件接口层
│   ├── web/          # FastAPI Web 服务
│   ├── ui/           # SPI 屏幕界面
│   ├── algorithms/   # 天文算法
│   └── utils/        # 工具函数
├── tests/            # 测试代码
├── docs/             # 文档
├── scripts/          # 部署脚本
└── web/              # Web 前端资源

许可证

本项目采用 CC BY-NC-SA 4.0 许可证

• 署名 (BY): 必须标明原作者
• 非商业性使用 (NC): 禁止商业用途
• 相同方式共享 (SA): 衍生作品必须使用相同许可证

详见 LICENSE 文件

贡献

欢迎提交 Issue 和 Pull Request！