Percept API
Output Data Format
Object List
The Object list is generated on every incoming Point Cloud Frame and contains the following Data:
| 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) |
| 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:
| 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) |
| 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 |
| 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)) |
| 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 |
| 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 |
| 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 |
| Field | Description |
|---|---|
volume |
The current volume measured inside the zone (in cubic meter) |
| 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. |
[{"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":[]}][{"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_pb2Install 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:
-
blickfeld/project_uuid/json/Statelist
-
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. 
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. |