开始
欢迎来到开始!这里有我们项目的所有文档可供参阅。
简介
Atmosphere 是一套面向民间自发漂流活动与野外游泳区域的低成本、高实效智能监测预警系统。
它通过部署在溪流/漂流点的传感器单元,实时采集土壤湿度、水流速、风速、温湿度等环境数据,用多因子数学模型判定山洪与泥石流风险等级(0~3 级),并通过网页监控 + 现场 LCD 双端呈现,在危险来临前为现场人员争取撤离时间。
优势
实时监测
多传感器同步采集土壤湿度、水流速、风速、温湿度等环境数据
智能预警
多因子数学模型判定山洪与泥石流风险等级(0~3级)
双端呈现
网页监控+现场LCD双通道预警,确保信息及时送达
低成本
采用开源硬件方案,适合民间自发漂流活动区域部署
高时效
在危险来临前为现场人员争取宝贵撤离时间
易部署
模块化设计,快速部署于溪流、漂流点及野外游泳区域
硬件方案
传感器单元单点成本约 300-400 元,包含以下组件:
| 部件 | 型号 | 接线 |
|---|---|---|
| 主控 MCU | Arduino Nano(ATmega328P,115200) | FQBN arduino:avr:nano:cpu=atmega328 |
| 土壤湿度 | 电容式 | AO→A2,DO→D2 |
| 水流速 | YF-S401 霍尔流量计 | 红→5V,黄→D8,黑→GND |
| 风速 | 三杯式风速计 | 红→A0,黑→GND |
| 温湿度 | DHT11 | s→D4 |
| 现场显示 | 1602 I2C(地址 0x27) | SCL→A5,SDA→A4 |
预警模型
等级体系(数字越大越严重):0 = 正常 / 1 = 一级 / 2 = 二级 / 3 = 三级
滑动基准
24h 窗口 [P10,P95] 归一化,冷启动 15 分钟。
滞回防抖
预警触发后保持(一级 10s / 二级 15s / 三级 20s),避免等级闪烁。
快速开始
项目结构
版本历史
| 版本 | 算法 | 核心改动 |
|---|---|---|
| beta1 | v1 | 原始算法 D<0.30 无门槛;水泵 D7 数字开关 |
| beta2 | v1 | 加门槛(土壤<60%)+ 三级阈值 0.30→0.45 |
| beta3 | v1 | 水泵 D9 PWM 调速 + 网页滑块 + 功率显示 |
| beta4 | v1 | 尖峰滑动基准(自适应 P95)+ 整机功率 |
| beta5 | v2 | LCD 显示 + 算法 v2 + 滞回防抖 + 土壤饱和 |
文档索引
自动同步文档
来自 GitHub 自动同步(docs/ 与 Atmosphere 主仓库),新文档自动出现在这里
demo1
数学预警模型第二版技术文档
2026-08-15 · demo1/algorithm-iterations/zh-CN/数学预警模型第二版技术文档.md
数学预警模型第一版技术文档
2026-08-15 · demo1/algorithm-iterations/zh-CN/数学预警模型第一版技术文档.md
README
2026-08-15 · demo1/algorithm-iterations/README.md
Mathematical-Warning-Model-v1-Technical-Documentation
2026-08-15 · demo1/algorithm-iterations/en-US/Mathematical-Warning-Model-v1-Technical-Documentation.md
Mathematical-Warning-Model-v2-Technical-Documentation
2026-08-15 · demo1/algorithm-iterations/en-US/Mathematical-Warning-Model-v2-Technical-Documentation.md
说明文档
2026-08-15 · demo1/zh-CN/第一版算法部分/beta4/说明文档.md
说明文档
2026-08-15 · demo1/zh-CN/第一版算法部分/beta2/说明文档.md
说明文档
2026-08-15 · demo1/zh-CN/第一版算法部分/beta1/说明文档.md
说明文档
2026-08-15 · demo1/zh-CN/第一版算法部分/beta3/说明文档.md
说明文档
2026-08-15 · demo1/zh-CN/第二版算法部分/beta5/说明文档.md
README
2026-08-15 · demo1/README.md
README
2026-08-15 · demo1/weather/README.md
readme1
2026-08-15 · demo1/weather/风速+温湿度/readme1.md
Documentation
2026-08-15 · demo1/en-US/algorithm-v1/beta4/Documentation.md
Documentation
2026-08-15 · demo1/en-US/algorithm-v1/beta2/Documentation.md
Documentation
2026-08-15 · demo1/en-US/algorithm-v1/beta1/Documentation.md
Documentation
2026-08-15 · demo1/en-US/algorithm-v1/beta3/Documentation.md
Documentation
2026-08-15 · demo1/en-US/algorithm-v2/beta5/Documentation.md
AustinLiang
README
2026-08-15 · AustinLiang/README.md
README.md
README
2026-08-15 · README.md
GJJ
pro_intro
2026-08-15 · GJJ/pro_intro.md
溪流山洪预警系统-技术方案与推导
2026-08-15 · GJJ/溪流山洪预警系统-技术方案与推导.md
slogan
2026-08-15 · GJJ/slogan.md
测量基准
2026-08-15 · GJJ/测量基准.md
wanglihui
README_CLASSIC.md
README_CLASSIC
2026-08-15 · README_CLASSIC.md
文档自动同步自 GitHub docs/ 目录
已知限制
流量计量程窄
YF-S401 实测 0.05~3 L/min,真实洪水流量超量程——v2 标定参数面向当前测试环境,换环境需重新标定。
突变阈值为经验值
土壤 5s+20%、风速 60s+12km/h 未做统计标定。
LCD 仅 ASCII
1602 无中文字库,现场人员需熟悉 0~3 数字含义。
硬阈值分级
0.45/0.55/0.75 阶梯跳变,无置信度/持续性判定(滞回已缓解闪断)。
常见问题
Q1:水泵一开 Arduino 就重启/断连?
水泵不能从 Arduino 5V 取电(会拉垮 5V → CH340 掉电 → 板子复位)。必须独立 5V 电源,GND 与 Arduino 共地,D9 只发 PWM 信号。
Q2:LCD 不亮 / 花屏?
① 检查 I2C 地址(默认 0x27);② 确认 SCL→A5、SDA→A4 没接反;③ 旋转背光电位器调对比度。
Q3:流速一直为 0?
YF-S401 最小启动流量 0.3 L/min,低于此值转子不转(吹气测不了,必须通水)。
Q4:风速数值异常 / 静止也有读数?
三杯式风速计部分型号存在零点偏移,可在固件里做零点校准。
Q5:预警一直不触发?
① 土壤 <60% 时泥石流路径跳过(正常);② 滑动基准冷启动需 15 分钟;③ 检查 D/F 数值是否在阈值附近(0.45/0.55/0.75)。
二次开发
算法迭代
新算法版本在 demo1/algorithm-iterations/ 归档,每代一份技术文档(优势 / 缺陷 / 特点),随迭代更新。
固件
FlowSensor.ino 模块化,新增传感器 = 加引脚定义 + 每秒块加采集 + JSON 加字段。
服务端
server.py 内嵌网页 + 预警模型,五路径独立计算,可单独迭代。
贡献
欢迎提交 Issue 与 PR。涉及硬件接线、标定参数、算法阈值的改动,请在提交前更新对应文档(demo1/algorithm-iterations/)。本项目为教学 / 竞赛 / 公益性质,文档一律不署名。