NamazuHaUrokoGaNai
自宅地震計システム。IIS3DHHC 加速度センサ + ESP32 で 100Hz サンプリングし、
気象庁の計測震度算出法でリアルタイムに揺れを評価する。24時間365日稼働を目標とする。
Qiita記事「地震観測用加速度センサ5種の性能比較」
(https://qiita.com/compo031/items/e62d0a0e1425c5e1efe8) がきっかけ。
全体像
[IIS3DHHC] --SPI--> [ESP32]
├─ 測定タスク(Core1): 100Hzポーリング → リングバッファ
├─ 検知タスク: リアルタイム震度を常時計算 → 閾値超えで即時アラート
└─ 送信タスク(Core0): 30秒バッチPOST / NTP / ローカル退避・バックフィル
│ HTTPS (Lambda Function URL, HMAC認証)
v
[ingest Lambda] ─→ S3 raw/YYYY/MM/DD/HH/*.bin (60日でexpire)
│ └─→ DynamoDB devices（最終受信を記録＝生存台帳）
│ (非同期起動)
v
[detect Lambda] ─ 直近数分を再計算・検証
├─→ DynamoDB events（重複排除）
├─→ S3 events/<id>/ へ波形コピー（永久保存）
└─→ Slack 通知（Notifier差し替え可能）
[watchdog Lambda] ← EventBridge 定期起動。devices の最終受信からの経過を見て
└─→ 欠測を Slack 通知（1日ごと再送・受信再開で復帰通知）
[dashboard] S3+CloudFront 静的SPA ←→ [api Lambda]（波形・イベント・デバイス生存）
ディレクトリ
| dir | 内容 |
|---|
firmware/ | ESP32 ファームウェア (PlatformIO / Arduino core) |
lambda/ | ingest / detect / api の Lambda (Python) |
terraform/ | AWS リソース定義 |
dashboard/ | 波形・イベント可視化 SPA |
tools/ | シリアルキャプチャ・震度計算・バックテスト (Python) |
docs/ | 設計メモ |
計測震度の算出ロジックは tools/jismo/ を単一の真実として持ち、
detect Lambda はこれを共有する。ファームウェアの C++ 実装(firmware/lib/Shindo)は
これに対して数値照合してから使う。
送信基盤（バッチのバッファ・HMAC署名POST・LittleFS退避とバックフィル・NTP同期・
デバイス生存台帳・通知）は地震に依存しないので
batch-uplink に切り出し、周波数モニタ
Electabuzz と共有している。C++ は
firmware/platformio.ini の lib_deps、Python は terraform/build_lambda.sh の
UPLINK_VERSION で、いずれもタグで pin する。
実装フェーズ
- センサ検証 — SPIドライバ + 100Hzサンプリング + シリアル出力。静置ノイズが計測震度0近傍か確認 (
tools/)
- クラウドingest — Terraform で S3/ingest Lambda、ファームで30秒バッチ送信・リトライ・バックフィル
- 検知・通知 — デバイス速報 + クラウド確定報のハイブリッド、Slack通知、イベント波形の永久保存
- ダッシュボード — 直近n分の波形とイベントブラウザ
- 運用強化 — OTA、欠測監視、生活振動チューニング
詳細は docs/design.md と plan.md を参照。
リポジトリの歩き方（各ドキュメントの索引・運用手順）は CLAUDE.md にまとめてある。
ライセンス
MIT (see LICENSE)
