IDS Software Suite 4.90.06 for Linux

System requirements ⇑. For operating the uEye cameras, the following system requirements must be met: USB 3.1/USB 3.0 camera, USB 2.0 ... IDSSoftwareSuite4.90.06forLinux Contents Systemrequirements Configurationnotes Installation Firststart Knownissues Listofcontainedfiles/dependencies Uninstallation Copyright/Trademarks Systemrequirements   ⇑ ForoperatingtheuEyecameras,thefollowingsystemrequirementsmustbemet:   USB3.1/USB3.0camera USB2.0camera Interface USB3.0port(SuperSpeed) USB2.0port(HighSpeed480Mbps,"FullPowered"500mA) CPU Inteli5orbetter Inteli3orbetter Memory min.2GB min.2GB Diskspace min.500MB min.500MB Operatingsystem Linux>Kernel3.4(32/64-bit) ForUI-3013XC:Linux>=Kernel3.13(32/64-bit) Linux>Kernel2.6(32/64-bit) Dependingonthesensormodel,thecameraperformancemaybelimitedwiththeminimumsystemrequirements. Compatibiltylist TheLinuxoperationsystemisoneofthemostwidelyported,runningonahugeamountofarchitecturesandprovidedovermanydistributions.Althoughwearetryingtobecompatibleamongthewholerangeofkernelversionsanddistributions,thereisnoguaranteethattheIDSSoftwareSuiteisworkingonaspecificuntestedcombination. Belowisalistoftestedandsucceededplatformsanddistributionsforthecurrentsoftwarerelease: Distribution Architecture/processor Setup Debian9.4/8.10 i386/i686 uEye-Linux-[version]-32.tgz Debian9.4/8.10 amd64/amd64 uEye-Linux-[version]-64.tgz Ubuntu18.04LTS/17.10/16.04LTS i386/i686 uEye-Linux-[version]-32.tgz Ubuntu18.04LTS/17.10/16.04LTS amd64/amd64 uEye-Linux-[version]-64.tgz Configurationnotes   ⇑ AccordingtotheIDSSoftwareSuiteversion,theLinuxsystemhastosupportaminimumrequiredversionoftheGNUCLibrary(GLIBC,libc.so.6)andtheGNUC++Library(GLIBCXX,libstdc++.so.6),seehttps://en.ids-imaging.com/download-ueye-emb-softfloat.html?file=tl_files/downloads/LinuxEmbedded/IDS_uEye_for_Embedded_Boards_EN.pdf: libc:minimumversion2.7 libstdc++:minimumversion3.4.17 POSIXthreadslibrary(POSIXthreadsenabledlibc) bash(Bourneagainshell)orshtorunthescript libcapv2 libgompv2(forOpenMPsupport) udevmin.v105 libpng(libpng.soorlibpng12.so.0)forsupportofsavingimagesinPNGformat libjpeg(libjpeg.so.8orlibjpeg.so.62)forsupportofsavingimagesinJPEGformatandJPEGmodeofXS OpenGLgraphicsfunctions ForOpenGL,version1.4orhighermustbeinstalled. IfyouwanttohaveagraphicalenvironmentbyusingtoolsliketheIDSCameraManagerortheuEyeDemoapplication,youneedtoinstalltheQtframework(min.v4.5.2) InstallationofIDSSoftwareSuite4.81(orhigher)willbreakUSBdriverinstallationspriorto4.81 Installation   ⇑ Youmustberoottoinstall. Youmustberoottocontrolthedaemon. Copyallthefilesintoadirectoryontheharddisk(youneedwriteaccesstodecompress). Gotothedirectoryyoucopiedthefilesintoandrunthesetupprogramscriptbytyping(replacethewildcardwiththeactualversionidentifieroftheinstallerfile)$>sh./ueyesdk-setup*.run Ifanyproblemsoccurred,theknownissuessectionbeloworthegeneratedreport.logfilemayincludeahinttosolvethem(seeinstalleroutput).Ifnot,contactyourlocaldistributorssupportandsubmitthereport.logfile. Ifinstallationsucceeded,onemaystarttheuEyedaemonbytyping/etc/init.d/ueyeethdrcstart(youneedtoberoot) TostoptheuEyedaemon,type/etc/init.d/ueyeethdrcstop ForUSBuEye,replace'ueyeethdrc'with'ueyeusbdrc'. Alternatively,ifonehasaworkinggraphicalenvironment,thedaemonsmaybecontrolledviatheIDSCameraManager(startedasroot) SetcameraID TosetthecameraID,onemayusetheIDSCameraManagerorthe'ueyesetid'tool. SetcameraIP TosetthecamerapersistentIPaddress,onemayusetheIDSCameraManagerorthe'ueyesetip'tool. IftheuEyedaemonhangsandcannotbestoppedwith/etc/init.d/ueyeethdrcstop,run(asroot)/etc/init.d/ueyeethdrcforce-stop Notethatitisnormalbehaviourthatueyeethdrefusestoterminateifthereareapplicationsconnected. ForUSBuEye,replace'ueyeethdrc'with'ueyeusbdrc'. Installedfilestructure ThecreatedfileswillbeinstalledinfollowingdirectorieswheninstallingtheUSBpackage: /usr/lib/libueye_api.so.[version] 32bituEyesharedlibrary Afterldconfighasfinished,asymboliclinklibueye_api.soshouldexisttoprovidelinkageagainstlibueye_api.so.Notethatonlytheversionforthecurrenttargetarchitecturewillbeinstalled,e.g.the32-bitlibrarywillonlybeinstalledona32-bitsystemandthe64-bitlibrarywillonlybeinstalledona64-bitsystem. /usr/lib/libueye_api64.so.[version] 64bituEyesharedlibrary /usr/include/ueye.h Developmentheaderfile Forcompatibilitywitholderversions,asymboliclink/usr/include/uEye.hwillbecreated.Itisstronglyrecommendedtousethelowercasefilenameinnewprojects. /usr/local/share/ueye/ueyeusbd USBuEyedaemonbinariesandconfiguration   /usr/local/share/ueye/bin uEyeutilities   /usr/local/share/ueye/licenses Thirdpartylicensesandcopyrights   /usr/local/share/ueye/firmware USB3firmwarebinaries   /var/run/ueyed Runtimedirectory   /etc/init.d/ueyeusbdrc USBuEyedaemonrunlevelcontrolscript   /usr/src/ids IDSdemosources   /usr/share/doc/ids IDSSDKreadme   /usr/share/doc/ids/ueye_manual IDSSDKusermanual     Additionally,theinstallerprovidesthefollowingtools-unlessnotindicatedotherwise,thetoolswillbeinstalledto/usr/local/share/ueye/bin: ueyesetid CameraIDconfigurationtool ueyesetip CameraIPaddressconfigurationtool idscameramanager IDSCameraManager ueyedemo Demoapplication report.sh Reportgeneratortool Forthebinarytools,asymboliclinkwillbecreatedin/usr/bintoprovidedirectcommandlineaccess. User/group Theinstallerwillcreateasystemgroup'ueye'andasystemuser'ueyed'torunthedaemonwith.Currentlytherearenoaccesscontrolrestrictions,butbeawarethatthismightchangeinthefuture. Firststart   ⇑ USB3.1/USB3/USB2uEyecamera Afteryouinstalledthesoftware,connectthecameratothePC,usingthecorrespondingUSBcable.Thecamerawillberecognizedautomatically.WhenyouconnectacamerawithaPCoranewUSBportforthefirsttime,itisdetectedasanewdeviceandthefirmwareisuploadedtothecamera.Whenthecamerahasbeencorrectlyinstalled,theLEDonthebackofthecameralightsupgreenandthecameraisdisplayedinthelistoftheIDSCameraManager. Knownissues   ⇑ Thissectionlistsknownissuesthatmightoccurinthisrelease. Energysavingissues:Onsomesystemswithactivatedenergysaving,thedaemonsmayhangoncethesystemhasenteredanenergysavingstate. USB3.0issues:SometimestheUSBdaemoncannotreceivedatafromthecamerawhichisconnectedonaUSB3.0port.Afterthatoccurs,physicallydisconnectthecameraandreconnectit. USB3.0performanceissues:HighCPUloadmayleadtoUSBtransferfails.Theypossiblycanbereducedby: IncreasingthedaemonprioritybyreducingtheNICEVALUEin/etc/init.d/ueyeusbdrc IncreasingthenumberofpendingUSBrequestswiththefollowingconfigurationof/usr/local/share/ueye/ueyeusbd/ueyeusbd.conf: [Parameters] NumRequestsStr=40; OpenMPissuesmaybecausehighCPUloador"Driveroutofbuffer"errors.Theypossiblycanbereducedby: SettingthevalueoftheenvironmentvariableOMP_WAIT_POLICYtoPASSIVE Thisvariablespecifieswhetherwaitingthreadsshouldbeactiveorpassive.IfthevalueisPASSIVE,waitingthreadsshouldnotconsumeCPUpowerwhilewaiting;whilethevalueisACTIVEspecifiesthattheyshould.Ifundefined,threadswaitactivelyforashorttimebeforewaitingpassively. Listofcontainedfiles/dependencies   ⇑ Seelistonhttps://en.ids-imaging.com/open-source.html Uninstallation   ⇑ Touninstallueyeusbd,run(asroot):/usr/local/share/ueye/bin/ueyed_install-usbuninstall Youshouldalwaysusetheinstallscriptthatcamewiththepreviousinstallationtoensurepropersystemcleanup.DonotattempttoremovetheIDSSoftwareSuitemanually. Note:Onceuninstalled,anyconfigurationfilewillbelost.Considerbackinguptherespectiveconfigurationfiles! Copyright/Trademarks   ⇑ ©2018,IDSImagingDevelopmentSystemsGmbH IDSImagingDevelopmentSystemsanduEyeareregisteredtrademarksofIDSImagingDevelopmentSystemsGmbH.   IDSImagingDevelopmentSystemsGmbH DimbacherStr.6-8 74182Obersulm,Germany http://www.ids-imaging.com