Gravio Device Manual

Table of Contents

1. Introduction
2. Overall Flow of Sensor Data Collection
3. Device Setup
   • Zigbee Devices
     • Required Hardware
     • Device Addition Procedure
     • Pairing Procedure
     • Data Reception Activation
   • EnOcean Devices
     • Required Hardware
     • Device Addition Procedure
   • Bluetooth Devices
     • Required Hardware
     • Device Addition Procedure
   • Barcode Readers
     • Prerequisites
     • Connection Verification
     • Device Addition Procedure
     • Notes
   • GPS Devices
4. Data Structure Setup
   • Creating Areas
   • Adding Layers
   • Adding Sensors
5. Starting and Verifying Data Collection
6. Troubleshooting
7. Appendix
   • HubKit Data Directory
   • Camera Image Storage Location

Introduction

Gravio is a system for efficiently collecting and managing data from various types of sensors. This manual explains the basic procedures for collecting sensor data using Gravio.

Overall Flow of Sensor Data Collection

The overall process for collecting sensor data in Gravio is as follows:

1. Physical Device Connection and Pairing - Physically connect sensor devices to HubKit and perform pairing as needed
2. Logical Data Structure Setup - Define areas (physical locations) and layers (sensor types)
3. Sensor Addition - Associate physical devices with the created layers
4. Data Collection Start - Enable settings to begin data reception

Device Setup

Zigbee Devices

Required Hardware

To use Zigbee-compatible devices, you need to connect a Zigbee USB receiver to your PC.

If the Zigbee USB receiver is not recognized on Windows or Mac, you need to install drivers from the Silicon Lab website:

• For Windows: Download and install “CP210x Windows Drivers”
• For Mac: Download and install “CP210x VCP Mac OSX Driver”

Zigbee Device Addition Procedure

1. In the “Device” tab, select the type of Zigbee sensor (DataKind) to add a new area and layer.

   

2. To receive sensor data from Zigbee-compatible devices, you first need to pair the sensor with the sensor receiver. Press the following button to display the sensor receiver settings screen connected to the serial port.

   

3. The device list screen will be displayed. Verify that the Zigbee USB receiver is properly connected.

   

Zigbee Device Pairing

1. Press the “Pairing” button to put the receiver in pairing wait state. (Pairing mode lasts for 1 minute.)

   

2. When you press and hold the button on the sensor side for about 5 seconds during pairing mode, the sensor will be paired and displayed as follows.

   

Data Reception Activation

If “Automatically set if there are available layers during pairing” is enabled, and there is a layer configured for the paired device type, the device will be automatically registered to that layer and the settings will be activated.

EnOcean Devices

EnOcean Required Hardware

Connect the EnOcean dedicated USB receiver to your PC.

EnOcean Device Addition Procedure

1. Open the sensor receiver settings screen

   

2. Press the button on the EnOcean-compatible device After a while, the sensor will appear in the serial port

   

Bluetooth Devices

Bluetooth Required Hardware

Use the PC’s built-in Bluetooth function or a Bluetooth USB receiver.

Bluetooth Device Addition Procedure

1. Open the sensor receiver settings screen

   

2. Click the right arrow on the Bluetooth line and press the scan button

   

3. Sensors will be displayed when discovered during scan mode

   

4. The detected device (in this example, Omron 2JCIE-BU01-sensor-1) is displayed

   

Barcode Readers

Gravio can use barcode readers (barcode readers with USB COM port emulation capability) as a layer for data input. Here, we explain the setup procedure for barcode readers using the BUSICOM BC-NL2200U as an example.

Prerequisites

The barcode reader must be configured for USB COM port emulation functionality. Models such as BUSICOM’s BC-NL1100U, BC-NL1100U II, BC-NL2200U, BC-NL2200U II, BC-NL3000U, and BC-NL3000U III can switch between USB HID-KBW functionality and USB COM port emulation functionality. When using with Gravio, make sure to set it to USB COM port emulation functionality.

Barcode Reader Connection Verification

1. For Windows, you can verify the barcode reader connection in Device Manager

   

2. Verify that “USB Serial Device (COMx)” (e.g., COM5) appears under Ports (COM & LPT)

Barcode Reader Addition Procedure

1. Adding Area and Layer
   • In “Device”, select Barcode (DataKind) to add a new area and layer

   

2. Barcode Reader Setup
   • Connect the barcode reader to the USB port
   • Click the circled “+” mark in the top right of the screen

   

3. Device List Verification
   • The device list will be displayed
   • Verify that BUSICOM BC-NL2200U is displayed

   

   Note: If BUSICOM BC-NL2200U is not displayed, verify that the barcode reader is properly connected to the USB port and configured for USB COM port emulation functionality, then restart HubKit.

4. Device and Layer Association
   • Click the circled “+” mark in the top right of the window
   • Select the barcode reader you want to connect to the layer

   

5. Barcode Reader Activation
   • After setup is complete, turn the switch ON to begin data reception

   

Notes

• When using BUSICOM barcode readers, USB COM port emulation functionality configuration is required. Please refer to the BUSICOM manual for details.
• If the barcode reader is not properly recognized, verify the connection and settings, then try restarting HubKit.
• A list of barcode readers verified to work with Gravio can be found in the official documentation.

GPS Devices

(GPS device setup procedures will be added in the future)

Data Structure Setup

After completing physical device connection, set up the logical data structure in Gravio.

Creating Areas

Areas represent the physical locations where devices are installed.

1. Click the “+” mark in the top right of the Device tab to create a new area
2. Name the area (e.g., “3rd Floor West”, “Seminar Room”, “Entrance Area”, etc.)
3. Adding photos can help with identification

Adding Layers

After creating an area, add layers within that area.

1. Click “+” within the area to add a layer
2. Give the layer a meaningful name (e.g., “Temperature Sensor Layer”, “Motion Sensor Layer”, etc.)
3. Select the type of data (DataKind) to be collected in this layer

Adding Sensors

Add the physically connected and paired sensor devices to the created layers.

1. Click the “+” mark in the top right of the sensor receiver settings screen
2. Select and configure the sensor you want to connect to the layer
3. Close the settings screen after configuration is complete

Starting and Verifying Data Collection

After sensor setup is complete, begin data reception.

1. Turn ON the sensor receiver switch
2. This will automatically begin data reception from the sensors
3. For Zigbee, you can connect up to 64 devices with one dongle
4. Use the data viewer to verify received data

Troubleshooting

If devices are not properly recognized:

• Verify that USB devices are properly connected
• Try changing the USB port
• Verify that device drivers are properly installed
• Restart HubKit
• For barcode readers and other COM port devices, verify they are configured for USB COM port emulation functionality

If sensor data cannot be collected:

• Verify that the receiver switch is ON
• Check if the distance between sensor and receiver is appropriate
• Check sensor battery level
• Verify layer settings are correct
• Check if the sensor is not registered in duplicate in another area/layer

Appendix

HubKit Data Directory

When Hub is installed, it creates a data directory for saving configuration files and data.

When Installed on Windows 10

C:\ProgramData\HubKit

When Installed on macOS

/Library/Application Support/HubKit/

When Installed on Linux/Raspberry

Since it runs in Docker on Linux/Raspberry, the following directory is mounted as a volume:

/home/gravio/hubkitrepo4/data

Camera Image Storage Location

Images obtained from cameras via ONVIF etc. are saved in directories organized by camera device and date in the following directory:

Windows 10

C:\ProgramData\HubKit\mediadata

macOS

/Library/Application Support/HubKit/mediadata

Linux/Raspberry

Since it runs in Docker on Linux/Raspberry, when viewed from the Host side, the following directory is mounted as a volume:

/home/gravio/hubkitrepo4/data/mediadata

When viewed from inside Docker, the directory is:

/var/opt/hubkit/mediadata