For the complete documentation index, see llms.txt. This page is also available as Markdown.

Akenza

Akenza provides native support for Efento devices within their CoAP Device Connector. This means Akenza automatically processes your Efento device identifiers and securely handles uplink authentication without requiring manual payload decoding.

Follow this guide to configure your Efento sensors and establish data delivery to Akenza.

1

Prepare the Akenza Platform

Before configuring your Efento hardware, you need to set up the corresponding cloud infrastructure in your Akenza workspace to obtain your connection keys.

1. Create a Data Flow

  1. Log in to your Akenza account.

  2. Navigate to Data Flows and create a new flow ("Start with empty Data Flow").

  3. Choose the CoAP Device Connector as your entry point block. Once created, copy the generated Uplink Secret (Custom Token). You will need to input this string into the Efento sensor configuration.

  4. Add a Device Type block and select "4-20 mA Analog Sensor Interface" from the library.

  5. Add an Output Connector block. Akenza offers multiple output connectors depending on where you want to route your data (e.g., AWS, Azure, custom webhooks). For the purpose of this tutorial, select the Akenza Database connector to save and view the incoming device data directly within the platform.

2. Register Your Efento Device

  1. In Akenza, go to Devices and select Create Device.

  2. Name the device, optionally add description, tags and custom fields

  3. Assign the Data Flow you created in the previous step.

  4. For the Device ID, use your Efento logger's serial number.

2

Configure Your Efento Sensor

To point your Efento sensor to the Akenza endpoint, you must use the Efento mobile application for iOS or Android.

  1. Verify the NB-IoT connection: Before proceeding with the configuration, confirm your cellular network allows data transport to your private server destination - connect to your sensor over Bluetooth in the app, open the settings menu (Android - three dots, iOs - gear icon) and select Cellular network status and verify that Registration status reads either REGISTERED or REGISTERED_ROAMING.

  2. Set the Target Server Address: Navigate to Server Configuration - >Data Server, select Other and input the server address as: coap.akenza.io , port 5683.

  3. Set the Authentication (Server configuration -> Authentication): Set the authentication type to Custom Token.

    1. Paste the Uplink Secret copied from the Akenza CoAP connector.

    2. Ensure that the option to send the token in the payload is explicitly enabled.

  4. CoAP Endpoint Paths (Server configuration -> CoAP endpoints): Update the resource paths exactly as follows:

    1. Data: efento/m

    2. Configuration: efento/c

    3. Device Info: efento/i

    4. Timestamp: efento/t

3

Verify the configuration

Once you have successfully completed the configuration on both the Akenza platform and your Efento logger, the device will begin transmitting its telemetry data. You can verify that everything is working correctly by navigating to the Devices section within your Akenza workspace. There, you will see the incoming payload decoded in real-time, confirming that your 4-20 mA analog readings are successfully reaching Akenza and being saved to the database.

Last updated