# VesiScan-Basic User Guide ## App Version: VBTAND0101 ## Last Updated: 2026-05-11 --- ## 1. Getting Started ### First Launch 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 5. You will arrive at the **Home** screen ### Home Screen - 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) --- ## 2. Connecting the Device 1. Tap **Start** on the Home screen 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 - 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 **Max Volume** (200-800 mL, default: 500 mL) - Tap **Continue** to proceed to Sensor Alignment --- ## 3. Sensor Alignment (Placement) This step ensures the sensor is positioned correctly over your bladder for accurate measurement. ### 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) ### Step 1/3: Vertical Alignment 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** > The hint text will show animated dots (e.g., "Slide up ↑.", "Slide up ↑..", "Slide up ↑...") to indicate the system is actively scanning. ### Step 2/3: Lateral Alignment 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 3/3: Final Check (Green Zone) 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 "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. Restart above pubic bone."** - Re-attach the sensor with gel and tap **Start Alignment** ### Tips - Use **plenty of ultrasound gel** — dry contact causes poor readings - Keep the sensor **flat against the skin** — tilting reduces accuracy - Move **slowly** — fast movements cause unstable readings - You can tap **Skip** to go directly to measurement without alignment --- ## 4. Measurement Screen After alignment, you will see the main measurement screen with a donut chart. ### Screen Layout ``` [Placement] [Battery] [Catheters] [Settings] Enjoy your day! ┌─────────────────┐ │ Donut Chart │ │ │ │ [Bladdy] │ │ 325 mL │ └─────────────────┘ Current Measurement | 65% 280 mL | 325/500 mL [Void/Catheterization] [Auto Scan] [Single Scan] ``` ### Understanding the Display | Element | Description | |---------|-------------| | **Donut Chart** | Fills based on max measured volume / max volume setting | | **Center Value** | Maximum measured volume this session (updates every 5 seconds) | | **Current Measurement** | Latest trimmed mean value (Auto) or last Spot result | | **Fill Card** | Top: fill percentage, Bottom: max measured / bladder max volume | | **Battery Icon** | Device battery level with visual indicator | | **Catheter Count** | Remaining catheters (tap to add more) | --- ## 5. Auto Scan 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 (10-sample window, top/bottom excluded) 5. The donut chart will update every 5 seconds 6. Tap **Stop Scan** (red) to end Auto measurement ### 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"** - Tap **Realign** to re-align the sensor - Or tap **Dismiss** to stay on the measurement screen --- ## 6. Single Scan (Spot) 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 Single Scan, the Auto Scan and Void buttons are disabled. --- ## 7. Void / Catheterization 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 **"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** --- ## 8. Settings 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 | ### Developer Settings (Developer Mode only) | Setting | Description | |---------|-------------| | Threshold | Otsu (auto) or manual echo threshold | | DPS | Distance per sample (mm) | | Detection | Method A / B / C | | BV | Frustum / V41 (volume calculation method) | | SG Filter | Savitzky-Golay noise filter on/off | | Post Max | Maximum sample index for wall detection (filters floor reflections) | --- ## 9. Navigation | Action | Result | |--------|--------| | **Placement button** (top left) | Go to Sensor Alignment | | **Settings button** (top right) | Open/close settings panel | | **Back button** (Android) | Go to previous screen | | **Back button on Home** | "Exit App?" confirmation dialog | --- ## 10. Troubleshooting | Problem | Solution | |---------|----------| | "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 | | 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) | | Pairing dialog appears but app won't proceed | You must tap **Pair** — canceling will block the connection | --- ## 11. LED Indicators (Device) | LED State | Meaning | |-----------|---------| | State 0 | OFF (default) | | State 4 | Sensor detached warning | | State 5 | Alignment searching (orange) | | State 6 | Alignment complete / In position (green) | --- ## 12. Important Notes - **Always use ultrasound gel** between the sensor and skin - **Keep the sensor still** during measurement — movement reduces accuracy - **Do not use the device while charging** - The app keeps the screen on during use to prevent BLE disconnection - Measurement logs are automatically saved to your device: - BLE logs: `Downloads/VesiScan_BLE_*.log` - ADC data: `Downloads/VesiScan_ADC/*.csv` --- ## Contact For technical support, contact: - App Development: dwjang - Algorithm: Charles KWON / eunji.won - Medithings Co., Ltd. — https://medithings.net