开始

欢迎来到开始!这里有我们项目的所有文档可供参阅。

简介

Atmosphere 是一套面向民间自发漂流活动与野外游泳区域的低成本、高实效智能监测预警系统。

它通过部署在溪流/漂流点的传感器单元,实时采集土壤湿度、水流速、风速、温湿度等环境数据,用多因子数学模型判定山洪与泥石流风险等级(0~3 级),并通过网页监控 + 现场 LCD 双端呈现,在危险来临前为现场人员争取撤离时间。

⚠️ 本系统是辅助决策工具,不替代救生员与现场安全管理。山洪预警的黄金法则是上游预警——请结合上游雨量/水位遥测站构成完整预警链。

优势

实时监测

多传感器同步采集土壤湿度、水流速、风速、温湿度等环境数据

智能预警

多因子数学模型判定山洪与泥石流风险等级(0~3级)

双端呈现

网页监控+现场LCD双通道预警,确保信息及时送达

低成本

采用开源硬件方案,适合民间自发漂流活动区域部署

高时效

在危险来临前为现场人员争取宝贵撤离时间

易部署

模块化设计,快速部署于溪流、漂流点及野外游泳区域

硬件方案

传感器单元单点成本约 300-400 元,包含以下组件:

部件型号接线
主控 MCUArduino Nano(ATmega328P,115200)FQBN arduino:avr:nano:cpu=atmega328
土壤湿度电容式AO→A2,DO→D2
水流速YF-S401 霍尔流量计红→5V,黄→D8,黑→GND
风速三杯式风速计红→A0,黑→GND
温湿度DHT11s→D4
现场显示1602 I2C(地址 0x27)SCL→A5,SDA→A4
⚠️ 供电铁律:水泵必须独立供电(单独 5V 电源,只共地)。从 Arduino 5V 取电会拉垮 5V → CH340 掉电 → 板子复位断联。

预警模型

等级体系(数字越大越严重):0 = 正常 / 1 = 一级 / 2 = 二级 / 3 = 三级

最终等级 = max(泥石流 D, 山洪 F, 风速, 流量尖峰, 突变, 土壤饱和) ← 0~3 泥石流 D = 0.30·S̄ + 0.35·Q̄ + 0.20·dQ̄ + 0.15·ΔS̄ (土壤 <60% 时跳过) 山洪 F = 0.60·Q̄ + 0.40·dQ̄ (流量暴涨即触发) 阈值:D/F ≥ 0.45 → 一级;≥ 0.55 → 二级;≥ 0.75 → 三级

滑动基准

24h 窗口 [P10,P95] 归一化,冷启动 15 分钟。

滞回防抖

预警触发后保持(一级 10s / 二级 15s / 三级 20s),避免等级闪烁。

快速开始

# 1. 烧录固件(Arduino IDE,板卡 Nano + 新 Bootloader,115200) # demo1/zh-CN/第二版算法部分/beta5/FlowSensor.ino # 2. 启动服务端(串口) cd demo1/zh-CN/第二版算法部分/beta5/ python3 -u server.py # 3. 打开网页 http://localhost:8080

项目结构

Atmosphere/ ├── README.md # 本文件 ├── README_CLASSIC.md # 旧版 README 存档 ├── demo1/ # Demo 1:算法归档 + 文档 │ ├── zh-CN/ # 中文版 │ ├── en-US/ # 英文版 │ ├── algorithm-iterations/ # 数学预警模型技术文档 │ ├── weather/ # 风速 + 温湿度模块 │ └── media/ # 演示图片与视频 ├── AustinLiang/ # 梁振宇工作区 ├── wanglihui/ # 王立辉工作区 └── GJJ/ # 团队成员工作区

版本历史

版本算法核心改动
beta1v1原始算法 D<0.30 无门槛;水泵 D7 数字开关
beta2v1加门槛(土壤<60%)+ 三级阈值 0.30→0.45
beta3v1水泵 D9 PWM 调速 + 网页滑块 + 功率显示
beta4v1尖峰滑动基准(自适应 P95)+ 整机功率
beta5v2LCD 显示 + 算法 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

2026-08-15 · wanglihui/README.md

readme1

2026-08-15 · wanglihui/风速+温湿度/readme1.md

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/)。本项目为教学 / 竞赛 / 公益性质,文档一律不署名。

联系我们

如需联系开发团队,请发送电子邮件到:liangaustin@hotmail.com

Copyright © AtmoWave Technology 2026-2027