Starting Developer Guide for Visual C++ 권 문서이해도 장 입문개발자용 스타팅디벨로퍼가이드 마지막수정일 : 2017 년 5 월 11 일 본자료는동영상자료를포함하고있습니다. 문서와함께영상을보시면빠른이해와쉬운개발환경구축에도움이됩니다. 동영상자료 : [ 홈페이지 ] [ 자료실 ] 참고
사용설명서 안내 본자료는 Visual C++ 의사전지식이필요합니다. 본사용설명서는 IEC 시리즈와 SmartX Framework 을처음접하시는개발자에게빠른이해와쉬운개발환경구축을 안내합니다 본사용설명서의저작권은 에이치앤에스에있습니다. 본사용설명서의내용중일부또는전부를다른목적으로복제또는복사를할수없습니다. 본자료의내용은해당제품 ( 소프트웨어 ) 의변경또는 에이치앤에스의사정에따라다를수있으며사용자에게통보없이일부변경될수있습니다. 변경된사용설명서는저희회사홈페이지 www.hnsts.co.kr 에서확인하시기바랍니다. 본제품을사용하기이전에반드시본사용설명서를충분히읽어본뒤사용하시기바랍니다. 본사용설명서를충분히읽어보지않은상태에서발생된모든피해는당사에서일체의책임을지지않으므로주의하십시오. 지정된규격품이외의시스템을사용하여발생한손상및본사용설명서의사용방법과주의사항을지키지않아시스템을손상시켰을때는당사에서책임지지않으므로주의하십시오. 진행상문의사항은 HNS 홈페이지의자료실 > 제품관련 > IEC Series 제품매뉴얼이나 SmartX 프로그래밍가이드를 참고바랍니다. 또는커뮤니티 > 질문과답변, 자주하는질문과답변을검색해보시기바랍니다. 문의 : 02-6402-8001( 내선 3), 070-7094-5002( 직통 ) / 홈페이지 : www.hnsts.co.kr, 쇼핑몰 : www.smartx.co.kr
www.hnsts.co.kr 목 차 목차... 3 제 1 장 IEC Series 준비사항... 5 1. 설치전준비사항... 5 2. 연결하기... 5 2-1. IEC Series 전원연결... 5 2-2. PC 와 IEC-Series 연결... 6 3. IEC Series 모드 ( 개발모드와응용프로그램런타임모드 )... 7 3-1. 개발모드 (Development Mode)... 7 3-2. 응용프로그램런타임모드 (Application RunTime Mode)... 8 4. 동작모드설정방법... 10 제 2 장개발환경설정... 11 1. 설치순서... 11 2. Visual Studio 2008 설치... 13 2-1. ServicePack1 for Visual Studio 2008 설치하기... 15 2-2. Visual Studio 2008 Update for Windows Embedded Compact 7... 16 2-3. Windows Embedded Compact 7 ATL Update for Visual Studio 2008 SP1... 17 2-4. SDK 설치... 18 2-5. Mobile Device Center(ActiveSync) 설치... 20
SmartX Framework Starting Developer Guide 제 3 장프로젝트생성... 21 1. Visual C++ Windows CE 장치프로젝트만들기... 21 1-1. Visual C++ Windows CE 장치프로젝트만들기 (Visual Studio 2008 / IEC667)... 21 1-2. C++ SmartX 지원사항... 24 1-3. 장치용 MFC C++ 과표준 MFC 의차이점... 24 2. 개발환경세부설정하기... 25 2-1. 디버깅시작과디버깅하지않고시작... 25 2-2. 디버깅 (Debug) 하지않고메뉴활성화하기... 25 2-3. 디버깅 (Debug) 모드 & 릴리즈 (Release) 모드... 26 2-4. 디버깅모드와릴리즈모드의전환... 27 2-5. Debug 폴더와 Release 폴더의위치... 28 제 4 장 SmartX 예제실행... 29 1. Smart X 예제실행... 29 2. Trouble Shooting... 30 2-1. Dll File Not Found 에러발생시... 30 2-2. C++ SmartX 별관련복사할 dll 파일정리... 31 2-3. C++ SmartX 별관련 dll 파일복사과정 (IEC1000 제품의 SmartGPIO 경우 )... 31 2-4. MFC90U.DLL 라이브러리에러발생시... 32
www.hnsts.co.kr 제 1 장 IEC Series 준비사항 IEC Series 를통한제품프로그램개발을위한구성품 1. 설치전준비사항 Visual Studio Visual 설치 Studio CD 설치 / IEC CD Series / IEC / Series 전원 / 아답터 USB케이블 / USB케이블 2. 연결하기 2-1. IEC Series 전원연결 IEC Series 전원연결 IEC Lite Series 전원연결 1 장개발환경설정 5
SmartX Framework Starting Developer Guide 2-2. PC 와 IEC-Series 연결 1) IEC266/667/1000-Series 개발시작키트에포함된 USB 케이블로서로연결 제품구매시 USB 케이블이포함되어있지않습니다. USB 케이블을사용하시려면, USB 케이블이포함된개발시작키트를구매하시거나 USB 케이블 을별도구매해주셔야합니다. 2) IEC-Series 사용케이블종류확인 IEC266-Series IEC667/1000-Series 사용케이블 IEC Series 개발 PC 개발PC의 USB포트에삽입개발PC의 USB포트에삽입 IEC-Series 의 USB 케이블을별도로구매원하시는경우에는 HNS 쇼핑몰 (http://www.smartx.co.kr/) 기타옵션제품 USB 케이블 [ 기본 / mini] 중에 IEC266-Series 사용자는기본을선택하고 IEC667/1000-Series 사용자는 mini 를선택하여구매하시면됩니다. 6 에이치앤에스
www.hnsts.co.kr 3) 연결완료시다음과같은화면출력 3. IEC Series 모드 ( 개발모드와응용프로그램런타임모드 ) 3-1. 개발모드 (Development Mode) Windows CE 표준 Shell 이로딩되며개발자가 Visual Studio 2005/2008 를사용하여장치응용프로그램을 개발할수있는모드입니다. 부팅순서 : 부트로고 개발화면 (Windows CE 표준 Shell) 1 장개발환경설정 7
SmartX Framework Starting Developer Guide 3-2. 응용프로그램런타임모드 (Application RunTime Mode) Windows CE 표준 Shell이로딩되지않으며개발자가지정한응용프로그램을먼저실행합니다. Flash Disk, SD Card의순서대로검색하며, 실행될응용프로그램이없는경우 Blanking 화면을표시한후에 Windows CE 표준 Shell을로딩합니다. 부팅순서 : 부트로고 응용프로그램 사용방법 부팅시자동으로실행될응용프로그램을 Flash Disk \ Run 위치에복사 실행파일관련 DLL 파일 (IEC667HWCON.DLL) 도함께복사하시길바랍니다. 함께복사할 DLL 파일은 4 장 2-2.C++ SmartX 별관련복사할 DLL 파일정리를참고하세요. Run 폴더에서실행파일 (*.EXE) 은한개만존재해야하며 Flash Disk 에 Run 폴더가없는 경우폴더를새로생성해야함. 복사가완료되면딥 (DIP) 스위치를개발모드에서응용프로그램런타임모드로변경후장치를 재부팅. 부팅시응용프로그램자동실행 8 에이치앤에스
www.hnsts.co.kr Application Run Time Mode 에시작프로그램이없는경우 Windows CE 표준 Shell 이보이기전에일정시간의 블랙화면이표시되며개발모드보다시간더걸림. Flash Disk\Run 용량이부족한경우 SD 메모리카드를사용가능. 부팅시자동으로실행될응용프로그램을 SD Card \ Run 위치에복사. 만약 Flash Disk\Run 폴더에응용프로그램파일이존재시 Flash Disk 에있는응용프로그램이실행됨. 1 장개발환경설정 9
SmartX Framework Starting Developer Guide 4. 동작모드설정방법 IEC Series 은여러동작모드를지원하고있으며동작환경모드의변경은 DIP 스위치또는점퍼스위치를변경 하여설정 DIP 스위치 ON/OFF 모습 DIP 스위치핀번호 1, 2 를 OFF 로설정한모습 Pin No. 딥 (DIP) 스위치 설명 1 ON OFF Application Run Time Mode Development Mode 2 Color Depth Select (IEC1000 Series Only) 딥스위치설정사진 IEC Series 딥스위치위치 개발모드응용프로그램런타임모드非 Lite Lite 런타임모드 (Application RunTime Mode) 에서 ActiveSync(Mobile Device Center) 연결주의 런타임모드에서개발 PC 와 Active Sync(Mobile Device Center) 를연결하면응용프로그램의성능문제와비정상적인동작으로 Active Sync 연결은반드시 Development Mode 에서만연결하시기바랍니다. 또한 IEC1000-Series(WinCE7.0) 에서는 Active Sync 연결과유선랜통신을동시에사용시문제가될수있으므로연결사용시에는 Active Sync 연결을해제해주시거나 WinCE6.0 OS 가탑재된제품을사용바랍니다. 참고 IEC-Series.pdf 의 6-4. Windows Embedded Compact 7 에서네트워크관련기능디버깅주의점 런타임모드에서원격이미지캡쳐프로그램실행을지원하지않습니다. 반드시 Development Mode 에서만실행하시기바랍니다. 10 에이치앤에스
www.hnsts.co.kr 제 2 장개발환경설정 1. 설치순서 위표의순서처럼 Visual Studio 2008 Tool 을설치할것을권장합니다. 2 장개발환경설정 11
SmartX Framework Starting Developer Guide [ 중요 ] Windows 10, 8.1, 8 개발환경지원안내 -1 Windows 10, 8.1, 8에서 IEC-Series(266/667/1000) 로장치응용프로그램 (C#, VB, C++) 개발을지원하고있습니다. 다만 IEC266-Series의 C++(MFC or API) 개발은지원하지않습니다. Windows 10, 8.1, 8 환경에서 Visual Studio 2008로스마트장치응용프로젝트를생성하거나빌드시에러가발생할수있습니다. 이경우.NET Compact Framework 관련파일을설치하면문제가해결됩니다. ( 관련자료를차례대로전부설치하여주시기바랍니다.) 자료위치 : 자료실 제품관련 3.NET Compact Framework (2.0, 3.5버전 ) 자료실바로가기 [ 주의 ] Windows 10, 8.1, 8 개발환경지원안내 (SmartX Framework 관련참조오류가발생하는경우 ) -2 SmartX 를다음의순서로재설치해야합니다. [STEP-1] [SETP-2] [SETP-3] [STEP-4] [STEP-5] SmartX 설치파일에서마우스우측클릭후 " 속성 " 탭을클릭 상단의호환성탭을클릭 호환모드상자에서 " 이프로그램을 " 실행할호환모드의박스를체크하고리스트박스에서 Windows 7 선택 설정상자에서 " 관리자권한으로이프로그램실행 " 의박스를체크 " 적용 " 버튼을눌러서저장후 SmartX Framework 재설치진행 12 에이치앤에스
www.hnsts.co.kr 2. Visual Studio 2008 설치 1) 설치시작화면. Visual Studio 2008 설치 를선택 2) 설치마법사. 다음 클릭 3) 제품키및설치정보입력. 다음 클릭 4). 설치기능및설치경로설정 ( 기능은기본값선택 ) 설치 클릭 5) 설치 진행중 2 장개발환경설정 13
SmartX Framework Starting Developer Guide 6) 정상설치완료시시스템재시작 7) MSDN 설치는필수사항아님웹사이트를통해접근가능 8) MSDN 설치마법사화면동의함선택 다음 클릭 9) 사용약관동의함체크 다음 클릭 10) 설치기능및설치경로설정 ( 기능은 전체설치 선택 ) 설치 클릭 11) 설치진행중 ( 시간이많이걸릴수있음 ) 12) 설치완료 14 에이치앤에스
www.hnsts.co.kr 2-1. ServicePack1 for Visual Studio 2008 설치하기 1) MS Download Center에서 Service Pack1 for Visual Studio 2008을받습니다. http://www.microsoft.com/kokr/download/details.aspx?id=10986 에서다운로드가능. Microsoft 사의정책에따라서다운로드주소는변경될수있습니다. 2) 설치마법사진행 다음 클릭 3) 사용약관동의함체크 다음 클릭 4) 설치중 5) 설치완료 마침 클릭 2 장개발환경설정 15
SmartX Framework Starting Developer Guide 2-2. Visual Studio 2008 Update for Windows Embedded Compact 7 1) MS Download Center에서 Visual Studio 2008 update for Windows Embedded Compact 7을받습니다. http://www.microsoft.com/enus/download/details.aspx?id=11935에서다운로드가능. Microsoft 사의정책에따라서다운로드주소는변경될수있습니다. 2) 설치마법사진행 다음 클릭 3) 사용약관동의 를체크. 다음 클릭 4) 소프트웨어업데이트설치중 5) 설치완료. 마침 클릭 16 에이치앤에스
www.hnsts.co.kr 2-3. Windows Embedded Compact 7 ATL Update for Visual Studio 2008 SP1 1) MS Download Center에서 Windows Embedded Compact 7 ATL Update for Visual Studio 2008 SP1을받습니다. http://www.microsoft.com/enus/download/details.aspx?id=27729에서다운로드가능. Microsoft 사의정책에따라서다운로드주소는변경될수있습니다. 2) Setup Wizard 를진행 Next 클릭 3) I accept the terms.. 체크 Next 클릭 4) Install 클릭 5) 설치완료 Finish 클릭 2 장개발환경설정 17
SmartX Framework Starting Developer Guide 2-4. SDK 설치 Visual Studio2005/ 2008 에서 C++ 즉 EVC++(Embedded Visual C++) 로프로그램을개발할경우반드시 설치해야합니다. 1) IEC1000 SDK 설치파일을실행 2) IEC1000 SDK 설치시작화면. NEXT 클릭 3) Accept 선택 NEXT 클릭 4) 설치정보를입력 NEXT 클릭 5) 설치유형은꼭 Custom 선택 NEXT 클릭 18 에이치앤에스
www.hnsts.co.kr 6) Documentation 에서 Entire feature will beunavaila ble 를선택하여항목을제거 ( 중요 ) 7) SDK 설치시작 Install 클릭 6) 부분은 IEC667 Series 인경우에만해당되는내용입니다. 이점참고하여주시기바랍니다. 8) 설치중 9) SDK 설치완료 2 장개발환경설정 19
SmartX Framework Starting Developer Guide 2-5. Mobile Device Center(ActiveSync) 설치 본내용은개발자 PC 의운영체재가 Windows XP 일경우에해당됩니다. Windows XP 버전 Mobile Device Center(ActiveSync) 를한동기화. HNS 홈페이지에서다운로드가능 Windows Vista, Windows 7 버전 Mobile Device Center를통한동기화. OS에탑재되어있음. 없는경우마이크로소프트에서다운로드가능 Mobile Device Center(ActiveSync) 설치완료후 IEC Series 과 PC 를 USB 케이블로연결바랍니다. 1) 다운로드받은 Mobile Device Center(ActiveSync) 설치파일을실행 (Windows XP 인경우 ) 2) ActiveSync 설치를시작 다음 클릭 3) 사용권에동의함선택 다음 클릭 4) 사용자정보입력 다음 클릭 5) 설치경로지정 ( 여기서는기본위치 ) 6) 파일설치중 7) 설치완료 마침 클릭 20 에이치앤에스
www.hnsts.co.kr 제 3 장프로젝트생성 1. Visual C++ Windows CE 장치프로젝트만들기 1-1. Visual C++ Windows CE 장치프로젝트만들기 (Visual Studio 2008 / IEC667) 프로젝트를만들기앞서 C++ 로 Windows CE 장치응용프로그램을개발할경우당사에서제공하는 SDK(IEC266 SDK, IEC667 SDK, IEC1000 SDK) 가반드시설치가되어있어야장치응용프로그램을개발하실수있습니다. 1) Microsoft Visual Studio 2008 을실행 2) 파일메뉴 프로젝트 선택 3) 아래와같이프로젝트형식에서 Visual C++ 스마트장치를선택후탬플릿은 MFC 스마트장치응용프로그램을선택하고아래의이름을입력합니다. ( 솔루션이름은자동입력됨 ) 4). 확인을클릭하면다음과같이응용프로그램마법사가시작됩니다. 다음 선택하세요 3 장프로젝트생성 21
SmartX Framework Starting Developer Guide 5) SDK 를선택합니다. 설치되어있는 SDK 에서 IEC667 을선택하고오른쪽의 > 버튼을클릭하면선택된 SDK 에 항목이추가되는것을확인할수있습니다. 6) 응용프로그램종류는대화상자기반을선택하여완료합니다. ( 여기까지완료되셨으면빌드하여장치에서프로그램이실행되는것을확인하실수있습니다.) 만약사용자고급기능을설정하시는경우다음을누르시고다음단계부터는개발자가생성하고자하는프로그램의환경에 맞도록설정하시면됩니다. [ 사용자고급기능설정창 ] 6) 솔루션탐색기 SmartWorldCPP.rc 를클릭후 Digalog 창클릭 열기 22 에이치앤에스
www.hnsts.co.kr 7) 도구상자의 Button 컨트롤을 Form1 에드래그앤드롭 8) 버튼에서속성창 Text 항목의값을 Button1 안녕하세요 로변경. 9) 안녕하세요 버튼더블클릭 버튼클릭이벤트에 AFxMessageBox(L" 감사합니다."); 입력 10) 빌드 솔루션빌드 클릭 11) 디버그 디버깅하지않고시작 클릭 12) IEC1000 장치에서응용프로그램이실행됩니다. 빌드및배포관련한사항은다음장의개발환경세부설정하기를반드시참고하시기바랍니다. 3 장프로젝트생성 23
SmartX Framework Starting Developer Guide 1-2. C++ SmartX 지원사항 Hardware Control Class SmartGPIO, SmartADC, SmartDAC, SmartPWM, SmartIIC, SmartSound, SmartBattery, SmartVideo(IEC667 Only), SmartPrint, Seiral_Test, BacklightControl(IEC266 Only) Useful Component Class SmartUpdate, SmartFTP, SmartPlayer 별도지원 지원예정 SmartUART, SmartBootLogo( 별도 App) SmartRemote 1-3. 장치용 MFC C++ 과표준 MFC 의차이점 Windows CE 에포함된 MFC Library 는메모리등장치상제약때문에 PC 환경의 Windows 보다적은 기능들로구성되어있으며표준데스크탑 MFC 가지원하는모든클래스와기능을지원하지는않습니다. IEC Series 제품매뉴얼 2-13. 장치용 MFC C++ 와표준 (PC) MFC 의차이점을참고하시기바랍니다. 24 에이치앤에스
www.hnsts.co.kr 2. 개발환경세부설정하기 2-1. 디버깅시작과디버깅하지않고시작 디버깅시작 디버깅하지않고시작 TRACE 를위한디버깅작업시사용 실행속도가디버깅하지않고시작보다 느리다 디버깅작업이필요없는경우 실행속도가보다빠르다 2-2. 디버깅 (Debug) 하지않고메뉴활성화하기 1. 디버깅하지않고시작메뉴 ( 아이콘 ) 이없는경우풀다운메뉴의 도구 사용자지정 을선택 3 장프로젝트생성 25
SmartX Framework Starting Developer Guide 2. 사용자지정에서명령탭선택. 범주 (G) : 디버그선택 / 명령 (D) : 디버깅하지않고시작선택. 마우스로드래그하여그림과같이메뉴를끌어올려놓습니다. 2-3. 디버깅 (Debug) 모드 & 릴리즈 (Release) 모드 디버깅모드 릴리즈모드 디버깅정보포함 개발중사용하는모드 파일크기가릴리즈모드보다크다 디버깅정보미포함 개발완료후양산시사용하는모드 파일크기가디버그모드보다작다 26 에이치앤에스
www.hnsts.co.kr 2-4. 디버깅모드와릴리즈모드의전환 1) 릴리즈모드와디버깅모드의전환은 솔루션구성 메뉴에서변경합니다. 만약솔루션구성메뉴가없으면사용자가추가해주셔야합니다. 2) 추가방법은디버깅하지않고시작에서와같습니다. 우선 도구 메뉴 사용자지정 을선택합니다. 3) 명령 탭 빌드 를선택 솔루션구성 을선택한후원하는위치에드래그앤드드롭하여메뉴를추가합니다. 솔루션구성메뉴를드래그앤드롭하기전메뉴가 비활성화된모습 4) 솔루션구성선택해도비활성화되는경우! 도구 옵션 선택 5) 옵션설정 일반 고급빌드구성표시 체크 6) 설정완료 릴리즈모드로선택하고빌드를하면 Release 폴더에실행파일이생성되고디 버그모드로선택하고빌드를하시면 Debug 폴더에실행파일이생성됩니다. 3 장프로젝트생성 27
SmartX Framework Starting Developer Guide 2-5. Debug 폴더와 Release 폴더의위치 일반적으로생성한프로젝트의 bin 폴더아래에위치. Ex Path : \Project 이름 \ IEC1000(ARMVAI) or \ IEC667(ARMVAI) or \ IEC266(ARMVAI) \ Debug 와 Release 폴더가생성됩니다. 28 에이치앤에스
www.hnsts.co.kr 제 4 장 SmartX 예제실행 1. Smart X 예제실행 HNS 홈페이지에서 SmartX 예제프로그램다운. 여기서는 IEC1000 C++ 버전으로하겠습니다. 1. HNS 홈페이지접속 자료실 제품관련 4. SmartX 예제파일 C++ IEC1000 Series 에서 Download 클릭 2. 다운완료 3. 다운받은파일의압축해제후 SmartPlayEVC.sln 을더블클릭 4. 빌드 솔루션빌드 5. 디버그 디버깅하지않고시작 을클릭합니다. 4 장 SmartX 예제실행 29
SmartX Framework Starting Developer Guide *. SmartPlayCore.DLL File Not Found 라는에러메 시지가나오는경우 SmartPlayCore.dll 파일을 IEC 장치의실행파일의위치에복사해주시기바랍니다. Dll File Not Found 관련에러는 Trouble Shooting 의 2-1. Dll File Not Found 에러발생시를 참고하시기바랍니다. 6. 디버그 디버깅하지않고시작. 실행된화면좌측화면 2. Trouble Shooting 2-1. Dll File Not Found 에러발생시 EVC에서사용방식은 DLL을참조하여외부로노출된함수를호출하여제어하도록구성되었습니다. 즉, 해당 DLL 파일은실행파일과같이장치에배포되어야합니다. 파일오류발생메시지 에러발생해결 해당 DLL 파일을실행파일과같은폴더에위치해주시기바랍니다. 30 에이치앤에스
www.hnsts.co.kr 2-2. C++ SmartX 별관련복사할 dll 파일정리 홈페이지 / 자료실에서 DLL 파일다운로드 SmartGPIO, SmartADC, SmartDAC, SmartPWM, SmartIIC, SmartSound, SmartBattery IEC제품의해당 dll을복사 - IEC266제품일경우 IEC266HWCON.dll - IEC667제품일경우 IEC667HWCON.dll - IEC1000제품일경우 IEC1000HWCON.dll을복사 SmartFTP SmartFTPCore.dll SmartPlayer SmartPrint SmartUpDate SmartPlayCore.dll SmartPrint.dll SmartUpDate.dll SmartX 예제에포함 2-3. C++ SmartX 별관련 dll 파일복사과정 (IEC1000 제품의 SmartGPIO 경우 ) 홈페이지자료실 제품관련클릭후 SmartX C++ for IEC1000 Series DLL 파일을클릭하여다운로드받습니다. * IEC 266/667 DLL 파일도홈페이지자료실에있습니다. 해당 DLL 파일을실행파일의위치에복사합니다. 상기 2-2 의표를참고하시고관련된 dll 을복사합니다. 실행파일을더블클릭하여실행합니다. 4 장 SmartX 예제실행 31
SmartX Framework Starting Developer Guide 2-4. MFC90U.DLL 라이브러리에러발생시 1. 프로젝트 해당 프로젝트속성 클릭 2. 구성 : 일반 선택후 MFC 사용정적라이브러리에서 MFC 사용으로변경 32 에이치앤에스