IRIS_FODIS/README.md

# 机顶辐照度使用说明书

## 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`