Atrium IIoT Gateway User Guide
Atrium

Atrium IIoT Gateway User Guide

Everything you need to unbox, power up, and operate your Atrium IIoT Gateway — a complete local platform for monitoring and managing your entire fleet of NCD wireless sensors, no cloud required.

Buy Now →

Audience
Operators & integrators
Estimated time
30 minutes
Last updated
2026-07-08

01Introduction

The Atrium IIoT Gateway is an industrial edge device that receives data from your NCD wireless sensors over a long-range wireless mesh network and turns it into a live, browser-based monitoring platform called Atrium.

What is Atrium?

Atrium is a local web dashboard for monitoring wireless sensor networks. It runs entirely on the gateway — data ingestion, the local database, the API, and the web interface all live on the device. There is no cloud connection required; the internet is only needed if you choose to enable Remote Access, push data to an external MQTT broker, or send email alerts.

Open a browser on any device on the same network as the gateway, sign in, and you get real-time visibility into every connected sensor: current readings, health status, historical charts, alerts, automations, scheduled reports, and a suite of industrial apps for productivity, OEE, energy, and environmental monitoring.

Offline & router capabilities

Atrium is built to run without an internet connection. Because data ingestion, storage, dashboards, alerts, and automations all execute on the gateway itself, your sensor network keeps collecting and recording data even when the site is fully offline — the internet is only used for optional cloud features (Remote Access, MQTT push, and email alerts), which resume automatically when connectivity returns.

The gateway also doubles as an industrial network router, so it can provide connectivity in the field rather than depend on existing infrastructure: dual Ethernet (WAN/LAN), dual-band Wi-Fi (access point or client), and optional cellular with automatic SIM detection for backhaul or failover, plus configurable firewalls and VPN for secure remote access. A single gateway can receive your wireless sensors, host Atrium, and route the local network at the same time.

Wireless mesh
Collects data from NCD sensors over a self-healing long-range wireless mesh with up to 2-mile range.
Runs 100% locally
Dashboard, database, and services all run on the gateway. Your data stays on-premises.
Alerts & automations
Threshold rules that email you or switch relays when readings cross a limit.
Industrial apps
Productivity Monitor now, with OEE, Energy, Action, and Environmental tools coming soon.
Cloud & MQTT ready
Publish telemetry to any MQTT broker — AWS, Azure, or your own pipeline.
Secure remote access
Reach the gateway from anywhere over an encrypted Cloudflare tunnel.
01 gateway hardware
The Atrium IIoT Gateway, built on the EG5120 industrial edge platform.

02Hardware & What’s in the Box

Your gateway is built on the EG5120 industrial edge platform. Everything you need to get on the air is included in the box.

In the box

  • Atrium IIoT Gateway unit (pre-loaded with the Atrium software platform)
  • Long-range wireless radio module for your selected frequency
  • Frequency-specific antenna (868–900 MHz or 2.4 GHz dipole)
  • U.FL to RP-SMA pigtail cable adapter
  • Power supply (9–60 VDC input)

Ports & connectors

ConnectorPurpose
ETH0 (Ethernet)Uplink / client port (default). Connect this to your existing LAN or router — it is the port you use to reach the Atrium dashboard and to give the gateway internet access.
ETH1 (Ethernet)Downstream port (default). Creates its own isolated network (with its own DHCP) for other devices. Both ports are configurable and have customizable firewalls.
Power9–60 VDC input (power supply included).
Antenna (RP-SMA)Connect the included wireless antenna via the U.FL to RP-SMA pigtail.
SIM slotOptional cellular connectivity with automatic SIM detection.

Antenna connections

The gateway has multiple antenna connectors. Attach each included antenna to its matching connector as shown below — the long-range wireless (sensor radio) antenna, plus Wi-Fi and cellular antennas if those radios are used.

12 antenna connections
Antenna connections — which antenna attaches to each connector.

Wireless frequency options

The gateway is ordered with one long-range wireless radio to match the frequency of your NCD sensors and your region. Sensors and gateway must be on the same frequency to communicate.

FrequencyRegion
900 MHzNorth & South America
868 MHzEurope
2.4 GHzWorldwide

Full gateway capabilities

Because it is the Enterprise IIoT Gateway underneath, your Atrium gateway is a full-featured industrial edge device even before you open Atrium. All of the standard gateway capabilities are available to you:

Full Linux OS
Debian-based Linux with SSH access for full customization on a 1.6 GHz quad-core, 2 GB platform.
Remote fleet management
Register and manage gateways remotely from a cloud console — VPN groups, user access, and location/tag tracking.
VPN & firewall
Encrypted VPN and remote access plus per-port configurable firewalls on both Ethernet interfaces.
Flexible networking
Dual Ethernet, dual-band Wi-Fi (AP or client, WPA/WPA2), and built-in cellular with automatic SIM detection.
Node-RED pre-installed
A full Node-RED runtime for custom flows and integrations (AWS, Azure, MongoDB, MySQL, Ubidots, email).
Industrial protocols
Speaks MQTT, HTTP, TCP, AMQP, and OPC UA to connect with cloud platforms, databases, and industrial systems.

03Physical Setup & First Access

Get the gateway powered, on your network, and logged in for the first time.

Connect the hardware

  1. 1
    Attach the antenna
    Connect the wireless radio antenna using the included U.FL to RP-SMA pigtail. Position it vertically and away from large metal surfaces for best range.
  2. 2
    Connect to your network
    Plug an Ethernet cable from your LAN / router into the ETH0 port. A wired Ethernet connection to your local network is required to reach the Atrium dashboard. (Wi-Fi and cellular serve the gateway’s own internet uplink, not local dashboard access.)
  3. 3
    Apply power
    Connect the included power supply (9–60 VDC input). The gateway boots and the Atrium software starts automatically — allow a minute or two for services to come up.

Open Atrium in a browser

On any device connected to the same network, open a web browser and navigate to the gateway’s address. Atrium is served on the standard web port, so no port number is needed:

URLAny browser on the LAN
http://<gateway-hostname>
# example
http://ncd-d8fc.local

If .local hostname resolution isn’t available on your network, use the gateway’s LAN IP address instead (you can find it from your router’s device list, or later on the Settings page under Gateway Info).

Log in

You’ll be presented with a login screen. Sign in with the default credentials shipped with your gateway:

FieldDefault
Usernamencdio
PasswordncdB3ast
02 login screen
The Atrium login screen.

04First-Time Setup Wizard

The first time you log in to a new gateway, a guided Setup Wizard walks you through initial configuration in about two minutes. A progress bar tracks six phases: Welcome, Email, Security, Access, Sensors, and Done.

Watch: Atrium Setup — Onboarding Sensors

Every step is optional — you can skip any individual step or the entire wizard, and change everything later from the Settings page. The wizard covers:

The six phases

PhaseWhat you configure
WelcomeIntroduction. Click Get Started, or skip setup entirely.
EmailSMTP server, port, username, password, and From address so Atrium can send alerts. A Send Test Email button verifies credentials before saving.
SecurityChange the default username and password (new password must be at least 6 characters). You’ll be logged out to sign back in with the new credentials.
AccessOptionally enable Remote Access via a secure Cloudflare tunnel. A warning appears if you haven’t changed the default credentials yet.
SensorsName and describe any detected-but-unconfigured sensors — one at a time — with a friendly name, location, asset, and install date.
DoneA summary of what was configured. Click Go to Sensors to enter the main interface.
03 setup wizard
The first-time Setup Wizard guides you through six quick phases.
04 setup wizard sensors
Naming detected sensors during the wizard’s Sensor Setup step.

06Sensor Dashboards

Click any device in the Sensor List to open its dashboard — detailed, real-time information for a single sensor.

What’s on the dashboard

  • Device header — name, device ID (MAC), sensor type, firmware version, location/asset, and a color-coded Last Heard timestamp.
  • Status banners — amber warnings (sensor error, low battery, weak signal) or a red offline banner when applicable.
  • Status History — a collapsible, chronological log of every health transition, useful for post-incident review.
  • Time-series charts — one per metric, with selectable ranges (1h, 6h, 24h, 7d, 30d, or custom). Drag to zoom; drag charts to reorder.
  • Thresholds — draw an alert reference line on any chart with a condition, value, and swing (hysteresis).

Vibration sensors add an FFT View for frequency-domain analysis and a one-shot Raw FFT Data capture. Sensors on the wireless mesh network show a Mesh Route Map with hop count and a link to the full network topology.

Configuring a sensor

The Configure link opens a tabbed editor where you set the sensor’s location, asset, friendly name, install date, report interval, and offline-alert preference; customize how each metric is displayed (formula, unit, label, visibility); and adjust sensor-specific parameters.

06 sensor dashboard
A sensor dashboard with live time-series charts.

Interactive Preview

The panel below simulates the Atrium Sensor Dashboard for this Vibration / Temperature sensor. Data updates every 5 seconds to demonstrate the live monitoring experience.

07Custom Dashboards (Monitor)

The Monitor page is a customizable, widget-based view for watching multiple sensors at a glance — ideal for a wall-mounted display or a dedicated monitoring station.

Widgets

Click + Add Widget, choose a type, then add one or more sensor metrics with the Add Metric wizard. Available widgets include Line / Area / Bar charts, Gauge, Tank Level, Stat Card, Sparkline, Metric Card, and Table.

  • Thresholds — Metric Card, Gauge, and Tank Level widgets support color-coded value bands. Use Auto-fill Zones to generate red/orange/green ranges.
  • 4-20 mA scaling — for analog inputs, a built-in workflow maps 4 mA and 20 mA to real-world units (feet, PSI, gallons, and more).
  • Synthetic Variables — computed metrics that combine readings from one or more sensors using a formula, available to any widget.

Drag widgets to rearrange them, resize by the corner handle, and click Tidy Up to auto-arrange. Layouts save automatically. A global time range panel controls chart-based widgets, and a Fullscreen button expands the page for shop-floor displays.

07 monitor vibration
A custom Monitor dashboard built from vibration-sensor widgets.

08Alerts, Automations & Reports

Turn raw readings into action — get notified when something crosses a limit, switch a relay automatically, and receive scheduled summaries by email.

Alerts & automations

The Alerts page has four parts:

  • Alert Templates — threshold rules that auto-apply to groups of devices (all devices, a sensor type, a location, or an asset). New matching devices inherit the alert automatically.
  • Triggers — a single threshold condition on one device’s metric, with a condition (above/below), value, and swing (hysteresis).
  • Automations — link one or more triggers to one or more actions. When all triggers are active, the automation fires.
  • Alert History — a searchable log of past alert events.

An automation’s actions can send an email to one or more recipients or command an output device (relay/actuator) — firing on trigger, on clear, or both. Each automation shows a live ACTIVE / OK status.

Scheduled reports

The Reports page generates and emails recurring reports (daily, weekly, or monthly) as PDF, CSV, or both. Report types include Fleet Summary, Sensor Group, Alert Digest, Productivity Summary, Custom SQL, and an OEE Summary (coming soon, alongside the OEE app). Use Send Now to test a report immediately.

08 alerts page
Automations link triggers to email and relay actions.

09Apps

The Apps page provides specialized tools built on top of your sensor data. Productivity Monitor is available now; the remaining apps are coming soon and will unlock in a future update.

Productivity Monitor
Track machine runtime and production quota attainment against shift schedules.
OEE
Overall Equipment Effectiveness — Availability × Performance × Quality, with reject logging.
Coming Soon
Energy Monitor
Electrical consumption, cost, and idle waste per machine via CT current sensors.
Coming Soon
Action
Automate relay control from sensor thresholds using pre-built recipes.
Coming Soon
Environmental
Monitor temperature, humidity, air quality, and compliance across facility zones.
Coming Soon

Each app supports date navigation, auto-refresh when viewing today, drag-and-resize layouts, and a Fullscreen mode for floor displays. Productivity, OEE, and Energy share machine definitions, so a machine configured once can be tracked across all three.

09 app productivity
The Productivity Monitor app — machine runtime and quota attainment at a glance.

10Gateway Settings

The Settings page holds all gateway configuration. Read-only Gateway Info at the top shows the MAC address, LAN IP, and platform version.

Key settings

SettingWhat it does
GeneralGateway name, display timezone, temperature unit (°C/°F, global), data retention (default 100 days), and dashboard refresh interval (default 30 s).
Remote AccessEnable secure access over the internet via a Cloudflare tunnel. Change the default password first.
Email (SMTP)Configure the outgoing mail server for alerts and reports, with a Send Test Email button.
MQTT ClientPush every telemetry reading, alert, and status change to a remote MQTT broker for cloud or external system integration. Configurable topic patterns.
System UpdatesOne-click over-the-air updates when a new version is available, plus a force-update / rollback option.
Device ManagementNew-sensor handling (auto-whitelist or auto-blacklist) and whitelist/blacklist panels with bulk actions.
CredentialsChange the username/password for both the web interface and the Node-RED admin editor.
Advanced: Node-RED & SQL
Atrium does not require Node-RED for normal operation — it ships installed but dormant for advanced users who want to build custom flows against the raw radio feed. A built-in SQL Query console is also available for direct database access. Leave these off unless you specifically need them.
10 settings page
The Settings page — one place for network, email, MQTT, updates, and credentials.
11 gateway health
Gateway Health tracks the device itself — load, memory, and communication.

11Troubleshooting

Quick fixes for the most common issues.

SymptomWhat to check
Can’t reach Atrium in the browser Confirm your device is on the same network as the gateway. If the .local hostname won’t resolve, use the LAN IP from your router. Give the gateway 1–2 minutes to finish booting.
Device shows Offline (red) Check sensor power/batteries and range; move it closer or clear obstructions; verify the gateway antenna is connected and upright. Long report intervals can make a device look offline between transmissions.
Device shows Warning (amber) Low battery: replace batteries. Weak signal: reposition sensor/gateway or check the antenna. Sensor error: inspect probe connections and cabling.
No new sensors appearing Confirm sensors are on the same wireless frequency as the gateway. Check the New Sensor Handling setting and the whitelist/blacklist in Settings → Device Management.
No email received Verify SMTP in Settings and use Send Test Email. Confirm a recipient is set on the alert or report, and check spam folders.
Can’t log in Verify credentials. If forgotten, contact your system administrator. Ensure your browser is on the same network as the gateway.

Factory Reset

A factory reset restores the gateway’s network settings and Node-RED configuration to their defaults. Use it as a recovery step if the gateway becomes unresponsive or stops booting normally, or when you want to start from a clean configuration.

  1. 1
    Disconnect cables
    Remove all Ethernet and USB devices from the gateway.
  2. 2
    Power on the gateway
    Apply power and wait a few seconds for it to begin booting.
  3. 3
    Press and hold RST
    Press and hold the RST (reset) button — shown below — for 5 to 10 seconds.
  4. 4
    Watch the RUN light
    The RUN indicator light will begin to flash rapidly. This confirms the reset has started.
  5. 5
    Release RST
    Release the button. The gateway performs the factory reset and restarts — allow about 2–3 minutes before the interface is reachable again.
13 factory reset button
Location of the RST (reset) button and RUN indicator light.

12Technical Specifications

At-a-glance hardware and platform details.

CategorySpecification
PlatformNCD Enterprise IIoT Gateway (EG5120)
Processor1.6 GHz quad-core
Memory2 GB DDR4
Storage64 GB flash (local SQL database)
EthernetDual ports — ETH0 uplink/client, ETH1 downstream network; customizable firewalls
Wi-Fi802.11 a/b/g/n/ac, 2.4 GHz & 5 GHz, AP or client mode (WPA/WPA2/AES-CCMP)
CellularBuilt-in, automatic SIM detection
Sensor radioLong-range wireless mesh — 900 MHz, 868 MHz, or 2.4 GHz (selectable), up to ~2-mile range
AntennaFrequency-specific dipole + U.FL to RP-SMA pigtail (included)
Power9–60 VDC, 5–20 W (power supply included)
Operating systemDebian-based Linux with SSH access
Remote managementCloud fleet management, encrypted VPN and remote access
Industrial protocolsMQTT, HTTP, TCP, AMQP, OPC UA
Software platformAtrium — React web app, local API, SQLite database, OTA updates
IntegrationsAWS, Azure, MongoDB, MySQL, Ubidots, email, custom endpoints; Node-RED pre-installed

Buy Now on store.ncd.io →