Help Center

Guides and answers for connecting devices, building dashboards, and automating your IoT stack with Synacl.

Getting started

What is Synacl?
A quick tour of the platform — devices, gateways, dashboards, rules, and alerts.
Quickstart: from signup to a live IoT dashboard in five steps
Create an account, connect an ESP32 gateway or an MQTT device, see live data on a dashboard and get your first threshold alert.
IoT platform glossary: devices, gateways, tags, telemetry, events and alerts
The vocabulary Synacl uses: device, gateway, tag (parameter), telemetry, event, alert, tenant and plan, and how the pieces fit to…
Setting up your account securely
Verify email, add a passkey or 2FA, and set your profile.
Set up an ESP32 IoT gateway: flash it, join Wi-Fi, come online
Flash the gateway firmware onto an ESP32 from your browser, provision Wi-Fi, and bridge RS485/Modbus and GPIO sensors to the clou…
Add a Modbus, MQTT, GPIO or webhook device to your IoT dashboard
Register a device and pick the right protocol for how it connects: mqtt-direct, RS485/Modbus, GPIO, I²C, SPI, 1-Wire, UART, HTTP…
Try Synacl without hardware: add a simulated device
No ESP32 or sensor yet? Add a simulated sensor that publishes live temperature, humidity and light readings for an hour, so you c…
The Synacl mobile app
What you can do from the iPhone and Android app — alerts, dashboards, monitors, rules and remote gateway checks — and how to get…
Cold-chain temperature monitoring with ESP32 probes and threshold alerts
Put a temperature probe on an ESP32 gateway in each freezer, chart every unit, and get an email or webhook alert before stock spo…
Energy meter monitoring over Modbus RTU: kWh, power and overload alerts
Wire RS485 energy meters to a gateway, map voltage, current and kWh registers to tags, chart consumption and alert on overloads.

Devices

Devices vs. gateways
When you need a gateway, and when a device can talk to us directly.
Device parameters (tags) explained
Tags are the named measurements a device reports — what widgets bind to.
How device online/offline status works
A device is online if we've heard from it within its expected reporting window.
Alert thresholds (and the yellow dot)
Set an alarm limit on a tag — above, below, outside a range or beyond ± — with an optional Watch value; the device dot turns yell…
Normal, Watch and Alert — cloud alarms for every reading
Give a tag an alarm limit and an optional Watch value. Synacl grades every reading Normal, Watch or Alert — in the cloud or on th…
Why a device gets suspended
Repeated rate-limit violations suspend a device temporarily — here's the cycle.
Editing, moving, and deleting a device
Change a device's name, connection settings, gateway, or remove it.
Pause a device's reads & change its read interval
Temporarily stop polling a device (3 modes) or change how often it's read — no re-provisioning.
Add & control actuators (relays, dimmers, servos, motors)
Add an actuator as a device and control it — on/off, level %, position °, move, or speed — from the device page, a dashboard, or…
Adding many devices at once
Register a whole fleet in one go — configure one device, then generate copies with auto-numbered names and Modbus IDs.
On/Off actuators — relays, valves, pumps & switching loads
Switch a load on or off — relays, solid-state relays, contactors, solenoids, valves, pumps, heaters, fans, lights and buzzers — f…
Level actuators — dimmers & variable-speed (PWM)
Drive a 0–100% output — LED dimmers, dimmable lamps, variable-speed fans and motors, proportional heaters and generic PWM — from…
Position actuators — servos, motorized valves & dampers
Set an angle (0–180°) for servo-driven hardware — hobby/industrial servos, motorized ball valves, HVAC dampers and linear actuato…
Move actuators — stepper motors & linear stages
Step a motor a number of units forward or reverse — stepper motors and stepper-driven linear stages / camera sliders. Each press…
Speed actuators — DC motors & conveyors (H-bridge)
Drive a bidirectional DC motor by speed and direction (−100…100%) through an H-bridge — DC motors and conveyor/belt drives. Needs…
Add a device from the catalog
Start from a known meter or sensor — the catalog fills in the protocol, connection settings and the full register/tag map for you.
Connect an RS485 / Modbus RTU device
Wire a Modbus RTU sensor to a gateway and map its registers.
Connect a Modbus TCP device
Poll a Modbus TCP slave over the LAN by IP and port.
Connect a direct MQTT device
Publish straight to our broker with per-device credentials — the topics and the exact JSON payloads the platform accepts.
Connect an HTTP-polled device
Pull JSON from a device or API endpoint on a schedule.
Connect an SNMP device
Poll network gear (UPS, switches, PDUs) over SNMP.
Send device data over an HTTPS webhook
Push telemetry to Synacl over HTTPS as an alternative to MQTT — with a per-device secret.
Connect a host-metrics device (software gateway)
Monitor the CPU temperature and load, memory, disk, uptime and network throughput of the machine synacl-gateway runs on, as an or…
Bridge a device from your local MQTT broker (software gateway)
Subscribe to topics on a broker you already have — Tasmota, zigbee2mqtt, Home Assistant, a PLC — and map a field of each payload…
Connect GPIO devices (digital & analog)
Read or drive a gateway's pins — digital in/out, analog (ADC), and PWM.
Connect a 1-Wire device
Read DS18B20-style 1-Wire sensors from a gateway pin.
Connect a CAN bus device
Read CAN bus frames (automotive/industrial) via a gateway.
Connect an M-Bus device
Read M-Bus utility meters (heat, water, gas) through a gateway.
Drive a relay or output with GPIO
Control a gateway output pin and toggle it from a dashboard.
Connect an I²C device
Read I²C sensors from a gateway's I²C bus — built-in drivers for BME280, BMP280, SHT31 and ADS1115, or any chip with a datasheet…
Connect an SPI device
Read an SPI sensor/ADC from a gateway using MOSI/MISO/SCLK/CS.
Connect a UART / serial device
Read a serial (UART) sensor or module via a gateway's TX/RX.
Read an analog sensor (ADC)
Read a 0–3.3 V analog signal on a gateway ADC pin and scale it.

Gateways

Gateways overview
What a gateway does, the supported types, and its lifecycle.
Flash an ESP32 from your browser
Flash the Synacl gateway firmware, or any .bin, from Chrome or Edge over Web Serial — in the app or at synacl.com/flash, no accou…
Connect your own gateway (software gateway)
Register a gateway that is not an ESP32 — a Raspberry Pi, a PC, a container — run the open-source reference gateway on it in one…
Provision a gateway's Wi-Fi
Give a freshly flashed gateway network credentials so it comes online.
Update gateway firmware (OTA)
Push a new firmware version over the air from the gateway page.
Restart or reset a gateway
Reboot a gateway or clear its configuration remotely.
Picking sensors & pin validation
Add sensors to a gateway with automatic pin-conflict checking.
Gateway uplinks & network configuration
Wi-Fi, Ethernet, and cellular uplinks; parent/child chaining; and configuring a gateway's Ethernet port.
Debug a gateway remotely from the mobile app
Pull a live diagnostics snapshot and stream a gateway's logs from your phone — from anywhere.
Reading gateway events & health
The events a gateway emits and what its health fields mean.
View a gateway's console log over USB
Open a USB serial console to an already-provisioned gateway to watch its live log and run commands.
Watch a gateway's live logs from the web app
Stream a gateway's logs in real time from its detail page, choosing which categories you see — no USB cable needed.
Registering several gateways at once
Register a batch of pre-flashed gateways from their chip IDs — no serial flashing required.
Offline buffering — what happens when the gateway loses internet
Your gateway keeps recording while its internet is down and uploads the backlog when the connection returns. What is kept, for ho…
How many devices and tags one gateway can hold
Why a gateway has a configuration size limit, what happens when you reach it, and how to free space.

Dashboards

Dashboards overview
How dashboards, widgets, and the grid layout fit together.
Build a real-time IoT dashboard from live sensor data
Drag charts, gauges and value cards onto a canvas, bind them to live device tags, and quick-add widgets straight from a device's…
Creating, editing & deleting dashboards
Day-to-day dashboard management, including conflict handling.
Set a default dashboard
Choose which dashboard opens automatically when you log in.
Dashboard settings (time range, refresh, timezone, theme)
Control the time window, refresh, timezone, and theme of a dashboard.
Widget data sources explained
The seven data-source types and when to use each.
Aggregation & rolling windows
Downsample noisy streams with avg/min/max/sum/count/last over an interval.
Transforming values (scale, offset, unit convert, smooth)
Adjust raw readings before they're displayed.
The read-only widget catalog
Every display widget and what it's best for.
Interactive (control) widgets
Write back to devices with buttons, toggles, sliders, and actions.
On-demand Read widget
Read a tag from the device right now with one click — without waiting for the next poll.
Computed widgets & expressions
Combine multiple tags into one value with a formula.
Mapping & GPS tracking
Plot device location with the map-track widget.
Build a P&ID / SCADA mimic screen
Drop pumps, valves, tanks and gauges on a canvas and connect them with live animated pipes.
Fleet views — one overview for every station, one dashboard for each
A Fleet KPI tile per parameter, a Station List that puts alerts at the top, and a station variable so one detail dashboard serves…

Rules & alerts

Macros

Events

Integrations

Plans & billing

Rate limits

Account & security

FAQ

Troubleshooting