docs: README 전체 업데이트 (v5, 2026-05-11 기준)
- Pipeline Summary: GREEN 상수 (CV preset별, LR 0.20, 7s hold, 3fail exit), 힌트 텍스트 표 추가, Spot 5회/Auto 10윈도우, 태블릿 fontScale, 향후 과제 갱신 (IMU 포팅 예정) - USER_GUIDE: 전체 재작성 — Start flow, 힌트 화살표(↑↓←→), 페어링 다이얼로그, Void/Catheterization, Single Scan/Auto Scan, Checking/Final check/In position! 텍스트 반영 - ALGORITHM_COMPARISON: Placement 섹션 현행화 — Start 버튼 필수, phase protection, 화살표 항상 갱신, GREEN 7s+3fail Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
+58
-63
@@ -1,6 +1,7 @@
|
||||
# VesiScan-Basic User Guide
|
||||
|
||||
## App Version: VBTAND0101
|
||||
## Last Updated: 2026-05-11
|
||||
|
||||
---
|
||||
|
||||
@@ -23,17 +24,17 @@
|
||||
## 2. Connecting the Device
|
||||
|
||||
1. Tap **Start** on the Home screen
|
||||
2. The app will scan for nearby VesiScan devices
|
||||
2. The app will scan for nearby VesiScan devices (sorted alphabetically)
|
||||
3. When your device appears in the list, tap it to connect
|
||||
4. **Complete the Bluetooth pairing** when the system dialog appears
|
||||
- Do NOT press Cancel — the app will not proceed without pairing
|
||||
- A "Pairing Required" dialog will guide you through the process
|
||||
- Tap **Pair** on the system Bluetooth dialog — canceling will block the connection
|
||||
- The app waits up to 30 seconds for pairing to complete
|
||||
5. Once paired, you will move to the Personalization screen
|
||||
|
||||
### Personalization
|
||||
- Set your **posture** (standing/sitting/lying)
|
||||
- Set the **sensor position**
|
||||
- Set the **Max Volume** (default: 500 mL)
|
||||
- Tap **Next** to proceed to Sensor Alignment
|
||||
- Set your **Max Volume** (200-800 mL, default: 500 mL)
|
||||
- Tap **Continue** to proceed to Sensor Alignment
|
||||
|
||||
---
|
||||
|
||||
@@ -41,45 +42,49 @@
|
||||
|
||||
This step ensures the sensor is positioned correctly over your bladder for accurate measurement.
|
||||
|
||||
### Step 1: Vertical Alignment
|
||||
### Before Starting
|
||||
- Place VesiScan above the pubic bone
|
||||
- Apply ultrasound gel between the sensor and your skin
|
||||
- Tap the **Start Alignment** button (large orange button)
|
||||
|
||||
1. **Place the VesiScan-Basic device just above your pubic bone**
|
||||
2. Apply ultrasound gel between the sensor and your skin
|
||||
3. Tap the **Start Alignment** button
|
||||
4. The app will begin scanning and provide direction:
|
||||
- **"Raise the sensor up"** — slide the device upward toward your navel
|
||||
- **"Lower the sensor down"** — slide the device downward toward your pubic bone
|
||||
- **"Raise the sensor slightly"** / **"Lower the sensor slightly"** — make small adjustments
|
||||
5. Move the sensor **slowly, 1-2mm at a time**
|
||||
6. When the vertical position is correct, the app will show **Step 2/3**
|
||||
### Step 1/3: Vertical Alignment
|
||||
|
||||
> The hint text will show animated dots (e.g., "Raise the sensor up.", "Raise the sensor up..", "Raise the sensor up...") to indicate the system is actively scanning.
|
||||
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**
|
||||
|
||||
### Step 2: Lateral Alignment
|
||||
> The hint text will show animated dots (e.g., "Slide up ↑.", "Slide up ↑..", "Slide up ↑...") to indicate the system is actively scanning.
|
||||
|
||||
1. The app will first show **"Checking left/right balance..."** for a few seconds
|
||||
### Step 2/3: Lateral Alignment
|
||||
|
||||
1. The app will first show **"Checking..."** for a few seconds
|
||||
2. Then it will guide you:
|
||||
- **"Move left"** — slide the device to the left
|
||||
- **"Move right"** — slide the device to the right
|
||||
- **"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 3: Final Check (Green Zone)
|
||||
### Step 3/3: Final Check (Green Zone)
|
||||
|
||||
1. The app checks overall alignment quality
|
||||
2. If everything is optimal, the hint will show **"Optimal position!"**
|
||||
3. The screen will hold this state for **7 seconds** to confirm stability
|
||||
4. Tap **Alignment Complete** to proceed to the measurement screen
|
||||
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
|
||||
|
||||
### If Alignment is Lost
|
||||
- If the sensor shifts significantly after reaching Optimal:
|
||||
- The app will show **"Position lost. Place sensor above pubic bone, then press Start"**
|
||||
- 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
|
||||
|
||||
### If the Sensor is Detached
|
||||
- If the sensor loses contact with skin:
|
||||
- The app will show **"Sensor detached. Place above pubic bone, then press Start"**
|
||||
- The app will show **"Sensor detached. Restart above pubic bone."**
|
||||
- Re-attach the sensor with gel and tap **Start Alignment**
|
||||
|
||||
### Tips
|
||||
@@ -111,7 +116,7 @@ After alignment, you will see the main measurement screen with a donut chart.
|
||||
Current Measurement | 65%
|
||||
280 mL | 325/500 mL
|
||||
|
||||
[Void/Catheterize] [Auto] [Spot]
|
||||
[Void/Catheterization] [Auto Scan] [Single Scan]
|
||||
```
|
||||
|
||||
### Understanding the Display
|
||||
@@ -127,48 +132,47 @@ After alignment, you will see the main measurement screen with a donut chart.
|
||||
|
||||
---
|
||||
|
||||
## 5. Auto Measurement
|
||||
## 5. Auto Scan
|
||||
|
||||
1. Tap the **Auto** button (orange)
|
||||
2. The device will measure continuously every ~1.5 seconds
|
||||
1. Tap the **Auto Scan** button (orange)
|
||||
2. The device will measure continuously (minimum 800ms interval)
|
||||
3. For the first 5 measurements, the display will show **"—"** (collecting data)
|
||||
4. After 5+ measurements, the **trimmed mean** value will be displayed
|
||||
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** (red) to end Auto measurement
|
||||
6. Tap **Stop Scan** (red) to end Auto measurement
|
||||
|
||||
### Auto Measurement Failure
|
||||
- If measurements fail **5 times in a row** (sensor shifted or lost contact):
|
||||
- A dialog will appear: **"Sensor Position Issue"**
|
||||
- Tap **Go to Alignment** to re-align the sensor
|
||||
- If 2+ channels fail **5 times in a row** (sensor shifted or lost contact):
|
||||
- A dialog will appear: **"Position lost. Restart from alignment"**
|
||||
- Tap **Realign** to re-align the sensor
|
||||
- Or tap **Dismiss** to stay on the measurement screen
|
||||
|
||||
---
|
||||
|
||||
## 6. Spot Measurement
|
||||
## 6. Single Scan (Spot)
|
||||
|
||||
1. Tap the **Spot** button
|
||||
2. The device will take **5 consecutive measurements** (~4 seconds total)
|
||||
1. Tap the **Single Scan** button
|
||||
2. The device will take **5 consecutive measurements** (~4 seconds total, max 8 attempts)
|
||||
3. A **spinner** will show during measurement
|
||||
4. The result (trimmed mean of 5 readings) will be displayed immediately
|
||||
5. The donut chart and Current Measurement card will update
|
||||
|
||||
> During Spot measurement, the Auto and Void buttons are disabled.
|
||||
> During Single Scan, the Auto Scan and Void buttons are disabled.
|
||||
|
||||
---
|
||||
|
||||
## 7. Void / Catheterize
|
||||
## 7. Void / Catheterization
|
||||
|
||||
1. Tap the **Void / Catheterize** button
|
||||
1. Tap the **Void / Catheterization** button
|
||||
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 **"Voiding recorded"** will appear
|
||||
5. A toast message **"Recorded"** will appear
|
||||
|
||||
### Managing Catheters
|
||||
- The catheter count is shown at the top of the screen (hospital icon + number)
|
||||
- **Tap the catheter count** to add more catheters
|
||||
- Enter the number and tap **Add**
|
||||
- Default starting count: **15 catheters**
|
||||
|
||||
---
|
||||
|
||||
@@ -192,11 +196,6 @@ 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) |
|
||||
|
||||
### Saving Settings
|
||||
- Adjust values using sliders and toggles
|
||||
- Tap **Save** to apply and close
|
||||
- Tap **Cancel** to close without changes (note: slider changes apply in real-time)
|
||||
|
||||
---
|
||||
|
||||
## 9. Navigation
|
||||
@@ -214,14 +213,13 @@ Tap the **gear icon** at the top right to open settings.
|
||||
|
||||
| Problem | Solution |
|
||||
|---------|----------|
|
||||
| "Place sensor above pubic bone" won't go away | Make sure the sensor is attached with gel, then press **Start Alignment** |
|
||||
| Alignment keeps showing "Raise/Lower" | Move the sensor **very slowly**, 1-2mm at a time |
|
||||
| "Place VesiScan above the pubic bone" won't go away | Make sure the sensor is attached with gel, then press **Start Alignment** |
|
||||
| Alignment keeps showing "Slide up/down" | Move the sensor **very slowly**, 1-2mm at a time |
|
||||
| Auto measurement shows "—" | Wait for at least 5 measurements to accumulate |
|
||||
| Donut chart value doesn't change | Max volume updates every 5 seconds |
|
||||
| Spot measurement takes too long | Each Spot takes ~4 seconds (5 readings) |
|
||||
| "Sensor Position Issue" dialog appears | The sensor may have shifted — go to Alignment |
|
||||
| Single Scan takes too long | Each scan takes ~4 seconds (5 readings) |
|
||||
| "Position lost" dialog appears | The sensor may have shifted — go to Alignment |
|
||||
| Bluetooth connection lost | The app will attempt auto-reconnect (up to 5 times) |
|
||||
| App freezes on measurement screen | Check BLE connection, try disconnecting and reconnecting |
|
||||
| Pairing dialog appears but app won't proceed | You must tap **Pair** — canceling will block the connection |
|
||||
|
||||
---
|
||||
@@ -230,13 +228,10 @@ Tap the **gear icon** at the top right to open settings.
|
||||
|
||||
| LED State | Meaning |
|
||||
|-----------|---------|
|
||||
| Green blink (0.5s) | Bluetooth scanning |
|
||||
| Green on 1s / off 3s | Device idle (not attached) |
|
||||
| Orange blink (1s) | Sensor Alignment in progress |
|
||||
| Green solid | Alignment complete (Optimal position) |
|
||||
| Orange fast blink (3Hz) | Error detected |
|
||||
| Orange solid | Charging |
|
||||
| Blue solid | Charging complete |
|
||||
| State 0 | OFF (default) |
|
||||
| State 4 | Sensor detached warning |
|
||||
| State 5 | Alignment searching (orange) |
|
||||
| State 6 | Alignment complete / In position (green) |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user