Download Print this page
FLIR BRICKSTREAM 3D Gen 2 Programmer's Manual
Hide thumbs Also See for BRICKSTREAM 3D Gen 2:

Advertisement

Quick Links

Programmer's Guide
FLIR
BRICKSTREAM®
3D Gen 2
June 2021
6/24/2021
Names and marks appearing on the products herein are either registered
trademarks or trademarks of FLIR Systems, Inc. and/or its subsidiaries.
© 2015-2021 FLIR Integrated Imaging Solutions Inc. All rights reserved.

Advertisement

loading
Need help?

Need help?

Do you have a question about the BRICKSTREAM 3D Gen 2 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for FLIR BRICKSTREAM 3D Gen 2

  • Page 1 Programmer's Guide FLIR BRICKSTREAM® 3D Gen 2 June 2021 6/24/2021 Names and marks appearing on the products herein are either registered trademarks or trademarks of FLIR Systems, Inc. and/or its subsidiaries. © 2015-2021 FLIR Integrated Imaging Solutions Inc. All rights reserved.
  • Page 2 ACC-POE29U-1AF). L’utilisation de tout autre adaptateur ou injecteur risque d’endommager l’appareil et de causer un incendie ou des blessures. Trademarks Names and marks appearing on the products herein are either registered trademarks or trademarks of FLIR Systems, Inc. and/or its subsidiaries. Licensing...
  • Page 3 Brickstream® 3D Gen 2 Contents Introduction About the Brickstream 3D Gen 2 Sensor Hardware Components Software (Firmware) Components System Architecture Exception Conditions Notes on Time Synchronization and Daylight Savings Time Delivery System Features About Encryption XML Metric Data Delivery Real-Time Data Delivery...
  • Page 4 Unpacking and Using the Video Capture XML Schemas Locating the XML Schema Files Example Metric File Diagnostic Message Key/Value Pairs Diagnostic Heartbeat Message 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 5 Brickstream® 3D Gen 2 Introduction Welcome to the Brickstream 3D Gen 2 sensor. The sensor represents the next generation of video analytics. Brickstream 3D Gen 2 captures and analyzes traffic metrics in a single sensor for retail outlets, malls, transportation hubs, and smart buildings.
  • Page 6 Note: The sensor's firmware version is in the footer of the sensor web interface. An update to firmware may include a separate package to update drivers used by the sensor. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 7 1. Open a database connection 2. Listen for a socket connection 3. Fork a new thread 4. Accept a socket connection 5. Read and parse data 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 8 2:00:00 am time shifts back. Data for the next 60 minutes is collected in the 2:00:00 am time bucket and transmitted in one message. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 9 6 = Pathlinking sensor is offline, where offline is defined as no path linking feature messages received by the master sensor within 5 seconds. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 10 A VLI sample is shown below. It is important to note that the VLI is sent in Little Endian format so you may need to reverse the format in your code if either your code or machine requires Big Endian formatting: 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 11 FTP protocol, if the delivery fails, the device attempts to use active FTP. The use of passive FTP requires that you open the high number (>1024) ports on the server machine. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 12 Contains the count of customer exits for the zone since the zone was created or since the Exit Count last counter reset. 3D Gen 2 IP Contains the IP address of the 3D Gen 2 unit. Address 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 13 <Count StartTime="12:40:00" EndTime="12:45:00" UnixStartTime="1556210400" Enters="0" Exits="0" Status="0"/> <Count StartTime="12:45:00" EndTime="12:50:00" UnixStartTime="1556210700" Enters="0" Exits="0" Status="0"/> <Count StartTime="12:50:00" EndTime="12:55:00" UnixStartTime="1556211000" Enters="0" Exits="0" Status="0"/> <Count StartTime="12:55:00" EndTime="13:00:00" UnixStartTime="1556211300" Enters="0" 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 14 <Service StartTime="12:40:00" EndTime="12:45:00" UnixStartTime="1556210400" NumberServed="0" SecondsOccupied="0" Status="0"/> <Service StartTime="12:45:00" EndTime="12:50:00" UnixStartTime="1556210700" NumberServed="0" SecondsOccupied="0" Status="0"/> <Service StartTime="12:50:00" EndTime="12:55:00" UnixStartTime="1556211000" NumberServed="0" SecondsOccupied="0" Status="0"/> <Service StartTime="12:55:00" EndTime="13:00:00" UnixStartTime="1556211300" 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 15 <Detection StartTime="12:40:00" EndTime="12:45:00" UnixStartTime="1556210400" SecondsOccupied="300" AvgValue="54" Status="0"/> <Detection StartTime="12:45:00" EndTime="12:50:00" UnixStartTime="1556210700" SecondsOccupied="300" AvgValue="54" Status="0"/> <Detection StartTime="12:50:00" EndTime="12:55:00" UnixStartTime="1556211000" SecondsOccupied="299" AvgValue="54" Status="0"/> <Detection StartTime="12:55:00" EndTime="13:00:00" UnixStartTime="1556211300" 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 16 The alert can be configured to send one to five images of the event. Card Scan REST call POST /restapi/gates/[gate]?direction=[enter | exit]&count=[scan count] 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 17 Host: 52.52.31.131:9001 Content-Length: 19809 Connection: Keep-Alive Content-Type: multipart/form-data; boundary=CAMERA.00b09d237247 --CAMERA.00b09d237247 Content-Disposition: form-data; name="data"; filename="CameraData000002.pbs" Content-Type: application/octet-stream "GateID" : "c1",  "eventType" : "Enter", 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 18 The MAC address of the sensor that recorded the event. Occupancy Alerts The following is the JSON payload for the occupancy alert. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 19 See Data Management Architecture for more details. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 20 SNTP (RFC 4330) Brickstream The Brickstream format sets the 3D Gen 2 to use a time synchronization server developed by FLIR to synchronize the 3D Gen 2. This method uses HTTP headers to notify the server that a time synchronization is being attempted. By default, this server runs on port 2010 but can be configured to use other ports.
  • Page 21 Fatal <text> bytes. support@flir.com. Hostname: <text> Filename: <text> Informational message that contains memory Info <text> details with respect to the FLASH memory. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 22 Current DateTime clock. Compare the current value to the last Info value: <text>. Last recorded value, if the difference is greater and 20 Timestamp recorded seconds report it to PCT-support@flir.com. <text> See diagnostic Info Diagnostic message. schema for heartbeat This is a memory dump of calibration data...
  • Page 23 3D Gen 2. When 3D Gen 2s are mounted within the height specification, it is unlikely the event will occur. See the 3D Gen 2 Installation Guide for height specifications. If this error is encountered, contact PCT-support@flir.com. Error <info> Tracking disabled due to undefined disparity.
  • Page 24 REST API Calls Logged Log Message Admin Operator Added BLE tags Deleted BLE tags Updated BLE tags Calibrated device Captured background Updated calibration Cleared events Cleared AVIs 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 25 Updated device manager info Updated device identification Updated network configuration Updated logging info Updated password protection info Updated proxy info Updated tracking info Reset tallies Reset histograms 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 26 Updated global service parameters Updated queue zones Updated service zones Updated {zone type} zones CGI Calls Logged Log Message Admin Operator Got calibration HTML Cleared AVIs 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 27 Generated report Got camera image Configuration exported Got count metrics Got histograms Got camera image Got application parameters Reset license Updated license info Got device credentials Registered image capture client Resending Metrics data Resending Batch data Resending FTP data Reset Timezones CGI Tracking Unregistered image capture client Captured background Imported configuration Rebooted device Upgraded device Got upgrade status 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 28 <Object Id="0" DeviceId="2500-212" Devicename="2500-212" ObjectType="0" Name="CountZone"> <Count StartTime="10:55:00" EndTime="11:00:00" UnixStartTime="1554303300" Enters="2" Exits="4" Status="0"/> </Object> <Object Id="1" DeviceId="2500-212" Devicename="2500-212" ObjectType="1" Name="QueueZone"> <Queue StartTime="10:55:00" EndTime="11:00:00" UnixStartTime="1554303300" 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 29 The content length is set to 0. HTTP/1.1 200 OK HTTP/1.1 400 Bad Request Content-type: text/html Content-type: text/html Connection: close Connection: close Content-Length: 0 Content-Length: 0 <CRLF> <CRLF> 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 30 Date Format Month yyyy Year Hours (24-hour clock) Minutes Seconds In the example above 07172017220705 translates to: July 17, 2019 at 10:07:05 pm. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 31 RP points to the next time bucket of data to be transmitted to a server. Note, RP is only used for configurations which are configured for real-time data delivery. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 32 WP continues to increment and move forward. Pointer Date Time 4/15/2007 10:00:00 ... 4/15/2007 10:01:00 ... RP -> 4/15/2007 10:02:00 ... WP -> 4/16/2007 3:03:00 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 33 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 34 Brickstream® 3D Gen 2 HTTP Server FLIR has provided you with a sample HTTP server that receives data from the sensor. To use the HTTP Server: Note: For descriptions of the HTTP Server Output file format, refer to the file SmartCameraHTTP Format v2.1.pdf in the Docs directory of your download package.
  • Page 35 New connection accepted /192.168.1.7:57360 Entering the Read Method Exiting the Read Method Sent a TimeSync Response Entering the Read Method Socket closed 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 36 This command decodes the DAT file from the 3D Gen 2 and outputs the AVI and CSV files required to complete the validation. Files are created in the same directory where the DAT files are located. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 37 5 seconds. BSCamera-v6.xsd Support for occupancy zones. 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 38 <ServiceTime StartTime="10:56:25" EndTime="10:56:52" UnixStartTime="1554303413" Duration="27" Id="1830851"/> <ServiceTime StartTime="10:57:13" EndTime="10:57:41" UnixStartTime="1554303462" Duration="28" Id="1830855"/> <ServiceTime StartTime="10:58:40" EndTime="10:58:57" UnixStartTime="1554303538" Duration="17" Id="1830863"/> </DwellTimes> </Object> <Object Id="3" DeviceId="2500-212" Devicename="2500-212" ObjectType="6" 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 39 Diagnostic Message Key/Value Pairs The following table shows the key value pairs contained in the diagnostic messages: Value NUM_OF_REBOOTS count TOTAL_FRAMES_PROC count ELAPSED_RESET_SEC seconds 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 40 TRACKING_SHUTTER integer PCT_UNDEFINED integer percentage (0-100) PCT_GROUNDPLANE integer percentage (0-100) TRACKING_GAIN_CONTROL integer SATURATION_BIN integer DYNAMIC_RANGE integer AVERAGE_INTENSITY integer NOISE_LEVEL integer RTC_ALARM_STATUS integer 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 41 <Value>9079983</Value> </Stat> <Stat> <Key>ELAPSED_RESET_SEC</Key> <Value>610433</Value> </Stat> <Stat> <Key>LAST_REBOOT_TIME</Key> <Value>03/27/2019 12:51:35</Value> </Stat> <Stat> <Key>LAST_TALLY_RESET_TIME</Key> <Value>03/27/2019 12:51:35</Value> </Stat> <Stat> <Key>TOTAL_TIMESYNCS</Key> <Value>678</Value> </Stat> <Stat> <Key>TOTAL_FAILED_TIMESYNCS</Key> 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 42 <Value>32</Value> </Stat> <Stat> <Key>DYNAMIC_RANGE</Key> <Value>203</Value> </Stat> <Stat> <Key>AVERAGE_INTENSITY</Key> <Value>140</Value> </Stat> <Stat> <Key>NOISE_LEVEL</Key> <Value>0</Value> </Stat> <Stat> <Key>CAMERA_HEIGHT</Key> <Value>245</Value> </Stat> <Stat> <Key>X_ROTATION</Key> <Value>25</Value> </Stat> 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.
  • Page 43 <Value>1</Value> </Stat> <Stat> <Key>FOCAL_LENGTH</Key> <Value>144.9335</Value> </Stat> <Stat> <Key>BASE_LINE</Key> <Value>0.1200</Value> </Stat> <Stat> <Key>X_CENTER</Key> <Value>201.1833</Value> </Stat> <Stat> <Key>Y_CENTER</Key> <Value>116.4127</Value> </Stat> <Message>Heart Beat</Message> </Event> </Diags> 6/24/2021 Brickstream® 3D Gen 2 Programmer's Guide ©2015-2021 FLIR Integrated Imaging Solutions Inc. June 2021 All rights reserved.