ICT
튜토리얼 · Chapter 1

title: "시작하기 — 설치부터 첫 실행까지" chapter: 1 source: "Doc/QMachineStudio UserManaul.pdf" images:

  • install-overview.png
  • first-run.png
  • license-check.png

시작하기

QMachineStudio 를 처음 접하는 분을 위한 단계별 가이드입니다. 설치 → 첫 실행 → 라이선스 인식 확인까지 15 분 이내에 완료할 수 있습니다.

QMachineStudio 설치 프로그램

권장 시스템 사양

항목권장
OSMicrosoft Windows 10 이상 (64bit)
CPUIntel i5 이상
RAM8 GB 이상
저장 공간2 GB 이상 여유
기타.NET Framework 4.8 · (선택) USB 라이선스 동글

설치

  1. 배포받은 인스톨러를 실행합니다 (예: QMS_Setup_x.x.x.exe).
  2. 기본 설치 경로는 D:\QMS. 필요에 따라 변경 가능.
  3. 설치가 끝나면 바탕화면에 QMachineStudio 바로가기가 생성됩니다.
  4. 최초 1회 Tools → Install Drivers 로 USB 동글 드라이버 설치 (라이선스 사용 시).

Windows 권한 설정

  • 설치 폴더는 쓰기 권한 필요 → 관리자 계정으로 설치 권장.
  • 실시간 백신 프로그램이 *.xms · *.xdf 파일 접근을 차단할 수 있음 → 설치 폴더 예외 추가.

첫 실행

첫 실행 화면
  1. 바탕화면 바로가기 또는 QMachineStudio.exe 실행.
  2. 환영 화면에서 최근 프로젝트 목록이 비어 있으면 File → New 로 샘플 프로젝트 생성.
  3. 편집기 · Solution Explorer · Output 창이 표시되면 정상 실행.

종료는 창 우측 상단 × 또는 File → Exit. 저장되지 않은 변경이 있으면 저장 여부를 확인합니다.

샘플 프로젝트 열기

설치 폴더에 다음 샘플이 함께 설치됩니다.

경로설명
SampleProject/ChartDemo차트 · 로그 · 파일 데모
SampleProject/Communication/TCP ServerClientTCP 서버/클라이언트
SampleProject/Fieldbus/ModbusTCP_ClientModbus/TCP
SampleProject/GUI/UISample1920x1080FHD 기본 UI 샘플

File → Open Project 에서 원하는 샘플의 .xproj 파일을 여세요.

라이선스 확인

Tools → Check License

Tools → Check License 메뉴에서 현재 라이선스 상태를 확인할 수 있습니다.

  • 정상 인식 — USB 동글이 연결되어 있고 인증 완료. 화면 하단에 파란색 태그 표시.
  • 동글 없음 — 동글 미연결 또는 드라이버 미설치. 하단이 회색으로 표시.
  • 런타임 모드 — 개발 기능은 비활성, 실행만 가능.

라이선스 관련 문의는 sales@ict-lab.com 으로 연락하세요.

처음 만들어보는 스크립트

File → New Project 로 빈 프로젝트를 만든 후 Run1 모듈에 다음 코드를 넣고 Build → Build All 로 컴파일합니다.

FUNCTION OnSystemStart()
{
    Log("Hello, QMachineStudio!");
    TOWERLAMP.SetLamp("RUN");
    return true;
}
 
FUNCTION OnSystemStop()
{
    TOWERLAMP.SetLamp("STOP");
    return true;
}

시작 버튼 → Hello, QMachineStudio! 가 Output 창에 찍히고 타워램프가 RUN 상태로 전환되면 정상입니다.

문제 해결

증상확인
빌드 에러 "Module not found"Solution Explorer 에 모듈이 포함됐는지
런타임 에러 "License invalid"USB 동글 재삽입 / 드라이버 설치
IO 업데이트 안 됨Tools → IO Test 에서 보드 연결 확인
출력 창에 !!!--- 로그 다수초기화 시퀀스 오류 — Init.xms 확인

다음 단계