bcmeter.org - Recent changes [en]

User:DelSpedding

DelSpedding — Tue, 09 Jun 2026 02:07:21 GMT

User account DelSpedding was created

Introduction

Bcmwiki — Mon, 08 Jun 2026 19:17:02 GMT

Consistency: 'open design/PCB' -> 'source-available' per licensing decision

← Older revision		Revision as of 19:17, 8 June 2026
Line 9:		Line 9:
	=== Device Types ===		=== Device Types ===

	* '''bcMeter (DIY)''' — The source-available, self-build version. Runs on a Raspberry Pi using the ~~open~~ PCB design, freely available for private, educational and research use (CC BY-NC 4.0). Build your own from the ~~open~~ design files and the Wiki (nothing is sold).		* '''bcMeter (DIY)''' — The source-available, self-build version. Runs on a Raspberry Pi using the source-available PCB design, freely available for private, educational and research use (CC BY-NC 4.0). Build your own from the source-available design files and the Wiki (nothing is sold).
	* '''bcMeter Kit''' — Assembled-instrument PCB plus components for self-assembly and 3D printing. Available on request.		* '''bcMeter Kit''' — Assembled-instrument PCB plus components for self-assembly and 3D printing. Available on request.
	* '''bcMeter Complete''' — Fully assembled, ready-to-use instrument on a compact platform that starts in seconds and updates over the air, with no microSD card or Linux system to maintain. Available on request.		* '''bcMeter Complete''' — Fully assembled, ready-to-use instrument on a compact platform that starts in seconds and updates over the air, with no microSD card or Linux system to maintain. Available on request.

Bill of material

Bcmwiki — Mon, 08 Jun 2026 19:10:05 GMT

Fix GitHub org: bcmeter/bcmeter -> dahljo/bcmeter (legacy V1 Pi repo)

← Older revision		Revision as of 19:10, 8 June 2026
Line 17:		Line 17:
	== 3D Printed Case ==		== 3D Printed Case ==

	STL files for 3D Printing (SLA or FDM): [https://github.com/~~bcmeter~~/bcmeter/tree/main/stl GitHub repository] — printing material ~10 EUR.		STL files for 3D Printing (SLA or FDM): [https://github.com/dahljo/bcmeter/tree/main/stl GitHub repository] — printing material ~10 EUR.

	Use black filament/resin. FDM is prone to leakage if not properly configured. If possible, mix resin with flex resin.		Use black filament/resin. FDM is prone to leakage if not properly configured. If possible, mix resin with flex resin.
Line 67:		Line 67:
	\|}		\|}

	Full BOM with exact product numbers available at [https://github.com/~~bcmeter~~/bcmeter GitHub].		Full BOM with exact product numbers available at [https://github.com/dahljo/bcmeter GitHub].

	== PCB / Gerber Files ==		== PCB / Gerber Files ==

	Gerber files for PCB fabrication: [https://github.com/~~bcmeter~~/bcmeter/tree/main/gerbers GitHub]		Gerber files for PCB fabrication: [https://github.com/dahljo/bcmeter/tree/main/gerbers GitHub]

	Two PCB variants exist:		Two PCB variants exist:

Serial commands

Bcmwiki — Mon, 08 Jun 2026 18:59:35 GMT

Restructure: platform separation (ESP32 commercial prioritised, Raspberry Pi DIY in own section); verified against firmware/Pi source; complete serial command list

Show changes

API reference

Bcmwiki — Mon, 08 Jun 2026 18:59:35 GMT

Restructure: platform separation (ESP32 commercial prioritised, Raspberry Pi DIY in own section); verified against firmware/Pi source; complete serial command list

Show changes

Maintenance

Bcmwiki — Mon, 08 Jun 2026 18:59:35 GMT

Restructure: platform separation (ESP32 commercial prioritised, Raspberry Pi DIY in own section); verified against firmware/Pi source; complete serial command list

← Older revision		Revision as of 18:59, 8 June 2026
Line 32:		Line 32:
	# Wait for "Calibration Successful" before starting a new log.		# 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 with the LED duty cycle values~~. Current ESP32 builds use ADS1220 block averaging for the optical readings~~. Calibration typically takes 30–60 seconds.		'''Technical detail:''' Calibration determines the per-channel correction factor K = Ref_avg / Sen_avg and stores it with the LED duty cycle values. Calibration typically takes 30–60 seconds.

	=== Data Management ===		=== Data Management ===

	~~Data is stored on the device's internal flash storage (LittleFS) and persists across reboots.~~

	Click '''Log Files''' to open the data manager. The modal lists all stored sessions:		Click '''Log Files''' to open the data manager. The modal lists all stored sessions:
Line 43:		Line 41:
	! Column !! Description		! Column !! Description
	\|-		\|-
	\| '''Log''' \|\| Session name or filename (e.g., <code>~~bcmeter_20260312_2126~~.csv</code>). "Current Session" shows the active log.		\| '''Log''' \|\| Session name or filename (e.g., <code>26-03-12_212600.csv</code>). "Current Session" shows the active log.
	\|-		\|-
	\| '''Size''' \|\| File size in KB, or number of data points for the current session.		\| '''Size''' \|\| File size in KB, or number of data points for the current session.
Line 57:		Line 55:

	'''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 73:		Line 69:
	* '''Reboot Device:''' Restarts the device.		* '''Reboot Device:''' Restarts the device.
	* '''Shutdown Device:''' Powers down before unplugging. Use this before disconnecting power. If the device loses power during an active session, it resumes measurement on the next boot.		* '''Shutdown Device:''' Powers down before unplugging. Use this before disconnecting power. If the device loses power during an active session, it resumes measurement on the next boot.
	* '''Manual Firmware Update:''' Opens a dialog to upload a firmware file ~~(.bin)~~. The device also checks for updates a few times a day.		* '''Manual Firmware Update:''' Opens a dialog to upload a firmware file. The device also checks for updates a few times a day.
	* '''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 113:		Line 109:

	The location input accepts common coordinate formats: <code>48.2082, 16.3738</code> — <code>48.2082 16.3738</code> — <code>(48.2082; 16.3738)</code>.		The location input accepts common coordinate formats: <code>48.2082, 16.3738</code> — <code>48.2082 16.3738</code> — <code>(48.2082; 16.3738)</code>.

			=== bcMeter (DIY) — Raspberry Pi ===

			The following notes apply specifically to the '''bcMeter (DIY)''' Raspberry Pi version. For the commercial bcMeter (ESP32), the sections above describe all maintenance procedures.

			==== Storage ====

			The Raspberry Pi version stores measurement data on the Linux filesystem (typically under <code>/home/bcmeter/logs/</code>). There is no fixed flash storage limit — available disk space depends on the SD card and system configuration. The web interface data manager works the same way as on the ESP32: log files are listed and can be downloaded or deleted individually.

			The Pi does '''not''' use LittleFS or NVS. Configuration is stored in <code>~/bcmeter/bcMeter_config.json</code>.

			==== Service Management ====

			The bcMeter software runs as a systemd service (<code>bcMeter.service</code>). '''Do not use <code>systemctl stop</code>''' — stopping the service also disables the WiFi access point, cutting off remote access. Use the web interface Reboot or Shutdown buttons, or <code>systemctl restart</code> if a restart is needed from the terminal.

			The firmware update endpoint (<code>POST /api/update</code>) accepts a <code>.tar.gz</code> or <code>.zip</code> archive, extracts it over the code directory, and runs <code>sudo systemctl restart bcMeter.service</code> automatically.

			==== Maintenance Log Bundle ====

			The Raspberry Pi version provides an additional endpoint, <code>GET /api/maintenance-logs</code>, which downloads a zip bundle for support purposes. The bundle contains:

			* Rotating <code>bcmeter.log</code> files
			* Syslog and <code>dmesg</code> output
			* The 10 most recent CSV session files
			* <code>journalctl</code> output for the bcMeter and pigpiod services
			* The current config JSON (sensitive keys redacted)
			* The incident log

			This endpoint does not exist on the ESP32, which uses the structured <code>/api/logs</code> endpoint and crash report email for equivalent diagnostics.

			==== ADC Hardware ====

			The Raspberry Pi version uses the ADS8344E (18-bit, SPI) or MCP3428 (I2C, legacy) ADC, rather than the ADS1220 used on the ESP32. Calibration and measurement procedures are identical from the user's perspective.

Best practices

Bcmwiki — Mon, 08 Jun 2026 18:47:40 GMT

Consistency pass 2: airflow range via Configuration, multi-wavelength as in-development, ESP32/Pi CSV filename split, legacy sensor wording

← Older revision		Revision as of 18:47, 8 June 2026
Line 15:		Line 15:

	* '''Airflow:'''		* '''Airflow:'''
	** ~~Adjustable roughly between 25 and 500~~ mL/min (~~default 300 mL/min~~); the usable range narrows as the filter loads. With Auto Flow Control the device sets the rate automatically from the measured BC concentration.		** Default 300 mL/min, adjustable (see [[Configuration]] for the range). Higher flow improves signal but loads the filter faster; the usable range narrows as the filter loads. With Auto Flow Control the device sets the rate automatically from the measured BC concentration.
	** Higher airflow improves signal strength but loads the filter faster.		** Higher airflow improves signal strength but loads the filter faster.

Interface

Bcmwiki — Mon, 08 Jun 2026 18:47:40 GMT

Consistency pass 2: airflow range via Configuration, multi-wavelength as in-development, ESP32/Pi CSV filename split, legacy sensor wording

← Older revision		Revision as of 18:47, 8 June 2026
Line 115:		Line 115:
	! Parameter !! Description		! Parameter !! Description
	\|-		\|-
	\| '''Reference (880nm)''' \|\| Light intensity from the 880nm LED through the clean portion of the filter — baseline for comparison. Optional: 520nm, 370nm ~~if multi-wavelength~~ hardware ~~installed~~.		\| '''Reference (880nm)''' \|\| Light intensity from the 880nm LED through the clean portion of the filter — baseline for comparison. Optional 520nm / 370nm channels are in development (not available in shipped hardware).
	\|-		\|-
	\| '''Sensor (880nm)''' \|\| Light intensity after passing through the particle-loaded spot.		\| '''Sensor (880nm)''' \|\| Light intensity after passing through the particle-loaded spot.
Line 127:		Line 127:
	\| '''Relative Load''' \|\| Filter spot saturation level (%), indicating when replacement is needed.		\| '''Relative Load''' \|\| Filter spot saturation level (%), indicating when replacement is needed.
	\|-		\|-
	\| '''Ångström Exponent''' \|\| Ratio indicating aerosol source characteristics (requires multi-wavelength hardware).		\| '''Ångström Exponent''' \|\| Ratio indicating aerosol source characteristics (requires multi-wavelength hardware — in development, not in shipped devices).
	\|-		\|-
	\| '''Temperature (°C)''' \|\| Internal operating temperature — important for measurement stability.		\| '''Temperature (°C)''' \|\| Internal operating temperature — important for measurement stability.

CSV data format

Bcmwiki — Mon, 08 Jun 2026 18:47:40 GMT

Consistency pass 2: airflow range via Configuration, multi-wavelength as in-development, ESP32/Pi CSV filename split, legacy sensor wording

← Older revision		Revision as of 18:47, 8 June 2026
Line 21:		Line 21:
	=== Filename Convention ===		=== Filename Convention ===

	* Active session: <code>YY-MM-DD_HHMMSS.csv</code> (based on session start time)		* Active session: <code>YY-MM-DD_HHMMSS.csv</code> on ESP32 builds, <code>DD-MM-YY_HHMMSS.csv</code> on Raspberry Pi builds (based on session start time)
	* Fallback (no RTC sync): <code>nosync_HHMMSS.csv</code> (based on uptime)		* Fallback (no RTC sync): <code>nosync_HHMMSS.csv</code> (based on uptime)

Line 54:		Line 54:
	\|}		\|}

	==== Multi-Wavelength Columns (~~optional~~, if hardware ~~installed~~) ====		==== Multi-Wavelength Columns (in development, not in shipped hardware) ====

	Same structure as 880nm, repeated for each wavelength:		Same structure as 880nm, repeated for each wavelength:

Developer mode

Bcmwiki — Mon, 08 Jun 2026 18:47:40 GMT

Consistency pass 2: airflow range via Configuration, multi-wavelength as in-development, ESP32/Pi CSV filename split, legacy sensor wording

← Older revision		Revision as of 18:47, 8 June 2026
Line 185:		Line 185:
	* '''Optics/ADC:''' Pi builds use ADS8344E hardware (legacy units may use MCP342X); ESP32 builds use ADS1220-based optical acquisition.		* '''Optics/ADC:''' Pi builds use ADS8344E hardware (legacy units may use MCP342X); ESP32 builds use ADS1220-based optical acquisition.
	* '''Firmware updates:''' bcMeter (DIY) builds may update through OS/GitHub release workflows, while ESP32 devices use OTA firmware images.		* '''Firmware updates:''' bcMeter (DIY) builds may update through OS/GitHub release workflows, while ESP32 devices use OTA firmware images.
	* '''Sensors:''' ~~bcMeter (~~DIY) builds ~~may~~ expose DS18B20 ~~or other prototype sensors that are~~ not present on ~~every ESP32 unit~~.		* '''Sensors:''' Some legacy or prototype DIY builds expose additional sensors (e.g. DS18B20 1-Wire temperature) not present on standard units.

Introduction

Bcmwiki — Mon, 08 Jun 2026 18:43:41 GMT

Consistency pass: multi-wavelength in-development, bcmeter-pi link, anchor/Flask/V2 fixes, airflow & ATN clarifications

← Older revision		Revision as of 18:43, 8 June 2026
Line 5:		Line 5:
	The device operates "headless" — it has no built-in screen. Instead, it hosts its own website that you can access from any smartphone or computer connected to the same network.		The device operates "headless" — it has no built-in screen. Instead, it hosts its own website that you can access from any smartphone or computer connected to the same network.

	The software is source-available — freely available for private, educational and research use (CC BY-NC 4.0): [https://github.com/dahljo/bcmeter github.com/dahljo/bcmeter]		The software is source-available — freely available for private, educational and research use (CC BY-NC 4.0): [https://github.com/dahljo/bcmeter-pi github.com/dahljo/bcmeter-pi]

	=== Device Types ===		=== Device Types ===
Line 25:		Line 25:
	# Data is saved as CSV and displayed in real-time on the web interface		# Data is saved as CSV and displayed in real-time on the web interface

	'''Multi-wavelength:''' ~~Optional~~ 520 nm and 370 nm channels ~~enable~~ source apportionment via the Ångström Exponent (AAE) ~~— distinguishing between fossil fuel~~ and ~~biomass burning sources~~.		'''Multi-wavelength (in development):''' Additional 520 nm and 370 nm channels for source apportionment via the Ångström Exponent (AAE) are in development and '''not available in shipped hardware'''. Current devices measure at 880 nm only.

	=== Sensors & Capabilities ===		=== Sensors & Capabilities ===
Line 35:		Line 35:
	\|-		\|-
	\| Black Carbon (BC) \|\| Optical absorption at 880 nm \|\| Primary measurement		\| Black Carbon (BC) \|\| Optical absorption at 880 nm \|\| Primary measurement
	\|-
	~~\| Source apportionment \|\| 520 nm, 370 nm \|\| Ångström Exponent~~
	\|-		\|-
	\| Temperature / Humidity \|\| SHT4x \|\|		\| Temperature / Humidity \|\| SHT4x \|\|

Main Page

Bcmwiki — Mon, 08 Jun 2026 18:43:41 GMT

Consistency pass: multi-wavelength in-development, bcmeter-pi link, anchor/Flask/V2 fixes, airflow & ATN clarifications

← Older revision		Revision as of 18:43, 8 June 2026
Line 35:		Line 35:
	== Software ==		== Software ==

	The bcMeter software is source-available — freely available for private, educational and research use (CC BY-NC 4.0): '''[https://github.com/dahljo/bcmeter github.com/dahljo/bcmeter]'''		The bcMeter software is source-available — freely available for private, educational and research use (CC BY-NC 4.0): '''[https://github.com/dahljo/bcmeter-pi github.com/dahljo/bcmeter-pi]'''

	The codebase includes the web [[Interface\|interface]], [[API reference\|REST API]], measurement engine, and all device management functionality.		The codebase includes the web [[Interface\|interface]], [[API reference\|REST API]], measurement engine, and all device management functionality.

Troubleshooting

Bcmwiki — Mon, 08 Jun 2026 18:43:41 GMT

Consistency pass: multi-wavelength in-development, bcmeter-pi link, anchor/Flask/V2 fixes, airflow & ATN clarifications

← Older revision		Revision as of 18:43, 8 June 2026
Line 6:		Line 6:
	\| '''Negative data over a longer period''' \|\| '''Temperature or lighting changes.''' Ensure the bcMeter is not in direct or reflected sunlight (keep reflections from windows on other side of the road in mind). Do not place near radiators or heat sources. If issue persists, contact support.		\| '''Negative data over a longer period''' \|\| '''Temperature or lighting changes.''' Ensure the bcMeter is not in direct or reflected sunlight (keep reflections from windows on other side of the road in mind). Do not place near radiators or heat sources. If issue persists, contact support.
	\|-		\|-
	\| '''Device keeps restarting''' \|\| '''Power supply.''' Cable too long or thin — see power requirements in [[Setup#~~Power Supply is Critical~~\|Setup]].		\| '''Device keeps restarting''' \|\| '''Power supply.''' Cable too long or thin — see power requirements in [[Setup#Hardware Requirements\|Setup]].
	\|-		\|-
	\| '''WiFi unstable or disconnects''' \|\| Voltage instability (see power supply) or weak signal. The hotspot may temporarily disappear for 2–3 minutes during self-recovery — it returns automatically.		\| '''WiFi unstable or disconnects''' \|\| Voltage instability (see power supply) or weak signal. The hotspot may temporarily disappear for 2–3 minutes during self-recovery — it returns automatically.

Best practices

Bcmwiki — Mon, 08 Jun 2026 18:43:41 GMT

Consistency pass: multi-wavelength in-development, bcmeter-pi link, anchor/Flask/V2 fixes, airflow & ATN clarifications

← Older revision		Revision as of 18:43, 8 June 2026
Line 15:		Line 15:

	* '''Airflow:'''		* '''Airflow:'''
	** ~~Minimum 40~~ mL/min~~, maximum 400~~ mL/min ~~(hardware-dependent~~).		** Adjustable roughly between 25 and 500 mL/min (default 300 mL/min); the usable range narrows as the filter loads. With Auto Flow Control the device sets the rate automatically from the measured BC concentration.
	** Higher airflow improves signal strength but loads the filter faster.		** Higher airflow improves signal strength but loads the filter faster.

Line 45:		Line 45:
	* At the default airflow in a typical urban environment (~500 ng/m³), a filter lasts approximately '''3–5 days'''.		* At the default airflow in a typical urban environment (~500 ng/m³), a filter lasts approximately '''3–5 days'''.
	* In heavily polluted areas, a filter may saturate in '''6–12 hours'''.		* In heavily polluted areas, a filter may saturate in '''6–12 hours'''.
	* ~~The filter~~ is ~~considered saturated at approximately '''30%~~ attenuation~~'''. Beyond this, accuracy degrades — values~~ are ~~flagged in~~ the ~~CSV~~.		* Filter status is derived from attenuation (ATN): measurements are fully quantitative up to about ATN 75 and degrade at higher loading; the device flags the filter for replacement around ATN 120. (The ATN value is not a simple percentage of light loss.)
	* The [[Configuration#Measurement Tab\|Airflow Reference table]] in Settings helps estimate filter lifetime for your conditions.		* The [[Configuration#Measurement Tab\|Airflow Reference table]] in Settings helps estimate filter lifetime for your conditions.

Developer mode

Bcmwiki — Mon, 08 Jun 2026 18:43:41 GMT

Consistency pass: multi-wavelength in-development, bcmeter-pi link, anchor/Flask/V2 fixes, airflow & ATN clarifications

← Older revision		Revision as of 18:43, 8 June 2026
Line 182:		Line 182:
	The <code>bcmeter-dev</code> Raspberry Pi codebase powers '''bcMeter (DIY)''' builds, but it differs from the ESP32 firmware in the assembled instruments. Device-specific differences should be treated as implementation details of the same function:		The <code>bcmeter-dev</code> Raspberry Pi codebase powers '''bcMeter (DIY)''' builds, but it differs from the ESP32 firmware in the assembled instruments. Device-specific differences should be treated as implementation details of the same function:

	* '''Networking:''' Raspberry Pi builds ~~may~~ use ~~Flask~~ and NetworkManager, while ESP32 builds use the embedded web server and ESP-IDF WiFi stack.		* '''Networking:''' Raspberry Pi builds use FastAPI/uvicorn and NetworkManager, while ESP32 builds use the embedded web server and ESP-IDF WiFi stack.
	* '''Optics/ADC:''' Pi builds may ~~reference ADS8344E or~~ MCP342X ~~hardware~~; ~~current~~ ESP32 V2 builds use ADS1220-based optical acquisition.		* '''Optics/ADC:''' Pi builds use ADS8344E hardware (legacy units may use MCP342X); ESP32 builds use ADS1220-based optical acquisition.
	* '''Firmware updates:''' bcMeter (DIY) builds may update through OS/GitHub release workflows, while ESP32 devices use OTA firmware images.		* '''Firmware updates:''' bcMeter (DIY) builds may update through OS/GitHub release workflows, while ESP32 devices use OTA firmware images.
	* '''Sensors:''' bcMeter (DIY) builds may expose DS18B20 or other prototype sensors that are not present on every ESP32 unit.		* '''Sensors:''' bcMeter (DIY) builds may expose DS18B20 or other prototype sensors that are not present on every ESP32 unit.

CSV data format

Bcmwiki — Mon, 08 Jun 2026 16:20:51 GMT

Fix ATN formula: ATN = -100*ln(Sen/Ref), dimensionless; sigma enters BC not ATN (verified vs firmware measure.cpp)

← Older revision		Revision as of 16:20, 8 June 2026
Line 39:		Line 39:
	\| <code>bcmSen_880nm</code> \|\| float \|\| V \|\| Sensor channel voltage (880nm LED through sample spot)		\| <code>bcmSen_880nm</code> \|\| float \|\| V \|\| Sensor channel voltage (880nm LED through sample spot)
	\|-		\|-
	\| <code>bcmATN_880nm</code> \|\| float \|\| — \|\| Attenuation at 880nm = ~~−ln~~(Sen/Ref) / σ		\| <code>bcmATN_880nm</code> \|\| float \|\| — \|\| Attenuation at 880nm = −100·ln(Sen/Ref), dimensionless. The absorption cross-section σ enters the BC concentration, not ATN.
	\|-		\|-
	\| <code>BCngm3_unfiltered_880nm</code> \|\| float \|\| ng/m³ \|\| Real-time BC concentration (unsmoothed)		\| <code>BCngm3_unfiltered_880nm</code> \|\| float \|\| ng/m³ \|\| Real-time BC concentration (unsmoothed)

Setup

Bcmwiki — Mon, 08 Jun 2026 10:35:07 GMT

Reframe: bcMeter (DIY) / source-available

← Older revision		Revision as of 10:35, 8 June 2026
Line 5:		Line 5:
	'''Use a stable power supply:''' Weak adapters and voltage drops are the most common causes of WiFi dropouts and random reboots.		'''Use a stable power supply:''' Weak adapters and voltage drops are the most common causes of WiFi dropouts and random reboots.

	* ~~ESP32~~ bcMeter V2: use a suitable '''12V / 2A''' power adapter.		* bcMeter Kit/Complete: use a suitable '''12V / 2A''' power adapter.
	* ~~Raspberry Pi based development devices~~: use a suitable '''5V / 2.5A''' power adapter.		* bcMeter (DIY): use a suitable '''5V / 2.5A''' power adapter.
	* Use a '''short, low-resistance cable''' (ideally under 40 cm). Long or thin cables can drop enough voltage to reboot the device when the pump starts.		* Use a '''short, low-resistance cable''' (ideally under 40 cm). Long or thin cables can drop enough voltage to reboot the device when the pump starts.

Line 24:		Line 24:
	# Wait '''1-2 minutes''' for the system to boot.		# Wait '''1-2 minutes''' for the system to boot.
	# On your phone or computer, search for a WiFi network whose name starts with '''bcMeter''' or '''eBcMeter'''.		# On your phone or computer, search for a WiFi network whose name starts with '''bcMeter''' or '''eBcMeter'''.
	# If asked, connect using the password <code>bcMeterbcMeter</code> (case sensitive). ~~Recent ESP32 devices~~ may create an open setup hotspot and will not ask for a password.		# If asked, connect using the password <code>bcMeterbcMeter</code> (case sensitive). Current assembled bcMeter instruments may create an open setup hotspot and will not ask for a password.
	# Your phone may warn "No Internet Connection." '''This is normal.''' Select "Keep Connected" if prompted. Do not choose "use mobile data."		# Your phone may warn "No Internet Connection." '''This is normal.''' Select "Keep Connected" if prompted. Do not choose "use mobile data."
	# Open a browser and type <code><nowiki>http://bcmeter-XXXX.local</nowiki></code> (where XXXX are the last 4 hex characters of the MAC address, e.g. <code>bcmeter-A3AB</code>) or <code><nowiki>http://192.168.18.8</nowiki></code>.		# Open a browser and type <code><nowiki>http://bcmeter-XXXX.local</nowiki></code> (where XXXX are the last 4 hex characters of the MAC address, e.g. <code>bcmeter-A3AB</code>) or <code><nowiki>http://192.168.18.8</nowiki></code>.

Installation

Bcmwiki — Mon, 08 Jun 2026 10:35:06 GMT

Reframe: bcMeter (DIY) / source-available

← Older revision		Revision as of 10:35, 8 June 2026
Line 1:		Line 1:
	{{Note\|1='''~~Legacy V1 Documentation~~''' — This page documents software setup for the bcMeter V1. The ~~current V2~~ bcMeter ~~comes~~ pre-configured and is set up via the [[Setup#Welcome Screen\|Welcome Screen]]~~. These instructions are preserved for V1 users~~.}}		{{Note\|1='''bcMeter (DIY)''' — This page documents software setup for the source-available bcMeter (DIY) — the Raspberry-Pi-based design, freely available for private, educational and research use (CC BY-NC 4.0). The assembled bcMeter instruments come pre-configured and are set up via the [[Setup#Welcome Screen\|Welcome Screen]].}}

	== Recommended: Pre-configured microSD Card Image (V1) ==		== Recommended: Pre-configured microSD Card Image (bcMeter DIY) ==

	=== Step 1: Download and Flash the Image ===		=== Step 1: Download and Flash the Image ===
Line 26:		Line 26:
	# Follow on-screen instructions		# Follow on-screen instructions

	== Advanced: Manual Setup via SSH (V1) ==		== Advanced: Manual Setup via SSH (bcMeter DIY) ==

	Use the [https://www.raspberrypi.com/software/ Raspberry Pi Imager] to write '''Raspberry OS 64-bit LITE''' to the microSD card. Do '''not''' install the Desktop variant.		Use the [https://www.raspberrypi.com/software/ Raspberry Pi Imager] to write '''Raspberry OS 64-bit LITE''' to the microSD card. Do '''not''' install the Desktop variant.
Line 44:		Line 44:
	This runs an unattended installation taking a few minutes.		This runs an unattended installation taking a few minutes.

	== ~~Current Platform~~ (V2) ==		== Assembled instruments (Kit/Complete/eBcMeter) ==

	The V2 bcMeter ~~comes~~ with firmware pre-installed. Setup only requires:		The assembled bcMeter instruments come with firmware pre-installed. Setup only requires:

	# Plug in power		# Plug in power

Device assembly

Bcmwiki — Mon, 08 Jun 2026 10:35:05 GMT

Reframe: bcMeter (DIY) / source-available

← Older revision		Revision as of 10:35, 8 June 2026
Line 1:		Line 1:
	{{Note\|1='''~~Legacy V1 Documentation~~''' — This page documents assembly of the bcMeter V1. The ~~current V2 platform has~~ a different hardware design~~. V1 assembly instructions are preserved here for reference~~.}}		{{Note\|1='''bcMeter (DIY)''' — This page documents assembly of the source-available bcMeter (DIY) — the Raspberry-Pi-based design, freely available for private, educational and research use (CC BY-NC 4.0). The assembled bcMeter instruments use a different hardware design.}}

	'''bcMeter V1 Assembly Documentation''' (v02, January 2025)		'''bcMeter (DIY) Assembly Documentation''' (v02, January 2025)

	== LED and Sensor Brackets ==		== LED and Sensor Brackets ==
Line 62:		Line 62:
	* If noise is heard (indicating leakage), use glue to seal the gap.		* If noise is heard (indicating leakage), use glue to seal the gap.

	== Description of the Components (~~V1 PCB~~) ==		== Description of the Components (bcMeter DIY) ==

	* '''U1:''' MCP3428 4-Channel Analogue/Digital Converter		* '''U1:''' MCP3428 4-Channel Analogue/Digital Converter

Bill of material

Bcmwiki — Mon, 08 Jun 2026 10:35:04 GMT

Reframe: bcMeter (DIY) / source-available

← Older revision		Revision as of 10:35, 8 June 2026
Line 1:		Line 1:
	{{Note\|1='''~~Legacy V1 Documentation~~''' — This page documents the bill of materials for the bcMeter V1. The ~~current V2 platform uses~~ a different PCB design.}}		{{Note\|1='''bcMeter (DIY)''' — This page documents the bill of materials for the source-available bcMeter (DIY) — the Raspberry-Pi-based design, freely available for private, educational and research use (CC BY-NC 4.0). The assembled bcMeter instruments use a different PCB design.}}

	== Overview of Parts (V1) ==		== Overview of Parts (bcMeter DIY) ==

	[[File:bcMeter_parts.jpg\|thumb\|none\|800px]]		[[File:bcMeter_parts.jpg\|thumb\|none\|800px]]
Line 13:		Line 13:
	# '''Air Pump''' (~10–200 EUR depending on type)		# '''Air Pump''' (~10–200 EUR depending on type)

	''~~Populated PCBs are~~ available — contact jd@bcmeter.org.''		''Prefer not to source parts? bcMeter Kit/Complete available on request — contact jd@bcmeter.org.''

	== 3D Printed Case ==		== 3D Printed Case ==
Line 77:		Line 77:
	* '''THT PCB''' — For 12V and larger pumps. Easier to assemble but less accurate.		* '''THT PCB''' — For 12V and larger pumps. Easier to assemble but less accurate.

	== ~~Current Platform~~ (V2) ==		== Assembled instruments (Kit/Complete/eBcMeter) ==

	The ~~current~~ bcMeter ~~V2 uses~~ a different hardware design:		The assembled bcMeter instruments use a different hardware design:

	* '''ADS1220''' 24-bit ADC (replaces MCP3428)		* '''ADS1220''' 24-bit ADC (replaces MCP3428)
	* '''Integrated microcontroller''' (~~replaces~~ Raspberry Pi)		* '''Integrated microcontroller''' (instead of the Raspberry Pi used in the DIY build)
	* '''Internal flash storage''' (replaces microSD)		* '''Internal flash storage''' (replaces microSD)
	* '''Optional:''' SIM7080G LTE-M modem, AT6668 GPS, SPS30 PM sensor		* '''Optional:''' SIM7080G LTE-M modem, AT6668 GPS, SPS30 PM sensor

	For current device information, see [[Introduction]].		For current device information, see [[Introduction]].

Developer mode

Bcmwiki — Mon, 08 Jun 2026 10:35:03 GMT

Reframe: bcMeter (DIY) / source-available

← Older revision		Revision as of 10:35, 8 June 2026
Line 178:		Line 178:
	<blockquote style="background:#fff3cd;padding:8px 16px;border-radius:4px;">'''⚠ 12V Power Missing''' — The optical ADC is not detected. Optics and light sensors will not function. Pump and airflow control may be limited by hardware state.</blockquote>		<blockquote style="background:#fff3cd;padding:8px 16px;border-radius:4px;">'''⚠ 12V Power Missing''' — The optical ADC is not detected. Optics and light sensors will not function. Pump and airflow control may be limited by hardware state.</blockquote>

	=== ~~Development Device~~ Variants ===		=== Platform Variants (DIY / open line vs assembled instruments) ===

	The <code>bcmeter-dev</code> Raspberry Pi codebase ~~is useful for development and older prototypes~~, but it differs from the ESP32 ~~production~~ firmware. Device-specific differences should be treated as implementation details of the same function:		The <code>bcmeter-dev</code> Raspberry Pi codebase powers '''bcMeter (DIY)''' builds, but it differs from the ESP32 firmware in the assembled instruments. Device-specific differences should be treated as implementation details of the same function:

	* '''Networking:''' Raspberry Pi builds may use Flask and NetworkManager, while ESP32 builds use the embedded web server and ESP-IDF WiFi stack.		* '''Networking:''' Raspberry Pi builds may use Flask and NetworkManager, while ESP32 builds use the embedded web server and ESP-IDF WiFi stack.
	* '''Optics/ADC:''' Pi builds may reference ADS8344E or MCP342X hardware; current ESP32 V2 builds use ADS1220-based optical acquisition.		* '''Optics/ADC:''' Pi builds may reference ADS8344E or MCP342X hardware; current ESP32 V2 builds use ADS1220-based optical acquisition.
	* '''Firmware updates:''' ~~Pi development devices~~ may update through OS/GitHub release workflows, while ESP32 devices use OTA firmware images.		* '''Firmware updates:''' bcMeter (DIY) builds may update through OS/GitHub release workflows, while ESP32 devices use OTA firmware images.
	* '''Sensors:''' ~~Development devices~~ may expose DS18B20 or other prototype sensors that are not present on every ESP32 unit.		* '''Sensors:''' bcMeter (DIY) builds may expose DS18B20 or other prototype sensors that are not present on every ESP32 unit.

API reference

Bcmwiki — Mon, 08 Jun 2026 10:35:02 GMT

Reframe: bcMeter (DIY) / source-available

← Older revision		Revision as of 10:35, 8 June 2026
Line 3:		Line 3:
	The bcMeter exposes a REST API on port 80. All endpoints are accessible without authentication when connected to the device network. CORS is enabled for all GET requests (<code>allow_origins=["*"]</code>).		The bcMeter exposes a REST API on port 80. All endpoints are accessible without authentication when connected to the device network. CORS is enabled for all GET requests (<code>allow_origins=["*"]</code>).

	The software is ~~open~~ source: [https://github.com/dahljo/bcmeter github.com/dahljo/bcmeter]		The software is source-available — freely available for private, educational and research use (CC BY-NC 4.0): [https://github.com/dahljo/bcmeter github.com/dahljo/bcmeter]

	=== Status & Diagnostics ===		=== Status & Diagnostics ===

Introduction

Bcmwiki — Mon, 08 Jun 2026 10:35:01 GMT

Reframe: bcMeter (DIY) / source-available

← Older revision		Revision as of 10:35, 8 June 2026
Line 1:		Line 1:
	== Introduction ==		== Introduction ==

	The '''bcMeter''' is ~~an open~~-~~source~~ optical absorption photometer designed to measure Black Carbon (BC) aerosols — commonly known as soot — in real-time. Whether you are monitoring ambient air quality in your neighborhood or measuring direct emissions from wood stoves, this device provides scientific-grade data at a fraction of the cost of reference instruments.		The '''bcMeter''' is a source-available optical absorption photometer designed to measure Black Carbon (BC) aerosols — commonly known as soot — in real-time. The design is freely available for private, educational and research use (CC BY-NC 4.0); assembled instruments are offered on request. Whether you are monitoring ambient air quality in your neighborhood or measuring direct emissions from wood stoves, this device provides scientific-grade data at a fraction of the cost of reference instruments.

	The device operates "headless" — it has no built-in screen. Instead, it hosts its own website that you can access from any smartphone or computer connected to the same network.		The device operates "headless" — it has no built-in screen. Instead, it hosts its own website that you can access from any smartphone or computer connected to the same network.

	The software is ~~open~~ source: [https://github.com/dahljo/bcmeter github.com/dahljo/bcmeter]		The software is source-available — freely available for private, educational and research use (CC BY-NC 4.0): [https://github.com/dahljo/bcmeter github.com/dahljo/bcmeter]

	=== Device Types ===		=== Device Types ===

	* '''bcMeter''' — ~~Portable optical absorption photometer~~ for ~~ambient Black Carbon measurement~~. ~~Designed~~ for ~~stationary or mobile deployment~~ in ~~monitoring networks~~, ~~citizen science projects, and field campaigns~~.		* '''bcMeter (DIY)''' — The source-available, self-build version. Runs on a Raspberry Pi using the open PCB design, freely available for private, educational and research use (CC BY-NC 4.0). Build your own from the open design files and the Wiki (nothing is sold).
	* '''eBcMeter''' — Emission measurement instrument for direct source sampling from wood-burning stoves and similar combustion sources. Uses microgram (µg) units instead of nanogram (ng).		* '''bcMeter Kit''' — Assembled-instrument PCB plus components for self-assembly and 3D printing. Available on request.
			* '''bcMeter Complete''' — Fully assembled, ready-to-use instrument on a compact platform that starts in seconds and updates over the air, with no microSD card or Linux system to maintain. Available on request.
			* '''eBcMeter''' — Emission measurement instrument for direct source sampling from wood-burning stoves and similar combustion sources. Uses microgram (µg) units instead of nanogram (ng). Available on request.

	=== How Does It Work? ===		=== How Does It Work? ===

Main Page

Bcmwiki — Mon, 08 Jun 2026 10:34:59 GMT

Reframe: bcMeter (DIY) / source-available

User:MikeEmbley4055

MikeEmbley4055 — Fri, 05 Jun 2026 07:43:30 GMT

User account MikeEmbley4055 was created

User:ByronSteffen202

ByronSteffen202 — Wed, 03 Jun 2026 05:11:06 GMT

User account ByronSteffen202 was created

← Older revision		Revision as of 10:34, 8 June 2026
Line 1:		Line 1:
	== Welcome to the [https://bcmeter.org bcmeter.org] Wiki ==		== Welcome to the [https://bcmeter.org bcmeter.org] Wiki ==

	The bcMeter wiki is the technical documentation hub for the bcMeter platform — an ~~open-source~~ optical absorption photometer for measuring Black Carbon (BC) aerosols in real-time.		The bcMeter wiki is the technical documentation hub for the bcMeter platform — an optical absorption photometer for measuring Black Carbon (BC) aerosols in real-time. The platform spans the source-available '''bcMeter (DIY)''' (build it yourself) and the ready-to-use '''bcMeter Kit, bcMeter Complete and eBcMeter''' instruments.

	Whether you are setting up a new device, configuring measurements, or building your own unit, this wiki covers everything you need.		Whether you are setting up a new device, configuring measurements, or building your own unit, this wiki covers everything you need.
Line 25:		Line 25:
	* [[Serial commands]] — USB debug interface		* [[Serial commands]] — USB debug interface

	== ~~Building a~~ bcMeter (~~V1 Legacy~~) ==		== bcMeter (DIY) — build it yourself ==

	''~~The following~~ pages document the bcMeter ~~V1 hardware~~. The ~~current V2 platform has~~ a different hardware design.''		''These pages document the source-available bcMeter (DIY) — the Raspberry-Pi-based design, freely available for private, educational and research use (CC BY-NC 4.0), built from open design files (nothing is sold). The assembled bcMeter Kit, Complete and eBcMeter use a different hardware design.''

	* [[Working principle]] — Optical measurement principle		* [[Working principle]] — Optical measurement principle
	* [[Bill of material]] — Component list and costs (V1)		* [[Bill of material]] — Component list and costs (bcMeter DIY)
	* [[Device assembly]] — Hardware build instructions (V1)		* [[Device assembly]] — Hardware build instructions (bcMeter DIY)

	== Software ==		== Software ==

	The bcMeter software is ~~open~~ source: '''[https://github.com/dahljo/bcmeter github.com/dahljo/bcmeter]'''		The bcMeter software is source-available — freely available for private, educational and research use (CC BY-NC 4.0): '''[https://github.com/dahljo/bcmeter github.com/dahljo/bcmeter]'''

	The codebase includes the web [[Interface\|interface]], [[API reference\|REST API]], measurement engine, and all device management functionality.		The codebase includes the web [[Interface\|interface]], [[API reference\|REST API]], measurement engine, and all device management functionality.