V1.1 正式版本提交
主要新增功能： 1. 添加 Debian 打包脚本 (pack_deb.sh)，支持一键打包部署 2. 新增机顶辐照度使用说明书 (README.md)，记录系统配置和使用方法 3. 添加 SD 卡配置更新功能 (configdatairis 文件夹)，便于现场配置 4. 新增光谱仪打开失败检测，两灯同时闪烁提示异常 5. 添加说明书自动拷贝到 SD 卡功能 详细修改： - main.cpp: * 添加 SD 卡 configdatairis 配置更新逻辑 * 添加说明书自动拷贝到 /home/data/ * 优化 stopwait.txt 判断逻辑 - Source/Capture/MainGrabber.cpp: * 添加光谱仪初始化失败检测，失败时两灯同时闪烁 - Source/Logger/Logger.h: * 添加日志功能支持 - pack_deb.sh: * 新增完整的 Debian 打包脚本 * 支持自动构建、复制文件、生成 postinst/prerm - root/start.sh: * 添加 mkdir 确保 /home/data 目录存在 - root/DCTable.txt: * 添加默认暗电流校准表文件 - README.md: * 编写完整的中文使用说明书 * 包含硬件连接、目录结构、配置说明、GPIO 指示灯含义等 依赖文件： - /root/DeviceSettings.ini (需另行配置) - /root/机顶辐照度使用说明书.md (打包时自动复制)
This commit is contained in:
120
README.md
120
README.md
@ -0,0 +1,120 @@
|
||||
# 机顶辐照度使用说明书
|
||||
|
||||
## 1. 系统概述
|
||||
|
||||
机顶辐照度使用说明书 支持 GPS 北斗双模定位、实时暗背景扣除等功能。
|
||||
|
||||
## 2. 硬件连接
|
||||
|
||||
光谱仪 |USB(下)
|
||||
GPS (内置)
|
||||
|
||||
## 3. 目录结构
|
||||
|
||||
**SD 卡根目录** (挂载到 /home/data/)
|
||||
|
||||
```
|
||||
SD卡根目录/
|
||||
├── configdatairis/ # 配置更新文件夹（可选）
|
||||
│ ├── DeviceSettings.ini # 设备配置文件
|
||||
│ └── DCTable.txt # 暗电流校准表
|
||||
├── Setting/
|
||||
│ └── DeviceSettings.ini # 设备配置文件
|
||||
├── Data/
|
||||
│ ├── DCTable.txt # 暗电流校准表
|
||||
│ └── WavelengthInfo.txt # 波长校准信息（程序生成）
|
||||
├── Log/ # 日志目录
|
||||
└── stopwait.txt # 启动等待文件（可选）
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 4. 配置文件
|
||||
|
||||
### DeviceSettings.ini
|
||||
|
||||
```ini
|
||||
[FS]
|
||||
Model=IS1 # 光谱仪型号：IS1, IS11, FLAME
|
||||
Port=/dev/ttyUSB0 # 串口路径
|
||||
UID=FLMS15814 # 设备序列号
|
||||
Depth=65535 # 积分深度
|
||||
AEMax=0.85 # 自动曝光最大值
|
||||
AEMin=0.60 # 自动曝光最小值
|
||||
MinSI=1000 # 最小光谱强度
|
||||
|
||||
[GPS]
|
||||
Port=/dev/ttyS1 # GPS 串口
|
||||
Baud=9600 # GPS 波特率
|
||||
```
|
||||
|
||||
### 支持的光谱仪型号
|
||||
|
||||
- `IS1` - Iris S1
|
||||
- `IS11` - Iris S11
|
||||
- `FLAME` - Ocean Optics FLAME
|
||||
|
||||
## 5. 输入输出文件
|
||||
|
||||
| 文件 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| DeviceSettings.ini | 输入 | 设备参数配置 |
|
||||
| DCTable.txt | 输入 | 暗电流校准表 |
|
||||
| WavelengthInfo.txt | 输出 | 波长校准信息（程序生成） |
|
||||
| *.dat | 输出 | 采集的光谱数据文件 |
|
||||
|
||||
## 6. 配置更新流程
|
||||
|
||||
如果在 SD 卡上放置 `configdatairis` 文件夹，程序启动时会自动拷贝其中的配置文件到 `/root` 并删除该文件夹。
|
||||
|
||||
```
|
||||
1. 在 SD 卡根目录创建目录：configdatairis/
|
||||
2. 放入配置文件：
|
||||
- DeviceSettings.ini
|
||||
- DCTable.txt
|
||||
3. 启动程序，配置文件会自动复制到系统 /root/ 目录
|
||||
4. configdatairis 文件夹会被自动删除
|
||||
```
|
||||
|
||||
## 7. 使用流程
|
||||
|
||||
### 首次部署
|
||||
|
||||
1. 格式化 SD 卡（FAT32）
|
||||
2. 创建必要目录结构：
|
||||
```
|
||||
SD卡根目录/
|
||||
├── Setting/
|
||||
├── Data/
|
||||
└── Log/
|
||||
```
|
||||
3. 部署 deb 包或手动复制可执行文件到 `/home/pi/bin/`
|
||||
4. 配置文件会随程序从系统 /root/ 复制到 SD 卡
|
||||
|
||||
### 正常启动
|
||||
|
||||
1. 系统上电，TF 卡自动挂载到 /home/data/
|
||||
2. 启动程序：`/home/pi/bin/IRIS_FODIS &`
|
||||
|
||||
### 启动等待
|
||||
|
||||
如果 **不存在** SD 卡根目录下的 `stopwait.txt` 文件，程序会等待 30 秒再继续（用于调试时等待调试器附加）。
|
||||
|
||||
### 采集数据
|
||||
|
||||
程序自动采集光谱数据，保存到 SD 卡根目录 `/Data/` 目录，文件名格式为时间戳。
|
||||
|
||||
## 8. GPIO 指示灯
|
||||
|
||||
| 灯状态 | 含义 |
|
||||
|--------|------|
|
||||
| 灯1与灯2交替闪烁（各亮200ms） | TF 卡检测失败（卡未挂载），程序等待中 |
|
||||
| 灯1与灯2同时闪烁（各亮200ms） | 光谱仪打开失败，程序异常 |
|
||||
| 灯1亮，灯2灭 | GPS 时间同步中 |
|
||||
| 灯1灭，灯2闪烁（亮200ms） | 数据采集中（光谱采集→写卡） |
|
||||
| 灯1灭，灯2常亮 | 采集完成/待机 |
|
||||
|
||||
## 9. 版本信息
|
||||
|
||||
- 当前版本：1.1
|
||||
- 版本号文件：SD卡根目录 `/version`
|
||||
|
||||
Reference in New Issue
Block a user