background image

3.3.2  Linux

Directory structure of the SDK distribution (Linux)

camlab

Camera application with control and viewer window

vrmcamserver

Camera application for Ethernet transmission

demos

Demo applications

deviceinfo

Demo application displaying device information

restorefactory 
defaults

Demo application that restores all factory defaults

sdlviewer

Demo application displaying the camera pictures in an 
SDL widget

docs

vrmusbcam API documentation

include

Include file for using the shared library

lib

Shared library

share

fpgaprogramfiles

setup

Setup scripts, hotplug helper and ethernet enable/
disalbe scripts

udev

udev rules file which invokes the hotplug helper

etc

Potential contents of /etc/vrmagic

USB Cameras – User Guide

16

USB Components

Software Installation

Summary of Contents for USB Camera

Page 1: ...VRmagic USB Camera User Guide Issued July 2014 ...

Page 2: ...ght All rights reserved No part of this document may be reproduced or transmitted for any purpose in any form or by any means electronically or mechanically without expressly written permission by VRmagic Windows is a registered trademark of Microsoft VRmagic GmbH Augustaanlage 32 68165 Mannheim Germany Phone 49 0 621 400 416 20 Fax 49 0 621 400 416 99 info imaging vrmagic com www vrmagic imaging ...

Page 3: ......

Page 4: ...the Interface Cables 19 4 2 1 General Information on the USB Connection 19 4 2 2 Cameras with Hirose DF14 15P Connector 20 4 2 3 Cameras with MPE Garry Micro T Connector 22 4 2 4 Compact Single Sensor Cameras 23 4 3 Connecting to Power 23 4 3 1 Power Supply via USB 24 4 3 2 External Power Supply 25 5 First Steps 26 5 1 Auto Detection of the Camera 26 5 2 Starting CamLab 26 5 3 Accessing the Demo A...

Page 5: ...RmC X OEM Interface Cable 34 7 2 Cable Plan VRmDC FC X DF14 Open 35 7 3 Cable Plan VRmC X PRO Interface Cable 36 7 4 Pinout 4 pin Header VRmC X OEM COB 37 7 5 Status LED Indications 38 8 Index 39 5 USB Cameras User Guide Table of Contents USB Components ...

Page 6: ...device Caution Indicates a situation which if not avoided may result in minor damage to the device in malfunction of the device or in data loss Note Notes provide information on special issues related to the device or provide infor mation that will make operation of the device easier This headline indicates the beginning of a procedure 1 This number indicates the first step of a certain procedure ...

Page 7: ...ard level cameras with optics COB versions and as cameras with aluminium housing PRO versions All cameras are equipped with a sensor board and an interface board Depending on the image sensor the camera may be equipped with an additional FPGA board VRm FC X models Front View Side View Back View Sensor Fig 1 USB single sensor camera OEM with FPGA board 1 Sensor board with image sensor 2 FPGA board ...

Page 8: ...camera OEM Remote Sensor Cameras VRmC X E Remote sensor cameras consist of a base unit and an external sensor board connected to the base unit by flex foil cable Remote sensor cameras are available as board level cameras OEM versions and board level cameras with optics COB versions The base unit consists of a sensor connection board and an interface board Back View Front View Side View Fig 3 Base ...

Page 9: ...ions and board level cameras with optics COB versions The base unit consists of a sensor connection board an FPGA board and an interface board Front View Side View Back View Fig 4 Base unit of USB multi sensor camera with standard interface board 1 Sensor connection board external sensor boards are connected via flex foil cables 2 FPGA board 3 Interface board 9 USB Cameras User Guide Overview USB ...

Page 10: ... Single sensor cameras remote sensor cameras and multi sensor cameras in OEM and COB versions are equipped with a USB connector a Hirose DF14 15P connector for trigger strobe and external power supply and a status LED Ü Fig 5 on page 10 Back View Top View Fig 5 Interfaces of a single sensor camera VRmFC X OEM 1 USB Mini B port 2 Status LED 3 DF14 15P connector for trigger strobe and external power...

Page 11: ...or for trigger strobe and external power supply and a status LED Ü Fig 6 on page 11 Side View Back View Fig 6 Interfaces of a single sensor camera VRmC X PRO 1 MPE Garry Micro T 386 2 021 ZS0 connector for trigger strobe and external power supply 2 USB Mini B port 3 Status LED 11 USB Cameras User Guide Overview USB Components ...

Page 12: ...header for trigger strobe and a status LED Ü Fig 7 on page 12 Front View Top View Fig 7 Interfaces of a compact single sensor camera VRmC X PRO 1 USB Mini B port Side View Back View USB Sensor T G G S Fig 8 Interfaces of a compact single sensor camera VRmC X OEM 1 USB Mini B port 2 4 pin header for trigger and strobe 3 Status LED USB Cameras User Guide 12 USB Components Overview ...

Page 13: ...n one end and different adapters on the other end Ü Fig 12 on page 21 For all board level cameras OEM and COB except compact single sensor cameras VRmC X PRO Interface Cable Interface cable with MPE Garry Micro T plug on one end and dif ferent adapters on the other end Ü Fig 14 on page 22 For all housing cameras PRO except compact single sensor cameras 1 Power supply 5 V 15 W worldwide Power suppl...

Page 14: ...Installing the software development kit Windows 1 Navigate into the directory created after unpacking the downloaded file 2 To install the SDK run setup exe 3 Follow the on screen instructions f f After successful installation a message is displayed A new folder VRmagic was created in your Windows start menu Several folders were created on your hard drive Ü 3 3 1 on page 15 Installing the software...

Page 15: ...ewer window CamServer Camera application for Ethernet transmission Install Install scripts for COM API DirectShow Ethernet PnP enable script weblinks Links to VRmagic website 32 bit C Program Files x86 Common Files VRmagic VRmUsbCamSDK 64 bit C Program Files x86 Common Files VRmagic VRmUsbCamSDK demos Demo applications docs Product documentation include Include file for using the shared library li...

Page 16: ...lts Demo application that restores all factory defaults sdlviewer Demo application displaying the camera pictures in an SDL widget docs vrmusbcam API documentation include Include file for using the shared library lib Shared library share fpgaprogramfiles setup Setup scripts hotplug helper and ethernet enable disalbe scripts udev udev rules file which invokes the hotplug helper etc Potential conte...

Page 17: ...n Connecting the flex foil cable s to the base unit 1 Pull out the lock of the connector on the base unit Ü Fig 9 on page 17 2 Insert the flex foil cable with the blue marker facing the board and the open con tacts facing you 3 Secure the cable by pushing the lock back in 4 Repeat steps 1 to 3 for further external sensor boards Multi Sensor Base Unit Remote Sensor Base Unit Fig 9 Connecting the fl...

Page 18: ... blue marker facing you and the open contacts facing towards the sensor board 3 Secure the cable by pushing the lock back in 4 Repeat steps 1 to 3 for further external sensor boards VRmMS 12 VRmS 9 12 14 16 18 Fig 10 Connecting the flex foil cable to the sensor board contacts not visible blue marker visible USB Cameras User Guide 18 USB Components Hardware Installation ...

Page 19: ...xt to USB connectors Blue USB port This is a USB 3 0 connector Some USB 3 0 ports are additionally labelled with a USB 3 0 logo Do not connect the camera to USB 3 0 ports Black USB port This is a USB 2 0 connector Some USB 2 0 ports are additionally labelled with a USB 2 0 logo Yellow USB port This type of connector permanently supplies power to the con nected device even if the host is switched o...

Page 20: ...13 Connecting the camera 1 Connect the supplied cable with the Hirose DF14 plug to the camera s receptacle Ü Fig 5 on page 10 2 The other end of the cable splits into open ends or receptacles for trigger strobe and external power supply depending on the accessory kit you ordered Ü Fig 10 on page 18 Connect trigger and strobe if required f f View the cable plan for a detailed description Ü 7 1 on p...

Page 21: ...craft PC722A receptacle for 5 V power supply 3 Receptacles for 0 1 connector 3 pieces 4 Open ends 8 pieces reserved 1 15 Fig 13 VRmDC FC X DF14 Open interface cable for OEM and COB cameras 1 Hirose DF14 15S 1 25C to be plugged into camera receptacle 2 Open ends 15 pieces 21 USB Cameras User Guide Hardware Installation USB Components ...

Page 22: ...her end of the cable splits into 0 1 receptacles for trigger and strobe and a receptacle for an external power supply Connect trigger and strobe if required f f View the cable plan for a detailed description Ü 7 3 on page 36 3 Connect the USB cable to the camera s USB port 4 Continue with Ü 4 3 on page 23 and read the information on power supply 1 11 12 21 Fig 14 VRmC X PRO interface cable for PRO...

Page 23: ...ower supply 4 3 Connecting to Power Most cameras can be powered via the USB connection without an additional external power supply Only certain multi sensor camera models require an external power supply Caution Additional external power supply necessary with certain multi sensor cameras In the case of a multi sensor camera with the sensor boards VRmS 9 VRmS 14 VRmS 16 or VRmS 18 connect an extern...

Page 24: ...e USB ports may not be sufficient In this case power the cameras externally Connecting the camera to power via USB 1 Connect the USB cable attached to the camera to a USB 2 0 port of your host PC Do not connect to a USB 3 0 port f f The status LED starts blinking f f If you have installed the camera software the camera should be detected auto matically by the host PC When Windows XP complains abou...

Page 25: ...ceptacle Connecting the camera to an external power supply 1 Connect the power adaptor to power multi sensor cameras only 2 Connect the power adaptor cable to the camera s power inlet multi sensor cam eras only 3 If you have not already done so connect the USB cable attached to the camera to a USB 2 0 port of your host PC Do not connect to a USB 3 0 port f f The status LED starts blinking f f If y...

Page 26: ...5 on page 38 5 2 Starting CamLab Start the CamLab application to test the functionality of your camera CamLab allows you to select the cameras connected to your host PC view the image recorded by the image sensor and change all available camera parameters 1 Start the CamLab application Windows Start All programs VRmagic CamLab f f Your camera should be listed in the device list model name and seri...

Page 27: ...oose grab to view the camera image f f The camera image is displayed in the viewer window 4 Try out the different camera parameters You can change and save parameters in the config area 27 USB Cameras User Guide First Steps USB Components ...

Page 28: ...e to the folder your path to VRmUsbCamSDK demos 2 Open the subdirectory for your development platform f f All demo applications are located there Accessing the demo applications under Linux Note To build the demos you need the SDL library including the development package installed on your system SDL and SDL devel packages 1 Change to the demo directory for example cd demos c sdlviewer 2 Build the...

Page 29: ...Pin Signal 1 11 12 21 MPE Garry Micro T 386 2 021 ZS0 1 GND 2 Passive Strobe Out 3 24 V 3 Passive Strobe Out 3 24 V 4 Active Strobe Out 5 V 5 GND 6 Passive Trigger In 3 24 V 7 Passive Trigger In 3 24 V 8 Active Trigger In 3 3 5 V 9 GND 10 11 5 V 12 21 Single Sensor Board Level Cameras Remote Sensor Cameras Multi Sensor Cameras Camera Models VRm F C X OEM COB VRmC X E VRmMFC Connector Pin Signal 1 ...

Page 30: ... and as logically low when the voltage drops below 1 V The current flowing between Trigger In and Trigger In is approx 2 mA at 3 3 V and approx 5 mA at 24 V The active and the passive trigger input are connected internally and cannot be controlled separately 3 3V 24V TriggerIn TriggerIn Passive Trigger Input Fig 17 Passive Trigger Input Active Trigger Input TTL An LVTTL TTL compatible signal can b...

Page 31: ...t be positive 3 24 V The output transistor is capable of switching currents of up to 100 mA The voltage drop across it will never fall below 1 V Passive Strobe Output StrobeOut StrobeOut 3 3V 24V 1V drop Fig 18 Passive Strobe Output Active Strobe Output TTL At the active strobe out is a TTL compatible strobe signal referenced to GND Active strobe out can sink or source currents of up to 20 mA 31 U...

Page 32: ...ed Updating the camera firmware 1 Visit www vrmagic com imaging downloads f f The firmware for USB cameras can be found beneath the heading Software for USB Components 2 Download the zip file VRmUsbCam Firmware Bundle X Y 3 Unpack the file 4 Connect the camera you wish to update to your host PC and be certain it is de tected by using CamLab Ü 5 2 on page 26 5 Navigate into the directory created af...

Page 33: ...s already up top date an error is displayed and the update procedure is canceled 8 Wait until all VRmagic USB devices have been updated and Finished is displayed f f You may now unplug the devices or continue working with them 33 USB Cameras User Guide Firmware Update USB Components ...

Page 34: ...722A receptacle for 5 V DC power supply 3 Receptacles for 0 1 connector 3 pieces 4 Open ends 8 pieces reserved 2 pin 3 wire 4 wire 1 pin Signal ring 3 13 GND center pin 1 2 5 V DC 5 in VBUS out gray 8 GND white 9 TTL TriggerIn 3 3 5 V black 10 TTL StrobeOut 5 V yellow1 green1 blue purple brown2 red2 yellow2 green2 4 5 6 7 11 12 14 15 reserved USB Cameras User Guide 34 USB Components Appendix ...

Page 35: ... be plugged into camera receptacle 2 Open ends 15 pieces 2 wire 1 pin Signal orange1 gray orange2 3 8 13 GND brown1 red1 1 2 5 V DC 5 in VBUS out white 9 TTL TriggerIn 3 3 5 V black 10 TTL StrobeOut 5 V yellow1 green1 blue purple brown2 red2 yel low2 green2 4 5 6 7 11 12 14 15 reserved 35 USB Cameras User Guide Appendix USB Components ...

Page 36: ...receptacle for 5 V power supply 3 Receptacles for 0 1 connector 7 pieces 2 pin 3 wire 1 pin Signal ring 5 9 GND center pin 10 11 5 V DC 5 in VBUS out white 1 GND brown 2 StrobeOut potential free green 3 StrobeOut potential free yellow 4 TTL StrobeOut 5 V gray 6 TriggerIn potential free pink 7 TriggerIn potential free blue 8 TTL TriggerIn 3 3 5 V USB Cameras User Guide 36 USB Components Appendix ...

Page 37: ...B USB Sensor T G G S Fig 23 4 pin header of compact single sensor cameras OEM COB 1 4 pin header for trigger and strobe 1 pin Signal T TTL TriggerIn 3 3 5 V G GND G GND S TTL StrobeOut 5 V 37 USB Cameras User Guide Appendix USB Components ...

Page 38: ...necting the device to the PC Another reason for this status may be that the device is not being supplied with sufficient power via the USB connection LED on low brightness Device was detected and is operational idle mode LED on medium brightness Device is active and waiting for a trigger signal LED on high brightness An image is currently captured or transferred to the PC If the cameras is free ru...

Page 39: ...o T 11 22 36 E External sensor board 9 F Firmware update 32 FPGA board 7 9 I Interface board 7 8 9 Interfaces 10 M Multi Sensor Camera 9 23 P Pinouts 34 Power supply 13 23 external 25 via USB 24 R Remote Sensor Camera 8 S Sensor board 7 Sensor connection board 8 9 Single Sensor Camera 7 Compact 8 23 Software 14 Download 14 Install 14 Status LED 10 11 24 25 26 38 Strobe 29 31 T Trigger 29 30 U USB ...

Page 40: ...USB Cameras User Guide 40 USB Components Notes ...

Page 41: ...41 USB Cameras User Guide Notes USB Components ...

Page 42: ...USB Cameras User Guide 42 USB Components Notes ...

Page 43: ......

Page 44: ...VRmagic GmbH Augustaanlage 32 68165 Mannheim Germany Phone 49 621 400 416 20 Fax 49 621 400 416 99 info imaging vrmagic com www vrmagic imaging com 2014 VRmagic GmbH Mannheim ...

Reviews: