ESP32-C6 기반 실내 측위(Indoor Positioning) 연구 실험 아카이브.
FTM, ESP-NOW, Wi-Fi 로밍, 저전력 동작 등 다양한 무선 통신 패턴을 단계별로 검증한 펌웨어/서버 코드 모음.
컨벤션: 카테고리별로 시간순 + 목적 기반 폴더명 (예:
v1-basic-ftm-espnow→v7-low-power-deepsleep). 빌드 산출물 제외:build/,managed_components/,sdkconfig*.old는.gitignore로 제거됨. 재빌드 시 ESP-IDF가 자동으로 다시 가져옴.
비콘 + 게이트웨이 페어 기반 실내 측위 시스템의 점진적 진화 (7단계).
| 버전 | 폴더 | Beacon / Gateway WiFi | HTTP | 핵심 |
|---|---|---|---|---|
| v1 | v1-basic-ftm-espnow |
STA / AP | ❌ | 기본 FTM + ESP-NOW + SNTP. Gateway 자체 AP. |
| v2 | v2-http-server |
STA / AP | ✅ | + HTTP POST + cJSON + RSSI 필터. 60초 주기 서버 전송. |
| v3 | v3-virtual-gateway |
STA / AP | ✅ | + 가상 게이트웨이 1개 (실 측정 2 + 가상 1). |
| v4 | v4-allsta-mode |
STA / STA | ✅ | All-STA 모드. 외부 공유기 AP 공유, 채널 고정. |
| v5 | v5-roaming-discovery |
STA / STA | ✅ | + 동적 게이트웨이 디스커버리, 로밍 지원. |
| v6 | v6-apsta-relay |
STA / APSTA Relay | ✅ | 아키텍처 전환: Gateway가 Beacon 데이터 인터넷 중계. |
| v7 | v7-low-power-deepsleep |
STA(scan only) / APSTA | ❌ | 초저전력: Wi-Fi 미연결 + ESP-NOW + Deep Sleep 5s + 압축 바이너리. (코드 주석엔 v8) |
ESP-NOW 송수신 페어 (4단계 진화).
| 버전 | 폴더 | 방식 | 채널 | 핵심 |
|---|---|---|---|---|
| v1 | v1-unicast-basic |
유니캐스트 | 1 | 고정 MAC 1:1 sensor 데이터. |
| v2 | v2-broadcast-basic |
브로드캐스트 | 1 | FF:FF MAC, 다중 수신. |
| v3 | v3-broadcast-stats |
브로드캐스트 | 8 | + sender_id, 시퀀스, 최빈값 통계. |
| v4 | v4-multi-sender-rssi |
브로드캐스트 | 13 | + 다중 sender 추적, RSSI, lost_packets. |
FTM (Wi-Fi 802.11mc) 거리 측정 검증.
| 버전 | 폴더 | 핵심 |
|---|---|---|
| v1 | v1-responder-support-test |
외부 AP의 FTM Responder 지원 여부 테스트 (단일 디바이스, 폴더명은 'responder'지만 코드는 Initiator). |
| v2 | v2-initiator-responder-pair |
Initiator + Responder 깨끗한 페어. SSID jah22, ch6. |
작은 단위의 ESP32 검증 유틸 (재사용 가능한 빌딩 블록).
| 폴더 | 핵심 |
|---|---|
wifi-sta-hello |
WiFi STA 연결 + AP 정보 출력 (가장 기본). |
wifi-http-post |
WiFi STA + HTTP POST 클라이언트. |
wifi-roaming-basic |
3초 BSSID 변화 감지 (간단 로밍 모니터). |
wifi-roaming-advanced |
BSSID/채널/RSSI 실시간, 채널 변경 감지. |
mac-address-reader |
STA/AP/BT/ETH MAC 주소 읽기. |
espnow-receiver-string |
ESP-NOW 문자열+정수 수신 변종. |
iOS/macOS용 FTMSwift 라이브러리.
| 폴더 | 핵심 |
|---|---|
ftmswift-spm-clean |
순수 SwiftPM 라이브러리. WiFiManager/WiFiTypes + Initiator/Responder 실행 타겟. |
ftmswift-esp-idf-attempt |
동일 코드 + ESP-IDF 빌드 통합 시도 (CMakeLists, Makefile, build.sh, components/). |
ESP32 → 서버 데이터 수집 백엔드.
| 폴더 | 스택 | 핵심 |
|---|---|---|
flask-socketio-server |
Flask + Flask-SocketIO | HTTP API + WebSocket 명령 + 웹 대시보드. ESP32 게이트웨이 예제 포함. |
flask-json-test-server |
Flask | JSON 파일 저장 테스트 서버. 웹 대시보드. |
ESP32 sender + ESP32 receiver + Python server를 하나로 묶은 최종 데모 번들. ESP-NOW(채널4) → WiFi(STA) → Flask 서버.
각 폴더의 README.md 또는 Prompt.md 참고. 일반적으로:
# ESP-IDF 펌웨어
. $IDF_PATH/export.sh
cd indoor-positioning/v2-http-server/beacon
idf.py set-target esp32c6
idf.py build flash monitor
# Python 서버
cd python-server/flask-socketio-server
pip install -r requirements.txt
python3 server.py
# Swift 라이브러리
cd swift-library/ftmswift-spm-clean
swift build코드 내 WiFi SSID/비밀번호는 YOUR_WIFI_SSID / YOUR_WIFI_PASSWORD 플레이스홀더로 치환됨. 사용 전 본인 환경 값으로 교체 필요.
#define WIFI_SSID "YOUR_WIFI_SSID"
#define WIFI_PASSWORD "YOUR_WIFI_PASSWORD"Flask 서버 SECRET_KEY는 환경변수로 분리:
export FLASK_SECRET_KEY="your-secret-here"
python3 server.pydocs/plans/inspection-notes.md — 각 폴더의 코드 검증 결과 및 버전 명명 근거.