시작하기
동작 타입 상세
부록

동작 타입 상세

동작 타입 33종의 명령, 입력 항목, 출력 변수를 동작 추가 창의 타입 목록 순서대로 정리했습니다. 동작을 추가하고 편집하는 방법과 재생 종료 대기, 상태 변수의 공통 설명은 4부를, AI 분석 동작은 부록 D를 참고합니다.

알아두기 리소스를 사용하는 동작은 첫 항목에서 설정에 등록한 리소스(장치, 타이머, 클라이언트 등)를 선택합니다(6부). 리소스는 선택 창에서도 추가, 편집, 삭제할 수 있습니다. 값 입력 항목은 직접 입력 외에 변수의 값이나 블록 편집기를 사용할 수 있고(8부), 파일 항목은 프로젝트에 업로드한 파일을 선택합니다(3부). 출력 변수 항목에는 설정 → 변수에서 만든 변수 중 타입이 맞는 것만 표시됩니다. 「~일 때만 표시됩니다」는 그 조건에서만 항목이 나타난다는 뜻입니다.

이 장의 내용

  1. I/O 장치 제어LED, 센서, LCD, 모터 등 컨트롤러에 연결된 I/O 장치를 제어합니다. 지원 장치의 분류와 목록, 장치별 명령은 7부 를 참고합니다. 장치 제어할 I/O 장치를 선택합니다. 장치는 설정 > I/O장치 에서 등…
  2. 변수 쓰기선택한 변수에 값을 씁니다. 변수 타입에 따라 쓰기 옵션과 값 입력 항목이 달라집니다. 변수 값을 쓸 변수를 선택합니다. 모든 타입의 변수를 선택할 수 있습니다. 쓰기 옵션 값을 쓸 때 적용할 연산을 선택합니다. 기…
  3. SHELL 명령 실행컨트롤러 운영체제의 기본 셸로 명령을 실행합니다. 시스템 명령을 실행하거나 외부 프로그램과 스크립트를 호출할 때 사용합니다. 명령 실행할 셸 명령을 입력합니다(예: ls -al /home , python /path/…
  4. 파일 읽기/쓰기파일에서 텍스트 또는 바이너리 데이터를 읽거나 파일에 데이터를 씁니다. 파일 편집기는 설정 > 파일 편집기 에서 등록합니다. 파일 편집기 사용할 파일 편집기를 선택합니다. 명령 읽기 (기본값): 파일을 읽어 내용을 …
  5. 파일 시스템컨트롤러의 로컬 파일과 폴더를 만들고 복사, 이동, 삭제하거나 정보를 조회합니다. 경로는 Windows 와 Linux 형식을 모두 쓸 수 있습니다(예: C:\Users\me\file , /hom…
  6. 시간 지연설정한 시간만큼 대기한 뒤 다음 동작으로 넘어갑니다. 모드 일반 (기본값): 밀리초 단위의 지연입니다. 정밀 : 마이크로초 단위의 정밀한 지연이며 0~999μs 범위에서 사용합니다. 지연 시간 대기할 시간(시간길이)…
  7. 타이머기준 시간에서 경과한 시간을 계산합니다. 시간을 증가 또는 감소시키도록 설정할 수 있어 타이머나 스톱워치로 사용합니다. 타이머는 설정 > 타이머 에서 등록합니다. 타이머 제어할 타이머를 선택합니다. 명령 시작 (기본…
  8. 컬렉션컬렉션에 값을 추가, 조회, 삭제합니다. 컬렉션은 여러 값을 담아 두는 저장소이며 리스트 와 맵 두 타입이 있습니다. 컬렉션의 타입과 키·값 타입은 설정 > 컬렉션 에서 만들 때 정합니다( 6부 ). 리스트 : 값을…
  9. 데이터베이스데이터베이스의 데이터를 조회, 삽입, 수정, 삭제합니다. SQL 데이터베이스(MySQL, PostgreSQL, SQLite, ODBC)와 Firebase 실시간 데이터베이스를 사용할 수 있으며, 연결은 설정 > 데이…
  10. 통계 계산지정한 숫자 변수의 최소, 최대, 평균 등 통계값을 계산합니다. 예를 들어 온도 센서의 측정값을 통계로 지정하면 최고, 최저, 평균 온도를 바로 구할 수 있습니다. 통계와 대상 변수는 설정 > 통계 에서 등록합니다.…
  11. 데이터 로깅지정한 데이터 로깅 채널에 현재 변수 값을 한 건 기록합니다. 동작이 실행되는 시점에 채널의 변수 값이 한 줄 추가되므로, 채널의 자동 로깅 과 별개로 이벤트가 발생한 시점에만 기록하는 트리거 기반 기록에 사용합니다…
  12. 미디어 재생오디오와 비디오를 재생합니다. mp3, mp4 등 대부분의 형식의 파일과 웹 스트리밍을 지원하며, 재생 가능한 형식은 VLC 지원 형식 을 참고합니다. 미디어 플레이어는 설정 > 미디어 플레이어 에서 등록하며, 비디…
  13. 이미지 보기컨트롤러에 연결된 디스플레이에 이미지를 표시합니다. 프로젝트에 업로드한 파일과 웹 이미지를 표시할 수 있으며, 이미지 뷰어는 설정 > 이미지 뷰어 에서 등록합니다. 화면 출력에는 컨트롤러의 데스크톱 세션이 필요합니다…
  14. 전자 악기 연주여러 악기의 소리와 효과음을 연주하거나 MIDI 파일을 재생합니다. 전자 악기는 소프트웨어로 구현된 신디사이저이며 음원으로 사운드 폰트(sf2, sf3) 파일을 사용합니다. 악기는 설정 > 전자 악기 에서 등록하고,…
  15. 카메라카메라의 촬영과 스트리밍을 시작하거나 정지하고, 현재 화면을 파일로 저장합니다. 카메라는 설정 > 카메라 에서 등록합니다( 6부 ). 비디오 AI 분석은 이 동작으로 카메라를 시작해야 시작됩니다( 4부 ). 카메라 …
  16. 오디오 분석FFT(고속 푸리에 변환)로 오디오의 세기와 주파수 분포를 실시간으로 분석합니다. 오디오 분석기와 소스(마이크 또는 스피커)는 설정 > 오디오 분석기 에서 등록합니다. 오디오 분석기 사용할 오디오 분석기를 선택합니다…
  17. 오디오 녹음마이크로 입력되는 소리를 녹음하여 파일로 저장합니다. mp3, ogg, flac, wav 형식을 지원하며, 녹음기는 설정 > 오디오 녹음기 에서 등록합니다. 오디오 녹음기 사용할 오디오 녹음기를 선택합니다. 명령 녹…
  18. 오디오 변조원본 오디오 파일의 템포, 피치, 재생 속도를 바꾸어 새 파일로 저장하고, 필요하면 바로 재생합니다. 변환기는 설정 > 오디오 변조 에서 등록합니다. 이 동작에는 명령 항목이 없습니다. 오디오 변조 사용할 오디오 변…
  19. LLM AI 질의LLM(거대 언어 모델) 제공자에 질의 텍스트와 첨부 파일을 보내고 응답을 변수에 저장합니다. 제공자와 모델은 설정 > LLM AI 에서 등록하며( 6부 ), API 키 준비는 부록 B 를 참고합니다. LLM AI …
  20. 텍스트 음성 변환 (TTS)텍스트를 음성으로 변환하여 재생합니다. 변환 서비스의 타입(On Device, Google Cloud, OpenAI, ElevenLabs)은 설정 > 텍스트 음성 변환 에서 등록할 때 정하며( 6부 ), 타입에 따라…
  21. 음성 텍스트 변환 (STT)사람의 음성을 실시간으로 텍스트로 변환합니다. VAD(음성 활동 감지)로 음성 구간을 자동으로 감지하며, 변환 서비스와 감지 임계값은 설정 > 음성 텍스트 변환 에서 등록합니다( 6부 ). 음성 텍스트 변환 사용할 …
  22. 텔레그램 메시지텔레그램 봇으로 사용자와 메시지 또는 파일을 주고받습니다. 봇은 설정 > 텔레그램 봇 에서 등록하며, 봇 토큰과 Chat ID 를 얻는 방법은 부록 B 를 참고합니다. 텔레그램 봇 사용할 텔레그램 봇을 선택합니다. …
  23. 이메일 보내기SMTP 클라이언트로 이메일을 보냅니다. 텍스트 또는 HTML 본문을 작성하고 파일을 첨부할 수 있으며, 네이버, 구글 등 SMTP 를 지원하는 메일 서버를 사용합니다. 클라이언트는 설정 > 이메일 클라이언트 에서 …
  24. 푸시 알림사용자의 모바일 앱으로 푸시 알림을 보냅니다. 제목과 메시지를 자유롭게 정할 수 있으며, 변수 값을 포함한 동적 메시지도 만들 수 있습니다. 이 동작에는 리소스 선택과 명령 항목이 없습니다. 제목 알림의 제목을 입력…
  25. Zigbee장치 제어설정 에 등록한 Zigbee 장치의 센서 값을 읽거나 장치를 제어합니다. 조명 밝기 조절, 스위치 켜기와 끄기, 온습도 값 읽기 등 장치가 노출하는 모든 속성에 접근할 수 있습니다. 장치 페어링과 등록은 설정 > Z…
  26. Home Assistant 연동설정 에 등록한 Home Assistant 서버와 연동합니다. Home Assistant 엔티티의 상태를 읽거나 제어하고, Grablo 변수를 Home Assistant 의 새 엔티티로 노출할 수 있습니다. 서버 연…
  27. MQTT 통신MQTT 브로커에 메시지를 발행하거나 토픽을 구독하여 메시지를 받습니다. MQTT 는 저전력, 저대역폭 환경에 최적화된 경량 메시지 프로토콜로 IoT 에서 널리 쓰입니다. 브로커 연결(호스트, 포트, 인증, TLS)…
  28. 모드버스 통신Modbus 프로토콜로 PLC, 센서 등 산업용 장비와 데이터를 주고받습니다. Modbus 는 1979년에 자동화 장치 간 통신을 위해 개발된 산업용 프로토콜로, 단순하고 안정적이어서 여러 산업 분야에서 널리 쓰입니…
  29. OPC UA 통신OPC UA 서버의 노드를 읽거나 씁니다. OPC UA 는 통신 방식이 다른 산업용 장비의 데이터를 표준화된 방식으로 교환하는 산업용 표준 프로토콜로, PLC 기반 시스템 통합, 스마트 팩토리, 빌딩 자동화, 에너지…
  30. HTTP 통신HTTP 로 웹 서버나 REST API 에 요청을 보내고 응답을 받습니다. 이 동작에는 리소스 선택과 명령 항목이 없으며, 요청 헤더를 입력하는 항목은 제공되지 않습니다. 날씨 API 를 호출하는 사용 예는 부록 B…
  31. 사용자 정의 통신사용자가 직접 정의한 프레임으로 외부 기기와 통신합니다. 시리얼, TCP, UDP, 웹소켓, 블루투스, 공유 메모리 연결을 사용할 수 있으며, 연결은 설정 > 사용자 정의 통신 에서 등록합니다( 6부 ). 사용자 정…
  32. PID 제어PID 피드백 제어를 계산합니다. PID 는 비례(Proportional), 적분(Integral), 미분(Derivative)의 약자로, 세 요소를 결합하여 목표값과 측정값의 오차를 최소화합니다. 제어기와 제어 방…
  33. 사용자 동작블록 코딩으로 실행할 내용을 직접 작성합니다. 블록 편집기의 사용법과 블록 분류는 8부 , 블록 하나하나의 의미는 부록 E 를 참고합니다. 동작 블록 편집 을 클릭하여 블록 편집기를 열고 실행할 동작을 작성합니다. …