INCA V7.0 Instrument Integration Development Kit
Quick Start Guide
Copyright
The data in this document may not be altered or amended without special notification
from ETAS GmbH. ETAS GmbH undertakes no further obligation in relation to this document. The software described in it can only be used if the customer is in possession of a
general license agreement or single license. Using and copying is only allowed in concurrence with the specifications stipulated in the contract.
Under no circumstances may any part of this document be copied, reproduced, transmitted, stored in a retrieval system or translated into another language without the express
written permission of ETAS GmbH.
© Copyright 2010 ETAS GmbH, Stuttgart
The names and designations used in this document are trademarks or brands belonging
to the respective owners.
Document AM010401 R1.0.0 EN
2
1
Create an Instrument
The purpose of this document is to get you started with the INCA Instrument Integration
Development Kit in an efficient way. It provides information on how to install the SDK on
your system and shows how to create a new instrument.
For the description of the implementation, please refer to the Tutorial document.
1.1
Install the Etas Instrument Integration SDK
To use the Instrument Integration Development Kit you need Visual Studio 2008 or Visual
Studio 2008 Express. Furthermore, you need INCA v7.0 and the INCA Instrument
Integration SDK.
You have to install the programs in the following order
1. Visual Studio 2008 or Visual Studio 2008 Express
2. INCA V7.0
3. INCA Instrument Integration SDK
1.2
Create a new Instrument
The first step to your own instrument is to create a new Project in Visual Studio.
To create a new project
! Open Visual Studio
! Select File " New
" Project
! Select Visual C# "
ETAS " INCA
Custom
Instrument
! Click OK.
! Run through the
Wizard and configure
the project settings.
After you have finished the wizard, Visual Studio
creates a complete Visual Studio Project
containing all files you need to create the
instrument.
If you use Visual Studio Express, you will not see the "INCA Custom Instrument" project
template, see step 3 above. You need to copy the file "<ETAS>\INCA Instruments
Integration SDK 1.0\VS2008Template\INCA Custom Instrument.zip" to the following
location: "C:\Documents and Settings\<user>\My Documents\Visual Studio
2008\Templates\ProjectTemplates\Visual C#" and restart Visual Studio Express.
You will then see the "INCA Custom Instrument" project template in "File " New Project".
Note
Do not extract the file, just copy the zip-file.
Create an Instrument
3
1.3
Modify the instrument user interface
To modify the user interface of your instrument you
can use the UI Developer from Visual Studio. The UI
components are located in the Visual Studio toolbox.
To change the Instrument layout
! Choose your windows
form and drag it to the
instrument UI.
! Save Layout
You can find Information about the implementation in the tutorial.
1.4
Integrate the instrument in INCA
To integrate the Instrument in INCA
! Close INCA.
! Select Build -> Build Solution or press F7 in Visual Studio.
After you have built the solution, Visual Studio copies the solution automatically into the
INCA plug-in folder located at “C:\EtasData\INCA7.0\Instruments”.
! Restart INCA.
Now you can see your instrument in the “Variable Selection Dialog” in the Experiment
Environment. There is a new Icon in the toolbar at the top of the window and you can
choose your instrument from the context menu in the widget tree.
You can find further information about the Instrument Integration Development Kit in the
tutorial.
4
Create an Instrument
2
ETAS Contact Addresses
ETAS HQ
ETAS GmbH
Borsigstraße 14
70469 Stuttgart
Germany
Phone:
Fax:
WWW:
+49 711 89661-0
+49 711 89661-106
www.etas.com
ETAS Subsidiaries and Technical Support
For details of your local sales office as well as your local technical support team and product
hotlines, take a look at the ETAS website:
ETAS subsidiaries
ETAS technical support
ETAS Contact Addresses
WWW:
WWW:
www.etas.com/en/contact.php
www.etas.com/en/hotlines.php
5