Difference between revisions of "Maintenance"

From bcmeter.org
Jump to navigation Jump to search
(Update: V1/V2 naming, remove ESP32/Pi distinction)
(Sync with updated manual: updated calibration description, updated data management (3 months storage, oldest log deletion), updated filter change procedure (check for residue), updated firmware upload formats)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Maintenance Procedures ==
== Maintenance Procedures ==


Access maintenance functions via the '''Maintenance''' button (wrench icon) in the navigation bar. The modal is organized into cards for device management, system status, time synchronization, and geolocation.
Access maintenance functions via the '''Maintenance''' button in the navigation bar. The modal is organized into cards for device management, system status, time synchronization, and geolocation.


=== Filter Change Procedure ===
=== Filter Change Procedure ===
Line 10: Line 10:
* The '''marked side must face UP''' (towards the LEDs/light source in the upper optical chamber).
* The '''marked side must face UP''' (towards the LEDs/light source in the upper optical chamber).


'''Warning:''' Incorrect orientation (marked side down) results in ~30% measurement error.
'''Warning:''' Incorrect orientation (marked side down) results in ~30% measurement error. Do not bend or fold the filter. Creases damage the filter surface and cause unreliable measurements.


'''Procedure:'''
'''Procedure:'''


# Stop any running session.
# Stop running session.
# Unscrew the top cap of the optical chamber.
# Unscrew the top cap of the optical chamber.
# Remove the saturated filter.
# Remove the saturated filter.
# Check the air inlet for filter paper residue and '''remove if present'''.
# Insert a new filter with '''markings facing up'''.
# Insert a new filter with '''markings facing up'''.
# Screw the cap back on (hand-tight).
# Screw the cap back on (hand-tight).
Line 24: Line 25:
=== Calibration ===
=== Calibration ===


Filters vary slightly in optical density. Calibration balances the sensor signal against the reference signal for the specific filter currently installed.
Calibration balances the sensor signal against the reference signal for the specific filter currently installed and should ideally be processed on every filter change — although the calibration factor will change extremely slowly once determined.


# Go to '''Maintenance''' > '''Calibrate Device'''.
# Go to '''Maintenance''' > '''Calibrate Device'''.
Line 36: Line 37:
=== Data Management ===
=== Data Management ===


Data is stored on the device's internal storage (with SD card as optional backup).
Data is able to be stored on the device's internal storage for about 3 months of continuous sampling every 5 minutes before deleting the oldest log. To manage your session files:


# Click '''Log Files'''.
# Click '''Log Files'''.
Line 45: Line 46:


'''Backup:''' Internal storage is not archival. Download data to a secure location regularly.
'''Backup:''' Internal storage is not archival. Download data to a secure location regularly.
'''Storage management:''' The device has ~2 MB internal flash for logs. Warning at 512 KB free, critical at 32 KB. Old logs are auto-deleted when critical threshold is reached. Empty files are cleaned on startup.


=== Device Management ===
=== Device Management ===
Line 54: Line 53:
* '''Calibrate Device:''' Adjusts LED duty cycles. Required after each filter change.
* '''Calibrate Device:''' Adjusts LED duty cycles. Required after each filter change.
* '''View System Logs:''' Opens the application log for diagnosing issues. Logs are grouped by category: hardware, measurement, system, network.
* '''View System Logs:''' Opens the application log for diagnosing issues. Logs are grouped by category: hardware, measurement, system, network.
* '''Download Logs:''' Downloads full system logs for troubleshooting or support.
* '''Download Logs:''' Downloads system log for troubleshooting or support.


==== System Operations ====
==== System Operations ====
Line 60: Line 59:
* '''Reboot Device:''' Restarts the device.
* '''Reboot Device:''' Restarts the device.
* '''Shutdown Device:''' Safely powers off to prevent data corruption. Always use this before unplugging. If the device loses power during a session without proper shutdown, it will automatically resume measurement on next boot.
* '''Shutdown Device:''' Safely powers off to prevent data corruption. Always use this before unplugging. If the device loses power during a session without proper shutdown, it will automatically resume measurement on next boot.
* '''Update Firmware:''' Opens a dialog to manually upload a firmware file (.tar.gz). The device also checks for updates automatically every 6 hours and notifies you when one is available.
* '''Update Firmware:''' Opens a dialog to manually upload a firmware file (.tar.gz or .zip). The device also checks for updates automatically several times a day and notifies you when one is available.
* '''Factory Reset:''' Permanently erases all measurement logs, WiFi credentials, calibration data, and device settings. A slide-to-confirm gesture is required. The device reboots into factory state.
* '''Factory Reset:''' Permanently erases all measurement logs, WiFi credentials, calibration data, and device settings. A slide-to-confirm gesture is required. The device reboots into factory state.


Line 67: Line 66:
Displays device information:
Displays device information:


* '''Device ID:''' Unique hardware identifier (MAC address).
* '''Device ID:''' Unique hardware identifier.
* '''Device Name:''' Current network hostname.
* '''Device Name:''' Current network hostname.
* '''Software Version:''' Installed firmware version.
* '''Software Version:''' Installed firmware version.
Line 80: Line 79:
* '''Sync:''' If mismatch exceeds 10 seconds, a sync button appears to synchronize the device clock with your browser.
* '''Sync:''' If mismatch exceeds 10 seconds, a sync button appears to synchronize the device clock with your browser.


Devices connected to the internet sync automatically via NTP. Modem-based time sync (CLTS) is also supported when a 4G modem is connected.
Devices connected to the internet sync automatically via NTP. Modem-based time sync (CLTS) is also supported when a 4G modem is connected ''(optional — requires 4G module)''.


=== Geolocation ===
=== Geolocation ===


When location services are active (Settings > Measurement > Location), a Geolocation card displays:
When location services are active (Settings > Measurement > Location), a Geolocation card displays position and altitude data. ''The available fields depend on which optional hardware modules are installed.''


* '''Location:''' Latitude/longitude with source (GPS, cell tower, or IP-based) and accuracy indicator.
* '''Location:''' Latitude/longitude with source and accuracy indicator. Sources vary by hardware: GPS module ''(optional)'', cellular modem cell tower lookup ''(optional, requires 4G module)'', or IP-based geolocation (available on all WiFi-connected devices).
* '''Altitude (barometric):''' Derived from the pressure sensor.
* '''Altitude (barometric):''' Derived from the pressure sensor. ''Optional — requires a BME280 pressure sensor.''
* '''Altitude (GPS) & Speed:''' Shown when a GPS module is connected and has a fix.
* '''Altitude (GPS) & Speed:''' GPS-derived altitude and current speed. ''Optional — only shown when a GPS module is installed and has a satellite fix.''


The location input supports multiple formats: <code>48.2082, 16.3738</code> — <code>48.2082 16.3738</code> — <code>(48.2082; 16.3738)</code> etc.
The location input supports multiple formats: <code>48.2082, 16.3738</code> — <code>48.2082 16.3738</code> — <code>(48.2082; 16.3738)</code> etc.

Latest revision as of 20:18, 31 March 2026

Maintenance Procedures

Access maintenance functions via the Maintenance button in the navigation bar. The modal is organized into cards for device management, system status, time synchronization, and geolocation.

Filter Change Procedure

The filter is not identical on both sides.

  • Identify the side with markings (black line, dot, or circles).
  • The marked side must face UP (towards the LEDs/light source in the upper optical chamber).

Warning: Incorrect orientation (marked side down) results in ~30% measurement error. Do not bend or fold the filter. Creases damage the filter surface and cause unreliable measurements.

Procedure:

  1. Stop running session.
  2. Unscrew the top cap of the optical chamber.
  3. Remove the saturated filter.
  4. Check the air inlet for filter paper residue and remove if present.
  5. Insert a new filter with markings facing up.
  6. Screw the cap back on (hand-tight).
  7. Check hose (if used): ensure the air hose remains connected to the inlet port.
  8. Run Calibration (required).

Calibration

Calibration balances the sensor signal against the reference signal for the specific filter currently installed and should ideally be processed on every filter change — although the calibration factor will change extremely slowly once determined.

  1. Go to Maintenance > Calibrate Device.
  2. Ensure a new and clean filter is installed.
  3. Click "Yes."
  4. A progress bar appears. The device adjusts LED intensity per channel using binary search to find optimal duty cycles.
  5. Wait for "Calibration Successful" before starting a new log.

Technical detail: Calibration determines the per-channel correction factor K = Ref_avg / Sen_avg and stores it along with optimal LED duty cycles. The ADS1220 ADC samples at 200 samples/sec and targets the 0.5–3.8V sensor range. Calibration typically takes 30–60 seconds.

Data Management

Data is able to be stored on the device's internal storage for about 3 months of continuous sampling every 5 minutes before deleting the oldest log. To manage your session files:

  1. Click Log Files.
  2. Logs (>2 KB): Valid measurement sessions. Download these for analysis.
  3. Logs (<2 KB): Failed starts or very short tests — can typically be deleted.

Downloads available as CSV (for analysis), PNG, or SVG (for printing). CSV files use semicolon separation with dot as decimal divider.

Backup: Internal storage is not archival. Download data to a secure location regularly.

Device Management

Routine Maintenance

  • Calibrate Device: Adjusts LED duty cycles. Required after each filter change.
  • View System Logs: Opens the application log for diagnosing issues. Logs are grouped by category: hardware, measurement, system, network.
  • Download Logs: Downloads system log for troubleshooting or support.

System Operations

  • Reboot Device: Restarts the device.
  • Shutdown Device: Safely powers off to prevent data corruption. Always use this before unplugging. If the device loses power during a session without proper shutdown, it will automatically resume measurement on next boot.
  • Update Firmware: Opens a dialog to manually upload a firmware file (.tar.gz or .zip). The device also checks for updates automatically several times a day and notifies you when one is available.
  • Factory Reset: Permanently erases all measurement logs, WiFi credentials, calibration data, and device settings. A slide-to-confirm gesture is required. The device reboots into factory state.

System Status

Displays device information:

  • Device ID: Unique hardware identifier.
  • Device Name: Current network hostname.
  • Software Version: Installed firmware version.
  • Free Memory: Available system memory.
  • Last Calibration: Timestamp of the most recent calibration.

Time Synchronization

Critical for accurate data timestamps, especially for devices without internet.

  • Browser Time / Device Time: Displayed for comparison.
  • Sync: If mismatch exceeds 10 seconds, a sync button appears to synchronize the device clock with your browser.

Devices connected to the internet sync automatically via NTP. Modem-based time sync (CLTS) is also supported when a 4G modem is connected (optional — requires 4G module).

Geolocation

When location services are active (Settings > Measurement > Location), a Geolocation card displays position and altitude data. The available fields depend on which optional hardware modules are installed.

  • Location: Latitude/longitude with source and accuracy indicator. Sources vary by hardware: GPS module (optional), cellular modem cell tower lookup (optional, requires 4G module), or IP-based geolocation (available on all WiFi-connected devices).
  • Altitude (barometric): Derived from the pressure sensor. Optional — requires a BME280 pressure sensor.
  • Altitude (GPS) & Speed: GPS-derived altitude and current speed. Optional — only shown when a GPS module is installed and has a satellite fix.

The location input supports multiple formats: 48.2082, 16.3738 — 48.2082 16.3738 — (48.2082; 16.3738) etc.

Retrieved from "https://bcmeter.org/wiki/index.php?title=Maintenance&oldid=344"