컨텐츠로 건너뛰기
CIMON-Canvas v4.4.0

명령 함수 목록

명령 함수 테이블

유의사항: 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 서버의 원본 경로에서 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 사용자를 로그아웃합니다.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)
비디오 재생지정된 비디오 파일을 별도의 뷰어 애플리케이션에서 재생합니다.
eXT2 장치에서만 사용 가능합니다.		system.video.playFile(Storage.Project, "Folder/training.wav")
라이브러리 오디오 정지현재 비동기식으로 재생 중인 오디오 파일을 정지합니다.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))
레시피 설정 창 열기기본 레시피 설정 창을 엽니다.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)