Skip to content

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

Still unable to configure your gateway?

Check our FAQ ยท Contact us


Last update: 2020-10-15