I N S T A L L A T I O N G U I D E D o c u m e n t v e r s i o n 1. 1 B E N E F I T S S Y S T E M R E Q U I R E M E N T S Analog data visualization Force vector representation 2D and 3D plot Data Logging Easy to use CPU: Intel Core i5 (or equivalent) RAM: 2GB Operating systems: Windows 7 Windows 8 Linux (64 bit, tested on Ubuntu 14.04) OpenGL 1.2 or greater HDD space: 500 MB OptoForce page 1
P A C K A G E C O N T E N T The supplied kit contains the following elements: 1 x OMD sensor 1 x Data Acquisition Board (DAQ) with USB interface 1x USB cable 1 x Pendrive On the pendrive you can find the following folders: \Driver \ODV \SDK \Setup USB driver for the DAQ (for manual installation) OptoForce Data Visualization Software (runs from the pendrive) OptoForce Software Development Kit (without installation) Contains all the setup files (Driver, ODV, SDK) \ This document in PDF format \ Autorun.exe (Menu for the automated installation) OptoForce page 2
I N S T A L L A T I O N ( W I N D O W S ) PLEASE NOTE THAT ADMINISTRATOR PRIVILAGE COULD BE REQUIRED FOR THE DRIVER INSTALLATION IF SO PLEASE CONTACT YOUR SYSTEM ADMINISTRATOR! INSTALLATION STEPS First Step Execute AutoRun.exe from the Pendrive. Second Step The OptoForce DAQ requires a device driver in order to operate. Click on Install USB Driver and follow the driver installation instructions. If the vendor of the driver needs to be confirmed click on Install. Third Step Once the Driver Installation finished, click on Install Data Visualization (3D or 6D) and follow the instructions. Once the installation has finished the software will be automatically opened. OptoForce page 3
I N S T A L L A T I O N ( L I N U X ) INSTALLATION STEPS First Step Unpack the archives to an optional directory List of archives (where x.x.x is the actual version number): ODV3D: DAQ material/usb/odv/odv_3d/linux/odv3d_vx.x.x.tar.gz ODV6D: DAQ material/usb/odv/odv_6d/linux/odv6d_vx.x.x.tar.gz API: DAQ material/usb/sdk/linux/1.x/linux_api_v1.x.x.tar.gz Second Step The OptoForce DAQ does not need any drivers to be installed under Linux systems. To operate the Data Visualization softwares you should go through these steps (ODV3D/6D): Start a Terminal Change directory where you unpacked the ODV3D/6D software Enter sudo chmod +x ODV3D or sudo chmod +x ODV6D To start the application, enter sudo./odv3d or sudo./odv6d To start application without sudo, type sudo usermod -a -G dialout $USER then do a logout/login procedure to apply the settings. After the application started it automatically opens dev/ttyacmn (the DAQ device, value of n may changes) You may experience problems when you connect your DAQ to the PC and almost immediately start ODV 3D or ODV 6D: in this case the application does not always recognize the DAQ or it recognizes the DAQ, but some seconds later the connection lost. This phenomenon is caused by a daemon, namely modemmanager. You can do fix this problem in two ways: OptoForce page 4
I N S T A L L A T I O N ( L I N U X ) 1. You should read about the aim of this daemon (http://www.freedesktop.org/wiki/software/modemmanager) and if you do not need it, the easiest way to get rid of the problem is to remove it: sudo apt-get purge modemmanager 2. The second way is to temporaly prevent the daemon from running: sudo mv /usr/share/dbus-1/system-services/org.freedesktop.modemmanager1.service ~/manager.service sudo stop modemmanager and Now you can start ODV3D or ODV6D and connect your DAQ. To make the service available again, you should move back manager.service back to its original folder: sudo mv ~/manager.service /usr/share/dbus-1/systemservices/org.freedesktop.modemmanager1.service and restart the service: sudo start modemmanager (Note 1 : In some cases just stopping and starting of the modemmanager deamon can fix the problem. If this is the case then you do not need moving the file. Note 2 : The name of the file can be different (i.e. not org.freedesktop.modemmanager1.service but org.freedesktop.modemmanager.service) sudo killall modem-manager OptoForce page 5
T R O U B L E S H O O T I N G ( W I N D O W S ) TROUBLESHOOTING If in the OptoForce Data Visualization software on the Connection tab, the Available Sensors shows 0, then: Manual driver installation might be needed. In this case please check the appropriate driver installation manual on the pendrive (\Driver\driver_installation_xp or driver_installation_win7) Try to disconnect and reconnect the DAQ while the software is running Check the cables and the connections (see above picture), the blue LED must continuously light (showing the power ON state) and the green LED must blink (showing the data communication) DAQ USB mini B Sensor USB cable Sensor cable 1m (±5cm) OptoForce page 6
T R O U B L E S H O O T I N G ( L I N U X ) TROUBLESHOOTING If in the OptoForce Data Visualization software on the Connection tab, the Available Sensors shows 0, then: Close the application, disconnect and reconnect the DAQ and restart the application after ~15-20 seconds (see installation seciton of the guide) Check the cables and the connections (see picture on the previous page), the blue LED must continuously light (showing the power ON state) and the green LED must blink (showing the data communication) If the application does not start and produces and error message like version `GLIBCXX_3.4.xx' not found (required by./odv6d or./odv3d) then you should go through these steps: 1. Start a terminal and update g++ to version 4.8: 2. Type sudo add-apt-repositoryppa:ubuntu-toolchain-r/test 3. Type sudo apt-get update 4. Type sudo apt-get install g++-4. g++-4.8 5. You can check other dependencies by typing sudo ldd ODV3D or sudo ldd ODV6D If the application cannot open output file when you want to use the Write to file function, then please start the application with sudo./odv3d or with sudo./odv6d OptoForce page 7