Skip to content

User Guide

Jump to bottom
Brian Rodriguez edited this page Dec 5, 2025 · 1 revision

User Guide

Dashboard Overview

The web interface consists of four main sections:

1. Current Values Display

  • Large display of current temperature and humidity
  • Real-time updates every second
  • Color-coded status indicators

2. Psychrometric Calculations

  • Dew Point: Temperature at which water vapor condenses
  • Absolute Humidity: Water vapor mass per air volume (g/m³)
  • Enthalpy: Total heat content of air (kJ/kg)

3. Interactive Graphs

Two synchronized time-series graphs:

  • Temperature over time (degrees Celsius)
  • Humidity over time (percentage)

Graph features:

  • Zoom: Click and drag
  • Pan: Shift + drag
  • Reset: Double-click
  • Hover: View exact values with timestamp

4. Data Table

Scrollable table showing historical measurements:

  • Timestamp
  • Temperature
  • Humidity
  • Dew Point
  • Absolute Humidity
  • Enthalpy

Language Selection

Switch interface language using dropdown in top-right:

  • Nederlands (NL)
  • English (EN)
  • Deutsch (DE)
  • Français (FR)
  • Español (ES)

Language preference is saved in browser.

Data Refresh

Data updates automatically:

  • Current values: Every 1 second
  • Graphs and table: Every 5 seconds
  • No manual refresh needed

Time Period Selection

Use dropdown to view different time ranges:

  • Last hour
  • Last 24 hours
  • Last week
  • Last month
  • All data

Data Export

Data can be exported from the table:

  1. Right-click on table
  2. Select "Export as CSV" (browser dependent)
  3. Or copy data directly from table

Alternatively, access SQLite database directly:

sqlite3 sensor_data.db
SELECT * FROM data_2025_12 ORDER BY timestamp DESC LIMIT 100;

Keyboard Shortcuts

Graph navigation:

  • Arrow keys: Pan view
  • +/-: Zoom in/out
  • Home: Reset view
  • Escape: Clear selection

Troubleshooting

No Data Displayed

Check:

  1. Modbus connection: See terminal for error messages
  2. Serial port: Correct port in .env
  3. Sensor power: XY-MD02 is powered on
  4. Wiring: Correct A/B polarity

Connection Lost

Application continues running and attempts reconnection:

  • Check sensor power and connections
  • Verify serial port availability
  • Review terminal output for errors

Inaccurate Readings

Verify:

  1. Sensor calibration
  2. Correct register addresses in .env
  3. Proper division by 10 (sensor data format)
  4. Environmental stabilization (5-10 minutes)

Slow Performance

Possible solutions:

  1. Reduce data retention period
  2. Clear old database tables
  3. Close unused browser tabs
  4. Check system resources

Database Maintenance

View Database Size

ls -lh sensor_data.db

Vacuum Database

sqlite3 sensor_data.db "VACUUM;"

Manual Cleanup

from database import cleanup_old_data
cleanup_old_data()

Mobile Access

Access dashboard from mobile devices:

  1. Ensure HOST=0.0.0.0 in .env
  2. Find server IP: ipconfig (Windows) or ifconfig (Linux)
  3. On mobile browser: http://SERVER_IP:8050
  4. Ensure firewall allows port 8050

Performance Optimization

For long-term monitoring:

  • Set DATA_RETENTION_DAYS to reasonable value (30-90 days)
  • Use SSD storage for database
  • Consider scheduled database vacuum
  • Monitor disk space regularly

Clone this wiki locally