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))
(Update: V1/V2 naming, remove ESP32/Pi distinction)
 
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) ==
== Building a bcMeter (V1 Legacy) ==


''The following pages document the Raspberry Pi-based bcMeter V1. The current platform uses ESP32.''
''The following pages document the bcMeter V1 hardware. The current V2 platform has a different hardware design.''


* [[Working principle]] — Optical measurement principle
* [[Working principle]] — Optical measurement principle
Line 35: Line 35:
== Software ==
== Software ==


The bcMeter platform consists of two codebases:
The bcMeter software is open source: '''[https://github.com/dahljo/bcmeter github.com/dahljo/bcmeter]'''


* '''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 14: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

Technical Reference

Building a bcMeter (V1 Legacy)

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

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