Cube Eye User Manual Eye Manual v1.0_Jun_2015_En.pdfaccordance with the instruction manual, may...
Transcript of Cube Eye User Manual Eye Manual v1.0_Jun_2015_En.pdfaccordance with the instruction manual, may...
meerecompany Inc., 69-12, Jeongmunsongsan-ro, Yanggam-myeon, Hwaseong-si, Gyeonggi-do, 445-933, Korea
Tel. +82.31.350.9999, Fax. +82.31.352.8871 www.cube-eye.co.kr / www.meerecompany.com
Part 15 Tested
meerecompany Inc.
Cube Eye User Manual
Model: RS5243A(B) / RS5243C(D)
Part 15 Tested
1
Contents
1. INTRODUCTION ------------------------------------------------------------------------------ 2
1.1 PRODUCT DESCRIPTION ------------------------------------------------------------------------- 2
1.2 QUALITY ASSURANCE ---------------------------------------------------------------------------- 2
1.3 COPYRIGHT -------------------------------------------------------------------------------------- 2
1.4 CAUTION & NOTE -------------------------------------------------------------------------------- 3
1.5 REGULATIONS ----------------------------------------------------------------------------------- 3
1.6 REVISION HISTORY ------------------------------------------------------------------------------ 3
2. HARDWARE ------------------------------------------------------------------------------------ 4
2.1 GENERAL SPECIFICATION ------------------------------------------------------------------------ 4
2.2 HARDWARE SPECIFICATION ---------------------------------------------------------------------- 4
2.3 HARDWARE OVERVIEW -------------------------------------------------------------------------- 4
2.4 HARDWARE CONNECTION ------------------------------------------------------------------------ 5
2.5 INSTALLATION GUIDE ---------------------------------------------------------------------------- 6
3. SOFTWARE ------------------------------------------------------------------------------------- 7
3.1 SOFTWARE SPECIFICATION & DOWNLOAD ------------------------------------------------------- 7
3.2 WINDOWS SOFTWARE INSTALLATION------------------------------------------------------------ 8
3.3 LINUX SOFTWARE INSTALLATION --------------------------------------------------------------- 12
3.4 ARM SOFTWARE INSTALLATION ---------------------------------------------------------------- 13
4. CUBE EYE VIEWER STRUCTURE & OPERATION ------------------------------------- 14
4.1 MENU BAR -------------------------------------------------------------------------------------- 14
4.2 VIEW SCREEN ---------------------------------------------------------------------------------- 15
4.3 SETUP SCREEN --------------------------------------------------------------------------------- 16
4.4 3D VIEW SCREEN ------------------------------------------------------------------------------ 17
5. TROUBLESHOOT ----------------------------------------------------------------------------- 18
5.1 FAQ & SOLUTION ------------------------------------------------------------------------------ 18
5.2 CONTACT --------------------------------------------------------------------------------------- 18
Part 15 Tested
2
1. Introduction
1.1 Product Description
<Fig.1-The Principle of Time of Flight>
3D Range Camera is composed of the laser diode illuminator and receiver sensor.
This depth camera can measure object‟s distance by pixel unit. Cube Eye Viewer
program is for viewing the image acquired by 3D Range Camera device.
You can acquire the data from the camera and store. Through a simple setup, you
can also optimize the image.
For the appropriate usage, please read the manual carefully before using the
camera.
1.2 Quality Assurance
meerecompany Inc. warrants the original components free of defects for one year
from the new product purchase date. This warranty covers failure and damage due
to defect, which may occur during the normal use. It does not cover damages or
failure resulting from mishandling, abuse, misuse or modification.
The information contained in this document has been carefully checked and is
believed to be reliable. meerecompany assumes no responsibility for inaccuracies.
meerecompany assumes no legal obligation to document product‟s functionalities,
internal connectivity/ relationship among modules, hardware, or software.
1.3 Copyright
Cube Eye Viewer program, camera driver files, files for executing program and
user manual are protected by copyright law and international treaties. They are
not allowed to be copied, reproduced, or modified for any use without the
permission of meerecompany. Software contains meerecompany‟s intellectual
Part 15 Tested
3
property. Specifications, functions or designs are subject to change without notice.
If you have any question regarding product, please contact meerecompany.
1.4 Caution & Note
◎ Caution: Any structural/ constructional changes or modifications to this device,
not expressly approved by the party responsible for compliance, could result in
nullifying user's right to operate the equipment.
◎ Note: This equipment has been tested and found to comply with the limits for a
Class A digital device, pursuant to part 15 of the FCC Rules. These limits are
designed to provide reasonable protection against harmful interference when the
equipment is operated in a commercial environment. This equipment generates,
uses, and can radiate radio frequency energy and, if not installed and used in
accordance with the instruction manual, may cause harmful interference to radio
communications. Operation of this equipment in a residential area is likely to
cause harmful interference in which case the user will be required to correct the
interference at the user‟s expense.
1.5 Regulations
1.6 Revision History
◎ Version 1.0: first created and distributed
This device compiles with International Standard
IEC/EN 60825-1:2014 for Class 1 laser product.
For safe use of product, do not look into the laser
exposure part & do not disassemble.
Not following the instructions or arbitrarily
manipulating the product may result in hazardous
injury.
Part 15 Tested
4
2. Hardware
2.1 General Specification
Product Name 3D Range Camera
Model Name Depth Only: RS5243A(B) / Depth + RGB: RS5243C(D)
Operating Range 1m ~ 5m
Data Interface USB 2.0
Frame Rate 30fps
2.2 Hardware Specification
Illuminator Laser diode 2ea
Pixel Count Depth: QVGA(320x240) / RGB: VGA(640x480)
FOV 60°(H) x 46°(V)
Dimension(mm) RS5243A – 117(H) x 54(V) x 43(D), W:390g
RS5243C – 143(H) x 56(V) x 45(D), W:540g
Power Spec. DC 9V, RS5243A - 0.44A / RS5243C - 0.55A
2.3 Hardware Overview
<Fig.2 – RS5243A Dimension>
Part 15 Tested
5
<Fig.3 – RS5243C Dimension>
2.4 Hardware Connection
<Fig.4 – Hardware Connection>
Part 15 Tested
6
2.5 Installation Guide
Avoid any objects in FOV near camera‟s close range (within 1.0m). Reflection
may cause depth data error.
<Fig.5 - Installation Example>
<Fig.6 – Field Of View>
Part 15 Tested
7
3. Software
Software installation package includes Cube Eye Viewer program, library and header
files for programming, sample application code, device driver and user manual. Cube
Eye Viewer can acquire and store depth data from the camera and offers various
analysis functionalities. Users can also use provided libraries to develop user
applications.
3.1 Software Specification & Download
◎ For Windows:
Windows7 / Windows8 (x86, x64)
Development language: MFC Visual C++ 2012
Dynamic library link (*.dll, *.lib)
OpenGL library (for Sample viewer)
◎ For Linux:
Ubuntu 10.04 / 12.04 / 14.04 LTS (x86, x64)
QT version 5.2 (Linux Tool program)
libusb-1.0.9 (x86 / x64 Version)
◎ For ARM Test Environment:
Test CPU : Exynos4412 (Cortex A9)
Compiler Ver.: arm-none-linux-gnueabi, arm-linux-gnueabihf
libusb-1.0.9 (ARM Version)
◎ Downloadable Software Package
Latest version of SDK is available on our website.
http://cube-eye.co.kr
Part 15 Tested
8
3.2 Windows Software Installation
◎ Install the software package: Cube Eye Software Setup.exe
<Fig.7 – Installation Process>
Part 15 Tested
9
◎ Install the device driver: manually select driver path in the windows
device manager
< Path- C:\Cube Eye\Driver\x86(32bit) or x64(64bit)>
① Right click on device in the device manager, select “Update Driver
Software”
<Fig.8 – Driver Installation1>
② Select “Browse my computer for driver software”
<Fig.9 – Driver Installation2>
Part 15 Tested
10
③ Browser -> Select Driver path: C:\Cube Eye\Driver\x86 or x64
<Fig.10 – Driver Installation3>
④ Driver Installation complete
<Fig.11 – Driver Installation4>
Part 15 Tested
11
◎ Software installation path: C:\Cube Eye
<Fig.12 – Software installed path>
◎ Running the Program: Double-click shortcut in the desktop or select from
windows program list
< Fig.13 - The initial view of Cube Eye Viewer for Windows >
Part 15 Tested
12
3.3 Linux Software Installation
◎ Copy and unzip Linux program: Copy “mtf_linux_1.0.tar.gz” file to Linux
folder and unzip.
# tar –xvf mtf_linux_1.0.tar.gz
# cd mtf_linux_1.0
◎ Run Driver & Library File installation
# ./mtfinstall.sh
◎ Check USB connection status: VID=03a4, PID=8718, 871A, 871C (PID
differs by model)
# lsusb
◎ Execute program: cd mtf_linux_1.0-API/Tool
# ./CUBE-EYE
< Fig.14 - The initial view of Cube Eye Viewer for Linux >
Part 15 Tested
13
3.4 ARM Software Installation
◎ Check USB connection status
# lsusb
◎ Create device node file
# mknod /dev/bus/usb/(Bus Number)/(Device Number) c (Major Number)
(Minor Number)
ex)
Bus Number, Device Number, Major Number, and Minor Number may change
depending on the environment.
◎ Set library file path (libMTF_API.so, libusb-1.0.so)
# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:PATH
ex) PATH : Library file path
◎ Execute SimpleRead program (./SimpleRead)
Part 15 Tested
14
4. Cube Eye Viewer Structure & Operation
4.1 Menu Bar
① Play/Stop the video from the camera.
② Save video data as BMP image file. (Max 10 files; also saved as CSV file type)
Save Path - C:\Cube Eye\SaveData\Date Folder
③ Save consecutive frame data.(*.mee)
- Output Folder: Name of video file storage folder created under root folder
- Duration Time: Recording time of video
- Start: Begin video recording
- Stop: End video recording.
- Saved file example
- Data File Naming Format - MeereYYYYMMDDHHMMSSMMM.mee
(Ex: Meere20131106183103247.mee)
⑦ ① ② ③ ④ ⑤ ⑥ ⑧
Select
Root Folder
Part 15 Tested
15
④ Play/stop the saved video file (*. mee)
⑤ Pause playing pre-recorded video file and move one frame forward or
backward
⑥ Select the saved video file for play and set the play speed of video
⑦ Adjust display view image scale.
⑧ Display current integration time & modulation frequency.
4.2 View Screen
<Fig.15 – Image View Snapshot>
Part 15 Tested
16
4.3 Setup Screen
<Fig.16 - Setup Dialog>
Integration time (us): 4000(Default)
Module Frequency (MHz): 20(fixed)
Signal Check Threshold: 0~1000.
(If the amplitude value of IR image‟s each pixel is smaller than this
check threshold, this pixel is regarded as invalid pixel. Invalid pixel will
be shown as “0”. This „Function‟ can be used to reduce background
noise)
Soft Distance Offset (mm): Set the distance offset of depth data.
Min Depth Range: Set the minimum depth range.
(The depth value lower than minimum is set zero)
Max Depth Range: Set the Maximum depth range.
(The depth value greater than maximum is set zero)
※ Min, Max value should be chosen depending on the user environment.
Flip Horizontally: Enable/ Disable horizontal flip
Flip Vertically: Enable/ Disable vertical flip
Filter Select: Select among „No filter‟, „Smoothing Filter‟, or „Segmentation Filter‟
Current Temperature: Show camera temperature
Model Name: Show camera model
Part 15 Tested
17
4.4 3D View Screen
<Fig.17 - 3D Image Display>
Show 3D view
Part 15 Tested
18
5. Troubleshoot
5.1 FAQ & Solution
◎ In case of driver installation failure,
Check the USB connection. If you use USB Hub, also check the Hub
power status.
If the driver is not installed continuously, please try to use another USB
port.
◎ If images are not displayed,
Check the camera adapter power status.
Check the Setup Dialog value. (Check Threshold, Min/Max value)
If the camera parameter data in the ROM has been deleted, images may
not be displayed. In that case, please contact with meerecompany.
◎ If depth data is out of its tolerance bound,
Minor data error may occur depending on the user environment or
temperature. However, if the error is continuous and not consistent with
provided specifications, please contact with meerecompany.
5.2 Contact
meerecompany Inc. ,69-12, Jeongmunsongsan-ro, Yanggam-myeon,
Hwaseong-si, Gyeonggi-do, 445-933, Korea
Tel. +82.31.350.9999, Fax. +82.31.352.8871
www.cube-eye.co.kr / www.meerecompany.com