Difference between revisions of "Configuration"

From bcmeter.org
Jump to navigation Jump to search
(Sync with updated manual: no content changes needed, reformatted for consistency)
(Polish English manual/wiki wording)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
== Configuration & Settings ==
== Configuration & Settings ==


Click '''Settings''' (gear icon) to configure the device. Settings are organized into tabs: '''Network''', '''Measurement''', '''Device''', and '''Email'''.
Click '''Settings''' in the navigation bar to configure the device. Settings are organized into tabs: '''Network''', '''Measurement''', '''Device''', and '''Email'''. An additional '''⚠ Dev''' tab is available in [[Developer_mode|Developer Mode]].


=== Main Controls ===
=== Main Controls ===


* '''Start:''' Begins a measurement session. The device runs an initialization phase (20–30 seconds) to prime the pump and stabilize the optical chamber. Data points appear after the "Sample Time" has elapsed.
* '''Start:''' Opens a startup dialog for a new measurement session. The dialog shows each initialization step while the pump primes and the optical chamber stabilizes. If '''auto-start logging''' is enabled, a countdown timer lets you cancel before the measurement starts. When GPS is available, a '''Mobile measurement''' checkbox turns on per-sample GPS coordinate logging.
* '''Stop:''' Ends the session and saves the file.
* '''Stop:''' Ends the session and saves the file.
* '''Log Files:''' Opens the file manager to download or delete session logs.
* '''Log Files:''' Opens the file manager showing all stored sessions (see [[Maintenance#Data Management|Data Management]]).


=== Network Tab ===
=== Network Tab ===
Line 22: Line 22:
| '''Protect hotspot with WPA2 key''' || When enabled, secures the bcMeter hotspot with a custom password (minimum 8 characters) instead of the default.
| '''Protect hotspot with WPA2 key''' || When enabled, secures the bcMeter hotspot with a custom password (minimum 8 characters) instead of the default.
|}
|}
The WiFi key field includes a show/hide toggle. During connection, the log shows SSID association, IP assignment, and errors.


=== Measurement Tab ===
=== Measurement Tab ===


Controls how the device takes measurements. When Auto Flow Control (AFC) is active, an informational banner summarizes the current AFC configuration.
These settings define the sampling interval, airflow, location handling, and related measurement behavior. When Auto Flow Control (AFC) is active, a banner shows the current AFC limits.


{| class="wikitable"
{| class="wikitable"
! Setting !! Description
! Setting !! Description
|-
|-
| '''Time between samples''' || '''Default: 300s (5 min).''' Adjustable from 30s to 1 hour. Ambient monitoring: 180–600s. Emission monitoring: 10–30s. Increasing frequency may increase noise.
| '''Time between samples''' || '''Default: 300s (5 min).''' Adjustable from 30s to 1 hour. Ambient monitoring: 180–600s. Emission monitoring: 10–30s. Shorter intervals can increase noise.
|-
| '''Airflow per minute''' || '''Default: 300 mL/min.''' Adjustable 50–750 mL/min. Higher flow improves signal but loads the filter faster. Disabled when Auto Flow Control is active.
|-
| '''Auto-adjust airflow''' || Adjusts airflow from the measured BC concentration. High BC lowers the flow to protect the filter; low BC raises the flow for a stronger signal.
|-
|-
| '''Airflow per minute''' || '''Default: 100 mL.''' Adjustable 50–750 mL. Higher flow improves signal but loads filter faster. Disabled when Auto Flow Control is active.
| '''Target filter lifetime''' || '''Default: 7 days.''' Target lifetime used by Auto Flow Control when calculating the airflow setpoint.
|-
|-
| '''Auto-adjust airflow''' || Automatically adjusts airflow based on measured BC concentration. When BC is high, flow is reduced to extend filter life; when BC is low, flow is increased for better signal. When enabled, the manual airflow slider is locked.
| '''Auto-start logging''' || Starts measurement after boot. Requires prior calibration. '''Power-loss recovery:''' If the device loses power during a measurement, it resumes on next boot, regardless of this setting.
|-
|-
| '''Target filter lifetime''' || '''Default: 20 days.''' Sets the target number of days a filter should last. The AFC algorithm uses this value to balance signal quality against filter longevity.
| '''Mobile measurement mode''' || Logs location information per sample when GPS or another location source is available. Intended for moving measurements.
|-
|-
| '''BC smoothing filter''' || Selects the algorithm for smoothing the Black Carbon signal: '''Median3''' (3-point median, default — good balance of noise reduction and responsiveness), '''EMA''' (exponential moving average — smoother but slower), '''Kalman''' (adaptive smoothing that tracks signal dynamics).
| '''Outdoor measurement''' || Marks the session as outdoor ambient monitoring. Disable for indoor or direct emission measurements.
|-
|-
| '''Auto-start logging''' || Automatically begins measurement after device boot. Requires prior calibration. '''Power-loss recovery:''' If the device loses power during a measurement, it will automatically resume on next boot — regardless of this setting.
| '''Pressure correction''' || Corrects BC values for ambient pressure when a BME280 pressure sensor is installed.
|-
|-
| '''Location''' || Controls geographic coordinates: '''Automatic''' (uses best available source — GPS module ''(optional, ~5 m accuracy)'', cell tower lookup ''(optional, requires 4G module, ~1 km accuracy)'', or IP-based geolocation ''(~10–50 km accuracy))''), '''Manual''' (enter lat/lon), or '''Off''' (no location stored).
| '''Location''' || Controls geographic coordinates: '''Automatic''' (GPS/cell tower/IP lookup), '''Manual''' (enter lat/lon), or '''Off''' (no location stored).
|}
|}


An '''Airflow Reference table''' is shown below the settings, giving estimated filter lifetime (in days) at different BC concentrations and airflow rates.
The '''Airflow Reference table''' below the settings shows estimated filter lifetime (in days) at different BC concentrations and airflow rates.


=== Device Tab ===
=== Device Tab ===
Line 56: Line 62:
| '''Warm-up time''' || '''Default: 10 min.''' Duration for the optical chamber to stabilize before data recording begins. Set to 0 to disable.
| '''Warm-up time''' || '''Default: 10 min.''' Duration for the optical chamber to stabilize before data recording begins. Set to 0 to disable.
|-
|-
| '''Disable blinking LED''' || Deactivates the status LED on the device.
| '''Disable status LED''' || Deactivates the blinking status LED on the device.
|-
|-
| '''Device Name''' || Network hostname (e.g., bcmeter201). Sets the mDNS name — the device becomes reachable as <code>name.local</code> after renaming and rebooting.
| '''Device Name''' || Network hostname (e.g., bcmeter-0340). Sets the mDNS name, so the device becomes reachable as <code>name.local</code> after renaming and rebooting.
|}
|}


=== Email Tab (Notifications) ===
=== Email Tab (Notifications) ===


The bcMeter can send automated email notifications including periodic log delivery and filter status alerts. On V2 DIY devices, this requires an email service password (API key) — contact jd@bcmeter.org to request one. On sales devices, email is pre-configured and ready to use.
Use this tab for email delivery of log files, filter status alerts, and optional data sharing with the bcMeter project. Provisioned devices already include the required mail service setup. DIY and development mail-service details are documented in [[Developer_mode|Developer Mode]].
 
On DIY devices, the API key must be entered and validated before notification options become available. Enter it during the [[Setup#Welcome Screen|Welcome Screen]] or later in the Email tab.


{| class="wikitable"
{| class="wikitable"
! Setting !! Description
! Setting !! Description
|-
| '''Email Service Password''' || API key for the mail sending service. Must be validated before other options appear. ''V2 DIY only — on sales devices, email is pre-configured.''
|-
|-
| '''Periodic log sending''' || Master switch for automatic, timed email delivery of CSV logs.
| '''Periodic log sending''' || Master switch for automatic, timed email delivery of CSV logs.
Line 80: Line 82:
| '''Filter status mail''' || Sends alert when filter loading exceeds 70%. Alerts repeat every 12 hours and include device name and location.
| '''Filter status mail''' || Sends alert when filter loading exceeds 70%. Alerts repeat every 12 hours and include device name and location.
|-
|-
| '''Share data with bcMeter team''' || Optionally share measurement data with the bcMeter project for research.
| '''Detailed diagnostic emails''' || Adds extra device context to automatic emails. Enable only when support asks for it.
|-
| '''Share data with bcMeter team''' || Share measurement data with the bcMeter project for maps and analysis.
|}
|}

Latest revision as of 22:15, 2 May 2026

Configuration & Settings

Click Settings in the navigation bar to configure the device. Settings are organized into tabs: Network, Measurement, Device, and Email. An additional ⚠ Dev tab is available in Developer Mode.

Main Controls

  • Start: Opens a startup dialog for a new measurement session. The dialog shows each initialization step while the pump primes and the optical chamber stabilizes. If auto-start logging is enabled, a countdown timer lets you cancel before the measurement starts. When GPS is available, a Mobile measurement checkbox turns on per-sample GPS coordinate logging.
  • Stop: Ends the session and saves the file.
  • Log Files: Opens the file manager showing all stored sessions (see Data Management).

Network Tab

Manages wireless connectivity. This is the default view when opening Settings.

Setting Description
WiFi Scan for available networks, select a network, and enter a password. Use "Forget Network" to clear stored credentials and switch back to hotspot mode.
Hotspot Mode Forces the device to create its own WiFi network, even if a known network is available.
Protect hotspot with WPA2 key When enabled, secures the bcMeter hotspot with a custom password (minimum 8 characters) instead of the default.

The WiFi key field includes a show/hide toggle. During connection, the log shows SSID association, IP assignment, and errors.

Measurement Tab

These settings define the sampling interval, airflow, location handling, and related measurement behavior. When Auto Flow Control (AFC) is active, a banner shows the current AFC limits.

Setting Description
Time between samples Default: 300s (5 min). Adjustable from 30s to 1 hour. Ambient monitoring: 180–600s. Emission monitoring: 10–30s. Shorter intervals can increase noise.
Airflow per minute Default: 300 mL/min. Adjustable 50–750 mL/min. Higher flow improves signal but loads the filter faster. Disabled when Auto Flow Control is active.
Auto-adjust airflow Adjusts airflow from the measured BC concentration. High BC lowers the flow to protect the filter; low BC raises the flow for a stronger signal.
Target filter lifetime Default: 7 days. Target lifetime used by Auto Flow Control when calculating the airflow setpoint.
Auto-start logging Starts measurement after boot. Requires prior calibration. Power-loss recovery: If the device loses power during a measurement, it resumes on next boot, regardless of this setting.
Mobile measurement mode Logs location information per sample when GPS or another location source is available. Intended for moving measurements.
Outdoor measurement Marks the session as outdoor ambient monitoring. Disable for indoor or direct emission measurements.
Pressure correction Corrects BC values for ambient pressure when a BME280 pressure sensor is installed.
Location Controls geographic coordinates: Automatic (GPS/cell tower/IP lookup), Manual (enter lat/lon), or Off (no location stored).

The Airflow Reference table below the settings shows estimated filter lifetime (in days) at different BC concentrations and airflow rates.

Device Tab

Setting Description
Timezone Select the device timezone for accurate log file timestamps.
Warm-up time Default: 10 min. Duration for the optical chamber to stabilize before data recording begins. Set to 0 to disable.
Disable status LED Deactivates the blinking status LED on the device.
Device Name Network hostname (e.g., bcmeter-0340). Sets the mDNS name, so the device becomes reachable as name.local after renaming and rebooting.

Email Tab (Notifications)

Use this tab for email delivery of log files, filter status alerts, and optional data sharing with the bcMeter project. Provisioned devices already include the required mail service setup. DIY and development mail-service details are documented in Developer Mode.

Setting Description
Periodic log sending Master switch for automatic, timed email delivery of CSV logs.
Send logs every Adjustable from 3 hours to 7 days. Default: 24 hours.
Recipient addresses Destination email addresses (comma-separated).
Filter status mail Sends alert when filter loading exceeds 70%. Alerts repeat every 12 hours and include device name and location.
Detailed diagnostic emails Adds extra device context to automatic emails. Enable only when support asks for it.
Share data with bcMeter team Share measurement data with the bcMeter project for maps and analysis.
Retrieved from "https://bcmeter.org/wiki/index.php?title=Configuration&oldid=380"