Horizontal sulfur dioxide (SO2) card
Who it’s for
Environmental health officers, air quality managers, and industrial site managers ask “what is the SO₂ level at this station right now?” They need a compact, space-efficient card that fits into multi-station overview dashboards without dominating the layout.
What it does
A sensor reporting sulfur = 65 µg/m³ displays the reading in a horizontal card whose label and value sit side by side, color-coded by severity: green for Good (0–100 µg/m³), light green for Moderate (100–200 µg/m³), orange for Elevated (200–350 µg/m³), dark orange for High (350–500 µg/m³), and red for Hazardous (above 500 µg/m³).
- Horizontal layout fits more stations per row on a multi-station air quality dashboard
- Live SO₂ reading in µg/m³ with automatic color coding across five severity bands
- Shows one sensor’s reading per widget; tile multiple widgets to monitor all stations at a glance
How to set up
Data keys
| Key | Role | Type | Description |
|---|---|---|---|
sulfur | Main value | Timeseries | Sulfur dioxide concentration in µg/m³; change the key name to match your device’s telemetry key |
The widget ships with a simulated function datasource key labeled Sulfur dioxide, so it draws random values until you point the datasource at a device and rename the key.
To point it at your own device: open the dashboard in edit mode, open the widget’s Datasources, pick the entity or entity alias, and replace the function key with the key your device reports.
Value ranges
| Range (µg/m³) | Level | Color |
|---|---|---|
| 0–100 | Good | Green |
| 100–200 | Moderate | Light Green |
| 200–350 | Elevated | Orange |
| 350–500 | High | Dark Orange |
| 500+ | Hazardous | Red |
How to customize
- To change the severity thresholds — edit Icon color ranges and Value color ranges; set the same boundaries in both so the icon and the number always agree.
- To change the band colors — edit the color of each range in Icon color ranges and Value color ranges.
- To rename the units label — change the Units field in the widget settings if your sensor reports in ppm.
Tips
- Use the horizontal layout to fit more monitoring stations per row when building a city-wide or industrial-zone overview; pair with the standard card for stations in high-priority areas where a larger display is warranted.
- SO₂ is a direct marker of combustion emissions; placing horizontal cards for SO₂, NO₂, and CO side by side on the same row makes it easy to confirm that all three combustion-related pollutants are responding to the same source event.
- For regulatory reporting, archive hourly averages from each station; most national frameworks specify compliance limits in terms of 1-hour mean concentrations.
Share Your Widget with the Community
Built a custom widget? Export it as a JSON from ThingsBoard and publish it to the IoT Hub through a simple 4-step wizard (Upload, Listing, Readme, Review & Submit). Share it with thousands of ThingsBoard developers worldwide and get featured in the catalog.