From 4252464ef68d07be2068080ce30e50cc52181a5a Mon Sep 17 00:00:00 2001 From: jjangddu Date: Tue, 26 May 2026 10:26:00 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20v6=20=EC=A0=84=EC=B2=B4=20=EC=97=85?= =?UTF-8?q?=EB=8D=B0=EC=9D=B4=ED=8A=B8=20(1.0.0-design,=20VBTFW0116=20?= =?UTF-8?q?=EC=A7=9D,=202026-05-26=20=EA=B8=B0=EC=A4=80)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit a1042b8(v5) 이후 13개 커밋을 반영해 세 문서 일괄 갱신. USER_GUIDE.md: - 헤더: VBTAND0101 → 1.0.0-design (versionCode 24), 권장 펌웨어 VBTFW0116 - PIN DEMO 자동통과 안내 (배포 전 정리 필요) - Personalization 평행 2-카드 (Maximum Bladder Capacity + Catheter Threshold) - Sensor Alignment 리디자인 (38sp 큰 타이틀, pubic bone 빨강, 3-stop gradient, Canvas 화살표/아치 제거) - Measurement Screen top bar에 Home 아이콘 + Voiding/ 텍스트 + 48sp Recorded Dialog - Auto Scan 600ms로 단축 + 측정 사이클 ~330ms 실측 안내 - 설정 패널 폰/태블릿 자동 폰트 분기 (fontScale 표 추가) - Dev Mode 추가 기능 (DeviceScan 측정 직진입 버튼, Status 더미 주입) - Navigation에 placementFromMonitoring 라우팅 분기 설명 + startFromHome fix VesiScan_Android_Pipeline_Summary.md: - v6 주요 변경 요약 (헤더에 한눈 보기) - §5.1 BLE 통신: Connection Parameter 협상 (MTU 247, CONN_PRIORITY HIGH), maa throttle state-based gate, 측정 사이클 실측 표 - 측정 흐름: Auto/Single Scan 600ms 동기화 + Voiding 시 자동 stop - 연속 스캔 동작: Placement loop 1000 → 600ms + v6 화면 디자인 변경 박스 - §14 BLE 명령어 포맷: VBTFW0116 신규 사항 (pending slot 1→8, 안드로이드 짝꿍 변경) - §22 향후 과제: v6 완료 항목 12개 추가 docs/ALGORITHM_COMPARISON.md: - Placement loop 1s → 600ms, canSendMaa 게이트 단계 명시 - v6 BLE 사이클 실측 (330ms 평균) - Measurement Modes: 800 → 600ms, Voiding 자동 stop - 신규 섹션: BLE maa Throttle — State-Based Gate (배경/구현/효과/logcat 키워드) Co-Authored-By: Claude Opus 4.7 (1M context) --- USER_GUIDE.md | 118 ++++++++++++++++++++---- VesiScan_Android_Pipeline_Summary.md | 133 +++++++++++++++++++++++++-- docs/ALGORITHM_COMPARISON.md | 77 +++++++++++++++- 3 files changed, 296 insertions(+), 32 deletions(-) diff --git a/USER_GUIDE.md b/USER_GUIDE.md index 08a8597..5bdb847 100644 --- a/USER_GUIDE.md +++ b/USER_GUIDE.md @@ -1,7 +1,8 @@ # VesiScan-Basic User Guide -## App Version: VBTAND0101 -## Last Updated: 2026-05-11 +## App Version: 1.0.0-design (versionCode 24) +## Last Updated: 2026-05-26 +## Recommended Firmware: **VBTFW0116** (pending slot 1→8 확장, ADC drop 안정) --- @@ -11,10 +12,13 @@ 1. Install the app and open it 2. Complete the onboarding screens 3. Register your information (name, age, height, weight) -4. Set a 4-digit PIN +4. ~~Set a 4-digit PIN~~ — **현재 빌드는 PIN 데모 자동통과**: PinView 진입 시 즉시 verified 처리 (시연용) 5. You will arrive at the **Home** screen +> ⚠️ **DEMO 빌드 표시**: 현재 빌드는 PIN 잠금이 우회됩니다 ([PinView.kt:23-29](app/src/main/java/com/example/medilightv2android/ui/views/pin/PinView.kt#L23-L29)). 원본 UI는 `if (false) { ... }` 안에 보존되어 있어 배포 시 1줄 제거로 복구 가능. 배포 전 정리 체크리스트 참조. + ### Home Screen +- 큰 **Bladdy 캐릭터** (3× 확대, 최대 660dp, 작은 화면에선 90% 캡) - Tap **Start** to begin - The app version is displayed below "Smart Bladder Monitoring" - To enable Developer Mode: tap the Bladdy character **3 times quickly** (within 1.5 seconds) @@ -32,9 +36,25 @@ - The app waits up to 30 seconds for pairing to complete 5. Once paired, you will move to the Personalization screen -### Personalization -- Set your **Max Volume** (200-800 mL, default: 500 mL) -- Tap **Continue** to proceed to Sensor Alignment +### Personalization (전면 리디자인 — 평행 2-카드) + +상하 정렬된 두 카드로 구성: + +**Card 1: Maximum Bladder Capacity** +- 큰 숫자 표시 (예: `500` 64sp ExtraBold + `mL` 24sp) +- 56dp 원형 솔리드 **StepperButton −/+** 좌우 배치 +- 슬라이더 (200~800 mL, 50 단위, `roundToInt()` 절삭 fix 적용) +- 카드 헤더 34sp ExtraBold + +**Card 2: Catheter Threshold** +- 3분할 텍스트: `Level` 24sp + `7` 64sp + `/10` 24sp (Card 1과 픽셀 매칭) +- 56dp StepperButton −/+ +- 슬라이더 Level 1~10 (`roundToInt` 적용) +- 카드 헤더 34sp ExtraBold + +두 카드는 64dp 간격으로 수직 중앙 정렬. Bladdy 히어로는 상단에 동적 사이징. + +Tap **Continue** to proceed to Sensor Alignment. --- @@ -42,6 +62,13 @@ This step ensures the sensor is positioned correctly over your bladder for accurate measurement. +### 화면 디자인 (리디자인 적용) +- **큰 타이틀 "Sensor Alignment"** 38sp ExtraBold 검정 (Maximum Bladder Capacity 톤 통일) +- **3-stop vertical gradient 배경** (MlTeal 14% / 흰 / MlPrimary 10%) — GREEN 진입 시 단색 톤으로 덮임 +- **Hint 텍스트에서 "pubic bone" 인라인 빨강 ExtraBold 강조** +- Canvas 방향 화살표 제거 — hint 텍스트만으로 방향 안내 (이전 4종 화살표 + 치골 아치 라인+halo+endpoint 모두 제거) +- 토르소 실루엣 상단 16% UP shift (chestY 0.06 → 0.09) + ### Before Starting - Place VesiScan above the pubic bone - Apply ultrasound gel between the sensor and your skin @@ -102,23 +129,29 @@ After alignment, you will see the main measurement screen with a donut chart. ### Screen Layout ``` - [Placement] [Battery] [Catheters] [Settings] + [Home] [Placement] [Battery] [Catheters] [Settings] ← Home 아이콘 추가됨 Enjoy your day! ┌─────────────────┐ - │ Donut Chart │ + │ Donut Chart │ ← 너비 × 0.85 적응형 (이전 0.75 + 360dp cap 제거) │ │ - │ [Bladdy] │ - │ 325 mL │ + │ [Bladdy] │ ← 0.483 비율 (이전 0.55에서 -15% 후 +15%) + │ 325 mL │ ← 72sp ExtraBold (이전 24sp의 3배), letterSpacing -1 └─────────────────┘ Current Measurement | 65% 280 mL | 325/500 mL - [Void/Catheterization] [Auto Scan] [Single Scan] + [Voiding/ [Auto Scan] [Single Scan] + Catheterization] ``` +### Top Bar +- **Home 아이콘** (좌측 추가) — `appState.goHome()` 호출, 즉시 홈으로 +- **Placement 아이콘** (Home 옆) — `enterPlacementFromMonitoring()` 호출 → Back 시 Monitoring으로 복귀 +- 배터리 / 카테터 카운트 / Settings 톱니바퀴는 기존과 동일 + ### Understanding the Display | Element | Description | @@ -135,12 +168,15 @@ After alignment, you will see the main measurement screen with a donut chart. ## 5. Auto Scan 1. Tap the **Auto Scan** button (orange) -2. The device will measure continuously (minimum 800ms interval) +2. The device will measure continuously (**minimum 600ms interval**, 이전 1500ms에서 단축) 3. For the first 5 measurements, the display will show **"—"** (collecting data) 4. After 5+ measurements, the **trimmed mean** value will be displayed (10-sample window, top/bottom excluded) 5. The donut chart will update every 5 seconds 6. Tap **Stop Scan** (red) to end Auto measurement +> **속도 향상 배경 (2026-05-26)**: FW VBTFW0116 + MTU 247 + CONNECTION_PRIORITY_HIGH 조합으로 +> 한 측정 사이클이 ~330ms로 단축. 이전(~1.2초) 대비 **4배 향상**. 자세한 내용은 Pipeline Summary §5.1 참조. + ### Auto Measurement Failure - If 2+ channels fail **5 times in a row** (sensor shifted or lost contact): - A dialog will appear: **"Position lost. Restart from alignment"** @@ -161,13 +197,14 @@ After alignment, you will see the main measurement screen with a donut chart. --- -## 7. Void / Catheterization +## 7. Voiding / Catheterization (텍스트 변경) -1. Tap the **Void / Catheterization** button +1. Tap the **Voiding / Catheterization** button (이전 "Void/Catheterization" → **"Voiding/"** 로 첫 줄 갱신) 2. The current measurement is recorded to the voiding diary -3. The catheter count decreases by 1 -4. The bladder level resets to 0 -5. A toast message **"Recorded"** will appear +3. **자동: Auto Scan 진행 중이면 stop** + 측정 상태 정규화 (`displayMaxVolumeMl`/window/timer 모두 0) +4. The catheter count decreases by 1 +5. The bladder level resets to 0 +6. **큰 "Recorded" 다이얼로그** (48sp ExtraBold 흰색, MlPrimary 0.95 alpha 배경, 1.5초 자동 닫힘) — 이전 Toast 대체 ### Managing Catheters - The catheter count is shown at the top of the screen (hospital icon + number) @@ -183,8 +220,8 @@ Tap the **gear icon** at the top right to open settings. ### General Settings (always visible) | Setting | Description | Default | |---------|-------------|---------| -| Max Volume | Maximum bladder volume for fill calculation | 500 mL | -| Catheter Threshold | Alert level for catheterization | Level 7 | +| Bladder Capacity | Maximum bladder volume for fill calculation | 500 mL | +| Catheter Threshold | Alert level for catheterization | Level 8 | ### Developer Settings (Developer Mode only) | Setting | Description | @@ -196,17 +233,58 @@ Tap the **gear icon** at the top right to open settings. | SG Filter | Savitzky-Golay noise filter on/off | | Post Max | Maximum sample index for wall detection (filters floor reflections) | +### 폰/태블릿 자동 폰트 분기 (2026-05-26) + +설정 패널 라벨 크기는 화면 너비에 따라 자동 조절: +```kotlin +val fontScale = (screenWidth / 360f).coerceIn(1.0f, 1.8f) +val isTablet = screenWidth >= 600 +labelSize = (14 * fontScale).sp // 폰 14sp, 태블릿 ~25sp +rowSpacing = (6 * fontScale).dp // 폰 6dp, 태블릿 ~10dp +dividerPadding = if (isTablet) 12.dp else 0.dp +``` + +| 기기 | screenWidth | labelSize | +|---|---|---| +| Galaxy S20 (폰) | 360dp | 14sp | +| Pixel 7 (폰) | 412dp | 16sp | +| 갤탭 S6 Lite | 600dp | 23sp | +| 갤탭 S8 / iPad Pro | 800dp+ | 25sp (cap) | + +이전 시도(28sp 하드코딩)에서 폰 화면이 곱창나던 문제를 해결. + +### Dev Mode 추가 기능 + +- **HomeView Bladdy 3탭** → Developer Mode 토글 +- **DeviceScanView "No devices found" 화면 + dev 모드** → "Enter Measurement Mode (Dev)" 버튼 (BLE 없이 측정 화면 진입) +- **PiezoMonitoring Status 배지 dev 탭** → 60~maxVol-50 범위 더미 측정값 랜덤 주입 (BLE 없이 동작 검증용) +- **dev 모드 한정 ChannelPanel / BleDebugPanel** 표시 (Developer Tools 버튼 토글) + --- ## 9. Navigation | Action | Result | |--------|--------| -| **Placement button** (top left) | Go to Sensor Alignment | +| **Home button** (top left) | Go to Home screen (`appState.goHome()`) | +| **Placement button** (Home 옆) | Re-enter Sensor Alignment (`enterPlacementFromMonitoring()`) | | **Settings button** (top right) | Open/close settings panel | | **Back button** (Android) | Go to previous screen | | **Back button on Home** | "Exit App?" confirmation dialog | +### Placement 진입 경로 분기 (2026-05-12 신규) + +`placementFromMonitoring` 플래그로 Back 동작이 자동 분기: + +- **Personalization → Placement → Monitoring** (정방향): Placement에서 Back = Personalization으로 복귀 +- **Monitoring → Placement** (재정렬): Placement에서 Back = Monitoring으로 복귀 + +코드: [AppState.kt](app/src/main/java/com/example/medilightv2android/AppState.kt) 의 `enterPlacementFromMonitoring()` / `backFromPlacementGuide()`. + +### startFromHome() 라우팅 fix + +페어링 완료 상태에서 Home → Start 시 Personalization부터 시작 (이전: Monitoring 직행 버그). + --- ## 10. Troubleshooting diff --git a/VesiScan_Android_Pipeline_Summary.md b/VesiScan_Android_Pipeline_Summary.md index c953b2c..b96e1bb 100644 --- a/VesiScan_Android_Pipeline_Summary.md +++ b/VesiScan_Android_Pipeline_Summary.md @@ -2,7 +2,20 @@ ## 작성일: 2026-04-23 ## 작성자: dwjang -## 마지막 업데이트: 2026-05-11 (v5) — VBTAND0101 +## 마지막 업데이트: 2026-05-26 (v6) — 1.0.0-design (versionCode 24) +## 권장 펌웨어: **VBTFW0116** (pending slot 1→8 확장으로 ADC drop 안정) + +### v6 주요 변경 요약 (2026-05-12 ~ 2026-05-26) + +- **BLE throttle 상태 기반 게이트화** — 시간 단독(800ms)에서 `isMultiChannel && !isComplete` + 시간(600ms) 복합 게이트로 전환. 잔여 reb 폐기로 인한 CH0/CH1만 도착 + BV_FAIL/BV_SKIP 증상 해소 +- **CONNECTION_PRIORITY_HIGH 요청 추가** — CCCD write 완료 시점에 `gatt.requestConnectionPriority(HIGH)` 호출. peripheral이 수락 시 interval ~15ms로 단축 +- **MTU 247 협상 확정** — VBT26050202 + VBTFW0116 조합에서 247 정상 협상 (logcat 검증) +- **측정 사이클 시간 1.2s → 0.33s** (4배 향상). Placement loop 1000ms → 600ms, Auto loop 1500ms → 600ms +- **PinView DEMO 우회**, **DeviceScanView Dev 측정모드 진입 버튼**, **AppState placementFromMonitoring 라우팅 분기** 추가 +- **PiezoPersonalizationView 평행 2-카드 리디자인** (Maximum Bladder Capacity + Catheter Threshold, StepperButton, roundToInt fix) +- **PlacementGuideView Sensor Alignment 리디자인** (3-stop gradient, 38sp 큰 타이틀, "pubic bone" 빨강 강조, Canvas 화살표/아치 제거, chestY 0.09) +- **PiezoMonitoringView 누적 업데이트** (Voiding/ 텍스트, 48sp Recorded Dialog, useScrollLayout, Volume 72sp ExtraBold, Bladdy 0.483, Home 아이콘, 설정 패널 폰/태블릿 자동 분기) +- **HomeView Bladdy 3× 확대** (220 → 660dp + BoxWithConstraints 90% 캡) --- @@ -122,6 +135,68 @@ reb:(4바이트) + repeat_count(2바이트) + ADC데이터(200바이트) + CRC(2 └ "reb:" 문자 └ 항상 100 └ 100개 × 2바이트(16-bit) └ 체크섬 ``` +### Connection Parameter 협상 (v6 신규) + +**MTU 247**: 연결 직후 `gatt.requestMtu(247)` 호출. 208B `reb:` 패킷을 단일 노티로 전송하여 +단편화 drop 위험 제거. 실측 VBT26050202 + VBTFW0116에서 247 정상 협상 확인. + +**CONNECTION_PRIORITY_HIGH**: CCCD write 성공 직후(서비스 ready 시점) 호출: +```kotlin +gatt.requestConnectionPriority(BluetoothGatt.CONNECTION_PRIORITY_HIGH) +debugLogger.info("CONN_PRIORITY HIGH requested (ok=$priorityOk)") +``` +peripheral이 connection parameter update를 수락하면 interval ~15ms로 협상되어 +Central Link Layer ACK 속도가 향상됨 → 펌웨어 SoftDevice TX queue 포화 빈도 감소. +수락 여부는 안드로이드 API로 직접 확인 불가(HCI 레벨 차단) — 응답 시간 측정으로 간접 확인. + +### maa Throttle (v6 상태 기반 게이트로 강화) + +이전: 시간 단독 `now - lastMaaSentMs < 800` 차단 → 펌웨어 응답이 1.2s 걸릴 때 +`startMultiChannel(6)`이 응답 도중 호출되어 잔여 reb 패킷이 폐기되는 race 발생. + +신규: [BleManager.kt:464-481](app/src/main/java/com/example/medilightv2android/ble/BleManager.kt#L464-L481) `canSendMaa()` +```kotlin +private fun canSendMaa(caller: String): Boolean { + val now = System.currentTimeMillis() + val collectorBusy = piezoCollector.isMultiChannel && !piezoCollector.isComplete + val sinceLast = now - lastMaaSentMs + if (collectorBusy) { + if (sinceLast < 3000) { + Log.w("BleManager", "maa BUSY [$caller] — prev response in progress") + return false // (A) 상태 차단 + } + Log.w("BleManager", "maa FORCE [$caller] — prev incomplete after ${sinceLast}ms") + } + if (sinceLast < 600) { + Log.w("BleManager", "maa THROTTLED [$caller] — ${sinceLast}ms since last") + return false // (B) 시간 차단 + } + return true +} +``` + +| 게이트 | 차단 조건 | 풀림 조건 | +|---|---|---| +| (A) State | `isMultiChannel && !isComplete` (raa 미도착) | raa 도착 OR 3초 경과 (FORCE) | +| (B) Time | 마지막 송신 후 600ms 미만 | 600ms 경과 | + +두 게이트 모두 통과해야 maa 송신. State gate가 안전망, time gate가 펌웨어 burst 방어. + +### 측정 사이클 실측 (VBTFW0116 + MTU 247 + CONN_PRIORITY HIGH) + +logcat 측정 (2026-05-26): + +| 사이클 | TX maa | RX raa | 소요 | +|---|---|---|---| +| Placement #1 | 57.333 | 57.652 | **319ms** | +| Monitor #1 | 00.952 | 01.233 | **281ms** | +| Monitor #2 | 02.851 | 03.191 | **340ms** | +| Monitor #3 | 04.414 | 04.719 | **305ms** | +| Monitor #4 | 05.982 | 06.292 | **310ms** | +| Monitor #5 | 07.549 | 07.972 | **423ms** | + +**평균 ~330ms**. 이전 ~1.2~1.4s 대비 4배 향상. 모든 사이클에서 6/6 채널 도착, 유실 0건. + ### Big Endian 자동 감지 ``` @@ -480,7 +555,7 @@ Start Scanning 버튼 활성화 (초록색) | 위치 이탈 | "Position lost. Restart above pubic bone." | | 센서 미부착 | "Sensor detached. Restart above pubic bone." | -## 연속 스캔 동작 +## 연속 스캔 동작 (2026-05-26 업데이트) ``` "Start Alignment" 버튼 탭 (waitingForStart → false) @@ -489,7 +564,7 @@ Start Scanning 버튼 활성화 (초록색) ↓ 즉시 첫 스캔 (maa 6채널) ↓ 결과: CV, 방향, Score 표시 (28sp 대형 힌트) -1초 대기 +600ms 대기 (이전 1000ms → 600ms 단축, BleManager throttle과 동기화) ↓ 자동 재스캔 (scanCount 증가 → CV threshold 완화) ↓ @@ -498,6 +573,15 @@ Start Scanning 버튼 활성화 (초록색) is_pass = true → Lock → 7초 hold → "Start Scanning" 버튼 활성화 ``` +### v6 화면 디자인 변경 +- 큰 "Sensor Alignment" 38sp ExtraBold 검정 (Maximum Bladder Capacity 카드와 톤 통일) +- Hint 텍스트 "pubic bone" 인라인 빨강 ExtraBold (AnnotatedString + SpanStyle) +- 3-stop vertical gradient 배경 (MlTeal 14% / 흰 / MlPrimary 10%) — GREEN 진입 시 단색 톤 +- Canvas 방향 화살표 4종 제거 (hint 텍스트만으로 안내) +- 치골 아치 라인 + halo + endpoint 모두 제거 +- 토르소 chestY 0.06 → 0.09 (실루엣 위로 16% shift) +- Body 상단 Spacer 8dp + --- # 7. "Spot" 버튼 측정 흐름 @@ -534,20 +618,22 @@ Spot 버튼 탭 화면에 "305 ml" 표시! (도넛차트 + 레벨 업데이트) ``` -## Auto Scan 모드 (2026-05-11 업데이트) +## Auto Scan 모드 (2026-05-26 업데이트) "Auto Scan" 버튼으로 자동 반복 측정: -- 최소 800ms 간격 자동 측정 (BLE maa throttle 보장) +- **최소 600ms 간격** 자동 측정 (BLE maa state-based throttle 보장) +- LaunchedEffect loop delay: 1500ms → **600ms** (FW VBTFW0116 + MTU 247 + CONN_PRIORITY HIGH 적용 후 응답 ~330ms이므로 일관 단축) - 첫 5회: "—" 표시 (데이터 수집 중) - 5회 이상: **sliding window trimmed mean** (10개 윈도우, 최대/최소 각 1개 제외 → 8개 평균) - "Stop Scan" 버튼으로 종료 +- **Voiding/Catheterization 버튼 클릭 시 Auto 자동 stop + 측정 상태 정규화** (displayMaxVolumeMl/window/timer 모두 0) — v6 신규 - Auto fail: 2ch+ missing 5회 연속 → "Position lost. Restart from alignment" 다이얼로그 ## Single Scan 모드 (2026-05-11 업데이트) "Single Scan" 버튼 1탭 → **5회 측정 → trimmed mean**: - 최대 8회까지 재시도 (유효값 5개 수집 목표, 최소 3개) -- 측정 간격: maa 800ms throttle이 간격 보장 +- 측정 간격: maa 600ms throttle이 간격 보장 (v6에서 800 → 600 단축) - 중간 값 화면 미표시 (isSpotInProgress 플래그) - 1초 쿨다운 후 재사용 가능 @@ -626,6 +712,8 @@ medilightv2android/ │ └── (onboarding, registration, pin, ...) │ └── AppState.kt ← 전역 상태 관리 + 화면 라우팅 + (v6: placementFromMonitoring 플래그 + + enterPlacementFromMonitoring() / backFromPlacementGuide()) ``` ## 포팅 원본 대조 @@ -875,7 +963,26 @@ RX: "raa all-ch complete [8B]" # 14. BLE 명령어 포맷 (펌웨어 특이사항) -이 기기(VBTFW0111)는 파라미터 없는 명령어에도 **`cmd? `(물음표+공백)** 포맷이 필요합니다. +이 기기(VBTFW0111 ~ **VBTFW0116**)는 파라미터 없는 명령어에도 **`cmd? `(물음표+공백)** 포맷이 필요합니다. + +### VBTFW0116 신규 사항 (펌웨어 측 패치) + +``` +원인: +- Central(앱)의 Link Layer ACK / connection event 처리 속도보다 Peripheral이 + notify enqueue를 더 빨리 시도해서 SoftDevice TX queue 포화 +- 기존 FW: pending slot 1개만 보관 (이미 pending 있으면 다음 패킷 drop) +- PC 환경에선 Central 처리 빨라 문제 없음 → 실제 앱 환경에선 OS/connection 영향으로 포화 잦음 + +개선: +- pending slot 1 → 8개 확장 → TX queue 포화 시 보관/재전송 → 중간 채널 데이터 유실 감소 +- 결과: ADC drop 현상 재현되지 않음 (장시간 반복 테스트 진행 중) + +안드로이드 측 짝꿍 변경: +- MTU 247 협상 (208B reb 단일 노티) +- CONNECTION_PRIORITY_HIGH 요청 (interval 단축 시도) +- maa throttle을 state-based gate로 강화 (잔여 reb 폐기 방지) +``` ```kotlin // ❌ 안 됨 (rxs: cmd_not_supported 응답) @@ -1313,6 +1420,18 @@ ADC 파싱 시 Big/Little Endian을 자동 감지: | 앱 아이콘 | ✅ 완료 | 방광이 캐릭터 PNG (5 density) | | Placement 화살표 수정 | ✅ 완료 | 디바운스/보호 중에도 화살표 항상 표시 | | GREEN 안정성 | ✅ 완료 | 7초 hold + 3회 연속 실패 exit + phase 보호 | +| MTU 247 + CONN_PRIORITY HIGH | ✅ 완료 (v6) | VBT26050202 + VBTFW0116 정상 협상 | +| maa throttle state-based gate | ✅ 완료 (v6) | isComplete + 600ms + 3s FORCE | +| 측정 사이클 1.2s → 0.33s | ✅ 완료 (v6) | 4배 향상, 6/6 유실 0 | +| Placement loop 600ms 단축 | ✅ 완료 (v6) | 1000 → 600ms | +| Auto loop 600ms 단축 | ✅ 완료 (v6) | 1500 → 600ms | +| placementFromMonitoring 라우팅 분기 | ✅ 완료 (v6) | enterPlacementFromMonitoring/backFromPlacementGuide | +| PiezoPersonalization 평행 2-카드 | ✅ 완료 (v6) | Maximum Bladder Capacity + Catheter Threshold | +| PlacementGuide Sensor Alignment 리디자인 | ✅ 완료 (v6) | 3-stop gradient + 38sp 큰 타이틀 + pubic bone 빨강 | +| PiezoMonitoring Home 아이콘 / Voiding/ / Recorded Dialog | ✅ 완료 (v6) | | +| HomeView Bladdy 3× (660dp 캡) | ✅ 완료 (v6) | BoxWithConstraints 90% cap | +| 설정 패널 폰/태블릿 자동 분기 | ✅ 완료 (v6) | fontScale (360dp→1.0, 600dp+→1.8) | +| PinView DEMO 자동통과 | ✅ DEMO 빌드 한정 | 배포 전 if(false) 블록 제거 | | IMU 모션 감지 | 🔜 예정 | vesiscanbasicAndroid에서 포팅 예정 | | Placement 팬텀 테스트 | 🔜 예정 | Gradient vs SWEEP 비교 | | 5-Anchor calibration | 🔜 검토 | CKLaw 전체 포팅 여부 결정 | diff --git a/docs/ALGORITHM_COMPARISON.md b/docs/ALGORITHM_COMPARISON.md index 5226373..4a6a6d2 100644 --- a/docs/ALGORITHM_COMPARISON.md +++ b/docs/ALGORITHM_COMPARISON.md @@ -133,17 +133,20 @@ EDGE_DIST_DECAY=0.12, VALLEY_STOP_RISE=50, etc. ## Placement Test Algorithm -### Overview (2026-05-11 updated) +### Overview (2026-05-26 updated — v6) ``` Screen entry → "Place VesiScan above the pubic bone, then press Start" ↓ Start Alignment 버튼 탭 (waitingForStart=false) 전체 상태 리셋 ↓ -[1-second interval loop] +[600ms interval loop] ← v6: 1000ms → 600ms (BleManager throttle과 동기화) ↓ mpa (first time, 500ms delay) → maa → 6ch reb - ↓ + ↓ (maa 전 BleManager.canSendMaa() 게이트 통과 필요) + │ - State gate: !piezoCollector.isComplete 이면 차단 (3s 후 FORCE) + │ - Time gate: 마지막 송신 < 600ms 이면 차단 + │ Detachment check (6ch received, THR=30) → LED 4 if detached ↓ Wall detection (Method A/B/C) → urineLen ≥ 12 @@ -161,6 +164,11 @@ GREEN: 7s hold + 3 consecutive fail to exit Screen exit → LED OFF ``` +### v6 BLE 사이클 실측 (VBTFW0116 + MTU 247 + CONN_PRIORITY HIGH) + +한 측정 사이클 (TX maa → RX raa): **평균 ~330ms** (이전 ~1.2~1.4s 대비 4배 향상). +600ms loop delay 안에 한 사이클이 안정적으로 완료됨. + ### Guide Modes **Gradient** (default): weighted center gradient → LATERAL → GREEN @@ -173,13 +181,14 @@ Screen exit → LED OFF **Stage 2 LATERAL**: |len4-len5| ≤ 10 → GREEN, else "Slide left/right ←→" **Stage 3 GREEN**: CV ≤ threshold AND |LR dev| ≤ 0.20 → "In position!" (7s hold) -### Measurement Modes +### Measurement Modes (v6 업데이트) -- **Auto Scan**: min 800ms gap, 10-sample trimmed mean (max/min removed, 8 avg) +- **Auto Scan**: **min 600ms gap** (state-based throttle: `!isComplete` + 600ms), 10-sample trimmed mean (max/min removed, 8 avg) - **Single Scan (Spot)**: 5회 측정 → trimmed mean (max 8 attempts, min 3) - valid ≥ 4 channels only - Analysis on coroutine (Dispatchers.Default) - Auto fail: 2ch+ missing 5 consecutive → realign dialog +- **Voiding/Catheterization 클릭 시 Auto Scan 자동 stop + 측정 상태 정규화** (displayMaxVolumeMl/window/timer 모두 0) - Detachment → LED 4 (once), recovery → LED 0 (once) - Foreground Service: BLE connection maintained during screen off - BLE 로그: 실시간 파일 기록 (Downloads/VesiScan_BLE_*.log, 화면 잠금에도 보존) @@ -203,3 +212,61 @@ GREEN exit: 3회 연속 실패 (greenFailCount) ±15% 이내: 223/223 (100%) 범위: 441~537ml ``` + +--- + +## BLE maa Throttle — State-Based Gate (v6, 2026-05-26) + +### 배경: CH0/CH1만 도착 + BV_FAIL/BV_SKIP 증상 + +이전 throttle은 시간 단독 `now - lastMaaSentMs < 800ms` 만 검사. 펌웨어 응답이 +~1.2~1.4초 걸리는 환경에서 800ms 시점에 새 maa가 송신되면: + +1. `sendChannelsOnly()` 통과 → `piezoCollector.startMultiChannel(6)` → collector reset +2. **큐에 떠다니던 이전 사이클의 reb / raa 패킷이 새 collector의 시작 부분에 잘못 들어감** +3. 결과: 한 채널만 들고 raa로 종료 → `BV_FAIL no valid channels` 또는 `BV_SKIP center=0 total=5/6` + +실측 로그 (FW VBTFW0111, 2026-05-22): +``` +TX maa #1 → reb×5 → (raa 큐 밀림) → TX maa #2 → reb×1 + raa → BV_FAIL scan=656 +``` + +### v6 신규 게이트 + +```kotlin +private fun canSendMaa(caller: String): Boolean { + val now = System.currentTimeMillis() + val collectorBusy = piezoCollector.isMultiChannel && !piezoCollector.isComplete + val sinceLast = now - lastMaaSentMs + if (collectorBusy) { + if (sinceLast < 3000) return false // (A) state 차단 + // 3s 넘으면 강제 통과 (FORCE) — deadlock 방지 + } + if (sinceLast < 600) return false // (B) time 차단 + return true +} +``` + +| 게이트 | 차단 | 풀림 | +|---|---|---| +| (A) State | `isMultiChannel && !isComplete` | raa 도착 OR 3s FORCE | +| (B) Time | `sinceLast < 600` | 600ms 경과 | + +두 게이트 모두 통과해야 maa 송신. State gate가 race 방어, time gate가 burst 방어. + +### 효과 (FW VBTFW0116 + MTU 247 + CONN_PRIORITY HIGH 조합) + +- 한 사이클 응답: 1.2s → **330ms** (4배) +- 6/6 채널 도착률: 부분응답 잦음 → **100% 도착, 유실 0건** +- BV_FAIL/BV_SKIP 빈도: 자주 → 관찰되지 않음 + +### Logcat 키워드 + +| 로그 | 의미 | +|---|---| +| `maa BUSY [...] — prev response in progress (Xms)` | State gate 차단 (정상 방어) | +| `maa FORCE [...] — prev incomplete after Xms` | 3s 넘게 raa 없음 → 포기하고 진행 | +| `maa THROTTLED [...] — Xms since last` | Time gate 차단 (정상 방어) | +| (로그 없음) | 정상 송신 | +| `MTU changed: 247 (status=0)` | MTU 정상 협상 (CCCD write 직전) | +| `CONN_PRIORITY HIGH requested (ok=true)` | priority 요청 큐잉 성공 (수락 여부는 sniffer로만 확인 가능) |