Difference between revisions of "Main Page"

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

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

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.

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

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

@@ Line 1: / Line 1: @@
-Basic Requirements:
+== Welcome to the [https://bcmeter.org bcmeter.org] Wiki ==
-Solder Iron / Solder / Flux / 3D Printer
-d Print – STL Files are attached
+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.
-A: Upper Case
-B: Lower Case
-C: Intake manifold
-D: LED/Sensor holder
-Order (links for convenience, parts are off-the-shelf / available in any regular workshop)
+Whether you are setting up a new device, configuring measurements, or building your own unit, this wiki covers everything you need.
-F:	PCB from pcbway.com, jlcpcb.com  or anywhere else (~$20) – find gerber files for upload attached
-G:	Components from mouser.com or anywhere else  (~$40) – shopping cart to import on mouser attached.
+== Getting Started ==
-H:	Order filter papers (~$50) – Pack of 50 sufficient for at least 1000 samples. Type TBD, tested with T60A20 – ask local labs for availability
-I:	Additional material:
+* [[Introduction]] — What is bcMeter, how it works, capabilities
-Hot Glue ~$7
+* [[Setup]] — Hardware requirements, first boot, WiFi configuration
-Rubber band (SHORE A) for sealing ~$11
+* [[Interface]] — Web dashboard overview, status indicators, chart controls
-M3 Screws ~$3
-M3 threads ~$7
+== Using bcMeter ==
-microSD Card (4gb+)
-Pin Header (optional for plug the Hat)
+* [[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
+== 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.''
+* [[Working principle]] — Optical measurement principle
+* [[Bill of material]] — Component list and costs (bcMeter DIY)
+* [[Device assembly]] — Hardware build instructions (bcMeter DIY)
+== 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-pi github.com/dahljo/bcmeter-pi]'''
+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]