Percept API

Output Data Format

Output API Overview

Object List

The Object list is generated on every incoming Point Cloud Frame and contains the following Data:

Table 1. Object List
Field Description

header

The message header consists of (Project UUID, Project Name and a Timestamp (UTC))

reference_frame

The reference frame the geometry is expressed in

objects

The list of objects (see Object for a description of all fields inside object)

Table 2. Object
Field Description

timestamp

Timestamp of measurement

uuid

A UUID, with which the object can be identified

pose

The position and orientation of the object

linear_velocity

The linear velocity of the object

angular_velocity

The angular velocity of the object

shape

The shape representing the object (bounding box)

classification

Placeholder for future versions

path

List of the last poses including the current pose

State List

The State list is generated on every incoming Point Cloud Frame and contains the following Data:

Table 3. State List
Field Description

header

Message header consists of (Project UUID, Project Name and a Timestamp (UTC))

states

List of states (see States for a description of all fields inside state)

Table 4. States
Field Description

timestamp

Timestamp of the LiDAR frame in which the state was measured

zone_algorithm_uuid

The UUID of the zone algorithm generating this state

state_type

The type of the current state: counter, accumulated_counter, security, occupancy

Table 5. counter
Field Description

count

The value of the counter

type

The type of the counter, one of (INBOUND (counting entries), OUTBOUND (counting exits), INSIDE (counting the current number of objects))

Table 6. accumulated_counter
Field Description

count

A counter which increases over time starting at '0' at the timestamp 'start_of_count'. The 'count' and 'start_of_count' is automatically reset in certain intervals to prevent integer overflows.

type

Type of the counter (INBOUND (counting entries), OUTBOUND (counting exits))

start_of_count

Timestamp representing the starting time of the counter

Table 7. security
Field Description

alarm

Alarm state of a zone (true (alarm), false (no alarm))

num_detected_points

The current number of LiDAR points detected inside the zone raising the alarm

Table 8. occupancy
Field Description

occupied

Occupancy state of a zone (true (occupied), false (empty))

num_detected_points

The current number of LiDAR points detected inside the zone

You will only receive a State List if you have a Zone configured

Encoding

Percept provides different encoding formats for the output data. You can choose between either protocol buffer or JSON.

JSON

In comparison to the Protocol Buffer (Protobuf) the JSON encoding is human readable. The file size/data transmitted will be larger with this encoding format.

If you use the JSON encoding you don’t need the bf_proto package to be installed to parse the data.
Example Object List JSON Output
[{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:25Z"},"referenceFrame":"map","objects":[]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:25Z"},"referenceFrame":"map","objects":[]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:26Z"},"referenceFrame":"map","objects":[{"uuid":"500afe04-6a64-4bfa-a782-908adad331ef","pose":{"position":{"x":-14.1206198,"y":5.44104481,"z":0},"orientation":{"x":0,"y":0,"z":0.177404106,"w":0.984138072}},"linearVelocity":{"x":0.0187638216,"y":0.00699206861,"z":0},"angularVelocity":{"x":0,"y":0,"z":0},"shape":{"pose":{"position":{"x":-14.1439028,"y":5.44641447,"z":1.91552877},"orientation":{"x":0,"y":0,"z":0.0789654702,"w":0.996877372}},"box":{"dimensions":{"x":0.766963,"y":0.192871,"z":2.08492}}},"path":[{"position":{"x":-14.1206198,"y":5.44104481,"z":0},"orientation":{"x":0,"y":0,"z":0.177404106,"w":0.984138072}}],"timestamp":"2021-11-10T07:54:35.479706Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:26Z"},"referenceFrame":"map","objects":[{"uuid":"500afe04-6a64-4bfa-a782-908adad331ef","pose":{"position":{"x":-14.1152611,"y":5.44304228,"z":0},"orientation":{"x":0,"y":0,"z":0.177403837,"w":0.984138131}},"linearVelocity":{"x":0.0187638346,"y":0.00699206162,"z":0},"angularVelocity":{"x":0,"y":0,"z":0},"shape":{"pose":{"position":{"x":-14.1439028,"y":5.44641447,"z":1.91552877},"orientation":{"x":0,"y":0,"z":0.0789654702,"w":0.996877372}},"box":{"dimensions":{"x":0,"y":0,"z":0}}},"path":[{"position":{"x":-14.1206198,"y":5.44104481,"z":0},"orientation":{"x":0,"y":0,"z":0.177404106,"w":0.984138072}},{"position":{"x":-14.1152611,"y":5.44304228,"z":0},"orientation":{"x":0,"y":0,"z":0.177403837,"w":0.984138131}}],"timestamp":"2021-11-10T07:54:35.765340Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:26Z"},"referenceFrame":"map","objects":[{"uuid":"500afe04-6a64-4bfa-a782-908adad331ef","pose":{"position":{"x":-14.1099014,"y":5.44503975,"z":0},"orientation":{"x":0,"y":0,"z":0.177404106,"w":0.984138072}},"linearVelocity":{"x":0.0187638402,"y":0.00699207559,"z":0},"angularVelocity":{"x":0,"y":0,"z":0},"shape":{"pose":{"position":{"x":-14.1439028,"y":5.44641447,"z":1.91552877},"orientation":{"x":0,"y":0,"z":0.0789654702,"w":0.996877372}},"box":{"dimensions":{"x":0,"y":0,"z":0}}},"path":[{"position":{"x":-14.1206198,"y":5.44104481,"z":0},"orientation":{"x":0,"y":0,"z":0.177404106,"w":0.984138072}},{"position":{"x":-14.1152611,"y":5.44304228,"z":0},"orientation":{"x":0,"y":0,"z":0.177403837,"w":0.984138131}},{"position":{"x":-14.1099014,"y":5.44503975,"z":0},"orientation":{"x":0,"y":0,"z":0.177404106,"w":0.984138072}}],"timestamp":"2021-11-10T07:54:36.050978Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:26Z"},"referenceFrame":"map","objects":[{"uuid":"500afe04-6a64-4bfa-a782-908adad331ef","pose":{"position":{"x":-14.1045437,"y":5.44703722,"z":0},"orientation":{"x":0,"y":0,"z":0.17740415,"w":0.984138072}},"linearVelocity":{"x":0.0187638402,"y":0.00699207699,"z":0},"angularVelocity":{"x":0,"y":0,"z":0},"shape":{"pose":{"position":{"x":-14.1439028,"y":5.44641447,"z":1.91552877},"orientation":{"x":0,"y":0,"z":0.0789654702,"w":0.996877372}},"box":{"dimensions":{"x":0,"y":0,"z":0}}},"path":[{"position":{"x":-14.1206198,"y":5.44104481,"z":0},"orientation":{"x":0,"y":0,"z":0.177404106,"w":0.984138072}},{"position":{"x":-14.1152611,"y":5.44304228,"z":0},"orientation":{"x":0,"y":0,"z":0.177403837,"w":0.984138131}},{"position":{"x":-14.1099014,"y":5.44503975,"z":0},"orientation":{"x":0,"y":0,"z":0.177404106,"w":0.984138072}},{"position":{"x":-14.1045437,"y":5.44703722,"z":0},"orientation":{"x":0,"y":0,"z":0.17740415,"w":0.984138072}}],"timestamp":"2021-11-10T07:54:36.336611Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:27Z"},"referenceFrame":"map","objects":[]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:27Z"},"referenceFrame":"map","objects":[]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:27Z"},"referenceFrame":"map","objects":[]}]
Example State List JSON Output
[{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:38Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:47.761920Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:47.761920Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:38Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:48.047553Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:48.047553Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:38Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:48.333186Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:48.333186Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:39Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:48.618819Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:48.618819Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:39Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:48.904451Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:48.904451Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:39Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:49.190084Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:49.190084Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:40Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:49.475717Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:49.475717Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:40Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:49.761349Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:49.761349Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:40Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:50.046982Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:50.046982Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:40Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:50.332615Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:50.332615Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:41Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:50.618248Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:50.618248Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:41Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:50.903881Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:50.903881Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:41Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:51.189513Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:51.189513Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:42Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:51.475146Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:51.475146Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:42Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:51.760778Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:51.760778Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:42Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:52.046411Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:52.046411Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:42Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:52.332044Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:52.332044Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:43Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:52.617677Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:52.617677Z"}]}
,{"header":{"projectUuid":"2e002423-2a75-4af4-b521-b41698df7956","projectName":"Example","timestamp":"2021-12-15T17:02:43Z"},"states":[{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":2,"type":"INBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:52.903309Z"},{"zoneAlgorithmUuid":"cc85e0d0-a9af-4597-acb8-59a3a297f786","accumulatedCounter":{"count":0,"type":"OUTBOUND","startOfCount":"2021-11-10T07:53:59.775621Z"},"timestamp":"2021-11-10T07:54:52.903309Z"}]}]

Protocol Buffer (Protobuf)

While JSON is human readable, the protobuf encoding is save/send in binary format. Therefore the protobuf encoding needs less disc space/bandwidth and is recommended to use e.g. via MQTT.

Parse Percept Protocol Buffer

To parse the data, you need our bf_proto package, which is included with Percept. It contains Python and Javascript packages, as well as debian packages for C++ and protobuf source code so that you can compile it yourself.

Install Percept Protobuf for Python

The python code is available as a pip package in the directory pip. You can install bf_proto python package inside the bf_proto directory with the following command:

pip install -e ./pip/*

The package and its modules are imported as conventional pip-packages:

import bf_proto.percept.output.output_pb2
Install Percept Protobuf for Javascript

The JavaScript code is available as a npm package in the directory npm. To install it in your environment you can either use npm or yarn:

npm install ./npm/*
yarn add ./npm/*

The package is handled as a commonjs type:

import { ObjectList } from "bf_proto/percept/output/output_pb.js";
Install Percept Protobuf for C++ (Debian Package)

The C++ code is available as a debian package in the directory debian. In order to use it within your code development it is recommended to install it to your system:

dpkg -i ./debian/*

The package can be used as a library:

#include <bf_proto/percept/output/output.pb.h>

Output Options

There are different ways to get the Output of Percept. You can see the output on the Web UI from Percept, Write Data to File and/or Publish Data to MQTT.

Write Data to File

Percept allows you to store the data into files. The files will be written to a subdirectory of the project.

The files can be found in your percept directory under /data/projects/project_uuid/file_stream/.

There you will find the object_lists and/or state lists encoded as JSON or Protocol Buffer (Protobuf) based on your selection.

You have to replace the project_uuid with the UUID of your project in /data/projects/project_uuid/file_stream/. See How to get the UUID of a Project

Check out Project Setup - Output Options for the user interface of the output settings.

Publish Data to MQTT

Percept allows you to receive the data via MQTT.

You will receive the MQTT messages on the following Topics, e.g. for Json encoding:

  1. blickfeld/project_uuid/json/Statelist

  2. blickfeld/project_uuid/json/Objectlist

You have to replace the project_uuid with the UUID of your project, see How to get the UUID of a Project.

Check out Project Setup - Output Options for the user interface of the output settings.

How to get the UUID of a Project

You can get the ProjectUUID of your project while hovering with your mouse over the icon next of your project in the overview, see image below.

How to find the Project UUID
Figure 1. How to find the ProjectUUID of your Project

As an alternative you can also export the zone list, there you will also find the project name and UUID inside the downloaded file.