Difference between revisions of "Main Page"

From bcmeter.org
Jump to navigation Jump to search
(Wiki update: sync with manual and dev docs (2026-03))
(Consistency pass: multi-wavelength in-development, bcmeter-pi link, anchor/Flask/V2 fixes, airflow & ATN clarifications)
 
(2 intermediate revisions by the same user not shown)
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 7: Line 7:
== Getting Started ==
== Getting Started ==


* [[Introduction]] — What is bcMeter, how it works, hardware variants
* [[Introduction]] — What is bcMeter, how it works, capabilities
* [[Setup]] — Hardware requirements, first boot, WiFi configuration
* [[Setup]] — Hardware requirements, first boot, WiFi configuration
* [[Interface]] — Web dashboard overview, status indicators, chart controls
* [[Interface]] — Web dashboard overview, status indicators, chart controls
Line 23: Line 23:
* [[API reference]] — REST API endpoints for automation and integration
* [[API reference]] — REST API endpoints for automation and integration
* [[CSV data format]] — Column definitions and data structure
* [[CSV data format]] — Column definitions and data structure
* [[Serial commands]] — USB debug interface (ESP32)
* [[Serial commands]] — USB debug interface


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


''The following pages document the Raspberry Pi-based bcMeter V1. The current platform uses ESP32.''
''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 platform consists of two codebases:
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]'''


* '''bcmeter-esp32''' — Production firmware (ESP32-S3). Closed source, CC BY-NC 4.0.
The codebase includes the web [[Interface|interface]], [[API reference|REST API]], measurement engine, and all device management functionality.
* '''[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 ==
== Contact ==

Latest revision as of 20:43, 8 June 2026

Welcome to the bcmeter.org Wiki

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.

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

Technical Reference

bcMeter (DIY) — build it yourself

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.

Software

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

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