主要新增功能: 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 (打包时自动复制)
121 lines
3.3 KiB
Markdown
121 lines
3.3 KiB
Markdown
# 机顶辐照度使用说明书
|
||
|
||
## 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`
|