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
Access Password 16x0
Tx power 7
Rx filter 7 (Advised for ANY IQRF Linux gateway)

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.

v1.1.0

While button is being pressed green led is on.

after 2s of being pressed red led flashes 1x: selected daemon api call is executed upon button release
after 6s of being pressed red led flashes 2x: gateway poweroff is executed upon button release
after 10s of being pressed red led flashes 3x: gateway factory setting is executed upon button release

v1.0.0

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.

Tip: Check simple examples for bash.

Pixla remote management client¶

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

Login at https://www.pixla.online
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 disabled 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