docs: v7 (2026-07-10) 반영 — msp 제거, 6-stage alignment, mtb queue fix, labdb 자동 재시도
이번 세션 대량 변경 사항을 5개 문서에 반영. 각 문서마다 stale 이던
섹션을 갱신하거나 신규 섹션 추가.
USER_GUIDE.md
- Sensor Alignment 를 V1 (3-stage) / V2 (6-stage) 로 재구성
- V2 6-stage 표 + relaxed mode / soft hint 설명
- GREEN 진입 5초 hold + 10-strike 리셋 완화 명시
- "최적의 위치입니다!" 문구 반영
docs/BLE_PROTOCOL_REFERENCE.md
- msp 명령 취소선 처리 + mim 신규 명령 문서화
- Watchdog timeout 25초 연장 명시 (2.5)
- §2.6 신규: firmware VBTFW0121 mls mode 0 freeze 취약점 +
앱 측 3-layer 회피 (isMtbBusy / mtb 3초 timeout / 자동 재연결)
VesiScan_Android_Pipeline_Summary.md
- v7 (2026-07-10) 섹션 신규 추가 — BLE / Alignment / UI / labdb /
tools 5개 카테고리로 변경 사항 정리
- 권장 펌웨어 표기 VBTFW0116 → VBTFW0120+ 로 갱신
labdb.md
- §12b 신규: 앱 측 Auto Retry Policy — endMeasurement 자동 업로드
조건 완화, LabdbAutoRetry object, UI 배너, 재시도 안전성
tools/README.md
- labdb_upload.py 섹션 신규 — 사용법 / 폴더 구조 / 재실행 안전성 /
buildPayload 로직 / 활용 예 정리
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
+39
-26
@@ -74,40 +74,53 @@ This step ensures the sensor is positioned correctly over your bladder for accur
|
||||
- Apply ultrasound gel between the sensor and your skin
|
||||
- Tap the **Start Alignment** button (large orange button)
|
||||
|
||||
### Step 1/3: Vertical Alignment
|
||||
### 알고리즘 V1 (일반 사용자, 3-stage) / V2 (Clinical Alignment 세션, 6-stage)
|
||||
|
||||
The app will begin scanning and provide direction:
|
||||
- **"Slide up ↑"** — slide the device upward toward your navel
|
||||
- **"Slide down ↓"** — slide the device downward toward your pubic bone
|
||||
- **"Slide up slightly ↑"** / **"Slide down slightly ↓"** — make small adjustments
|
||||
- Move the sensor **slowly, 1-2mm at a time**
|
||||
- When the vertical position is correct, the app will show **Step 2/3**
|
||||
일반 진입 (모니터링 → Settings → 재측정 등) 은 **V1 (3-stage)**, Clinical
|
||||
Home 의 **Sensor Alignment** 버튼으로 진입한 세션은 자동으로 **V2 (6-stage)**
|
||||
로 활성화됩니다. Step indicator ("단계 N/M") 로 구분 가능.
|
||||
|
||||
> The hint text will show animated dots (e.g., "Slide up ↑.", "Slide up ↑..", "Slide up ↑...") to indicate the system is actively scanning.
|
||||
### V1: 3-stage (일반 진입)
|
||||
|
||||
### Step 2/3: Lateral Alignment
|
||||
**Step 1/3: Vertical Alignment**
|
||||
- **"Slide up ↑"** / **"Slide down ↓"** / **"Slide up slightly ↑"** 등의 방향 안내
|
||||
- 1~2mm 씩 천천히 이동, 위치가 잡히면 Step 2/3
|
||||
|
||||
1. The app will first show **"Checking..."** for a few seconds
|
||||
2. Then it will guide you:
|
||||
- **"Slide left ←"** — slide the device to the left
|
||||
- **"Slide right →"** — slide the device to the right
|
||||
3. Adjust until both lateral sensors (CH4 and CH5) detect the bladder equally
|
||||
4. When balanced, the app will show **Step 3/3**
|
||||
**Step 2/3: Lateral Alignment**
|
||||
- **"Checking..."** → **"Slide left ←"** / **"Slide right →"** — CH4/CH5 균형
|
||||
- 균형 잡히면 Step 3/3
|
||||
|
||||
### Step 3/3: Final Check (Green Zone)
|
||||
**Step 3/3: Final Check (Green Zone)**
|
||||
- CV + LR deviation 확인 → **"최적의 위치입니다!"** (2026-07-07 문구 개선)
|
||||
- 배경 초록 + **5초 hold** (2026-07-07: 7초 → 5초 유지, 조기 unlock 방지 강화)
|
||||
- **Start Scanning** 활성 → 측정 화면으로
|
||||
|
||||
1. The app checks overall alignment quality (CV + LR deviation)
|
||||
2. If everything is optimal, the hint will show **"In position!"**
|
||||
3. The screen background turns green and holds this state for **7 seconds** to confirm stability
|
||||
4. The **Start Scanning** button (green) becomes active
|
||||
5. Tap **Start Scanning** to proceed to the measurement screen
|
||||
### V2: 6-stage (Clinical Alignment 세션 전용)
|
||||
|
||||
방광 하부/후벽 각도 오차를 실시간 보정하는 정밀 정렬 알고리즘.
|
||||
|
||||
| 단계 | 화면 문구 예 | 조건 |
|
||||
|:---:|---|---|
|
||||
| 1/6 INITIAL_ACCUM | "잠시 그대로 두세요 (n/10)" | baseline 10 cycle 누적 |
|
||||
| 2/6 VERTICAL_CLIMB | "↑ 위로 조금씩 올리세요 (hit N/6)" | CH3 sliding window majority — 최근 6 프레임 중 3회 hit |
|
||||
| 3/6 CH3_STABILIZE | "✓ ch3 검출 — 위치 유지 (n/10)" | CH3 안정 확인, 단발 flick 무시 (window=4, majority=3) |
|
||||
| 4/6 CENTER_OPTIMIZE | "↑/↓ 조금 (CV=0.xx)" | CH0~CH3 chord CV 임계 0.15 |
|
||||
| 5/6 LR_BALANCE | "← / → \|Δ\|=n" | CH4/CH5 균형 |
|
||||
| 6/6 FINAL_CONFIRM | "✓ 최적의 위치입니다!" | 5 프레임 재확인 통과 → GREEN |
|
||||
|
||||
**추가 안전장치**:
|
||||
- **Relaxed mode**: VERTICAL_CLIMB 에 20 프레임 (~5초) 이상 갇히면 CH3 없이도
|
||||
상단 3채널 (CH0~CH2) 로 CENTER_OPT 진입. CH3 flicker 심한 자세에서 무한 대기 방지.
|
||||
- **Soft hint**: 12 프레임 (~3초) 이상 반복되면 "↑ 위로" → "CH3 신호 확인 중 · 위치 유지"
|
||||
로 문구 자동 완화.
|
||||
- **6단계 완료 후 GREEN 5초 hold**: 사용자가 "측정 시작" 버튼 누를 시간 확보.
|
||||
|
||||
### If Alignment is Lost
|
||||
- If the sensor shifts significantly after reaching "In position!":
|
||||
- The app allows up to **3 consecutive failures** before exiting GREEN
|
||||
- After 3 failures: **"Position lost. Restart above pubic bone."**
|
||||
- The scanning will stop automatically
|
||||
- Re-place the sensor and tap **Start Alignment** again
|
||||
- Green Zone 유지 중 실패해도 즉시 리셋 X — **10 consecutive failures** (약 5초+)
|
||||
까지 관대하게 유지 (2026-07-07 완화, 이전 3-strike → 10-strike). 이 사이는
|
||||
GREEN 유지 + "최적의 위치입니다!" 표시.
|
||||
- 10회 연속 실패: **"위치를 놓쳤습니다. 치골 위에서 다시 시작해주세요"** →
|
||||
자동 재시작 대기.
|
||||
|
||||
### If the Sensor is Detached
|
||||
- If the sensor loses contact with skin:
|
||||
|
||||
Reference in New Issue
Block a user