73e49fd528
2번 모듈 신규(raspberry_pi4_sht30/): SHT30 온습도 → cafe24, raw-body X-Signature HMAC, 폐쇄망 오프라인 설치(vendor/install), systemd, CRC/포맷 자가점검. firmware sht30_fw wire 포맷과 byte-parity 검증. 1번 모듈 통합(raspberry_pi4/): 누수+카메라를 동일 서버로. 레거시 sha256(key+json) body-sig → X-Signature HMAC 전환, 사진 canonical=device_id|sensor_id|log_id|timestamp. 서버 통합(php/): api/sensor_data.php 누수 이벤트 수신, api/photo_upload.php 신규(HMAC·finfo·서버생성 파일명·nonce 멱등·sensor 결속), photo.php 인증 사진서빙, dashboard.php 누수 패널+사진, sms_send.php 누수 SMS, config.php 태그/요약. DB: sql/migration_add_leak.sql(가산·멱등), schema_sht30.sql 통합 스키마. 보안 하드닝(외부 펜테스트 대비, 확정 CRITICAL/HIGH 0): cron_heartbeat api_key fail-closed, setup_mfa 부트스트랩 토큰 post-enrollment 잠금, var/ PHP 실행차단, HSTS. 문서/테스트: SYSTEM_OVERVIEW.md, security_hardening_test.php 갱신. 참고: 사용자 요청으로 세션 외 기존 미커밋 변경도 함께 포함. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
5.4 KiB
5.4 KiB
서버실 온습도(SHT30) 모니터링 시스템 v2606 정리 보고서
개요
본 시스템은 서버실 온습도를 24시간 감시하고, 임계 초과(고온/저온/고습/저습)·정상복귀·장비 오프라인/복구 상황을 SMS와 웹 대시보드로 알리는 IoT 기반 모니터링 체계입니다. Sensirion SHT30 센서가 5분 주기로 온습도를 측정하면, STM32F407VGT6 펌웨어가 유선 Ethernet/TLS로 서버에 보고하고, 서버가 임계를 판정해 통보합니다.
시스템 구성
단일 보드 온습도 전용: 메인 MCU는 STM32F407VGT6(Cortex-M4F) 베어메탈 펌웨어이며, 연결은 유선 Ethernet(LAN8720 RMII) + 온칩 TLS(mbedTLS HTTPS)입니다. 단일 보드
sht30_fw(sensor_id=2,device_id=stm32-sht30-01)만 사용합니다. 펌웨어는firmware/, 하드웨어 핀맵은firmware/docs/HARDWARE.md를 참조합니다.
[SHT30] --I2C(0x44)--> [STM32F407VGT6 (sht30_fw)] --유선 Ethernet/TLS--> [Cafe24 PHP API]
|
[MySQL DB]
|
[SMS 발송 / 대시보드]
인증: 펌웨어는
X-Signature = lowercase_hex(HMAC-SHA256(키=API_KEY, 메시지=요청본문 바이트))(raw-body) 헤더로 서명하며, 서버는 이 서명을 검증합니다. 온습도 임계 판정은 모두 서버(php/config.phpMETRIC_*상수 +api/sensor_data.php)에서 수행하므로, 폐쇄망에서 임계값 변경 시 서버 설정만 바꾸면 되고 펌웨어 재플래시가 필요하지 않습니다.
측정·임계
- 측정 주기: 5분(펌웨어
APP_SHT30_REPORT_INTERVAL_SEC=300). 최초 1회 startup, 이후 periodic. - 명령
0x2C06(high-repeatability) → 약 20ms 대기 → 6바이트 read → 온도(℃)/상대습도(%) 변환. - 임계(서버 판정,
METRIC_*;config.local.phpoverride):- 고온 30℃ / 저온 10℃ / 고습 70% / 저습 20%
- 복귀 히스테리시스 ±1℃ · ±3%
- 동일 종류 경보 쿨다운 1800초(30분)
이벤트 / SMS 정책
| 이벤트 | 조건 | DB | SMS |
|---|---|---|---|
startup |
기기 시작 첫 측정 | sensor_log |
X |
periodic |
정상 주기 측정(5분) | sensor_metric |
X |
| 고온/저온/고습/저습 경보 | 측정값이 임계 초과 | sensor_metric.metric_status |
O (종류별 30분 쿨다운) |
| 정상복귀 | 경보 후 히스테리시스 포함 정상 회복 | sensor_metric |
O (1회) |
| 장비 오프라인 | 마지막 수신 후 HEARTBEAT_TIMEOUT_SEC(기본 1200초=20분) 초과 |
sensor_status |
O |
| 장비 복구 | 오프라인 후 재수신 | sensor_status |
O |
운영 정책
| 항목 | v2606 기준 |
|---|---|
| 측정 주기 | 5분(펌웨어 300초) |
| 임계 판정 | 서버(METRIC_*), 폐쇄망에서 설정 변경으로 조정 |
| 고온/저온/고습/저습 SMS | 임계 초과 시 발송, 종류별 30분 쿨다운 |
| 정상복귀 SMS | 히스테리시스 포함 회복 시 1회 |
| 장비 오프라인 | 마지막 수신 후 1200초(20분) 초과 시 알림 |
| 오프라인 체크 | cron_heartbeat.php 주기 실행 |
| 운영 자가진단 | 설정값, 필수 테이블(sensor_metric), 권한, SMS 실패 표시 |
| 운영 요약 | 30일 경보/복귀/오프라인, SMS 현황 |
| 설치 점검 | DB/마이그레이션/권한/SMS 테스트 |
| 월간 보고서 | 월별 임계 경보/복귀/오프라인/SMS 현황 CSV 및 인쇄 출력 |
DB 구성
- 신규 설치:
sql/schema_sht30.sql하나(테이블sensor_log,sensor_status,sensor_metric,sms_log). - 기존 누수 설치 전환:
sql/migration_drop_leak.sql(레거시 누수 컬럼/테이블 정리,sensor_metric보장).
백업 위치
정리 전 원본은 아래 폴더에 보관했습니다.
_backup/pre_v2605_20260519/
남은 운영 작업
서버 (PHP/DB)
- 운영 서버의 실제 DB/SMS/API 키를 새 값으로 교체합니다.
php/config.local.example.php를 기준으로 운영 서버에config.local.php를 만듭니다(온습도 임계METRIC_*확인).- 신규 DB에는
schema_sht30.sql을 실행합니다. 기존 누수 설치는migration_drop_leak.sql로 전환합니다. cron_heartbeat.php를 1분 간격 cron으로 등록합니다.
펌웨어 (STM32F407) — firmware/docs/ 참조
firmware/common/secrets.h를secrets.h.example에서 생성하고APP_API_KEY를 서버API_KEY와 동일하게 설정합니다.firmware/certs/server_ca.c의 자리표시자 CA를 실제 Cafe24 루트 CA로 교체합니다(firmware/certs/README.md).firmware/common/app_config.h의APP_API_HOST/APP_API_PATH와 네트워크 주소(DHCP/static),APP_SHT30_I2C_ADDR(0x44),APP_SHT30_REPORT_INTERVAL_SEC(300)을 운영 값으로 설정합니다.- 폐쇄망 빌드 머신에서 의존성을 벤더링한 뒤
sht30_fw를 빌드·플래시합니다(firmware/docs/BUILD_OFFLINE.md). - 하드웨어 확정 필요(TODO(hw)): LAN8720 PHY 주소·REF_CLK 소스, RTC 클럭원(LSE/LSI), HSE 주파수, 상태 LED 핀. 상세는
firmware/docs/HARDWARE.md. SHT30 I2C는 PB6/PB7, 0x44, 4.7kΩ 풀업으로 확정. - 첫 부팅 후 USART3(PD8/PD9, 115200) 콘솔 로그로 I2C 측정/네트워크/SNTP/TLS 핸드셰이크/서버 200 응답을 확인합니다.