OpenScan 项目安装与使用指南

1. 项目目录结构及介绍

OpenScan 项目采用模块化设计，其目录结构如下：

OpenScan/
├── OpenScan-Documenation  文档资料存储仓库
├── OpenScan-Firmware     固件源代码
├── OpenScan-Design       3D打印模型和其他设计文件
├── OpenScan-PCB          PCB设计讨论区
├── OpenScanCloud         图像处理Web API
└── OpenScan-ML           基于机器学习的新工具开发

• OpenScan-Documenation: 包含所有关于OpenScan的文档和教程。
• OpenScan-Firmware: 提供了Raspberry Pi驱动的相机/电机控制器固件。
• OpenScan-Design: 存储3D打印模型和相关设计资源。
• OpenScan-PCB: 用于讨论和改进PCB设计的区域。
• OpenScanCloud: 开发用于摄影测量图像处理的Web应用程序接口。
• OpenScan-ML: 针对项目引入机器学习技术的开发。

每个子目录都有其特定的用途，为OpenScan的不同部分提供支持。

2. 项目的启动文件介绍

在OpenScan项目中，启动文件通常位于固件（Firmware）子目录下。这里主要包括两个关键文件：

1. firmware-setup.sh: 这是固件的设置脚本，它负责配置你的Raspberry Pi系统以运行OpenScan的硬件控制软件。
2. start-scanner.py: 扫描器的启动脚本，通过这个Python脚本来控制相机和电机进行扫描操作。

要启动扫描过程，你需要先执行firmware-setup.sh来准备环境，然后运行start-scanner.py启动扫描。

# 在OpenScan-Firmware目录中
$ ./firmware-setup.sh
$ python3 start-scanner.py

请注意，这些命令可能需要根据你的具体环境和项目的版本进行调整。

3. 项目的配置文件介绍

OpenScan 的配置文件主要位于OpenScan-Firmware/config/目录下，其中包括以下重要文件：

1. config.ini: 核心配置文件，包含了相机参数、扫描模式、运动速度等选项。
2. motor_settings.py: 电机设置脚本，定义了电机的参数，如步骤大小、加速和减速时间等。
3. camera_settings.py: 相机设置脚本，管理摄像头的捕获参数，如分辨率、曝光时间和帧率。

配置文件通常采用.ini或.py格式，可以使用文本编辑器打开并修改。当你需要自定义扫描仪的行为时，更改这些配置文件将影响设备的行为。务必谨慎操作，并确保在修改后保存文件。

这就是OpenScan项目的基本安装与使用流程，希望对你有所帮助。更多详细的说明和指导可以查看官方文档以及各子仓库的README文件。