Difference between revisions of "Main Page"

Revision as of 15:10, 8 March 2026

Welcome to the 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.

Whether you are setting up a new device, configuring measurements, or building your own unit, this wiki covers everything you need.

Getting Started

Introduction — What is bcMeter, how it works, hardware variants
Setup — Hardware requirements, first boot, WiFi configuration
Interface — Web dashboard overview, status indicators, chart controls

Using bcMeter

Configuration — All settings: network, measurement, device, email
Maintenance — Filter changes, calibration, data management
Troubleshooting — Common issues and solutions
Best practices — Environment, sampling, signal quality

Technical Reference

Developer mode — Hidden developer settings, hardware tuning
API reference — REST API endpoints for automation and integration
CSV data format — Column definitions and data structure
Serial commands — USB debug interface (ESP32)

Building a bcMeter (V1 Legacy)

The following pages document the Raspberry Pi-based bcMeter V1. The current platform uses ESP32.

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

Software

The bcMeter platform consists of two codebases:

bcmeter-esp32 — Production firmware (ESP32-S3). Closed source, CC BY-NC 4.0.
bcmeter-dev — Open-source reference implementation (Python/FastAPI). Functionally equivalent, runs on Raspberry Pi or any Linux system.

Both share the same web interface and REST API.

Contact

Technical inquiries & devices: Jonas Dahl — jd@bcmeter.org
Black carbon science & air quality: Axel Friedrich — af@bcmeter.org
Project website: bcmeter.org

@@ 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 serves as a technical documentation hub for the bcMeter device, covering assembly instructions, software configuration, troubleshooting, and general information. It provides resources for users to understand the working principles, gather necessary components, assemble the device, configure the software/WiFi, and download data.
-== How to build the device? ==
+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.
-Over the last years we decided to provide you with pre-populated PCBs as there were too many caveats for many people to assemble and solder them.
-* [[working principle|Working principle of the bcMeter]]
-* [[Bill_of_material|Parts of bcMeter / Bill of material]]
-* [[Device assembly|Assembly of the bcMeter]]
-== How to configure the software/wifi? ==
+Whether you are setting up a new device, configuring measurements, or building your own unit, this wiki covers everything you need.
-* [[Installation|Configuration of the Wifi and Software of bcMeter]]
-* [[interface|Download and archive the data]]
-== What else? ==
+== Getting Started ==
-* [[troubleshooting|Troubleshooting]]
-* [[caveats|The fine print]]
-== Questions about the bcMeter? ==
+* [[Introduction]] — What is bcMeter, how it works, hardware variants
-=== Check [http://www.bcmeter.org www.bcmeter.org] for an overview of resources ===
+* [[Setup]] — Hardware requirements, first boot, WiFi configuration
+* [[Interface]] — Web dashboard overview, status indicators, chart controls
-=== Direct contact ===
+== Using bcMeter ==
-* For '''technical inquiries, orders and about the bcMeter itself''', contact Jonas: jd@bcmeter.org
-* For '''idea behind the bcMeter''', contact Axel: af@bcmeter.org
-== You want to contribute to the wiki? ==
+* [[Configuration]] — All settings: network, measurement, device, email
-Awesome! Due to spam you cannot create/edit posts by default, so please just register here and let me know at jd@bcmeter.org and you'll get all necessary rights.
+* [[Maintenance]] — Filter changes, calibration, data management
+* [[Troubleshooting]] — Common issues and solutions
+* [[Best practices]] — Environment, sampling, signal quality
+== Technical Reference ==
+* [[Developer mode]] — Hidden developer settings, hardware tuning
+* [[API reference]] — REST API endpoints for automation and integration
+* [[CSV data format]] — Column definitions and data structure
+* [[Serial commands]] — USB debug interface (ESP32)
+== Building a bcMeter (V1 Legacy) ==
+''The following pages document the Raspberry Pi-based bcMeter V1. The current platform uses ESP32.''
+* [[Working principle]] — Optical measurement principle
+* [[Bill of material]] — Component list and costs (V1)
+* [[Device assembly]] — Hardware build instructions (V1)
+== Software ==
+The bcMeter platform consists of two codebases:
+* '''bcmeter-esp32''' — Production firmware (ESP32-S3). Closed source, CC BY-NC 4.0.
+* '''[https://github.com/dahljo/bcmeter-dev bcmeter-dev]''' — Open-source reference implementation (Python/FastAPI). Functionally equivalent, runs on Raspberry Pi or any Linux system.
+Both share the same [[Interface|web interface]] and [[API reference|REST API]].
+== Contact ==
+* '''Technical inquiries & devices:''' Jonas Dahl — jd@bcmeter.org
+* '''Black carbon science & air quality:''' Axel Friedrich — af@bcmeter.org
+* '''Project website:''' [https://bcmeter.org bcmeter.org]