Getting started

The gateway image is based on Linux for ARM development boards called Armbian.

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 port 1338
  • 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

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

IQRF Gateway controller

Controls gateway’s led and button.

  • 10s button press restores default IQRF Gateway daemon’s configuration and restarts the daemon.
sudo systemctl status iqrf-gateway-controller

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

Websocket client

Test IQRF Gateway daemon API from bash directly.

Pixla remote management client

Having all 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.
sudo systemctl status gwman

SSH server

SSH server is running on port 22.

  • Default credentials: root/1234
  • Action: Create your own user once login for the first time, there is a guide.
  • Tip: Use e.g. Putty client to login to the gateway.
sudo systemctl status ssh

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 your-gw-hostname.local
sudo systemctl status avahi-daemon

Network manager

GW WiFi client is pointed to your “IQRF” WiFi mobile hotspot.

  • Tip: Create your own “iqrf” WiFi hotspot and gateway will auto-connect. Set same password as on the gateway label.
sudo systemctl status NetworkManager

DHCP client

Fallback IP address on ETH is set to

  • Tip: Fallback IP is useful when connected directly via ETH cable to the gateway from laptop without DHCP server.
sudo systemctl status dhcpcd

NTP client

Keep gateway time in sync.

  • Tip: Configure your local timezone.

    sudo dpkg-reconfigure tzdata
sudo systemctl status ntp