How to integrate the Smart Building Kit with Actility on akenza

In this tutorial, you will learn how to integrate devices from the Smart Building Kit of Milesight with Actility on akenza. This kit is offered on the ThingPark marketplace of Actility.

Smart Building Kit from Milesight

The Smart Building Kit contains:

• 1x IAQ Sensor AM103

• 1x Smart IoT Controller UC300

• 1x Smart Button WS101

• 1x Magnetic Contact Switch WS301

• 1x Spot Leak Detection Sensor EM300-SLD

• 1x LoRaWAN Gateway UG65

Application examples:

• Monitor and visualize when to air a room (AM103)

• Prevent the buildup of mold in infrequently used rooms (AM103)

• Circumvent damage from prolonged water exposure (EM300-SLD)

Product Features:

• Screen and traffic light indicator (AM103)

• Industrial-grade enclosure with IP67 (EM300-SLD only)

• Multiple Press Actions (WS101 only)

You can buy the Milesight Smart Building Kit in the ThingPark marketplace of Actility.

In this tutorial, you will learn how to connect the Milesight Smart Building Kit to akenza. You will achieve the following:

1. Integrating your Actility account to your akenza environment

2. Creating Data Flows and Milesight devices on akenza

3. Creating your individual dashboard for data visualization

1. Getting started

To get started with akenza, follow these steps in order to set up your environment.

2. Add an Actility Integration on akenza

In order to proceed with the Actility integration on akenza, make sure to create a ThingPark community account and pre-commission the Milesight gateway to it as described here. Follow this link if you need to install Actility's firmware on the gateway.

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.

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.

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.

Data Flows consist of a device connector, a device type, and an output connector and define how device data are processed on akenza.

Create Data Flow

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.

Device Detail Page of AM103

Currently, all devices are created with a generic LoRa device profile. Do not do any changes on the Actility account.

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

Fullscreen view of an example dashboard

Optional

Try out other akenza features such as the rule engine. The rule engine allows you to apply a business logic to your infrastructure. E.g. inform your teammates about certain conditions by using MS-Teams as notification service. Check out more here.

Support

Reach out to us if you need any further support:

• Actility

• Akenza

• Milesight

  • [email protected]

  • Technical Support Guidance