TeraBee TB-PCL-XL-W User Manual

People counting l-xl
Table of Contents

Advertisement

Quick Links

Terabee People Counting L-XL
User manual
PoE Model
LoRa Model
Document version 3.0
Technical support:
terabee.com/support
Sales and commercial support:
terabee-sales@terabee.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the TB-PCL-XL-W and is the answer not in the manual?

Questions and answers

Summary of Contents for TeraBee TB-PCL-XL-W

  • Page 1 Terabee People Counting L-XL User manual PoE Model LoRa Model Document version 3.0 Technical support: terabee.com/support Sales and commercial support: terabee-sales@terabee.com...
  • Page 2: Example

    If you have any questions or remarks regarding the product, please contact your commercial representative or our support team here: terabee.com/support Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 3: Table Of Contents

    5.1.2.  Drawing of the counting area by clicking on the image 5.1.3. Drawing the counting area by entering the points manually Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 4 12. Javascript Decoder for LoRa Payload 12.1. People counting data (Uplink only) 12.2. People counting device management 12.2.1. Reset count Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 5 14.3. Force the device to reboot 14.4. I am not able to access the web GUI 14.4.1. LED check Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 6 14.15. I can’t fix my issue 15. Technical data 15.1. Dimensions 15.2. Technical specifications Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 6 / 120...
  • Page 7: General Information And Important Notice

    LAN network and a host such as a cloud platform or web server able to receive HTTP(S) or MQTT(S) payloads. Please note that Terabee delivers only the hardware product. The rest of the LAN infrastructure should be handled by the user.
  • Page 8: Sku Information

    WiFi access point and a LoRa gateway able to receive the LoRa packets and send them to a network server. Please note that Terabee delivers only the hardware product. The rest of the LoRaWAN infrastructure should be handled by the user.
  • Page 9: Safety And Regulatory Statement

    PoE (for the PoE version) or on a wireless LoRaWAN network (for the LoRa version). Changes or modifications to this product not expressly approved by Terabee could void its compliance to test standards and negate the user’s authority to operate it. The product comes with plastic film protection on the black optical part.
  • Page 10 Les changements ou modifications apportés à ce produit sans l'approbation expresse de Terabee peuvent annuler sa conformité aux normes de test et annuler le droit de l'utilisateur à le faire fonctionner. Le produit est livré avec un film plastique de protection sur la partie optique noire.
  • Page 11 PoE (voor PoE versie) of op een draadloos LoRaWAN netwerk (voor LoRa versie). Wijzigingen of aanpassingen aan dit product die niet uitdrukkelijk door Terabee zijn goedgekeurd, kunnen de conformiteit met de testnormen tenietdoen en de bevoegdheid van de gebruiker om het te bedienen tenietdoen. Het product wordt geleverd met een plastic filmbescherming op het zwarte optische gedeelte.
  • Page 12: Safety Instructions

    Ändringar eller modifieringar av den här produkten som inte uttryckligen godkänts av Terabee kan göra dess överensstämmelse med teststandarderna ogiltig och förneka användarens behörighet att använda den. Produkten levereras med ett plastfilmsskydd på den svarta optiska delen. Detta hjälper till att förhindra damm och repor under transporten och innan enheten installeras.
  • Page 13 IEC 62368-1: 2014, (3) för PoE-versionen använda PoE-standarden IEEE 802.3af, (4) strömförsörja enheten i enlighet med vad som framgår av ovanstående scheman. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 14: Eu Regulatory Statements

    Please contact us via terabee.com/support. FR Le fabricant, Terabee SAS (90 rue Henri Fabre, 01630 Saint-Genis-Pouilly, France) déclare par la présente que le People Counting L-XL est conforme aux directives européennes RED et RoHS.
  • Page 15 IT Questo simbolo indica che il prodotto deve essere smaltito secondo le leggi e le normative locali, senza mescolarlo con i rifiuti urbani non differenziati. Quando il prodotto raggiunge la fine del suo ciclo di vita, contattare Terabee o le autorità locali per Copyright © Terabee 2022...
  • Page 16 Cuando su producto llegue al final de su vida útil, póngase en contacto con Terabee o con las autoridades locales para conocer las opciones de reciclaje. El tratamiento y el reciclaje adecuados de su producto ayudarán a conservar los recursos naturales y a proteger el...
  • Page 17 SE Den här symbolen visar att enheten kräver kontinuerlig likström. OBS: PCL-XL LoRa-versionen måste drivas av en 5V DC - 2,5 A. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 18: Regulatory Statements

    1.4.4. UK Regulatory statements The manufacturer, Terabee SAS (90 rue Henri Fabre, 01630 Saint-Genis-Pouilly, France) hereby declares that the People Counting L-XL complies with UKCA Directives. 1.4.5. US and Canada Regulatory statements This equipment complies with FCC/ISED radiation exposure limits set forth for an uncontrolled environment.
  • Page 19: Package Contents

    ● Mounting plate x1 ● Concrete screws and wall plug x3 ● Plaster screws and wall plug x3 Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 20: Connectivity Requirements

    1.6.3. Data traffic The current rough estimate: 20 MiB daily (15 MiB down and 5 MiB up) for the PoE version. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 21: Prerequisites

    If you cannot fulfill one or several points mentioned above, or if you are unsure about one of the above, please contact your commercial representative or our support team here: terabee.com/support. We will help you resolve any problems. Copyright © Terabee 2022...
  • Page 22: Device Installation

    3.1. Guidelines and recommendations for installation 3.1.1. Installation height and wall clearance The Terabee People Counting L-XL is designed for installation on the ceiling. The size of the monitored area varies depending on the installation height. The higher the device is installed, the wider the monitored area will be.
  • Page 23: Sunlight Exposure

    3.1.2. Sunlight exposure The Terabee People Counting L-XL works in the infrared wavelength, just like the sun, which can affect the device's operation. To avoid any problem, installing the device inside your building where the sun's reflection is not projected onto the ground is recommended.
  • Page 24: People Counting Id Card

    3.1.4. People Counting ID card This is the Terabee People Counting L-XL identification card. It connects to the device to set the parameters and record the location information once the device is installed. Scanning the QR code on the left allows you to connect to the device. The empty fields on the right side allow you to record information during the installation.
  • Page 25 When the device is in lock position, it is securely fixed and can be connected to the power (PoE or 5 V - 2.5 A) Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 26: Device Placement

    3.1.6. Device placement Pay attention that the Terabee People Counting L-XL is installed directly on the ceiling, centered on the door axis. It works similarly if installed on both sides of the door. However, the installation is easier if the device is installed on the opposite side from the door swing direction.
  • Page 27: Mounting Instructions

    We recommend looking at section 3.1. Guidelines and recommendations to understand all the Terabee People Counting L-XL installation aspects. To install your People Counting L-XL follow these steps Locate and mark the device position on the ceiling ➔ Identify the central door axis ➔...
  • Page 28 Mark the holes to drill Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 28 / 120...
  • Page 29 Drill the holes in the ceiling Install the mounting plate with the supplied screws Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 29 / 120...
  • Page 30 Before installing the device, make sure to remove the plastic film on the optical part Match the mounting plate fins pattern with the device back part Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 31 Position the device onto the mounting plate Clip the device on the mounting plate by rotating it to the right until it clicks Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 32: Mounting Instructions Above A Door Swing

    Once the alignment is located, you can follow the installation steps from 2 to 9 of the previous section. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 33: Web Gui Access

    Once on the Login page, connect using the following credentials: Username: people_counting_admin Password: <device_id>--admin (for example b827eb6abb6f--admin) Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 33 / 120...
  • Page 34: Access The Web Gui Via Wi-Fi Ap Connection

    : PCL-XL_31cc2a WiFi Password : PCL 31cc2a Once connected, you can access the web GUI on IP: 192.168.4.1 Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 35 Once on the Login page, connect using the following credentials: Username: people_counting_admin Password: <device_id>--admin (for example b827eb6abb6f--admin) Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 35 / 120...
  • Page 36: Quick Device Setup

    Entry area without going out of the device field of view, and then comes back to the Exit area and leaves the field of view, the person won’t be counted. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 37: Drawing Of The Counting Area By Clicking On The Image

    Make sure the border of the counting area touch the image edges Make sure to leave a margin around the entrance Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 38 4. Continue to place the points to draw your “In” zone Point list gives: [[0,0],[79,0],[79,59],[59,59],[51,38],[19,38], [0,59]] Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 38 / 120...
  • Page 39: Drawing The Counting Area By Entering The Points Manually

    Each point of the area will be defined as such : [[x1,y1], [x2,y2] [x3,y3], [x4,y4], ...] and the last point will be linked automatically to the first one. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 40: Device Image Interpretation

    IN. Then, the area drawn (in yellow) defines the cohesive area as an Entry area and the door opening as an Exit area. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 41 The drawing area defines the meeting room as an Entry area while the door opening and the door swing, an Exit area. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 42: Example 3

    Here, since the flow is straightforward, we define the left half of the image as an Entry area and the other half as an Exit area. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 43: Example 4

    IN. The Entry area is then defined on the right half of the image as an Entry area and the other half as an Exit area. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 44: Necessary Tools And Accessories

    5.2. Necessary tools and accessories Included accessories People Counting L-XL x1 People Counter ID card x1 Terabee People Counting Setup App Not included Smartphone or computer Watch video tutorial https://youtu.be/0-tvMGTF4Lc 5.3. Configuration steps Once logged into the web GUI (see section 4.
  • Page 45 Click on the button to save the new settings Finally, click on the “Apply Parameters” button to save all settings and restart the device Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 46: Next Step After Setting Up Your Device

    For direct data push to a third-party host or LoRa communication (LoRa version), please refer to section 6. Advanced settings. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 47: Advanced Settings

    To communicate the counting data to a third-party host via MQTT or HTTP or to a gateway via LoRa, tick the “Enable custom data push” box. To communicate the counting data to the Terabee IoT Platform, tick the “Enable secondary push to Terabee” box.
  • Page 48: Mqtt Configuration (Poe Version)

    6.1.1. MQTT configuration (PoE version) Select the MQTT protocol Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 48 / 120...
  • Page 49 Server MQTT broker/server domain, or address which can be in the following format (depending on the server location): iot.terabee.com or the direct IP address without adding “mqtt://” at the beginning Port, TCP/IP port 1883 is reserved with IANA for use with MQTT...
  • Page 50 Parameters page Finally, click on the “Apply Parameters” button to register all settings and restart the device Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 51: Http-Get/Http-Post Configuration (Poe Version)

    Push URL field where the device should push data to in the following format: “http://host_url” or “https://host_url” for a secured connection Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 52 Parameters” button to save the data push settings Click on the “Standard Parameters” button to come back to the Standard Parameters page Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 53: Lora Configuration (Lora Version)

    Finally, click on the “Apply Parameters” button to register all settings and restart the device 6.1.3. LoRa configuration (LoRa version) Select the LoRa protocol Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 54 Application Key (AppKey) is a 128-bit application encryption key to secure communication between the device and the network. AppKey field is automatically pre-filled with device-specific code Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 55 Device Address (DevAddr) is a 32-bit code identifying the end device within the network LoRa region frequency: Depending on the ordered Terabee device version, select between EU (868 MHz) or US (915 MHz) (not adjustable) Adaptive Data Rate: Enables the system to set data rate and spreading factor for optimal performance automatically.
  • Page 56 Parameters page Finally, click on the “Apply Parameters” button to register all settings and restart the device Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 57: String Formatting

    Example JSON payload format: {{"type":"counters", "value":{{"in":{nb_in}, "out":{nb_out}}}}} Will result in the following payload: {"type":"counters", "value":{"in":<number of entries>, "out":<number of exits>} Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 58: Network Settings (Poe Version)

    6.2. Network settings (PoE version) 6.2.1. Setting up a static IP By default, the Terabee People Counting L-XL is configured in DHCP mode, meaning its IP address is automatically assigned by the DHCP server available on the local network. In case no DHCP server is available on the local network, or if you don’t want the device to acquire an IP address automatically, you can set up a static IP through the device’s...
  • Page 59 1.1.1.1 or 8.8.8.8 if allowed Click on the button “Save Network Parameters” to save the modifications Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 60 Setting a static fallback configuration has no effect when a DHCP server is available. This fallback configuration only activates in case no DHCP server is present on the network. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 61: Disabling Static Ip Fallback

    The values shown in the fields are the ones previously set by the user and don’t reflect the currently active ones Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 62 Parameters page Finally, click on the “Apply Parameters” button to register all settings and restart the device Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 63: Multi-Device Installation And Setup

    Terabee uses the terms Coordinator and Subordinate. The "coordinator" device acts as the primary device. It receives information from "subordinate" devices, processes it, and sends the resulting data to the Terabee IoT Platform and/or a third-party server or cloud platform.
  • Page 64: Guidelines And Recommendations

    1. Align the devices and give the same direction 2. Respect a maximum distance between devices, considering the installation height Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 64 / 120...
  • Page 65 3.3. Mounting instructions. Please note that each device must be connected to the same ethernet network Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 66: Coordinator And Subordinate Principle

    (side of the LED). Please orientate the black optical part on the opposite side of the door (as seen in the above picture). Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 67 Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 67 / 120...
  • Page 68: Device Camera Mode

    When the multi-device functionality is enabled, the counts operate on all devices. The coordinator device aggregates the data and pushes it to the Terabee IoT Platform (if the option is enabled) and/or to the configured platform or server. By default, a subordinate device does not push any data.
  • Page 69 OUT or IN) only applies to the coordinator and the global area. The subordinates' areas merged without considering their respective “reverse_direction” parameter. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 69 / 120...
  • Page 70: Configure The Coordinator Device

    Access the Multi-Device Parameters page by clicking on the button in the top right corner In the device role field, select “Coordinator” function to activate the functionality Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 71 Please note that once an offset distance has been registered for a subordinate, you need to set this offset distance to 0 to remove the associated subordinate from the multi-device setup. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 72 Click on the “Standard Parameters” button to return to the Standard Parameters page Under the Standard Parameters page, set the camera mode as A Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 73: Configure A Subordinate Device

    To configure a Subordinate device, use the following steps: Access the Multi-Device Parameters page by clicking on the button in the top right corner Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 74 Enter the coordinator local address (same as the web GUI) or IP address Click on the “Save Subordinate Parameters” button to save the settings Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 75 Under the Standard Parameters page, set the camera mode depending on the subordinate position and as described in the picture below Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 76 Click on “Save parameters” button to register the camera mode Finally, click on the “Apply Parameters” button to save all settings and restart the device Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 77: Local Data Download

    ● “Time” corresponds to the Unix timestamp, to be converted ● “In” corresponds to the entries ● “Out” corresponds to the exits Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 78: Credentials Modification

    Fill the username fields with the username you want to log in with Click on “Update Username” Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 79 Confirm your new password Click on “Update Password” button Please note that you will be automatically logged out Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 80: Device Update

    Fill the username field with the same username to connect to the web GUI Fill the password field with the same password to connect to the web GUI Click on “Login” button Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 81 Click on the “FILE” button and select the update files provided by Terabee Once the file is selected, click on upload, a new window will pop up Click on “Confirm” to launch the process. Do not power off the device during this process.
  • Page 82: Local Device Management Api On Lan Network

    ● 403 -> Forbidden (See section 11.2. API authentication) ● 500 -> Error while processing request Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 82 / 120...
  • Page 83: Api Authentication

    Which, in base 64, gives the following: cGVvcGxlX2NvdW50aW5nX2FkbWluOmI4MjdlYjZhYmI2Zi0tYWRtaW4= Then the final header would be formatted as follows: Authorization: Basic cGVvcGxlX2NvdW50aW5nX2FkbWluOmI4MjdlYjZhYmI2Zi0tYWRtaW4= Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 84: Javascript Decoder For Lora Payload

    12. Javascript Decoder for LoRa Payload Terabee offers an open-source javascript decoder for data payloads. The decoder is designed to be compatible with TheThingsNetwork, but the core decoding logic can be reused for other environments. Uplinks can be divided into three main categories: 1.
  • Page 85: People Counting Data (Uplink Only)

    WIFI_AP_ENABLED The wifi access point is enabled. One unique message containing the cumulative counts is sent per standard uplink Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 86: People Counting Device Management

    This command is used to get the current count values. The device will answer with two unsigned big-endian 32-bit integers. CMD downlink Byte 0 GET COUNT Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 86 / 120...
  • Page 87: Reboot

    Byte 1 Byte 2 PEOPLE COUNTING ACK = 00 AGENT RESTART NACK = FF Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 87 / 120...
  • Page 88: Get Software Version

    MINOR (uint8) PATCH (uint8) FAN SERVICE SW VER MAJOR (uint8) MINOR (uint8) PATCH (uint8) Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 88 / 120...
  • Page 89: Access Point

    Byte 1 Byte 2 SET ACCESS POINT STATE ACK = 00 NACK = FF Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 89 / 120...
  • Page 90: Force Rejoin

    Byte 0 Byte 1 Byte 2 FORCE REJOIN ACK = 00 NACK = FF Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 90 / 120...
  • Page 91: Force Time Synchronization

    Byte 0 Byte 1 Byte 2 FORCE TIME SYNC ACK = 00 NACK = FF Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 91 / 120...
  • Page 92: People Counting Device Parameters

    This command is used to set the push period in minutes. Specified as one big-endian 16-bit integer. Valid range is from 1 to 1440 minutes (1 day). Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 93: Get Mounting Height

    Byte 0 Byte 1-2 GET PUSH PERIOD Time interval between pushes in min (uint16) Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 93 / 120...
  • Page 94: People Counting Area

    This FPort is dedicated to getting the current counting area. CMD downlink Byte 0 GET PEOPLE COUNTING AREA Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 95: Set People Counting Area

    Byte 1 Byte 2 SET PEOPLE COUNTING AREA ACK = 00 NACK = FF Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 95 / 120...
  • Page 96: Recommendations For Device Deployment

    Here are a few tips and good practices during a device deployment. This can work for small as well as large deployments. Please note that Terabee experts are here to help during each of these phases if you would like to have some help.
  • Page 97: Check Installation Dimensions

    Pro tip: Before the installation, indicate the ID installation on the device with a sticker to save time during installation. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 98: After The Installation

    4. Camera mode set between A, B, C, and D All these elements can be aggregated inside a global table. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 99: Troubleshooting

    PoE version: Server not reachable or push rejected LoRa version: Device not joined yet Table 1: LED status indicators for standard operating mode Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 100: Multi-Device Led State For Coordinator Device

    ID on coordinator) invalid counting line ○ Table 3: LED status indicators for subordinate Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 100 / 120...
  • Page 101: The Device Doesn't Seem To Boot Or Is Blocked

    Please refer to section 7. Multi-device installation and setup Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 102: Force The Device To Reboot

    Once connected to the network, open your web browser and access the device web GUI via the following local address: http://terabee-<device_id>.local or the assigned IP address Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 103: Device Ip Check

    To find the device IP, you can use a network scan application such as Fing discover the device. It should appear with the following name: “Terabee-<device_id>”. Once you have the IP address, you can type it in your web browser to connect to the web GUI.
  • Page 104: I Cannot Connect To The Web Gui

    When you click the “Launch image refresh” button, you should see frames arriving, as shown in the picture below. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 105: The Device Image Seems Strange

    14.2. 2. If all the LEDs are green, check the next point Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 106: The Device Image Is Blinking

    To solve this problem, connect to the web GUI, go to the Standard Parameters page, and change the multi-camera mode to another. You can choose between four modes. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 107: The Image On The Web Gui Is Fixed; I Can't See People Passing Below The Device

    14.2. 2. If all the LEDs are green, check the next point Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 108: The Device Seems To Be Down; I Don't Receive Data Onto My Server Or Platform

    3. Connect to the web GUI and verify your HTTP push settings (please refer to section 6.1.2. for more details): Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 109 If you use the push on event feature, make sure it is ticked In case all the parameters are correctly set, click on the register button Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 110 4. Connect to the web GUI and verify your MQTT push settings (please refer to section 6.1.1.): Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 111 You will have to monitor the protocol activated (HTTP post, HTTP get, MQTT) on the device's IP. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 112: I Can't Modify Or Record Parameters On The Device

    The device reset occurs daily and at a fixed hour when the parameter is activated and set. Verify that the daily reset box is ticked and the reset hour is correct Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 113: The Device Does Not Seem To Count Correctly

    Install the device in a location where direct sunlight exposure can be avoided or minimized. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 114 Check section 3.4. for more details. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 115: Configuration Check

    Create two distinct zones - One Entry and one Exit area defined by the counting area you draw on the device picture: Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 116 Once you have installed the device onto the ceiling, measure the distance between the ground and the device. Indicate this value in the “Camera Height” parameter and in millimeters. Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 117: I Can't Fix My Issue

    ● Outbound: ○ 53 (DNS) ○ 80/443 (HTTP) ○ 1883/8883 (MQTT) ● Inbound: None ● Domains to whitelist: *.terabee.com Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0...
  • Page 118: Technical Data

    Real-time or at predefined time Predefined time intervals communication intervals (minimum of 2 minutes) Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 118 / 120...
  • Page 119 LoRa communication Supported LoRaWan frequencies EU 863-870 MHz, US 902-928 LoRaWAN activation methods OTAA, ABP Copyright © Terabee 2022 Terabee, 90 rue Henri Fabre Terabee People Counting L-XL 01630 Saint-Genis-Pouilly, France (next to CERN) User manual Version 3.0 119 / 120...
  • Page 120 ® are registered trademarks in the following countries: China, European Union, France, South Korea, Switzerland,Taiwan, United Kingdom and United States. Terabee reserves the right to make changes, corrections, modifications or improvements to this document, and the products and services described herein at any time, without notice.

This manual is also suitable for:

Tb-pcl-xl-bTb-pcl-xl-lora-eu-wTb-pcl-xl-lora-eu-bTb-pcl-xl-lora-us-wTb-pcl-xl-lora-us-b

Table of Contents