Configuration with a custom server

o configure the Efento LTE Gateway to send data to a custom server, use the free Efento mobile application for Android or iOS.

1

Place the gateway in its location

Place the gateway in its installation location.

Ensuring Good Signal Conditions

To ensure optimal Bluetooth communication performance, consider the following recommendations when selecting the installation site for the gateway:

• Place the gateway in an open area, at least 1 meter above the ground.

• Avoid installing the gateway close to corners, or large metal surfaces that may block or reflect Bluetooth signals.

• Keep the gateway away from sources of electromagnetic interference such as Wi-Fi routers or industrial equipment.

• Avoid placing the gateway inside cabinets, enclosures, or behind objects that may reduce signal strength.

• If multiple gateways are used, maintain sufficient spacing between them to minimize mutual interference.

• After installation, verify Bluetooth signal quality and communication stability with all connected devices to confirm proper operation.

2

Download the mobile application and go to Nearby devices mode

Download Efento mobile application for Android or for iOS. Select the option to use the mobile application with Nearby devices

3

Enable configuration mode on the gateway

Press the button located on the back panel of the gateway twice.

4

Connect to the Gateway

Tap the Gateway in the list to connect, then enter its password. You can find the password on the label attached to the bottom of the device.

5

Configure the Gateway

The gateway’s configuration is split into five tabs (you can switch the tabs by selecting them from the upper bar):

Network Parameters:

1. APN (Access Point Name): Enter the APN provided by your SIM card provider. If login and password are required, check “Use username and password,” or select “Automatic” to use the default APN.

2. PLMN (Public Land Mobile Network): Enter the unique code for your mobile network or select “Obtain automatically.”

3. DNS (Domain Name System): Set the address of the DNS server. By default it is set to 8.8.8.8

4. NTP (Network Time Protocol): Set the address of the NTP server. By default it is set to pool.ntp.org

If you are not certain which network settings to use, begin by selecting automatic APN and PLMN and keep the default DNS and NTP servers. If the gateway fails to connect, reach out to your connectivity provider for the correct APN and PLMN settings.

Server settings:

1. Server address: Address of the server to which the Gateway sends the data. Both IP and domain address are accepted

2. Server port: Port to which the data is sent

3. TLS: Enable or disable secure communication between the Gateway and the server. We strongly recommend enabling TLS to ensure secure, encrypted data transmission and protect your infrastructure from unauthorized access. If required, you can add custom CA certificates.

4. Organization token: Optional API token sent to the server in HTTP header by the Gateway along with the data.

5. Configure optional parameters:

   1. Custom Heartbeat endpoint: The Efento Gateway can send heartbeat messages to a user-defined endpoint at regular intervals. These messages allow the server to monitor the gateway’s status, including whether it is online, its uptime, battery status, and the number of loggers within range. Specify the endpoint where the messages should be sent. By default the heart beat messages are sent to /api/v2/gateways/heartbeat. The structure and details of the heartbeat message payload are described in the API Documentation section of this manual.

   2. Custom API endpoint: By default, the Efento Gateway sends measurements to the /api/v4/measurements endpoint. If needed, you can override this and specify your preferred endpoint address.

   3. Custom headers:

      By default, the Efento Gateway includes the value from the “Token” field in the HTTP "X-Api-Token" header. The default headers are:

      Content-Type: application/json
      charset=UTF-8
      X-Api-Token: <value of the “Token” field>

      If needed, you can configure the gateway to use custom headers that will overwrite the default "X-Api-Token" header. To do this, enable the “Custom headers” toggle and add the desired header names and values. You can define up to ten custom headers, which will be sent in the same order as they appear in the list. The headers “Content-Type” and “charset” are always included automatically.

6

Verify the connection

After saving the settings, the gateway will attempt to connect to the server. You can verify the current network and server communication status in Status (three dots in the upper-right corner → Status). The Registration status should show REGISTERED or REGISTERED_ROAMING, and the Communication status should display Success.

Hands-on tutorial: Build a server for Efento Gateways

If you want to see a complete, working example of how to receive measurements from Efento Gateways and store them in a database, make sure to check out our step-by-step tutorial. It includes sample Python code, a simple server application, and instructions for saving incoming data to PostgreSQL - perfect as a starting point for your own integration.