logo资料库

MTConnect SDK.pdf

第1页 / 共24页
第2页 / 共24页
第3页 / 共24页
第4页 / 共24页
第5页 / 共24页
第6页 / 共24页
第7页 / 共24页
第8页 / 共24页
资料共24页,剩余部分请下载后查看
MTConnect .NET Software Development Kit (SDK) Version 2.1.7 March 7, 2011 MTConnect is a registered trademark of AMT - The Association for Manufacturing Technology. Use of MTConnect is limited to use as specified on http://www.mtconnect.org/.
Revision History ....................................................................................................... 3  Table of Contents Introduction ............................................................................................................ 4  Architecture ............................................................................................................ 4  SDK Solution and Projects ........................................................................................ 5  MTConnectAgent Solution .................................................................................. 5  MTConnectAgentCore Project ............................................................................. 5  MTConnectAgentCoreWindows Project ................................................................ 5  MTConnectAgentCoreWindowsService Project ...................................................... 5  MTConnectAgentCoreWindowsServiceSetup Project ............................................. 5  Implementation Scenarios ........................................................................................ 6  Independent Adapter and Independent Agent ........................................................ 6  Combined Adapter and Agent ................................................................................ 6  Embedded Agent .................................................................................................. 7  How to Guide .......................................................................................................... 8  Windows Application Version ................................................................................. 8  How do I install the Windows Application Version? ............................................... 8  How do I run the Windows Application Version? ................................................... 8  Windows Service Version ...................................................................................... 9  How do I install the Windows Service Version? .................................................... 9  How to Run ....................................................................................................... 9  How to Stop ...................................................................................................... 9  How to Uninstall ................................................................................................ 9  Agent Interaction ............................................................................................... 10  How do I send an HTTP Request to the Core Agent? .......................................... 10  How do I send Data to the Core via HTTP? ........................................................ 10  How do I configure the Core Agent? ................................................................. 10  How can I view data stored by the Agent? ......................................................... 10  Development ...................................................................................................... 11  How can I Use the DLL in a Visual Studio 2005 C# Project? ................................ 11  Start Function .................................................................................................... 12  Stop Function ..................................................................................................... 12  StoreSample Function ......................................................................................... 13  StoreEvent Function ........................................................................................... 14  StoreCondition Function ...................................................................................... 15  HTTP Interface ...................................................................................................... 16  debug ................................................................................................................ 17  storeSample ....................................................................................................... 17  storeEvent ......................................................................................................... 18  storeCondition .................................................................................................... 19  version .............................................................................................................. 19  Agent Configuration ............................................................................................... 20  SDK Package Structure ........................................................................................... 21  General .............................................................................................................. 21  MTConnect .NET SDK Guide Page 1
Core Agent ........................................................................................................ 21  Windows Executable to Run Core Agent ............................................................... 21  Windows Service to Run Core Agent .................................................................... 21  Create Core Agent Windows Service .................................................................... 22  Known Issues ........................................................................................................ 23  Comments or Questions ......................................................................................... 23  MTConnect .NET SDK Guide Page 2
Revision History Date Description Author Version Date Description Author Version 4/30/2008 Initial Draft 5/1/2008 Changes and Recommendations from Paul Warndorf. 5/19/2008 Updated images. Added table of contents, terminology, and revision history. Various edits throughput. Georgia Tech Prerelease Georgia Tech 0.1 Georgia Tech 0.2 6/3/2008 Updated images. Georgia Tech 0.21 6/26/2008 Modified scenario section. See change log Georgia Tech 0.22 for list of code changes. 7/11/2008 Significant rewrite of the documentation. See change log for list of code changes. Georgia Tech 0.3 8/7/2008 8/15/2008 Changed the syntax for http storeEvent and storeSample requests. Added LDAP functionality. See change log for list of code changes. SHDR rejecting Event other than type Alarm. Various other fixes. See change log for list of code changes. Georgia Tech 0.4 Georgia Tech 0.41 10/20/2008 Changed Adapter to be a MS service for Georgia Tech 0.45 the Core Agent and the SHDR Agent. 12/22/2008 Revamped the Agent SDK document for Georgia Tech 0.5 clarity and further definition. 12/8/2010 Updated for MTConnect version 1.1.0 Georgia Tech 2.1 03/11/2011 Updated by Lei Yang version 2.1.7 Georgia Tech 2.1.7 MTConnect .NET SDK Guide Page 3
Introduction The .NET software development kit (SDK) was written to reduce the time and effort required to implement an MTConnect interface. It consists of four Visual Studio Projects that allow implementers to use the SDK in a variety of scenarios. The SDK was developed in Visual Studio 2008 and written in C#. It can be embedded directly into your application, used as a stand-alone Windows application or run as a Windows service. Architecture The following diagram provides an overview of the .NET Agent SDK architecture: MTC onnect Device MTC onnect  C lient Application Adapter HTTP  Input MTC onnect Interface Agent AP I Agent F unctionality Data S tore Agent C ore C onfiguration The Agent Core of the SDK contains the base functionality of the agent and can be accessed via function calls or HTTP. Functional and HTTP access allow the SDK to be used in a variety of ways MTConnect .NET SDK Guide Page 4
SDK Solution and Projects The SDK is written in Microsoft Visual Studio 2008 using C# and consists of one Visual Studio Solution containing four Visual Studio Projects. The solution and projects are as follows: MTConnectAgent Solution This solution contains the four SDK projects. MTConnectAgentCore Project This project produces an Agent Core DLL that can be embedded into an application. MTConnectAgentCoreWindows Project This project produces an executable file that exercises the Agent Core DLL through a simple graphical user interface. MTConnectAgentCoreWindowsService Project This project defines the MTConnect Agent Core as a window service. MTConnectAgentCoreWindowsServiceSetup Project This project produces an install shield and a setup.exe for the Core Agent Service. MTConnect .NET SDK Guide Page 5
Implementation Scenarios This section describes three possible scenarios in which the SDK can be used to implement an MTConnect interface. Independent Adapter and Independent Agent In this scenario, the adapter and agent are implemented as independent entities and can be manifested as either Windows Applications or Windows Services. The adapter communicates with the controller (typically via a serial or network connection) and with the agent via http. The agent provides the MTConnect interface to the client. The following diagram illustrates this scenario: Serial Device Adapter Agent Client HTTP MTConnect Network Combined Adapter and Agent In this scenario, the adapter and agent are combined into a single Windows Application or Windows Service. The combined entity communicates with both the device and the MTConnect client. Device Serial Network Adapter and Agent MTConnect Client MTConnect .NET SDK Guide Page 6
Embedded Agent In this scenario, the agent is embedded in the device and the device communicates with the agent through function calls. The agent communicates with the MTConnect client. The following diagram illustrates this scenario: Device Function Calls MTConnect Executable Agent Client MTConnect .NET SDK Guide Page 7
分享到:
收藏