Learning Goals 5 min
Yesterday your Property values were just numbers in the Things tab. Today you bind them to visual widgets — gauges, charts, switches, value cards — for a dashboard you can show anyone. By the end of this lesson you will be able to:
- Add 4+ widget types to a dashboard: Switch, Gauge, Chart, Value, and bind each to a Property.
- Resize and arrange widgets so the dashboard looks polished on phone and desktop.
- Use the Arduino IoT Remote phone app to view and control the dashboard on the go.
Warm-Up 10 min
From yesterday: DeskMonitor with potValue, ledOn, uptime properties. Confirm they're still updating.
Widget types overview
| Widget | Best for | Property type |
|---|---|---|
| Switch | Boolean toggle | bool |
| Push button | Momentary action (e.g. "water now") | bool |
| Gauge | Single value as an arc | int / float |
| Chart | Historical trend | int / float |
| Value | Big number readout | any |
| LED | Boolean as a coloured circle | bool |
| Slider | Set a numeric value | int / float, READWRITE |
| Colour picker | RGB selection | CloudColor |
| Map | GPS coordinates | CloudLocation |
| Messenger | Text log between sketch and dashboard | String |
New Concept · Building a dashboard 25 min
Step 1 — Dashboards tab
In IoT Cloud → Dashboards → Build Dashboard. Name it "DeskMonitor".
Step 2 — Add widgets
Click "Add" → pick a widget type. For each:
- Click "Link Variables" → pick the Thing → pick the property.
- Set widget name (shown above the widget).
- Customise: min/max range, colours, units.
- Save.
Step 3 — Layout
The dashboard uses a grid. Drag widgets to reposition; drag corner to resize. The layout adapts on phone (single column) automatically.
Suggested layout for DeskMonitor
- Top: big Value widget showing
potValueas "Knob position". - Top right: Switch widget for
ledOn, labelled "Desk LED". - Middle: Gauge widget for
potValue(0–1023), mirrors the Value but visually. - Bottom: Chart widget showing the last hour of
potValue. - Footer: Value widget showing
uptime.
Sharing the view
Click Dashboards → your dashboard → Share. Three options:
- Direct sharing: invite another Arduino Cloud user by email. They can view (or edit if you grant).
- Public link: anyone with the link sees the dashboard (read-only). For demos or live status pages.
- Phone app: install Arduino IoT Remote (free, iOS + Android). All your dashboards appear automatically.
Arduino IoT Remote app
- Install from App Store / Play Store.
- Sign in with the same Arduino account.
- Your dashboards appear in a list.
- Tap one — same widgets, optimised for touch.
Any widget toggle on the phone immediately updates the cloud → updates your device. Bidirectional sync just works.
Worked Example · Polish the DeskMonitor dashboard 25 min
Step 1 — add a Switch for ledOn
- Add → Switch → pick DeskMonitor → ledOn.
- Name it "Desk LED".
- Test: toggle in the dashboard, watch your physical LED.
Step 2 — add a Gauge for potValue
- Add → Gauge → potValue.
- Set min = 0, max = 1023.
- Test: turn the pot, gauge animates.
Step 3 — add a Chart
- Add → Chart → potValue.
- Default 1-hour window.
- Live values populate the right edge as they come in.
Step 4 — arrange + resize
Drag widgets so the "at-a-glance" (Switch + Gauge) is at top, the "detail" (Chart) below. Resize the Chart to take full width.
Step 5 — phone-app test
Install Arduino IoT Remote. Open your dashboard. Toggle the LED from your phone — the physical LED responds. Take a phone screenshot — that's your "commercial smart device" demo.
Step 6 — share publicly
Click Share → Public link. Copy and paste in your browser's incognito mode. The dashboard loads without login — view-only. Useful for showing a parent or classmate without making them sign up.
Basic 5 min
Goal: Add an LED widget bound to the same ledOn property. Now you have both a Switch (control) and an LED indicator (visual). Useful for "ON/OFF at a glance".
Challenge 1 5 min
Goal: Add a Slider bound to a new int property ledBrightness (0..255, READWRITE). On the device, use it to analogWrite a PWM-capable LED pin. Phone slider = real LED dimmer.
1. Think first (on paper, no typing yet):
- When the slider moves, which function in your sketch will the cloud call? Write its name.
- Which pins on your board can dim an LED?
- The slider sends 0–255. Does the number need changing before it reaches the pin?
2. Code it. Add the Property on the Thing's page, wire an LED with 220 Ω to a PWM pin, and fill in the new callback in your DeskMonitor sketch. Then add the Slider widget (min 0, max 255).
3. Upload and observe. Drag the slider slowly from 0 to 255 on the computer, then on the phone app.
It works if: the LED is off at 0, fully bright at 255 and dims smoothly in between, from both the computer and the phone.
Challenge 2 5 min
Goal: Add a Messenger widget bound to a String property. Use it as a two-way text log: dashboard sends "hello"; sketch responds "hello back at <time>".
The Messenger widget should end up looking like this:
hello hello back at 125 s
1. Think first (on paper, no typing yet):
- Which permission must the String Property have, if both the dashboard and the sketch write to it?
- Which function runs when a new message arrives? How can it check that the message is exactly
hello? - Where can the sketch get a "time" from? Seconds since power-on is fine.
2. Code it. Add the String Property and the Messenger widget. Then fill in the new callback in your DeskMonitor sketch.
3. Upload and observe. Type hello in the Messenger. Then type something else, like hi.
It works if: hello gets one reply with a time in seconds, the time goes up each time you try, and any other message gets no reply.
Challenge 3 · The gauge that hits the end too soon 10 min
A classmate moved DeskMonitor to a Nano ESP32. Their Gauge is bound to potValue, with min 0 and max 1023. Now the needle hits the end when the knob is only a quarter turned. The Chart shows values up to 4095.
- Explain the cause with one number.
- Fix it in the sketch, so the old Gauge works again.
- Then add a new int Property
knobPct(READ, 0–100). Fill it withmap()and bind a second Gauge to it, range 0–100.
It works if both Gauges move smoothly from end to end as you turn the knob once.
Recap 5 min
Dashboards bind widgets to Properties. ~10 widget types cover most needs. Layout adapts to phone automatically. Public links + phone app cover all sharing patterns. Free tier: 1 dashboard, lots of widgets in it. Tomorrow: turn the LED into a real cloud-controlled output that anyone with the share link can drive.
- Widget
- A visual element on a dashboard (Switch, Gauge, Chart, Value). Bound to a Property.
- Binding
- Connecting a widget to a Property. Bidirectional for READWRITE widgets.
- Grid layout
- The 12-column grid the dashboard uses. Widgets snap to grid; auto-collapses to single column on phone.
- Share link / public dashboard
- Read-only URL anyone can open. Doesn't require an Arduino account on their side.
- Arduino IoT Remote
- Free phone app showing all your dashboards. Touch-optimised.
- Chart history
- Auto-stored time-series data for any non-bool Property. Tier-limited retention.
Extra Mission 5 min
Part 1 — Design a dashboard someone else will use
Pick a person who would use a dashboard, such as a parent, a coach or a gardener. Design one phone screen for them on paper.
Your design must include:
- Who it is for and the one question it answers at a glance.
- Every widget, with the Property it is bound to and its min/max.
- Which widgets go at the top, and why.
- One widget that controls something, and one that only shows.
Part 2 — Make it
Build your dashboard for DeskMonitor or a new Thing, with real widgets bound to real Properties. Open it in the Arduino IoT Remote app. Toggle a control from another room to prove it works over WiFi alone.
Bring back next class: screenshots of the dashboard on a computer and on a phone, plus the uploaded sketch.