# How to integrate the Pepperl+Fuchs Kit with Actility on akenza

<figure><img src="https://2165942204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MMKXTFIN5ZlLOjBlfC4%2Fuploads%2FORfDh8TWbTcWeGQptItC%2Fwaste_water_fill_level_management_02.png?alt=media&#x26;token=8af1f337-432c-439e-a841-2c9787eead82" alt=""><figcaption><p>Actility - Pepperl+Fuchs - akenza Smart Level Monitoring</p></figcaption></figure>

{% hint style="success" %}

**The Kit contains**:

* 1 x Pepperl+Fuchs WILSEN.sonic.level **UCC2500** sensor or **UCC4000** sensor&#x20;
* 1 x Browan Pico NEXT LTE Gateway pre-installed and configured
* 3 x Months subscription to akenza.io application up to 2 devices
* 3 x Months subscription to ThingPark Enterprise SaaS service

**Application examples**:

* Remotely monitor **fill levels in containers, tanks, and silos,** **water levels of rivers, lakes, and flood basins** for verticals such:
  * Smart Farming
  * Smart Environment
  * Smart Cities
  * Smart Logistics

\
**Product Features**:

* Fill levels are measured at regular intervals and transmitted to operational experts through internet-based applications.
* The measurement and transmission frequency are parameterized via a mobile application and Bluetooth interface.
* Battery-powered ultrasonic sensor with LoRaWAN interface
* Thanks to the IP protection class IP66/67, the sensor can be used in harsh and industrial environments
* The sensor transmits more than just filling levels. **GPS** data from the sensor allows assets such as containers to be tracked, while other information such as **temperature** readings ​​and **battery charge status** enables it to benefit from predictive maintenance capabilities.

**You can purchase the Kit in the** [**ThingPark marketplace**](https://market.thingpark.com/catalog/product/view/id/14729/preview/1/preview_product_sku/KITPEP1000/) **of Actility.**
{% endhint %}

In this tutorial, you will learn how to connect the **Actility - Pepperl+Fuchs Smart Level Monitoring**

&#x20;**Kit** to akenza. You will achieve the following:

1. Integrating your Actility account to your akenza environment
2. Creating a Data Flow and device on akenza
3. Creating your individual dashboard for data visualization

### 1. Getting started

To get started with akenza, follow [these steps](https://docs.akenza.io/how-to-create-a-working-environment) in order to set up your environment.

### 2. Add an Actility Integration on akenza

{% hint style="info" %}
In order to proceed with the Actility integration on akenza, make sure to create a [ThingPark community account](https://community.thingpark.org/index.php/sign-up-tpcp/) and pre-commission the Milesight gateway to it as described [here](https://docs.thingpark.com/thingpark-enterprise/7.2/Content/BS-installation-guides/Provision-base-station.htm?tocpath=Using%20ThingPark%20Enterprise%7CManaging%20your%20radio%20access%20network%7CProvisioning%20the%20base%20station%20on%20ThingPark%20GUI%7C_____0). Follow this [link](https://docs.thingpark.com/thingpark-enterprise/7.2/Content/BS-installation-guides/Install-ThingPark-image.htm?tocpath=Using%20ThingPark%20Enterprise%7CManaging%20your%20radio%20access%20network%7CInstalling%20the%20ThingPark%20image%20on%20your%20base%20station%7C_____0) if you need to install Actility's firmware on the gateway.
{% endhint %}

The integration of Actility will be used to **connect**, **synchronize** and **manage** Assets on akenza. Start with the integration of your Actility account by adding your credentials on the Actility tab within *Integrations*. More details about Integrations (for ThingPark Enterprise only) can be found [here](https://www.actility.com/enterprise-iot-connectivity-solutions/).&#x20;

<figure><img src="https://2165942204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MMKXTFIN5ZlLOjBlfC4%2Fuploads%2F5opkFDSIRj0MLJU9Ho7v%2Fscreely-1673515520577.png?alt=media&#x26;token=393bf651-9341-4c7f-88b9-d6ea6cc95a2a" alt=""><figcaption><p>Connectivity Integration Setup</p></figcaption></figure>

If you use the community instance of ThingPark, the required Profile ID is ***community-api***. To find the Profile ID please check out the Actility API documentation of your account. See the example [here](https://community.thingpark.io/thingpark/dx/core/latest/swagger-ui/index.html?shortUrl=tpdx-core-tpe-api-contract.yaml).

After successful integration, the Actility-account-integration gets displayed on the Connectivity Integration Overview.

<figure><img src="https://2165942204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MMKXTFIN5ZlLOjBlfC4%2Fuploads%2FHxRDECrCyXghq2CHBVm0%2Fscreely-1673515615885.png?alt=media&#x26;token=dd25c967-0595-40b6-a14a-27082d3f5773" alt=""><figcaption><p>Connectivity Integration of Actility</p></figcaption></figure>

### 3. Create Dataflow

As a next step, go to *Data Flows* in your Workspace and choose as device connector *LoRa* and consequently, the Actility integration you have done in step 2. For data parsing continue with the selection in *Device Types* of your specific Milesight device. As an output connector, select the *akenza database*. This will store the data on akenza and allows further use on the dashboard composer. More about Data Flows can be checked [here](https://docs.akenza.io/akenza.io/get-started/your-data-flow).

{% hint style="info" %}
Data Flows consist of a **device connector**, a **device type,** and an **output connector** and define how device data are processed on akenza.
{% endhint %}

<figure><img src="https://2165942204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MMKXTFIN5ZlLOjBlfC4%2Fuploads%2FM7jxQ2M3jouXxWmTaw5b%2Fscreely-1673515782238.png?alt=media&#x26;token=b4c3a1b1-d38c-482d-a531-2ef56b205e2c" alt=""><figcaption><p>Data Flow with Wilsen Device Type</p></figcaption></figure>

Once all specific Data Flows are created for your devices, continue with the creation of your devices.

### 4. Create Assets

To add a device to your environment, select *+Create Device* in the tab of *Assets* and fill in the required device parameters. By assigning the appropriate Data Flow, your device will be automatically registered and connected to your Actility account.&#x20;

Upon a join request, the device will turn online. Incoming data are displayed in *Message Logs* and also on the *Data Overview* of your device detail page.&#x20;

<figure><img src="https://2165942204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MMKXTFIN5ZlLOjBlfC4%2Fuploads%2F8ZcJbEpzE0Nsvmja1dtG%2Fscreely-1673515850765.png?alt=media&#x26;token=319bdad0-7422-4aca-9a67-f4f28b861fa2" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Currently, all devices are created with a **generic LoRa device profile**. Do not do any changes on the Actility account.
{% endhint %}

### 5. Visualize IoT data with akenza's dashboard composer

In order to visualize your data with the dashboard composer, switch to the dashboard composer by selecting *Dashboard* in the side navigation. You will get redirected to the dashboard overview. Select *Create a Dashboard* and start adding the Widgets of your choice.

By adding the component *Chart*, the Source Tab allows to select the device of your choice and its data points. Customize the dashboard to your liking.

<figure><img src="https://2165942204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MMKXTFIN5ZlLOjBlfC4%2Fuploads%2FZPg44TgHnvukxqVuiEHp%2Fscreely-1673516170125.png?alt=media&#x26;token=0dc40e21-e565-4e1c-82fa-c2fab4f5caf5" alt=""><figcaption><p>Add chart component</p></figcaption></figure>

<figure><img src="https://2165942204-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MMKXTFIN5ZlLOjBlfC4%2Fuploads%2FfmcPiVRUMp7d3CDoZmG8%2Fscreely-1674465227311.png?alt=media&#x26;token=05f67868-5624-42cf-a9de-59338ad3fa2d" alt=""><figcaption><p>Dashboard example in Full Screen</p></figcaption></figure>

{% hint style="info" %}
**Optional**

Try out other akenza features such as the rule engine. The rule engine allows you to apply a business logic to your infrastructure. For E.g. inform your teammates about certain conditions by using MS-Teams as a notification service. Check out more [here](https://docs.akenza.io/akenza.io/tutorials/create-notifications/how-to-send-notifications-to-microsoft-teams).&#x20;
{% endhint %}

{% hint style="success" %}
**Support**

Reach out to us if you need any further support:

* [Actility](https://support.thingpark.org/portal/en/community/recent)
* [Akenza](https://akenza.atlassian.net/servicedesk/customer/portal/4/group/-1)
* [Pepperl+Fuchs](mailto:dmoest@de.pepperl-fuchs.com)
  {% endhint %}