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
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.|
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.
The installed application works as a system service called
$ 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”
Statistics are logged every 60 minutes by default.
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¶
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|
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.
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.
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