BOARDOM - How To Guide

01

Arduino Setup & Wiring

Boardom monitors your home by reading sensor data from the Arduino MKR 1010 WiFi together with the MKR 1010 WiFi Shield. Each board should have the Boardom firmware flashed onto it.

🔌

Required Hardware

Arduino MKR 1010 WiFi
MKR 1010 WiFi Shield (includes BME688 and APDS9960)
BME688 sensor — Temperature, Humidity & Pressure (on-shield)
APDS9960 sensor — Light level (on-shield)
ST0160 sensor — Soil Moisture (external, optional)

Flashing the Firmware

Download the Boardom Arduino sketch from the project repository.
Open the sketch in Arduino IDE (version 2.x recommended).
Install the Arduino SAMD Boards package via Tools → Board → Boards Manager if you haven't already.
Fill in your WiFi SSID, password, and the Boardom API URL in the config section at the top of the sketch.
Select Tools → Board → Arduino SAMD Boards → Arduino MKR WiFi 1010, select the correct port, then click Upload.
Open the Serial Monitor at 115200 baud to confirm the device connects to WiFi and begins sending data.

02

Connecting Arduino to Boardom

Once your Arduino is wired and flashed, adding it to your Boardom account is a quick two-step process.

1

Power on the Arduino and press 04 on the shield

When the Arduino boots and connects to WiFi, the shield will show a disconnected screen. Press 04 on the shield to send a connect signal to the Boardom server with its unique Device ID. The server holds this ID and waits for you to name it.

↓

2

Open the Dashboard and click +

Navigate to the Dashboard, then click the blue + floating button in the bottom-right corner. Choose Add device from the menu.

↓

3

Wait for the device ID to appear

The modal will show "Waiting for device..." and then automatically display the Device ID once the Arduino has connected. This is real-time — no refresh needed.

↓

4

Give it a friendly name and click Add

Type a descriptive name (e.g. "Living Room" or "Bathroom") and click Add. The device is now registered under your account and will start showing sensor data on the dashboard.

⚠️

Note: Only one device can be pending at a time. If you want to add multiple Arduinos, add them one at a time — power on, add, then power on the next one.

03

Dashboard Overview

The dashboard is your home base. It shows the current status and latest sensor readings for all your devices.

Stats Bar

●

Active Devices in Groups

How many of your devices that are assigned to a group are currently online (sent data in the last 4 minutes).

●

Device Groups

The number of groups you have created. Groups let you organise devices by room, floor, or any category you like.

●

Average Temperature

The mean temperature reading across all your registered devices with available data.

Device Cards

Each device appears as a card inside its group. The card shows:

Device name The friendly name you gave it when connecting.

● Online / ● Offline Green = connected and sending data within the last 4 minutes. Red = no recent signal.

💡 Light Ambient light level, measured in lux (lx).

🌡️ Temperature Room temperature in degrees Celsius (°C).

💧 Humidity Relative air humidity as a percentage (%).

🔵 Pressure Atmospheric pressure in kilopascals (kPa).

💡

Tip: Sensor values appear greyed out when a device is offline. Data shown is always the last known reading.

04

Managing Devices & Groups

The floating + button on the dashboard gives you access to all device and group management tools.

FAB Menu Options

+

Add device

Register a new Arduino that has just connected to the network. See Section 2 for the full flow.

✎

Edit devices

Rename any registered device or permanently delete it from your account. Deleting a device also removes all its historical sensor data.

⊟

Edit groups

Create new groups, rename existing ones, add/remove devices from groups, or delete groups entirely. A device can belong to multiple groups.

💡

Tip: If you remove a device from a group it is not deleted — it still exists in your account and can be added to a different group at any time.

Devices Page

The Devices page (sidebar → Devices) gives you a quick overview of all registered devices and their current online/offline status, with a count summary at the top. This is a read-only view — use the dashboard's FAB menu to make changes.

05

Analytics & Charts

The Analytics page lets you explore historical sensor data for any device or group across any date range.

1

Choose Device or Group

When you open Analytics, a selector modal appears. Switch between the Device and Group tabs, then click the item you want to analyse. Selecting a group plots all devices in that group on the same chart.

↓

2

Set the data type and date range

Use the controls at the top of the chart to choose what to plot — Temperature, Humidity, Light, or Pressure. Then pick a Start Date and End Date.

↓

3

Adjust the thinning factor (optional)

If there is a lot of data, increase the Thinning Factor to reduce the number of plotted points for a smoother chart. Lower values show more raw detail.

↓

4

Read the stats

Below the chart you will see the Maximum, Minimum, and Average values for the selected period, making it easy to spot trends and anomalies.

💡

Tip: When a group is selected, each device gets its own coloured line on the chart so you can compare rooms side by side.

How To Use BOARDOM