Wind speed and direction with background
Who it’s for
Outdoor event organizers, wind energy operators, and smart farming teams ask “how strong is the wind and which way is it blowing right now?” They use this card on field station or control room screens where a background image gives the widget a polished look.
What it does
A sensor reading 12.5 m/s from the southwest shows a deep blue speed value — Fresh — alongside a directional arrow pointing southwest on a compass rose, displayed over the preset background image.
- Color-coded wind speed value across seven Beaufort-inspired bands from Calm to Storm
- Compass rose with directional arrow rotating to the bearing reported by the wind direction sensor
- Decorative background image bundled with the widget, with a white overlay that keeps the text readable
- Last-updated timestamp showing how long ago the reading arrived
- Shows one sensor pair’s data; it does not chart trends or compare multiple stations
How to set up
Data keys
| Key | Role | Type | Description |
|---|---|---|---|
direction | Direction | Timeseries | Wind bearing in degrees (0–360, meteorological convention: the direction FROM which the wind blows); change the key name to match your device’s telemetry key |
speed | Speed | Timeseries | Wind speed (m/s); change the key name to match your device’s telemetry key |
The widget ships with simulated function datasource keys labeled Wind Direction and Wind Speed, so it draws random values until you point the datasource at a device and rename the keys.
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.
If either key has never reported, the compass arrow is absent or the speed value is empty.
Value ranges
| Range (m/s) | Level | Color |
|---|---|---|
| 0–0.2 | Calm | Light Blue |
| 0.2–3.4 | Light | Blue |
| 3.4–8 | Gentle | Blue |
| 8–10.8 | Moderate | Dark Blue |
| 10.8–17.2 | Fresh | Deep Blue |
| 17.2–24.5 | Strong | Red |
| 24.5+ | Storm | Dark Red |
How to customize
- To swap the background image — open the widget settings and set Background to a different image or switch to a solid color.
- To adjust how much the background shows through — change the Overlay opacity; lower values reveal more of the image, higher values push it further back.
- To use your own wind speed thresholds — edit the color ranges on the speed data key; adjust the seven default bands to match your operational or safety thresholds.
- To hide the timestamp — turn off Show date.
- To match your dashboard’s fonts — set the font options under the speed data key’s appearance settings.
Tips
- Wind direction follows meteorological convention: 0° / 360° means the wind is blowing FROM the north (toward the south), 90° FROM the east, 270° FROM the west. The arrow on the compass points in the direction the wind is coming from.
- The seven speed bands align broadly with the Beaufort wind scale; Strong (≥ 17.2 m/s, Beaufort 7) is the common threshold for halting outdoor crane operations, and Storm (≥ 24.5 m/s, Beaufort 10) triggers structural-risk alerts for tall cranes and masts.
- If the background image reduces contrast, raise the Overlay opacity to keep the text readable from a distance.
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.