Skip to content

DEPLOYMENT.md

Latest commit

 

History

History
98 lines (75 loc) · 1.69 KB

DEPLOYMENT.md

File metadata and controls

98 lines (75 loc) · 1.69 KB

Deployment Guide

Quick Start

Linux (Recommended)

git clone <repository-url>
cd lab-nmes-tens-bluetooth
chmod +x setup.sh && ./setup.sh
source venv/bin/activate
python main.py

macOS

# Same as Linux
./setup.sh
source venv/bin/activate
python main.py

Windows

.\setup_windows.ps1
venv\Scripts\activate
python main.py

WSL

WSL doesn't have native Bluetooth access. See WSL_BLUETOOTH.md for solutions:

  • USB/IP passthrough
  • Network bridge service
  • Or just use native Linux/Windows

Verifying Bluetooth

# Linux
bluetoothctl list          # Should show adapter
sudo systemctl status bluetooth

# Check adapter
hciconfig -a

Requirements

  • Python 3.8+ (3.11+ recommended)
  • BLE 4.0+ Bluetooth adapter
  • ~100MB disk space

Troubleshooting

"No module named 'PyQt6'"

source venv/bin/activate  # Make sure venv is active
pip install -r requirements.txt

"Bluetooth adapter not found"

# Check adapter exists
lsusb | grep -i bluetooth

# Check it's not blocked
rfkill list bluetooth

# Start service
sudo systemctl start bluetooth

Permission denied on Bluetooth

sudo usermod -a -G bluetooth $USER
# Log out and back in, or:
newgrp bluetooth

Configuration

Default settings are in src/core/config.py. Override by editing or via the Settings dialog in the GUI.

Key safety limits (can be adjusted for research purposes):

  • Max intensity: 100
  • Max frequency: 150 Hz
  • Max pulse width: 500 μs
  • Emergency timeout: 5s

Updates

git pull origin main
pip install -r requirements.txt --upgrade

See DEVICE_SETUP.md for connecting your device.