How to integrate the CoWork Kit with Actility on akenza

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

CoWork Kit from Milesight

The CoWork Kit contains:

• 1x AI Workplace Occupancy Sensor VS121

• 1x Smart Scene Panel WS156

• 1x Magnetic Contact Switch WS301

• 1x PIR & Light Sensor WS202

• 1x Smart Button WS101

• 1x LoRaWAN Gateway UG65

Application examples:

• Measure people flow of an area, entry or exit (VS121)

• Switch the status of your smart workplace between up to six scenes (WS156)

• Detect window and door status and its usage (WS301)

• Monitor Room usage (WS202)

Product Features:

• 98% Occupancy recognition rate (VS121)

• Easy NFC-Configuration (all sensors)

• Long battery life lasting (depending on the device)

You can purchase the Milesight CoWork Kit in the ThingPark marketplace of Actility.

In this tutorial, you will learn how to connect the Milesight CoWork 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