콘텐츠로 이동
CIMON-Canvas v5.2.2

명령 함수 목록

명령 함수 테이블

섹션 제목: “명령 함수 테이블”

유의사항: eXT, nXT, eXT2 제품을 통해 USB 저장장치를 사용할 때, USB 저장장치는 exFAT 또는 FAT32 형식으로 포맷되어야 합니다. 유의사항: Storage.Local을 저장 위치로 사용할 때, Xpanel은 경로 '$DATA_PARTITION/home/user'를 참조하고, 시뮬레이터는 경로 'C:\Users<user>'를 참조합니다.

경보

섹션 제목: “경보”
항목 설명 스크립트 사용 예시
경보 CSV로 저장 특정 레이블에 대한 모든 경보 이벤트를 CSV 파일로 지정된 저장 위치에 저장합니다.
레이블이 지정되지 않으면 모든 레이블에 대한 이벤트가 저장됩니다.

안내: CIMON은 저장 위치로 USB 또는 SD 카드 사용을 권장합니다. 
alarm.createAllCsv(Storage.Local);
alarm.createCsv("Group::A", Storage.Local);

데이터 수집

섹션 제목: “데이터 수집”
항목 설명 스크립트 사용 예시
데이터 수집에 행 추가 현재 태그 값을 사용하여 데이터 수집 모델에 새 행을 추가합니다. 
datalog.addRow("Model");
데이터 수집 CSV로 저장 지정된 모델과 시간 범위에 대해 데이터 수집 항목을 CSV 파일로 저장합니다. 
datalog.createCsv("Model", Storage.Local);
datalog.createCsvForRange("Model", past, current, Storage.Local);
데이터 수집 시작/정지 지정한 데이터 수집을 시작하거나 정지시킵니다. 
datalog.start("Model");
datalog.stop("Model");

FTP

섹션 제목: “FTP”
항목 설명 스크립트 사용 예시
FTP 다운로드 FTP 서버의 원본 경로에서 HMI의 대상 경로로 파일을 다운로드합니다.
대상 경로는 HMI에서 지정된 저장 위치를 기준으로 합니다. 
system.ftp.download({"server": "192.168.1.100", "port": 21, "username": "user", "password": "pass"}, Storage.Local, "remote_path", "path");
FTP 업로드 HMI의 원본 경로에서 FTP 서버의 대상 경로로 파일을 업로드합니다.
원본 경로는 HMI에서 지정된 저장 위치를 기준으로 합니다. 
system.ftp.upload({"server": "192.168.1.100", "port": 21, "username": "user", "password": "pass"}, Storage.Local, "path", "remote_path");
FTP 서버 활성화/비활성화 HMI에서 FTP 서버를 활성화하거나 비활성화합니다.
쓰기 접근과 위치 접근은 HMI의 설정 앱에서 별도로 구성됩니다. 
system.ftp.startServer()
system.ftp.stopServer()

IAM (보안)

섹션 제목: “IAM (보안)”
항목 설명 스크립트 사용 예시
사용자 로그아웃 현재 IAM 사용자를 로그아웃합니다. 
system.logout();
로그인 창 열기 IAM 사용자를 위한 기본 로그인 창을 엽니다. 
system.openLoginWindow();

멀티미디어

섹션 제목: “멀티미디어”
항목 설명 스크립트 사용 예시
PDF 열기 지정된 PDF 파일을 별도의 뷰어 애플리케이션에서 엽니다. 
system.file.openPdf(Storage.Project, "Folder/error_codes.pdf");
라이브러리 오디오 재생 지정된 오디오 파일을 내장된 오디오 포트를 통해 한 번 재생합니다.
2024년 11월 이전에 생산된 CM-eXT07 및 CM-nXT07 장치는 이 기능을 지원하지 않습니다. 
system.audio.playFile(Storage.Project, "Folder/buzzer.mp4", true);
라이브러리 오디오 정지 현재 비동기식으로 재생 중인 오디오 파일을 정지합니다. 
system.audio.stopFile(Storage.Project, "Folder/buzzer.mp4");

페이지

섹션 제목: “페이지”
항목 설명 스크립트 사용 예시
페이지 닫기 지정된 페이지를 닫습니다. 
page.close("Home");
page.closeIndex(0);
page.closePopupIndex(3);
페이지 열기 페이지를 엽니다.
유의 사항: 기본 페이지를 열 때는 현재 기본 페이지가 자동으로 닫힙니다. 
page.open("Safety");
page.openIndex(4);
page.openPopupIndex(2);
이전 페이지 열기 이전에 열었던 기본 페이지를 엽니다. 
page.openPrevious();

레시피

섹션 제목: “레시피”
항목 설명 스크립트 사용 예시
레시피 CSV 내보내기 지정된 모델에 대한 레시피 데이터를 CSV 파일로 저장합니다. 
recipe.exportCsv("Mixtures", Storage.Usb, system.file.saveDialog(Storage.Usb, "Mixtures.csv"));
레시피 CSV 가져오기 지정된 모델에 대한 현재 레시피 데이터를 CSV 파일로 덮어씁니다. 
recipe.importCsv("Mixtures", Storage.Usb, system.file.openDialog(Storage.Local));
Open Recipe Config Opens the built-in recipe config window. 
recipe.openConfig();
레시피 설정 창 열기 기본 레시피 설정 창을 엽니다. 
recipe.openConfig();
레시피 레코드 받기 지정된 레시피 레코드 데이터를 현재 파라미터 태그 값을 사용하여 덮어씁니다. 
recipe.receiveRecord("Mixtures", tag.read("Index"));
레시피 레코드 보내기 지정된 레시피 레코드 값을 파라미터 태그에 씁니다. 
recipe.sendRecord("Mixtures", tag.read("Index"));

스케줄

섹션 제목: “스케줄”
항목 설명 스크립트 사용 예시
스케줄 활성화/비활성화 스케줄을 활성화 또는 비활성화합니다.
비활성화된 스케줄은 설정된 동작을 수행하지 않습니다. 
schedule.setEnable("Dump", true);

스크립트

섹션 제목: “스크립트”
항목 설명 스크립트 사용 예시
스크립트 호출 기존 스크립트를 실행합니다.
스크립트는 동일한 thread(동기) 또는 별도의 thread(비동기)로 실행할 수 있습니다. 
system.importScript("Initialize");
system.runScript("Initialize");
사용자 정의 스크립트 삽입 로컬 사용자 정의 스크립트를 생성합니다.

태그

섹션 제목: “태그”
항 설명 스크립트 사용 예시
태그 값 입력 사용자가 값을 입력할 수 있는 내장 창을 열고 지정된 태그에 값을 씁니다. 
keyboard.launchKeypad("ID", {"x": 0, "y": 0});
태그 값 설정 상수 값이나 다른 태그 값을 대상 태그에 기록합니다. 
tag.write("ID", 145.0);
태그 값 토글 Boolean 태그의 값을 반전시킵니다; 현재 값이 false일 경우 true를, true일 경우 false로 변경합니다. 
tag.write("isActive", !tag.read("isActive"));

기타

섹션 제목: “기타”
항목 설명 스크립트 사용 예시
비프음 HMI 내장 버저를 사용하여 지정된 시간 동안 비프음을 재생합니다. 
system.staticBeep(true);
        thread.msleep(50);
        system.staticBeep(false);
드라이버 활성화/비활성화 I/O 장치의 드라이버를 활성화하거나 비활성화합니다.
비활성화되면 해당 장치에 대한 통신이 이루어지지 않습니다. 
drive.enable("PLC");
driver.disable("PLC");
프로젝트 종료 프로젝트를 종료하고 HMI 바탕 화면으로 돌아갑니다. 
system.exit();
설정 메뉴 열기 런타임 설정 메뉴를 엽니다.

"3-Button Menu Access 제한" 옵션은 무시됩니다. 
system.openConfig();
프레임 모니터 열기 장치 통신 문제 해결을 위한 프레임 모니터 도구를 엽니다. 
system.openFrameMonitor();
키 입력 키보드 입력 이벤트를 시뮬레이션합니다.
가상 키보드 버튼을 생성하는 데 사용할 수 있습니다. 
keyboard.sendKeyEvent(0x01000000);
이메일 보내기 고정된 제목과 메시지를 지정된 수신자에게 이메일로 보냅니다. 
system.email.send({to: "support@cimoninc.com", cc: "", subject: "Communication Failure", body: "The HMI has lost communication with the PLC"});
화면 알림 보내기 화면 하단의 알림 바에 메시지를 표시합니다. 
notification.send("Initialization complete", 3000);
번역 언어 설정 다국어 문자열 기능을 위해 현재 언어(열)를 설정합니다. 
system.setLanguage("English");
Sleep 스크립트 스레드를 지정된 시간 동안 일시 정지한 후 계속 진행합니다. 
thread.sleep(1);
thread.msleep(300);