# MeasurePRO Hardware Kit
## Quick Start Guide

**Welcome to MeasurePRO!**  
Thank you for choosing SolTec Innovation's professional measurement system. This guide will walk you through setting up your equipment and completing your first survey.

---

## What's in the Box

Before you begin, verify that your kit contains:

- ✓ Laser Distance Meter (LDM)
- ✓ GPS Receiver Unit
- ✓ USB-to-Serial Adapter Cables (2)
- ✓ Mounting Brackets & Hardware
- ✓ Power Cables & Adapters
- ✓ Quick Start Guide (this document)
- ✓ Registration Card with Activation Code

**[IMAGE: hardware-kit-contents.jpg]**  
*Photo showing all components laid out*

---

## Step 1: Account Registration

Before using your hardware, you'll need to create your MeasurePRO account.

### 1.1 Register Your Account

1. Visit **https://[your-replit-url]/register** on your computer or tablet
2. Fill in your information:
   - Full Name
   - Email Address
   - Company Name
   - Position/Title
   - Cell Phone Number
   - Business Address
   - How you heard about us

**[SCREENSHOT: registration-form.png]**  
*Registration form with fields highlighted*

3. Click **"Continue"**
4. Check your email for a 6-digit verification code
5. Enter the verification code on the next screen

**[SCREENSHOT: verification-code-screen.png]**  
*Email verification page*

### 1.2 Create Your Password

1. After email verification, create a secure password:
   - Minimum 8 characters
   - At least one uppercase letter
   - At least one number
   
2. Re-enter your password to confirm
3. Click **"Create Account"**

**[SCREENSHOT: password-creation-screen.png]**

### 1.3 Wait for Admin Approval

Your account needs to be approved by our team before you can start using the system.

- **Approval time:** Usually within 1-2 business hours during business days
- **Email notification:** You'll receive an email when your account is approved
- **Status check:** You can log in at any time to see your approval status

**[SCREENSHOT: awaiting-approval-screen.png]**

---

## Step 2: Hardware Setup

Once your account is approved, you're ready to set up your hardware.

### 2.1 Laser Distance Meter Installation

1. **Choose mounting location:**
   - Front bumper center (recommended for clearance monitoring)
   - Vehicle roof (for overhead measurements)
   - Handheld use with tripod mount

**[IMAGE: laser-mounting-locations.jpg]**  
*Diagram showing recommended mounting positions*

2. **Secure the mounting bracket:**
   - Use provided bolts or magnetic base
   - Ensure stable, vibration-free mounting
   - Point laser forward in direction of travel

3. **Connect power cable:**
   - Connect to 12V vehicle power or battery pack
   - Verify power LED illuminates

**[IMAGE: laser-power-connection.jpg]**

4. **Connect USB-to-Serial cable:**
   - Connect serial end to LDM data port
   - Connect USB end to your tablet/laptop
   - Note the cable color/label for identification

**[IMAGE: laser-serial-connection.jpg]**

### 2.2 GPS Receiver Installation

1. **Choose mounting location:**
   - Vehicle roof (best satellite visibility)
   - Dashboard near windshield
   - Handheld mounting pole

**[IMAGE: gps-mounting-locations.jpg]**

2. **Mount the GPS receiver:**
   - Magnetic mount for metal surfaces
   - Adhesive mount for non-metal surfaces
   - Ensure clear view of sky (no obstructions)

3. **Connect power cable:**
   - Connect to 12V vehicle power or battery pack
   - Verify power LED illuminates
   - Wait 1-2 minutes for satellite lock

**[IMAGE: gps-power-led.jpg]**  
*GPS unit with power LED indicator*

4. **Connect USB-to-Serial cable:**
   - Connect serial end to GPS data port
   - Connect USB end to your tablet/laptop
   - Use different USB port than laser

**[IMAGE: gps-serial-connection.jpg]**

### 2.3 Verify Hardware Connections

**[IMAGE: complete-hardware-setup.jpg]**  
*Tablet/laptop with both devices connected*

**Checklist:**
- ✓ Laser power LED: ON
- ✓ GPS power LED: ON
- ✓ Both USB cables connected to computer
- ✓ Cables secured and won't disconnect during movement

---

## Step 3: Software Installation

### 3.1 For Desktop/Tablet Users (MeasurePRO Web App)

1. **Open your web browser** (Chrome, Edge, or Firefox recommended)
2. **Navigate to:** `https://[your-replit-url]`
3. **Login** with your approved account credentials
4. **Bookmark** this page for quick access

**[SCREENSHOT: login-screen.png]**

**Optional - Install as App:**
1. Click the **browser menu** (⋮)
2. Select **"Install MeasurePRO"** or **"Add to Home Screen"**
3. The app will open in its own window (no browser tabs)

**[SCREENSHOT: install-pwa-option.png]**

### 3.2 For Mobile Users (RoadScope App)

RoadScope is our lightweight mobile companion app for quick field measurements.

**Android:**
1. Open **Google Play Store**
2. Search for **"RoadScope SolTec"**
3. Tap **"Install"**
4. Open app and login with your MeasurePRO credentials

**iOS:**
1. Open **App Store**
2. Search for **"RoadScope SolTec"**
3. Tap **"Get"**
4. Open app and login with your MeasurePRO credentials

**[SCREENSHOT: app-store-icons.jpg]**  
*Play Store and App Store icons side by side*

---

## Step 4: First Time Setup - Permissions

On first launch, MeasurePRO needs access to hardware and device features.

### 4.1 Grant Serial Port Access (Desktop/Tablet)

When you first connect your hardware, you'll see permission prompts.

**For Laser Distance Meter:**
1. Click **"Connect Laser"** button
2. Browser will show available serial ports
3. Select the port for your laser (check cable label)
4. Click **"Connect"**

**[SCREENSHOT: serial-port-selection-laser.png]**

**For GPS Receiver:**
1. Click **"Connect GPS"** button
2. Browser will show available serial ports
3. Select the port for your GPS (different from laser)
4. Click **"Connect"**

**[SCREENSHOT: serial-port-selection-gps.png]**

### 4.2 Grant Device Permissions (Mobile)

**For RoadScope mobile app:**

1. **Location/GPS:** Tap **"Allow"** when prompted
   - Required for position tracking and mapping
   
2. **Camera:** Tap **"Allow"** when prompted
   - Required for photo documentation
   
3. **Notifications:** Tap **"Allow"** (optional)
   - Helpful for alert notifications

**[SCREENSHOT: mobile-permissions.png]**

---

## Step 5: Verify Hardware Connection

Once connected, verify your devices are working properly.

### 5.1 Check Laser Connection

1. Look at the **Measurement Display** panel
2. Point laser at a target (wall, object, etc.)
3. You should see:
   - ✓ **Distance reading** updating in real-time
   - ✓ **Green status indicator**
   - ✓ Reading changes when you move

**[SCREENSHOT: laser-connected-status.png]**  
*Measurement panel showing live readings*

**Troubleshooting:**
- ❌ **"No Data"** - Check cable connections, try reconnecting serial port
- ❌ **"--" dashes** - Laser may need power cycle, check power cable
- ❌ **Frozen reading** - Click "Disconnect" then "Connect" again

### 5.2 Check GPS Connection

1. Look at the **GPS Data** panel (click GPS tab if hidden)
2. Wait 1-2 minutes for satellite lock
3. You should see:
   - ✓ **Latitude/Longitude** coordinates
   - ✓ **Satellite count** (4 or more is good)
   - ✓ **Fix Quality:** "3D Fix" or better
   - ✓ Your **position marker** on the map

**[SCREENSHOT: gps-connected-status.png]**  
*GPS panel showing satellite lock*

**Troubleshooting:**
- ❌ **"No Fix"** - Move GPS to location with clear sky view
- ❌ **Low satellite count** - Wait longer, ensure GPS antenna is upright
- ❌ **"No Data"** - Check cable connections, verify power LED is on

---

## Step 6: Your First Survey

Now that everything is connected, let's create your first survey!

### 6.1 Create a New Survey

1. Click the **"Survey Manager"** tab (left side)
2. Click **"+ New Survey"** button
3. Fill in survey details:
   - **Survey Name:** "My First Survey" (example)
   - **Location:** Address or description
   - **Project:** Optional project name
   - **Notes:** Any relevant details

**[SCREENSHOT: create-survey-dialog.png]**

4. Click **"Create Survey"**
5. The survey is now **active** - you'll see it highlighted in green

**[SCREENSHOT: active-survey-indicator.png]**

### 6.2 Take Your First Measurements

With an active survey, all measurements are automatically logged.

**Basic Measurement:**
1. Point the laser at your target
2. The distance appears in the **Measurement Display**
3. Click **"Log Measurement"** or press **[Space bar]**
4. Measurement is saved with GPS coordinates and timestamp

**[SCREENSHOT: measurement-logging.png]**  
*Measurement panel with Log button highlighted*

**Add a Photo:**
1. Click **"Camera"** tab
2. Click **"Capture Photo"**
3. Take a photo of your target
4. Photo is saved with the measurement data

**[SCREENSHOT: camera-capture.png]**

**Add a Note:**
1. Click the **"Add Note"** button (pencil icon)
2. Type your observation or description
3. Click **"Save"**
4. Note is attached to the measurement

**[SCREENSHOT: add-note-dialog.png]**

### 6.3 View Your Data

**Measurement Log:**
- Click **"Measurement Log"** tab
- See all your logged measurements
- Each entry shows: distance, GPS, time, notes, photos

**[SCREENSHOT: measurement-log-view.png]**

**Map View:**
- Click **"Map"** tab
- See your measurement locations on the map
- Purple line shows your vehicle path (trace)

**[SCREENSHOT: map-with-measurements.png]**

---

## Step 7: Common Tasks

### 7.1 Set Ground Reference

When measuring clearances, set a ground reference height:

1. Point laser straight down at the ground
2. Click **"Set Ground Reference"** button
3. All future measurements are adjusted (Height = Laser Reading - Ground Reference)

**[SCREENSHOT: ground-reference-button.png]**

**Use Case:** When your laser is mounted 10 feet high, and you measure a 12-foot overhead wire, the display shows "2 ft clearance" (12 - 10 = 2).

### 7.2 Export Survey Data

1. Open the active survey in **Survey Manager**
2. Click the **survey name** to open details
3. Click **"Export"** button
4. Choose format:
   - **CSV** - Excel-compatible spreadsheet
   - **JSON** - Raw data file
   - **GeoJSON** - For GIS software
   - **KML** - For Google Earth

**[SCREENSHOT: export-options.png]**

5. File downloads to your device

### 7.3 Switch Between Units

Change between metric and imperial units:

1. Click **"Settings"** (gear icon)
2. Go to **"Display Settings"**
3. Select **"Units":**
   - Imperial (feet/inches)
   - Metric (meters)
4. All measurements update instantly

**[SCREENSHOT: unit-settings.png]**

---

## Step 8: Advanced Features

Once you're comfortable with basics, explore these premium features:

### MeasurePRO+ (AI Detection)
- Real-time object detection in camera view
- Automatic identification of obstacles
- Clearance alerts and warnings
- **[Upgrade required]**

**[SCREENSHOT: ai-detection-overlay.png]**

### Envelope Clearance Monitoring
- Real-time vehicle clearance tracking
- Custom vehicle profiles (width, height, length)
- Audio/visual alerts when too close
- **[Upgrade required]**

**[SCREENSHOT: envelope-clearance-display.png]**

### Route Planning
- Create routes with waypoints
- Turn-by-turn navigation
- Route compliance tracking
- **[Included in all plans]**

**[SCREENSHOT: route-planning.png]**

### Swept Path Analysis
- Predict turning clearances
- Visualize vehicle path through turns
- Collision detection
- **[Premium add-on]**

**[SCREENSHOT: swept-path-overlay.png]**

---

## Troubleshooting Guide

### Issue: "Cannot connect to serial port"

**Solutions:**
1. ✓ Refresh the page and try again
2. ✓ Unplug USB cables, wait 5 seconds, reconnect
3. ✓ Try different USB ports on your computer
4. ✓ Check cable connections at device end
5. ✓ Restart your computer
6. ✓ Use Chrome or Edge browser (best compatibility)

### Issue: Laser shows "No Data" or dashes

**Solutions:**
1. ✓ Verify power LED is ON on laser unit
2. ✓ Check power cable connection
3. ✓ Disconnect and reconnect serial port in app
4. ✓ Power cycle the laser (unplug power, wait 10 seconds, reconnect)

### Issue: GPS shows "No Fix"

**Solutions:**
1. ✓ Wait 2-5 minutes for initial satellite lock (cold start)
2. ✓ Move GPS to location with clear sky view
3. ✓ Avoid parking garages, tunnels, dense tree cover
4. ✓ Ensure GPS antenna is upright (parallel to ground)
5. ✓ Check that GPS power LED is on

### Issue: Measurements seem incorrect

**Solutions:**
1. ✓ Verify laser is pointed at intended target
2. ✓ Check if ground reference is set correctly
3. ✓ Ensure laser lens is clean (use soft cloth)
4. ✓ Verify unit setting (metric vs imperial)
5. ✓ Check for reflective or transparent targets (may cause errors)

### Issue: App won't load or is slow

**Solutions:**
1. ✓ Check internet connection
2. ✓ Clear browser cache (Settings → Privacy → Clear Data)
3. ✓ Try different browser (Chrome recommended)
4. ✓ Close other browser tabs
5. ✓ Restart browser

### Issue: Photos not capturing

**Solutions:**
1. ✓ Grant camera permission when prompted
2. ✓ Check browser settings → Site Permissions → Camera
3. ✓ Ensure camera is not being used by another app
4. ✓ Try refreshing the page

---

## Safety Guidelines

### Laser Safety
- ⚠️ **Never look directly into laser beam**
- ⚠️ **Do not point at eyes or reflective surfaces**
- ⚠️ Class 2 laser - safe for momentary viewing
- Keep away from children

### Vehicle Operation
- ⚠️ **Never operate measurement system while driving**
- Always have a dedicated operator
- Ensure cables don't interfere with vehicle controls
- Secure all equipment before moving vehicle

### Electrical Safety
- Use only provided power cables and adapters
- Don't expose equipment to rain without weatherproofing
- Disconnect power when not in use for extended periods

---

## Support & Resources

### Getting Help

**Email Support:**  
support@soltec.ca  
Response time: Within 24 hours on business days

**Phone Support:**  
[Your phone number]  
Hours: Monday-Friday, 9 AM - 5 PM EST

**Online Resources:**
- Video tutorials: [Your YouTube channel]
- Knowledge base: [Your documentation site]
- User forum: [Your forum URL]

### Training Resources

**Video Tutorials Available:**
- Complete hardware setup walkthrough
- Creating your first survey
- Advanced measurement techniques
- Data export and reporting
- GPS troubleshooting
- Premium features overview

**[QR CODE: training-videos]**  
*Scan to access video tutorials*

### Updates & Maintenance

**Software Updates:**
- MeasurePRO updates automatically
- No downloads or installations needed
- New features appear automatically after login

**Hardware Maintenance:**
- Clean laser lens monthly with soft cloth
- Check cable connections before each use
- Store in protective case when not in use
- Avoid extreme temperatures (below -10°C or above 50°C)

---

## Subscription & Billing

Your hardware kit includes:

- **30-day free trial** of MeasurePRO base plan
- Full access to core measurement features
- GPS tracking and mapping
- Photo documentation
- Data export (all formats)

**After Trial Period:**

**MeasurePRO Base:** $79/month per user
- Unlimited surveys and measurements
- GPS tracking and route planning
- Photo/video documentation
- Email support

**MeasurePRO+:** $149/month per user  
*Includes everything in Base, plus:*
- AI-powered object detection
- Automatic clearance alerts
- Detection logging and training
- Priority support

**Add-ons:**
- Envelope Clearance Monitoring: +$99/month
- Swept Path Analysis: +$450/month (requires Envelope Clearance)
- Convoy Guardian: +$199/month per vehicle
- Permitted Route Enforcement: +$129/month

**To upgrade or manage your subscription:**
1. Login to MeasurePRO
2. Click your name (top right)
3. Select "Subscription & Billing"
4. Choose your plan

---

## Quick Reference Card

**[This section would be a separate tear-out card]**

### Connection Quick Steps
1. Connect laser USB cable → Computer
2. Connect GPS USB cable → Computer  
3. Open MeasurePRO web app
4. Click "Connect Laser" → Select port → Connect
5. Click "Connect GPS" → Select port → Connect
6. Wait for GPS satellite lock (1-2 min)

### Taking Measurements
1. Create/select active survey
2. Point laser at target
3. Press **[Space]** or click "Log"
4. Add photo (optional)
5. Add note (optional)

### Keyboard Shortcuts
- **Space** - Log measurement
- **C** - Capture photo
- **V** - Start/stop video
- **G** - Set ground reference
- **M** - Toggle map view
- **A** - Run AI detection (MeasurePRO+ only)

### Status Indicators
- 🟢 **Green** - Connected and receiving data
- 🟡 **Yellow** - Connected, waiting for data
- 🔴 **Red** - Disconnected or error
- 🔵 **Blue** - Connecting...

### Support Contacts
📧 support@soltec.ca  
📞 [Your phone number]  
🌐 [Your website]

---

**Welcome to professional field measurement!**

You're now ready to conduct accurate, documented surveys with GPS-tracked measurements and comprehensive data logging. If you have any questions during setup or operation, don't hesitate to contact our support team.

**Happy Surveying!**  
— The SolTec Innovation Team

---

*MeasurePRO Quick Start Guide v1.0 - October 2025*  
*© 2025 SolTec Innovation. All rights reserved.*