For proper operation, a device with Linux, a Bluetooth 4.0 module and an Internet connection (e.g. via Wi-Fi) is required.
The target platform is the Raspberry Pi computer with Raspberry Pi OS (formerly Raspbian) installed. Gateway tests have been performed on Raspberry Pi 4 B, 3 B and Zero W devices.
Having a device from among the listed, although recommended, is not required for proper operation of the application. It has been tested on popular Linux distributions: Ubuntu and Arch Linux. Please contact us if you want to install the application on such a distribution (a separate installation package is required). New features are first released on Raspberry Pi OS.
Depending on your preferences, there are two possibilities to install the software.
- For those who want to avoid installation and configuration of the operating system to make the application work.
- The level of difficulty is comparable to the difficulty of burning a data image on a CD/DVD.
- For those who already have an active device and want to automatically receive software updates and have control over application settings.
- This requires basic system command line and Debian package management knowledge.
Automatic update will be possible in future versions of the image and installation package.
We suggest that you read the entire manual in order to learn about all of the possibilities of the gateway.
The system image is a ready-made dump of the operating system containing all its basic functions as well as the OneMeter Gateway application installed. Burning to an SD card allows you to restore the state after the system is started. The gateway is then ready for operation just after you configure its Wi-Fi settings using another device (e.g. mobile phone) by connecting to a newly created access point and set the destined connection parameters in the GUI (details below).
- Etcher (or similar)
- approximately 2GB of free space on your computer
- Raspberry Pi
- microSD card (min. 4 GB)
- microSD card reader (an adapter is fine, if the computer does not have a dedicated port)
Download the system image with the gateway application. Select one of the links below. In the case of a compressed version, you may need to extract the
file size [MB] download link 395 .tar.xz file 563 .zip file 2957 .img file
Prepare the required devices and install Etcher.
- Insert the microSD card into the reader connected to your computer.
- Select system image in Etcher (eg.
Select the drive corresponding to the microSD card.
Make sure that the correct drive has been selected - its data will be completely overwritten!
Burn the image to disk. This operation may take a while.
- Insert the memory card into the card slot of Raspberry Pi.
Start the system. The device will boot in configuration mode.
If necessary, a temporary login and password can be found in the Specifications. Do not change the login - otherwise the application may not work properly.
Configure your Wi-Fi settings. Connect from another computer to the access point (Wi-Fi network) - created by your Raspberry Pi.
The name of the temporary network and the address of the page where you can configure your network connection settings can be found in the Specifications.
Enter the network name manually if you don't see it in the list. Set WPA if necessary.
The system should restart itself. If your RPi does not restart within several seconds, disconnect and re-connect the power supply to the gateway.
You don't have to follow this step, but after some time you may run out of memory if you don't.
The application has begun transferring data from nearby OneMeter devices to the OneMeter Cloud. Wait a while and then check your energy consumption profile.
Reset Wi-Fi settings
If you have an SSH connection (requires configuration), just run the following command in
sudo python3 manual_reset.py
If you can't access the gateway console to reset the Wi-Fi settings, you may short out GPIO18 pin to 3.3 volts and hold for 10 seconds. After this completion, you can set your connection parameters to your local Wi-Fi network again.
Please read the pinout of your device and make sure that the selected pin corresponds to GPIO18 of the CPU, not necessarily to the pin number of the connector to which it leads.
Did you get through all of the steps correctly? Great!
The application has now begun relaying data from nearby devices to the OneMeter Cloud. Wait a little bit and check your energy usage profile.
The program's installation package should be uploaded to the system using the built-in package installer manager (dpkg). The gateway will start working immediately after installation.
- Raspberry Pi with SD card containing a distribution
- Raspbian Buster or newer (current latest version)
Download the gateway application. Verify authenticity if required.
file size [kB] download link 53 .deb file - Raspberry Pi - armhf architecture 64 .deb file - PC - amd64 architecture (x86/64)
Boot the target operating system.
- Gain terminal access (console) eg. via SSH connection.
- Make sure you have access to Bluetooth, reboot the system.
- In the case of a SSH connection, reconnect.
- Download the OneMeter Gateway installation package on to your target platform.
- Install the gateway software (make sure the name and location of the file is correct).
sudo dpkg --install onemeter-gateway-armhf-v2.0.deb
In case of dependency errors, install the packages specified by the system.
sudo apt-get install -f
The application has now begun relaying data from nearby devices to the OneMeter Cloud.
Done Wait a little bit and check your energy usage profile.