Files
IRIS_FODIS/README.md
xin 60559291f2 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 (打包时自动复制)
2026-03-23 14:32:12 +08:00

121 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 机顶辐照度使用说明书
## 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`