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

Actility - Pepperl+Fuchs - akenza Smart Level Monitoring

{% hint style="success" %} **The Kit contains**: * 1 x Pepperl+Fuchs WILSEN.sonic.level **UCC2500** sensor or **UCC4000** sensor * 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** **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/).

Connectivity Integration Setup

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.

Connectivity Integration of Actility

### 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](/akenza.io/get-started/your-data-flow.md). {% 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 %}

Data Flow with Wilsen Device Type

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. 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.
{% 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.

Add chart component

Dashboard example in Full Screen

{% 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](/akenza.io/tutorials/create-notifications/how-to-send-notifications-to-microsoft-teams.md). {% 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 %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.akenza.io/akenza.io/tutorials/iot-starter-kits/how-to-integrate-the-iaq-kit-with-actility-on-akenza-1.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.