Preparation, Organization ID
Your account at https://internetofthings.ibmcloud.com/ should have an “Organization ID” at â€śSettingsâ€ť , â€śIdentityâ€ť, â€śOrganization IDâ€ť. This ID will be needed to authenticate a device to your account at the IBM Watson IoT Platform. It could be used to distinguish between different customers or projects.
Preparation, API Key and Token
To get a secure API Key and Token, you will need to go to https://internetofthings.ibmcloud.com/ into â€śAppsâ€ť and click on the top right to â€śGenerate API Keyâ€ť . Add a Description and then choose the role â€śStandard Applicationâ€ť and finalize it by click on â€śGenerate Keyâ€ť . The generated token will only be visible once, so please note the â€śAPI Keyâ€ť and â€śAuthentication Tokenâ€ť , before you â€śCloseâ€ť the view.
This key and the token will be needed for authentication of HELLAÂ Aglaia APS devices at the IBM Watson IoT Platform to your account.
Setup the APS to Watson IoT platfom connection
Connect to the web browser setup of the HELLA Aglaia APS with your PC. Go to the â€śNetwork Communication Settingsâ€ť and enable â€śUse Watson IOTâ€ť. Then the device sends available data to the IBM Watson IoT Platform server:
- To add the sensor to an IBM Watson IoT Platform account, enter the â€śWatson Organization IDâ€ť .
- To add the sensor to a group of sensors at the IBM Watson IoT Platform account, enter the â€śWatson API Keyâ€ť and â€śWatson API Tokenâ€ť .
- To send accumulated counting data in these time frames, set the â€śCounting Data Intervalâ€ť.
- To save all the settings in the device, click the â€śSaveâ€ť button.
- To go back to the last saved settings, click the â€śResetâ€ť button.
While saving your setup, the HELLA Aglaia APS will connect to the IBM Watson IoT platform and display a corresponding status message â€śConnecting to Watson REST APIâ€ť below the â€śSaveâ€ť button, followed by a â€śConnection successfulâ€ť message once the connection has been established.
(If this fails, please check the connection of the sensor to the Internet, check if IP ports 443 and 8883 TCP are open to the Internet and not blocked by firewalls and please make sure the sensor settings contain the correct access IDs and token.)
APS device status inside the IBM Watson IoT platform
The Hella Aglaia APS at least send its status.
Because of the complex and extensive data a HELLA Aglaia APS could provide beyond multiple simple counting line data, it is splitted into multiple logical devices. The sensor itself is a “gateway” using type “APS-RS”. Data providers like counting line data are “devices” at this gateway.
Counting line data
This includes accumulated data of one counting line of the sensor. It is located at the sensor “device” entry of the counting line. Every counting line acts as a separate device inside the IBM Watson IoT platform.
The unique ID of this counting line device is generated by the name of the counting line in combination with the hostname of the device.
It will be sent at the â€śCounting Data Intervalâ€ť defined in the â€śNetwork Communication Settingsâ€ť setup, for example every 5 minutes.
In addition to the feature of counting people passing lines, more data is available depending on the licenses installed at the HELLA Aglaia APS, such as:
- Zone monitoring –
to detect and count people within a zone, including dwell times, and send alerts if a certain amount of people or maximum dwell time was detected.
- Wireless services –
including tracking of wireless devices (such as smartphones)
Service requests regarding the HELLA Aglaia APS can be sent to the following e-mail address:
Visit our website for more information on our product range: https://people-sensing.com/retail/.
- Zone monitoring –