Difference between revisions of "Main Page"

Latest revision as of 15:21, 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, capabilities
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

Building a bcMeter (V1 Legacy)

The following pages document the bcMeter V1 hardware. The current V2 platform has a different hardware design.

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

Software

The bcMeter software is open source: github.com/dahljo/bcmeter

The codebase includes the web interface, REST API, measurement engine, and all device management functionality.

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, capabilities
-=== 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
+== Building a bcMeter (V1 Legacy) ==
+''The following pages document the bcMeter V1 hardware. The current V2 platform has a different hardware design.''
+* [[Working principle]] — Optical measurement principle
+* [[Bill of material]] — Component list and costs (V1)
+* [[Device assembly]] — Hardware build instructions (V1)
+== Software ==
+The bcMeter software is open source: '''[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.
+== 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]