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)
Default services setting¶
- IQRF Gateway daemon
- IQRF Gateway webapp
- IQRF Gateway controller
- Mosquitto MQTT broker
- Websocket client
- Pixla remote management client
- SSH server
- Auto updates
- Zeroconf Avahi daemon
- Network manager
- NTP client
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