Visual C# Developer Guide [Ver. 2014.10.30] 1 Visual C# Developer Guide
목 차 1 장 ATS-M1000DA 시리즈준비사항... 5 1.1 설치전준비사항... 5 1.2 연결하기... 5 1.2.1 ATS-1000DA 시리즈전원연결... 5 1.2.2 PC 와 ATS-1000DA 시리즈연결... 6 1.3 모드설정방법... 6 1.4 응용프로그램 AutoRun 모드... 7 1.4.1 AutoRun 모드응용프로그램추가, 편집... 8 1.4.2 AutoRun 삭제... 9 1.4.3 AutoRun 내용저장... 9 2 장개발환경설정... 10 2.1 Microsoft Visual Studio 2008 실행... 10 2.2 ActiveSync 설치... 18 2.2.1 Active Sync/Windows Mobile Device Center 설치... 18 2.2.2 USB 케이블연결... 18 2.2.3 Windows XP ActiveSync 설치... 19 2.2.4 Windows Vista/Windows7 ActiveSync(Windows Mobile Device Center) 설치 20 3 장 Visual C# Windows CE 프로젝트작업... 21 3.1 Visual C# 프로젝트생성과정... 21 3.2 Visual Studio 화면 (UI) 구성... 24 3.3 Visual Studio C# 장치프로젝트만들기... 25 4 장 ATS 시리즈라이브러리파일... 29 2 Visual C# Developer Guide
4.1 Ats 라이브러리파일설치... 29 4.2 Ats 라이브러리파일등록... 29 4.2.1 AtsCppUD 파일이용방법... 31 4.3 Ats 라이브러리파일사용방법... 32 4.4 Ats 라이브러리파일의클래스구성... 33 4.5 Ats 라이브러리파일의클래스구성... 34 3 Visual C# Developer Guide
업데이트된사용설명서는저희회사홈페이지 www.autobase.biz 에서확인하시기바랍니다. 본제품을사용하기이전에반드시본사용설명서를충분히읽어본뒤사용하시기바랍니다. 진행상문의사항은오토베이스홈페이지의고객지원 > Q/A 혹은자사의기술지원팀으로연락주 시기바랍니다. 4 Visual C# Developer Guide
1 장 ATS-M1000DA 시리즈준비사항 ATS-M1000DA 시리즈는사용자가직접프로그램을개발 / 배포하여이용하실수있습니다. 본사용설명서는 Visual C# 을이용하시는개발자에게빠른이해와쉬운개발환경구축을안내하며, Visual C# 에대한사전지식이필요합니다. 1.1 설치전준비사항 ATS-M1000DA 시리즈를통해제품프로그램개발을하기위해서는먼저, ATS-M1000DA 시리즈 의실행및 PC 와의연결이되어야하며, 필요한구성품은 < 그림 1-1> 과같습니다. < 그림 1-1> ATS-M1000 시리즈 / 전원어댑터 /USB2.0 케이블 1.2 연결하기 ATS-M1000DA 시리즈는 DC 어댑터에 12V DC 전원을입력하거나, 3핀전원입력소켓에 24V 주전원을입력하여선택적으로연결하실수있고, 전원연결을완료하신후에는 PC와 ATS- M1000DA 시리즈를연결함으로써, 개발환경구축을위한준비를마치실수있습니다.. [ 참고 ] 매뉴얼은 DC 어댑터로전원연결을한것으로작성되어져있습니다. 1.2.1 ATS-1000DA 시리즈전원연결 < 그림 1-2> 와같은 DC 어댑터전원입력소켓에, < 그림 1-3> 처럼어댑터를연결시켜주십시오. < 그림 1-2> DC 어댑터용전원입력소켓의모습 5 Visual C# Developer Guide
❶ ❷ < 그림 1-3> DC 어댑터전원연결모습 1.2.2 PC 와 ATS-1000DA 시리즈연결 전원입력이완료되신후 ATS-1000DA 시리즈에 < 그림 1-4> 와같이 USB 케이블을연결함으로 써, 개발하신프로그램이배포될수있습니다. [ 참고 ] USB 케이블설치후관련프로그램셋팅에관련된사항은매뉴얼 2.2 장을참조해주시 기바랍니다. ❶ ❷ < 그림 1-4> USB 케이블과 ATS-1000DA 시리즈연결모습 1.3 모드설정방법 ATS-M1000DA 시리즈는 Mode 스위치의설정에따라부팅방법, Debug, Auto Run 등의여러동작모드를지원하고있습니다. < 그림 1-5> 는 Mode 스위치의 ON/OFF 방향에대한설명이고, < 표 1-1> 은 Mode 스위치의상태에따른내용입니다. < 그림 1-5> Mode 스위치의 ON/OFF 방향 6 Visual C# Developer Guide
스위치번호 ON 시설정내용 비고 1 Nand Memory Boot Mode 일반적인경우항상 Off로설정해야함, On 시부팅안됨 2 USB Device Boot Mode 사용안함, 항상 Off 로설정, On 시부팅안됨 3 COM3를 Debug 포트로사용 일반적인경우항상 Off 로설정, On으로설정시 COM3 사용불가 4 Auto Run 설정의사용 Auto Run 사용시 ON으로설정 Auto Run = 부팅시실행할프로그램을등록하여실행하는유틸리티 < 표 1-1> Mode 스위치의상태에따른내용 [ 주의 ] Mode 스위치의 1, 2 번을 On 하면윈도우부팅이되지않습니다. 또한 4 번스위치를 On 하고 Explorer.exe 를 Auto Run 에넣지않으면윈도우기본화면이보이지않습니다. 1.4 응용프로그램 AutoRun 모드 AutoRun 모드는 ATS-M1000DA 시리즈부팅시실행되는모드를의미합니다. 해당설정은 ATS-M1000DA시리즈에서지원하는 UtilMain 프로그램을이용하여설정가능합니다. AutoRun은 Mode 스위치의 4번이 On 상태로설정하고윈도우부팅시실행되는프로그램을말합니다. AutoRun 은 < 표 1-2> 와같은파일이름, 작성형식, 실행조건으로되어있습니다. 구분 내용 파일이름 \AutoRun.inf 작성형식 Text 형식으로작성 실행조건 Mode 스위치의 4번이 On 일때 < 표 1-2> AutoRun 의파일이름, 작성형식및조건에대한내용 [ 참고 ] AutoRun 은 Text 에디터로도실행할파일을간단한형식으로입력할수도있지만 < 그 림 1-6> 와같은 UtilMain 프로그램으로설정하는것이좋습니다. ATS-M1000DA 실행시킨후바탕화면의 UtilMain 프로그램의 AutoRun 탭이나타납니다. 아이콘을선택하시면 < 그림 1-6> 과같은 7 Visual C# Developer Guide
< 그림 1-6> UtilMain 프로그램 AutoRun 탭의예 1.4.1 AutoRun 모드응용프로그램추가, 편집 < 그림 1-6> 에서또는버튼을누르면 < 그림 1-7> 과같은추가, 편집대 화상자에서 AutoRun 으로실행할파일을설정할수있습니다. < 그림 1-7> AutoRun 추가, 편집대화상자의예 < 그림 1-7> 의 Open Filename 에디터에실행할파일의폴더와이름을입력하거나아이콘을선택하여나타나는파일선택대화상자에서실행할파일을선택할수있습니다. Command Line 영역은 HdmiOut.exe 과같은프로그램처럼실행파일뒤에명령인자가필요한경우설정하고 Sleep는부팅후실행파일이실행될때기다리는시간을입력합니다. < 표 1-3> 는 AutoRun 추가 / 편집대화상자의설정인자및내용입니다. [ 주의 ] 여러개의 AutoRun 파일을등록하고앞쪽실행파일에 Sleep 이설정되어있는경우 뒤쪽의실행파일도앞쪽의 Sleep 만큼기다린후실행되므로주의를요합니다. 8 Visual C# Developer Guide
설정인자 내용 비고 Open Filename 실행파일폴더및이름 Command Line 실행파일의명령인자 HdmiOut.exe 등에사용 Sleep 실행대기시간 CeVncServer.exe 는 Sleep 등은필요함 < 표 1-3> AutoRun 추가 / 편집대화상자의설정인자및내용 < 표 1-4> 는 AutoRun 설정시주의해야할실행파일과내용입니다. 실행파일이름 Explorer.exe HdmiOut.exe CeVncServer.exe 내용 \Windows\Explorer.exe 를 AutoRun에입력하지않으면윈도우기본화면이생성되지않습니다. 이때는실행파일을종료하면윈도우를사용할수없습니다. 사용자실행프로그램에서 \Windows\Explorer.exe 를실행하여윈도우기본화면을사용할수있습니다. \Tools\HdmiOut.exe 실행시설정해상도와 DVI 모드여부는실행파일뒤의명령인자로설정함. Ethernet 주소유형이 DHCP일때 \Tools\CeVncServer.exe 는 20000 msec 정도의 Sleep 가필요함 < 표 1-4> AutoRun 설정시주의해야할실행파일과내용 1.4.2 AutoRun 삭제 < 그림 1-6> 의 AutoRun 이설정된항목을선택후, 버튼으로등록된 AutoRun 파일을 삭제할수있습니다. 1.4.3 AutoRun 내용저장 < 그림 1-6> 의버튼을눌러서설정한 AutoRun 파일을레지스트리에저장할수있 습니다. 수정한 AutoRun 내용저장은 UtilMain 프로그램종료를위한 저장됩니다. 버튼을눌러도 9 Visual C# Developer Guide
2 장개발환경설정 개발환경설정을위해서는 Microsoft 사의 Visual Studio의설치가필수적입니다. 해당프로그램의제품군은 MS Visual Studio Standard 2008, MS Visual Studio Professional 2008, MS Visual Studio Team Edition 2008 등으로나뉘며, Standard 버전의경우에는장치용응용프로그램개발을할수없으므로, Professional 혹은 Team Edition 제품을사용하시기바랍니다. [ 참고 ] 매뉴얼은 Professional 버전을기준으로작성되어져있습니다. 2.1 Microsoft Visual Studio 2008 실행 설치는 Visual Studio 2008 Professional 설치, 서비스팩 1 설치, Visual Studio 2008 update for Windows Embedded Compact 7 설치, ATS-M1000 SDK의설치 (C++ 사용시에해당 ) 등, 총 4단계로진행됩니다. 첫번째단계, Visual Studio 2008 Professional 설치를우선적으로해줍니다. 설치를실행하면아래 < 그림 2-1> 과같은화면이나타납니다. < 그림 2-1> Visual Studio 2008 설치시작화면 < 그림 2-1> 에서 Visual Studio 2008 설치항목을선택하면, < 그림 2-2> 와같은화면이나타납니다. 다음 버튼을누를때마다나타나는항목들을설정해주시면서설치를완료해주시면 < 그림 2-3> 과같은설치완료화면이나타납니다. 10 Visual C# Developer Guide
< 그림 2-2> Visual Studio 2008 설치진행화면 < 그림 2-3> Visual Studio 2008 설치완료화면 두번째단계, Visual Studio SP1( 서비스팩 1) 을설치해주시면되겠습니다. 해당프로그램설치 역시, 첫번째단계와마찬가지로 다음 버튼을눌러진행을시켜주시면되겠습니다. < 그림 2-4>~< 그림 2-6> 은 Visual Studio SP1( 서비스팩 1) 설치진행부터완료까지의화면입니다. 11 Visual C# Developer Guide
< 그림 2-4> Visual Studio 2008 SP1( 서비스팩 1) 설치시작화면 < 그림 2-5> Visual Studio 2008 SP1( 서비스팩 1) 설치진행화면 12 Visual C# Developer Guide
< 그림 2-6> Visual Studio 2008 SP1( 서비스팩 1) 설치진행화면 < 그림 2-6> 과같은설치진행을완료하면, < 그림 2-7> 과같은설치마법사화면이나타나게되 고, PC 를재부팅시켜주시면됩니다. < 그림 2-7> Visual Studio 2008 SP1 설치마법사화면 세번째단계, Visual Studio 2008 update for Windows Embedded Compact 7 설치를진행시켜주시면됩니다. 해당프로그램설치역시, 첫번째, 두번째단계와마찬가지로 다음 버튼을눌러진행을시켜주시면되겠습니다. < 그림 2-8>~< 그림 2-11> 은Visual Studio 2008 update for Windows Embedded Compact 7의설치진행부터완료까지의화면입니다. 13 Visual C# Developer Guide
< 그림 2-8> Visual Studio 2008 update for Windows Embedded Compact 7 설치시작화면 < 그림 2-9> Visual Studio 2008 update for Windows Embedded Compact 7 설치진행화면 14 Visual C# Developer Guide
< 그림 2-10> Visual Studio 2008 update for Windows Embedded Compact 7 설치진행화면 < 그림 2-11> Visual Studio 2008 update for Windows Embedded Compact 7 설치완료화면 15 Visual C# Developer Guide
네번째단계는 ATS-M1000 SDK 설치로써, 이는 C++ 을이용하여장치응용프로그램개발시에설치를하시면되며, C# 과 Basic을이용하여프로그램개발을하실경우에는설치를하지않으셔도무방합니다. < 그림 2-12>~< 그림 2-14> 는 ATS-M1000D SDK 설치과정에대한화면입니다. < 그림 2-12> ATS-M1000D SDK 설치시작화면 < 그림 2-13> 은설치종류선택대화상자입니다. Custom 을선택할경우설치항목을사용자가 선택적으로설치가가능하며, Complete 를선택할경우프로그램전체를설치하게됩니다. ( 본매 뉴얼에서는 Complete 설치선택 ) 16 Visual C# Developer Guide
< 그림 2-13> ATS-M1000D SDK 설치종류선택대화상자 < 그림 2-13> 에서설치종류를선택하신후 Next 버튼을눌러, 설치를완료시키시면됩니다. < 그림 2-14> 는설치완료대화상자입니다. < 그림 2-14> ATS-M1000D SDK 설치완료화면 17 Visual C# Developer Guide
2.2 ActiveSync 설치 Smart 제품과사용자 PC와의호환을위해선동기화프로그램의설치가반드시이루어져야합니다. 일반적으로 ATS-M1000DA 시리즈와사용자컴퓨터를연결하면 ActiveSync 프로그램이자동으로실행됩니다. 2.2.1 Active Sync/Windows Mobile Device Center 설치 동기화프로그램은 OS 마다조금씩명칭이다르며, 그내용은아래 < 표 2-1> 과같습니다. Windows XP Windows Vista / Windows 7, 8 이상 명칭 ActiveSync Windows Mobile Device Center 마이크로소프트홈페이지에서다운가능 (http://www.microsoft.com/enus/search/downloadresults.aspx?q=activesync) 경우마이크로소프트홈페이지에서다운 OS에탑재되어있음, 설치되어있지않은다운경로혹은 Autobase SCADA OEM DVD에포함가능 된프로그램으로설치가능 주의 : ActiveSync/Windows Mobile Device Center는 Window Media Player가설치되어있어야 합니다. < 표 2-1> 사용자컴퓨터의 OS 별연력프로그램명칭및경로 2.2.2 USB 케이블연결 ATS-M1000DA 시리즈와사용자컴퓨터와의연결을위해서는 < 그림 2-15> 와같은 USB Device 용케이블을각각연결하여야합니다. < 그림 2-16> 과같은 ATS-M1000DA 시리즈 USB Device 포트에 < 그림 2-15> 의 B Type 컨넥터 ( ) 를연결하고사용자컴퓨터에는 A Type 컨넥터 ( ) 를연결합니다. < 그림 2-15> ATS-M1000DA 시리즈와연결을위한 USB 케이블의예 18 Visual C# Developer Guide
< 그림 2-16> USB Device 포트의모습 2.2.3 Windows XP ActiveSync 설치 사용자컴퓨터의 OS 가 Windows XP 일때 ATS-M1000DA 시리즈와연결을위해사용하는프로그램은 ActiveSync 입니다. < 그림 2-15> 와같은 Device 용 USB 케이블을 ATS-M1000DA 시리즈와사용자컴퓨터에각각연결하면 < 그림 2-17> 과같은 ActiveSync 프로그램이자동으로실행됩니다. < 그림 2-17> ActiveSync 4.5 버전의실행예 Windows XP 환경에서 < 그림 2-17> 와같은 ActiveSync 자동으로실행되지않을경우에는 < 표 2-2> 와같은사항들을체크하여사용합니다. 체크사항 케이블연결 확인내용 USB 케이블연결을다시확인 케이블연결위치 ATS-M1000DA 시리즈에는 과같은 B Type Connector, 인식불량 Windows Mobile Device 사용자컴퓨터에는과같은 A Type Connector 를연결 ATS-M1000DA 시리즈재시작 ( Power Reset ) 또는사용자컴퓨터재시작 MS 사홈페이지에서다운로드하여설치 19 Visual C# Developer Guide
Center 미설치기타연결불량 ATS-M1000DA 시리즈서비스센터로연락해주세요 < 표 2-2> ATS-M1000DA 시리즈와연결을위한프로그램의연결불량체크사항 2.2.4 Windows Vista/Windows7 ActiveSync(Windows Mobile Device Center) 설치 사용자컴퓨터의 OS 가 Windows Vista, Windows 7, Windows 8 등일때 ATS-M1000DA 시리즈와연결을위해사용하는프로그램은 Windows Mobile Device Center 입니다. < 그림 2-15> 와같은 Device 용 USB 케이블을 ATS-M1000DA 시리즈와사용자컴퓨터에각각연결하면 < 그림 2-18> 과같은 Windows Mobile Device Center 프로그램이자동으로실행됩니다. < 그림 2-18> Windows Mobile Device Center 프로그램의예 만약 < 그림 2-18> 과같은 Windows Mobile Device Center 가실행되지않을경우에는 < 표 2-2> 와같은사항들을체크하여사용합니다. 20 Visual C# Developer Guide
3 장 Visual C# Windows CE 프로젝트작업 ATS-M1000DA 시리즈에사용할장치응용프로그램을개발할경우 Visual C# 프로젝트를 Windows용이아닌스마트장치프로젝트로생성시켜주어야하며, 개발시반드시 PC와 ATS- M1000DA 시리즈가 ActiveSync로연결된상태여야합니다. 3.1 Visual C# 프로젝트생성과정 CE 프로젝트생성을위해아이콘을눌러, Visual Studio 2008 을실행시킵니다. < 그림 3-1> 는 Visual Studio 2008 실행시나타나는첫화면입니다. < 그림 3-1> Visual Studio 2008 실행시첫화면 < 그림 3-2> 과같이 < 그림 3-1> 항목에서 파일 \ 새로만들기 \ 프로젝트 선택하고, < 그림 3-3>~< 그림 3-5> 까지의새프로젝트를생성과정을따라주시면됩니다. 21 Visual C# Developer Guide
< 그림 3-2> Visual Studio 2008 새프로젝트생성메뉴 < 그림 3-2> 과같이선택을하면, < 그림 3-3> 과같은새프로젝트대화상자가나타나며, 해당대 화상자의프로젝트형식항목에서 Visual C# - 스마트장치, 템플릿항목에서스마트장치프로젝 트를선택하여주고 확인 버튼을눌러주시면됩니다. < 그림 3-3> Visual C# 새프로젝트대화상자 < 그림 3-3> 에서설정을마친후 확인 버튼을누르게되면, < 그림 3-4> 과같은새스마트장치 22 Visual C# Developer Guide
프로젝트추가대화상자가열리게됩니다. < 그림 3-4> Visual C# 새스마트장치프로젝트추가대화상자 대상플랫폼은 < 그림 3-4> 과같이 Windows CE로선택하여주며, 템플릿은응용프로그램을만들고자하실경우 장치응용프로그램 항목을, dll 형식의파일을만들고자하실경우엔 클래스라이브러리 항목을선택하여프로젝트를생성시켜주시면됩니다. < 그림 3-4> 의과정을마치신후 확인 버튼을누르실경우, < 그림 3-5> 와같이새프로젝트화면이나타나게됩니다. 23 Visual C# Developer Guide
< 그림 3-5> Visual C# 새프로젝트화면 3.2 Visual Studio 화면 (UI) 구성 ATS-M1000DA 시리즈의응용프로그램개발시 Visual Studio 의개발환경화면구성및내용은 < 표 3-1> 과같습니다. 화면구성 내용 디자인화면 도구상자에서디자인화면으로활동을끌어워크플로를만드는데사용하는화면. 도구상자 그래픽을디자인화면으로드래그앤드롭하여디자인으로표현. 속성 디자이너화면에서작업중인컴포넌트의속성을설정시사용. 솔루션탐색기 워크플로프로젝트를계층적으로볼수있도록트리형식으로표시하며프로젝트관련기능에액세스시사용. 디버깅창 스레드, 호출, 스택, 중단점, 로컬도구및조사식도구창과같은표준 Visual Studio 디버깅창. < 표 3-1> Visual Studio 의개발환경화면구성및내용 24 Visual C# Developer Guide
3.3 Visual Studio C# 장치프로젝트만들기 < 그림 3-5> 와같이새프로젝트가생성되면, < 그림 3-6> 처럼, 도구상자의 Button 을선택하여 Form1 에드래그앤드롭하여줍니다. < 그림 3-6> Visual C# 도구상자의 Button 을 Form1 에삽입한화면 삽입된 Button 을마우스로더블클릭하여주면, < 그림 3-7> 과같은코드작성화면이나타나게 되며, < 그림 3-8> 과같이메시지박스표시코드를작성해주시면됩니다. 25 Visual C# Developer Guide
< 그림 3-7> Visual C# 코드작성화면의예 < 그림 3-8> Visual C# 메시지박스표시코드작성예 코드작성이완료되면, < 그림 3-9> 과같이콤보박스에서배포할장치종류를선택하여주신 후, < 그림 3-10> 와같이버튼 (F5) 을눌러, Debug 를실행시켜주시면됩니다. 26 Visual C# Developer Guide
< 그림 3-9> Visual C# 장치종류선택콤보박스의예 < 그림 3-10> Visual C# Debug 실행버튼화면 디버깅이누르면, ATS-M1000DA 시리즈로배포가진행되고, 개발하신프로그램이화면에실행되 어나타나게됩니다. < 그림 3-11> 은위에서작성하신프로그램의버튼을누른예입니다. 27 Visual C# Developer Guide
< 그림 3-11> 배포한프로그램의버튼을클릭한예 < 그림 3-11> 과같이테스트가끝난실행파일은 Compact 장치에복사해서사용하시면됩니다. 28 Visual C# Developer Guide
4 장 ATS 시리즈라이브러리파일 Ats 시리즈의라이브러리 l 파일은 ATS 시리즈의하드웨어제어, Autobase SCADA CE 데이터공유 및기타.NET 용일반라이브러리함수들로구성되어있습니다. 4.1 Ats 라이브러리파일설치 Ats 라이브러리파일은오토베이스홈페이지의다운로드 \Touch Smart 자료항목에서다운받으실수있습니다. 다운로드하신파일을실행시키시면 < 그림 4-1> 과같이 C:\AutoBase\AtsLibrary\( 버전정보 ) 폴더하위에 AtsLibrarySample, Bin, Documents 세개의폴더가생성되어있는것을확인하실수있습니다. < 그림 4-1> AtsLibrary 파일이설치시경로및생성폴더 AtsLibrarySample 폴더내부에는 Ats 라이브러리를이용하여만든예제파일이존재하고, Bin 폴더에는실제라이브러리내의함수에대한정의가저장되어있는 dll 파일들이존재합니다. Documents 파일은라이브러리에서지원하는함수에대한설명및사용예제파일포함되어있습니다. 4.2 Ats 라이브러리파일등록 제공되는 dll 파일을참조하기위해선해당파일을프로젝트에추가하는과정이필요합니다. < 그림 4-2> 는새로만든프로젝트의솔루션탐색기영역에서 Ats 라이브러리파일을참조추가하는과정을나타내고있습니다. 29 Visual C# Developer Guide
< 그림 4-2> 솔루션탐색기에서 Ats 라이브러리파일참조추가 < 그림 4-2> 와같이솔루션탐색기트리에서마우스오른쪽버튼을누르면참조할 dll 파일을추 가할수있는메뉴가나타나며, 해당메뉴에서참조추가메뉴를눌러주시면 < 그림 4-3> 과같은 참조추가대화상자가나타나게됩니다. < 그림 4-3> 참조추가대화상자의예 해당대화상자의찾아보기탭에서 < 그림 4-1> 과같이 AtsLibrary 파일이설치된경로로찾아가 Ats_x_x 파일을선택하신후확인버튼을누르면, Ats 라이브러리함수를포함하고있는 dll 파일 등록이완료됩니다. 30 Visual C# Developer Guide
Ats_x_x.dll 파일을참조추가를완료하면, < 그림 4-4> 와같이 dll 파일이솔루션탐색기에추가되 는것을확인할수있으며, Ats_x_x.dll 파일에내장된함수들을이용하실수있습니다. < 그림 4-4> Ats_x_x.dll 파일의등록완료모습 4.2.1 AtsCppUD 파일이용방법 AtsCppUD 파일은 Extension I/O 보드를제어하기위한기능들이모여있습니다. AtsCppUD 파일은참조추가하여사용하는것이아니라, Ats 라이브러리파일이포함되어있는프로젝트폴더로복사 / 붙여넣기를해주셔야합니다. 우선적으로, 작성한프로젝트가 Touch Smart 장비내부에배포가되어있어야합니다. < 그림 4-5> 은 Touch Smart 제품내로작성한프로젝트폴더가배포된예입니다. < 그림 4-5> Touch Smart 제품내로작성한프로젝트폴더가배포된예 31 Visual C# Developer Guide
< 그림 4-5> 과같이 AtsCppUD 파일을복사 / 붙여넣기를해주기전에, 우선적으로작성한프로젝트를디버깅하여 Touch Smart 제품으로프로젝트배포를해주어야합니다. 프로젝트배포가완료되면, Touch Smart 장비내부의 Program Files\ 프로젝트명 의경로로프로젝트가생성됩니다. 이렇게배포된프로젝트폴더내부는 < 그림 4-6> 과같이구성되어있으며, 해당프로젝트내부로 AtsCppUD 파일을복사 / 붙여넣기를해주시면 Extension I/O 보드를제어할함수들을이용하실수있습니다. < 그림 4-7> 은 AtsCppUD 파일을붙여넣기를한예입니다. < 그림 4-6> 프로젝트폴더내부파일구성예 < 그림 4-7> ATS_IOCONT.dll 파일을붙여넣기한예 4.3 Ats 라이브러리파일사용방법 Ats 라이브러리파일을 Visual Studio의참조트리에등록을마치시면, < 그림 4-8> 와같이 Ats를기입시, 관련된클래스, 메서드, 열거형, 함수명등을선택할수있도록, 나타나게됩니다. < 그림 4-8> 는 Ats 라이브러리파일에포함된함수들의예입니다. < 그림 4-8> Ats 기입시나타나는클래스, 메서드, 열거형, 함수명들의예 각각클래스들은고유의다양한함수들로구성되어있으며, 관련함수들은. 문자를기입하여확 인, 사용가능합니다. < 그림 4-9> 는 ConvertTool 클래스의함수종류가표시되는예입니다. 32 Visual C# Developer Guide
< 그림 4-9> ConvertTool 함수종류표시의예 4.4 Ats 라이브러리파일의클래스구성 각각클래스들은다른기능을실행하는함수와, 공통적으로포함되어있는메서드들로구성되어 있습니다. < 표 4-1> 은 Ats 라이브러리파일에구성되어있는클래스들의종류와내용입니다. CommaBlockString 콤마로구분된문자열을해석하기위한클래스들의네임스페이스. Control 윈도우컨트롤설정관련클래스. ConvertTool 선택한객체를지정한자료형으로변환시키는클래스. DrawClass 지정한요소를그리는클래스. EnumPlaySound 지정한음성파일을재생 / 정지등에관련된클래스. EnumShowWindow 윈도우창의크기, 위치, 표시, 활성화등을제어 / 확인하는클래스. IOControl Extension I/O 모듈의상태를제어 / 확인하는클래스. MainBoard 메인보드에설치된이미지버전의정보및전원리셋에관련된클래스. OldDefine Visual Studio에서미리정의되어있는클래스들의네임스페이스. RegistryTool 레지스트리에등록된특정한데이터를읽고쓰기위한클래스. Scada Autobase CE의태그값및자료값에관련된클래스들의네임스페이스. TimeOutClass 통신시간초과에관련된클래스. TimeUtil 날짜 / 시간을가감하거나설정할수있는클래스. Win32Function 윈도우창제어에관련된클래스. < 표 4-1> Ats 라이브러리파일에구성되어있는클래스들의종류와내용 33 Visual C# Developer Guide
[ 참고 ] 각함수들의형식, 인자, 반환값등에관한자세한사항은 Ats Library 문서를참조하 시기바랍니다. 4.5 Ats 라이브러리파일의클래스구성 Ats 라이브러리파일이포함하고있는함수들의구성은 < 그림 4-10>~< 그림 4-23> 와같습니다. < 그림 4-10> CommaBlockString 의함수구성 < 그림 4-11> Control 의함수구성 34 Visual C# Developer Guide
< 그림 4-12> ConvertTool 의함수구성 35 Visual C# Developer Guide
< 그림 4-13> DrawClass 의함수구성 36 Visual C# Developer Guide
< 그림 4-14> EnumPlaySound 의함수구성 < 그림 4-15> EnumShowWindow 의함수구성 37 Visual C# Developer Guide
< 그림 4-16> IOControl 의함수구성 38 Visual C# Developer Guide
< 그림 4-17> MainBoard 의함수구성 < 그림 4-18> OldDefine 의함수구성 < 그림 4-19> RegistryTool 의함수구성 39 Visual C# Developer Guide
< 그림 4-20> Scada 의함수구성 < 그림 4-21> TimeOutClass 의함수구성 40 Visual C# Developer Guide
< 그림 4-22> TimeUtil 의함수구성 41 Visual C# Developer Guide
< 그림 4-23> Win32Function 의함수구성 42 Visual C# Developer Guide
< 그림 4-10>~< 그림 4-23> 에나타나있는구성들은 Visual Studio 의보기 \ 개체브라우저를통해 서도 Ats 의모든구성요소를확인하실수있습니다. < 그림 4-24> 는개체브라우저를통해 Ats 라이브러리파일의구성요소를확인한예입니다. < 그림 4-24> Visual Studio 보기메뉴의개체브라우저를통한 Ats 라이브러리파일의구성요소확인예 43 Visual C# Developer Guide