Adam.NET Class Library For Visual Studio .
NET 2003 Installation Guide
Engineer: Tony Liu History: First edition, 2005/9/16 First release, 2006/03/23 Second release, 2006/5/30
1. Introduction
The Adam.NET Class Library is the newest release for user to write their code by using .NET technology to control ADAM-4000, ADAM-5000, ADAM-5000/TCP and ADAM-6000 series. For Win32 version, there are four main namespaces: Advantech.Protocol This contains the ModbusRTU and ModbusTCP packet constructor. Advantech.Graph This contains some useful graphic controls for user to create their HMI like programs. Advantech.Common This contains basic classes for communication and packet invalidation. Advantech.Adam This is the core of this library. You can use this to control and configure the ADAM series through serial and Ethernet communication.
This document will guide you through the installation of Adam.NET Class Library and Adam.NET Class Library Help.
2. Prerequisite
Before the installation, you have to install the Microsoft Visual Studio .NET 2003 as well as the Microsoft Visual Studio .NET 2003 documentation. For WinCE programmers, you have to install the ActiveSync and Windows CE .NET Utilities v1.1 for Visual Studio .NET 2003 from Microsoft website. Please link to the following web page to get the copy. ActiveSync http://www.microsoft.com/downloads/details.aspx?FamilyID=d2645c21-8a85-45a2-8 d13-653beb6cdddc&DisplayLang=en Windows CE .NET Utilities v1.1 for Visual Studio .NET 2003 http://www.microsoft.com/downloads/details.aspx?FamilyID=7ec99ca6-2095-4086-b 0cc-7c6c39b28762&displaylang=en
3. Adam.NET Class Library Installation
Run the installation package Adam.NET Class Library.exe. This will install Adam.NET Class Library for Win32 and WinCE. The Win32 class library will be installed into the following path: Program Files\Advantech\Adam.NET Class Library\VS2003. The WinCE class library will be installed into the following path: Program Files\Microsoft Visual Studio .NET 2003\CompactFrameworkSDK\v1.0.5000\Windows CE The sample programs will be installed into the following path: Program Files\Advantech\Adam.NET Class Library\VS2003\Samples The normal samples include following contents: The Win32 version samples for both C# and VB.NET. The WinCE version samples for both C# and VB.NET. The Pocket PC version for C#. The Adam.Graph samples (called EZGC, Easy Graphic Controls) include following contents: The Win32 version samples for C#. The WinCE version samples for C#. The Pocket PC version samples for C#.
4. Adam.NET Class Library Help Installation
Run the installation package Adam.NET Class Library Help.msi. This will install Adam.NET Class Library Help. The help documentation is integrated into the Microsoft Visual Studio .NET environment. You can view the help by using the Microsoft Visual Studio .NET 2003 documentation. You can also find the dynamic help when you using the Microsoft Visual Studio .NET. During the installation, it may takes up to few minutes to register the documentation. After the installation, it may also takes up to few minutes for Microsoft Visual Studio .NET and Microsoft Visual Studio .NET 2003 documentation to update the help collection.
5. Using the Adam.NET Class Library
Create your own project in the Visual Studio, in the Solution Explorer window, point to the References node under your project, right click the mouse to display the popup menu, click Add reference to display Add Reference window. For Win32 project, click Browse to display Select Component window, in the Look in combo box, change the directory to Program Files\Advantech\Adam.NET Class Library\VS2003, select Advantech.Adam.dll and Advantech.Common.dll, click Open, two components are listed in the Selected Components pane of the Add Reference window, click OK. For WinCE project, in the .NET tab select the Advantech.Adam and click Select, and then select the Advantech.Common and click Select, two components are listed in the Selected Components pane of the Add Reference window, click OK. Two components are listed under the References node of your project. Now, you are ready to use the Adam.NET Class Library to code your program.
