Skip to content

About

ESP32-C6 실내 측위 연구 실험 아카이브 (FTM, ESP-NOW, Wi-Fi roaming, low-power, Swift, Python)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

C6 Experiments

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가 자동으로 다시 가져옴.


📡 indoor-positioning/

비콘 + 게이트웨이 페어 기반 실내 측위 시스템의 점진적 진화 (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)

📨 espnow-pair/

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-distance/

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-utils/

작은 단위의 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 문자열+정수 수신 변종.

🧰 swift-library/

iOS/macOS용 FTMSwift 라이브러리.

폴더 핵심
ftmswift-spm-clean 순수 SwiftPM 라이브러리. WiFiManager/WiFiTypes + Initiator/Responder 실행 타겟.
ftmswift-esp-idf-attempt 동일 코드 + ESP-IDF 빌드 통합 시도 (CMakeLists, Makefile, build.sh, components/).

🐍 python-server/

ESP32 → 서버 데이터 수집 백엔드.

폴더 스택 핵심
flask-socketio-server Flask + Flask-SocketIO HTTP API + WebSocket 명령 + 웹 대시보드. ESP32 게이트웨이 예제 포함.
flask-json-test-server Flask JSON 파일 저장 테스트 서버. 웹 대시보드.

🎓 final-project/

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.py

📂 검사 노트

docs/plans/inspection-notes.md — 각 폴더의 코드 검증 결과 및 버전 명명 근거.

About

ESP32-C6 실내 측위 연구 실험 아카이브 (FTM, ESP-NOW, Wi-Fi roaming, low-power, Swift, Python)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages