Complete Setup Guide

From hardware assembly to data visualization in four steps

Prerequisites

Before You Begin

Make sure you have created an account on the platform before starting the hardware setup process.

ParticularMatter Account

Create a free account at dashboard.particularmatter.org

USB Cable & Computer

Micro-USB cable and a computer with a modern web browser (Chrome, Edge, or Opera with WebUSB support)

WiFi Network

2.4 GHz WiFi network (ESP8266 does not support 5 GHz networks)

Basic Tools (for hardware assembly)

Soldering iron (optional), screwdrivers, wire strippers (if assembling from scratch)

1. Hardware Assembly

Build your own air quality sensor or purchase a pre-assembled unit. The total cost for DIY components is approximately €30-45.

Shopping List

Component Description Est. Cost
ESP8266 or ESP32 Microcontroller board (e.g., NodeMCU, Wemos D1 Mini) €5-9
Plantower PMS5003 Particulate matter sensor (PM1.0, PM2.5, PM10) €14-18
BME280 Temperature, humidity, and pressure sensor €4-7
SenseAir S8 (Optional) CO₂ sensor (coming soon in firmware) €23-32
USB Power Supply 5V USB power adapter and cable €4-9
3D Printed Enclosure Download STL files and print locally or order online €4-14

3D Printed Enclosure

Download the STL files for the 3D-printable enclosure:

Download 3D Models

Assembly Instructions

1

Connect the BME280 sensor to the ESP8266

Wire VCC to 3.3V, GND to GND, SCL to D1, SDA to D2 (I2C pins)

2

Connect the PMS5003 sensor

Wire VCC to 5V, GND to GND, TX to D6, RX to D5 (UART pins)

3

Place components in the 3D printed enclosure

Ensure proper airflow for the PM sensor and avoid blocking sensor vents

4

Secure all connections and close the enclosure

Use screws or clips to secure the enclosure lid

Important Notes

  • • Double-check all wiring before powering on to avoid damaging components
  • • ESP8266 requires a stable 5V/1A power supply for reliable operation
  • • The PMS5003 sensor needs proper ventilation - do not block air intake/exhaust

2. Firmware Installation

Install the pre-built firmware using your web browser. No software installation required - the process uses WebUSB technology supported by Chrome, Edge, and Opera browsers.

Step-by-Step Instructions

1

Download Firmware

Download the latest firmware from the GitHub repository:

Download firmware.bin
2

Open ESPHome Web

Navigate to the ESPHome Web flasher tool:

Open web.esphome.io
3

Connect Device

Connect your ESP8266 to your computer via USB cable and click "CONNECT" in the web interface.

Select your device from the popup dialog (usually shows as "USB Serial" or "CP210x")

4

Install Firmware

Click "INSTALL" and select the firmware.bin file you downloaded in step 1.

The flashing process takes approximately 1-2 minutes. Do not disconnect during this process.

5

Verify Installation

Once complete, the device will restart. You should see a new WiFi network appear with the name:

ParticularMatterDevice-Setup

Browser Compatibility

This method requires a browser with WebUSB support (Chrome, Edge, Opera). If you're using Firefox or Safari, please switch to a compatible browser for firmware installation.

3. Device Registration

Configure your device to connect to your WiFi network and register it with the ParticularMatter platform.

WiFi Configuration

1

Connect to Device WiFi

On your phone or computer, connect to the WiFi network created by the device:

Network Name (SSID):

ParticularMatterDevice-Setup

Password:

particularmatter
2

Access Configuration Portal

Your device should automatically open a captive portal. If not, navigate to:

http://192.168.4.1
3

Enter Configuration

Fill in the configuration form with the following information:

  • WiFi SSID: Your home/office WiFi network name
  • WiFi Password: Your network password
  • User Email: Your ParticularMatter account email
  • Device Name: A friendly name for your sensor (e.g., "Living Room")
  • One-Time Key: Generate this in your dashboard (see next step)
4

Generate One-Time Key

Log in to your dashboard and generate a registration code:

  1. Go to dashboard.particularmatter.org
  2. Navigate to "Locations" → Select or create a location
  3. Click "Add Node" and then "Get Registration Code"
  4. Copy the generated code (valid for 24 hours)

Note: Each registration code can only be used once and expires after 24 hours.

5

Complete Registration

Click "Save" to save the configuration. The device will:

  • 1. Connect to your WiFi network
  • 2. Register itself with the ParticularMatter platform
  • 3. Start sending measurements to your dashboard

Registration Successful!

Once registered, you should see "Registered ✓" on the device configuration page. Your sensor will appear in your dashboard within 1-2 minutes and begin reporting data.

4. Dashboard Configuration

Once your device is registered, you can manage it through the web dashboard.

View Real-Time Data

Navigate to your location page to see live sensor readings displayed on interactive charts.

Open Dashboard →

Configure Sensors

Each node can have multiple sensors attached. Configure sensor types, calibration values, and display settings.

Historical Data

View historical data with customizable time ranges (1 hour to 1 year). Download data as CSV for offline analysis.

Map View

See all your sensors on an interactive map. Mark locations as public to share data with the community.

Troubleshooting

Device Not Appearing in WiFi List

  • Wait 1-2 minutes after powering on for the access point to start
  • Ensure the device is powered with a stable 5V power supply
  • Try resetting the device by unplugging and replugging power
  • Check that firmware was installed correctly (see firmware section)

Registration Fails

  • Verify the one-time key was copied correctly (no extra spaces)
  • Check that the email matches your account email exactly
  • Ensure the registration code hasn't expired (24-hour validity)
  • Confirm the device has internet connectivity (try pinging google.com)

No Data Appearing in Dashboard

  • Wait 2-3 minutes after registration for first data to appear
  • Check device logs in the configuration portal for errors
  • Verify sensors are properly connected (check wiring)
  • Ensure device has stable WiFi connection (check signal strength)

WiFi Connection Drops Frequently

  • Ensure you're using a 2.4 GHz network (ESP8266 doesn't support 5 GHz)
  • Move the device closer to your WiFi router
  • Check for WiFi interference from other devices
  • Consider using a WiFi repeater or mesh network

Sensor Readings Seem Incorrect

  • Allow 24-48 hours for sensors to stabilize after first power-on
  • Ensure proper airflow around the PM sensor (not blocked)
  • Check sensor calibration values in dashboard settings
  • Compare with nearby reference stations for validation

Need Help?

If you're still experiencing issues:

You're All Set!

Your sensor is now monitoring air quality and sending data to your dashboard

View Your Dashboard