Usage
Recommendations¶
The following assumes that the installation process was successful. Frequent user interaction with the gateway is not required.
Interacting with the system¶
- Place the gateway as close as possible to the devices being targeted and in a place with good WiFi coverage.
- Make sure every few days that the data is transmitted to the server (as evidenced by its presence in the cloud), and more often during the first days of the gateway's operation
- Move the gateway to a location where data can be sent to the server for the entire duration of the upload (which may take several minutes) in the event of a prolonged lack of connection to the Internet.
SD life expectancy¶
To increase the life of your SD card, you can mount some directories in the RAM. To do this, add the following lines to the /etc/fstab
file. Modify them if necessary.
tmpfs /tmp tmpfs defaults,noatime,nosuid,size=100m 0 0
tmpfs /var/tmp tmpfs defaults,noatime,nosuid,size=30m 0 0
tmpfs /var/log tmpfs defaults,noatime,nosuid,mode=0755,size=100m 0 0
tmpfs /run tmpfs defaults,noatime,nosuid,mode=0755,size=100m 0 0
tmpfs /var/spool/mqueue tmpfs defaults,noatime,nosuid,mode=0700,gid=12,size=30m 0 0
User interface¶
LED status¶
The ACT LED is used by the application to indicate the system status.
Blinking | Data is broadcasted and is transmitted to the server. | |
Stable | Connected to the server. | |
Off | No connection with server. |
Warning
Make sure that the LED logic is not inverted, i.e. it is disabled when connected to the server. Also make sure that the diode is not in use by other services.
The gateway operates on the led0
file descriptor in the operating system.
Administration¶
The installed application works as a system service called onemeter-gateway
.
$ systemctl status onemeter-gateway
๐ข onemeter-gateway.service - OneMeter Gateway
Loaded: loaded (/etc/systemd/system/onemeter-gateway.service
The event log contains information about the operation of the application (connection status, data redirection statistics).
journalctl -u onemeter-gateway -f --since โ2 hours agoโ
Statystics¶
Statistics are logged every 60 minutes by default.
Warning
If the directory /var/log
is mounted in RAM, the event log will be cleared after a reboot.
To change the frequency of statistics display to 24h and enable their collection (instead of resetting):
Add the following lines to the file /etc/onemeter-gateway/settings
and restart the system.
STATS_PERIOD_MINS 1440
STATS_AGGREGATED
We recommend caution when editing any device configuration files.
The first line summarizes the received package types and the number of OneMeter devices nearby.
Statistics: from last 60 mins
read info null beacons
2 1 4 1
# publ qos=0 fail conn lost+down
0 50 0 1 0 0
In the second line we see the number of successful data published (confirmed by the server), the number of unconfirmed attempts queued to send (QoS 0), the number of unsuccessful publications, successful connections to the server and unsuccessful or lost connections to it.
Verification of authenticity¶
Procedure
The following step is optional, however, users of the installation package are recommended to follow it. Users of the system image receive the application installed by us - in this case, there is no need for additional verification.
Download and import the OneMeter public key.
file size [kB] | download link |
---|---|
5 | .pgp file |
gpg --import onemeter-deployment.pgp
Verify the signature of the package.
Make sure the file name is correct. The expected result is: GOODSIG _gpgbuilder ...
dpkg-sig --verify onemeter-gateway-armhf-v2.0.deb
The user of the system image can find the installation package in the system home directory.
Uninstallation¶
To uninstall the OneMeter Gateway, call the following commands.
sudo systemctl stop onemeter-gateway
sudo dpkg --remove onemeter-gateway
In case you want to delete user settings, run the additional command.
sudo dpkg --purge onemeter-gateway
When you delete your user settings, the unique gateway ID will change after reinstallation. Otherwise, it will remain unchanged.
Technical support¶
Most of the potential errors associated with the operation of the gateway can be resolved by restarting the system. Make sure that:
- You have an active internet connection
- Bluetooth is enabled