Device services

The gateway image is based on Linux for ARM development boards called Armbian. Many thanks to Armbian team for the great work.

What is Armbian?

  • Lightweight Debian or Ubuntu based distribution specialized for ARM developing boards.
  • Compiled from scratch.
  • It has powerful build and software development tools.
  • A vibrant community.

Knowing basics about the gateway’s content and its configuration.

Default coordinator setting

  • DPA SPI coordinator plugin
  • LP networks enabled
  • Tx power 7
  • Rx filter 7 (Advised for ANY IQRF Linux gateway)

Default services setting

IQRF Gateway daemon

  • MQTT client connected to port 1883
  • WebSocket server ports 1338, 1438
  • UDP ports 55000 and 55300
  • Tip: Explore more about its configuration via web interface.
  • Tip: Explore more about daemon API.
sudo systemctl status iqrf-gateway-daemon.service

IQRF Gateway webapp

  • HTTP server is running port 80.
  • Action: Create your own user once logging for the first time, there is a guide.
  • Tip: Explore IQRF Gateway daemon’s posibilities using web interface.
sudo systemctl status nginx.service

IQRF Gateway controller

Controls gateway’s button and led.

  • 1-10s button press poweroff the gateway gracefully.
  • 10s button press restores default IQRF Gateway daemon’s and IP configuration and restarts the daemons.
  • Green led slow flashing means that the daemon is running in operational/forwarding mode.
  • Green led fast flashing means that the daemon is running in service mode.
  • Red led slow flashing means that the daemon service is not running.
  • Red led fast flashing means that the daemon interface is not correctly configured.
sudo systemctl status iqrf-gateway-controller.service

Mosquitto MQTT broker

MQTT broker is running on port 1883.

  • Tip: IQRF Gateway daemon is already configured and connected to it.
  • Tip: Check simple examples for bash.
sudo systemctl status mosquitto.service

Websocket client

Test IQRF Gateway daemon API from bash directly.

Pixla remote management client

Having all the gateways at one place with monitoring and management capabilities?

  • Login at
  • Action: Register your gateway’s token as printed on the label to your user account.
  • Tip: You can also scan printed QR code to get the token.
  • The client service can be disabled/enabled using web interface.
sudo systemctl status gwman-client.service

SSH server

SSH server is by default disabled. When enabled it runs on port 22.

  • Default credentials: root/1234
  • Tip: Use gateway web (/gateway/ssh) page to enable SSH service if required.
  • Tip: Use e.g. Putty client to login to the gateway.
  • Action: Create your own user once login for the first time, there is a guide upon login.
sudo systemctl status ssh.service

Auto updates

Unattending updates for the system and IQRF packages are configured and enabled by default.

  • Tip: The updates can be disabled/enabled using web interface.
sudo systemctl status unattended-upgrades.service

Zeroconf Avahi daemon

Do not know your IP address from DHCP server within your network?

  • Action: Zeroconf for Win
  • Tip: Ping your device using: ping -4 your-gw-hostname.local

The hostname can be found either on the gateway label or via web interface in the information page.

sudo systemctl status avahi-daemon.service

Network manager

GW ETH is configured for DHCP IP by default.

  • Tip: It is possible to switch to static IP using console armbian-config interface.

GW WiFi is not configured by default.

  • Tip: WiFi can be enabled and configured by the customer also via console armbian-config interface.
sudo armbian-config

NTP client

Keep gateway time in sync.

  • Tip: Configure your local timezone.

    sudo dpkg-reconfigure tzdata
sudo systemctl status ntp.service