동작
동작은 제어 또는 동작그룹 안에 추가하거나, 동작 영역에 있는 블록의 위·아래에 표시되는 + 버튼으로 추가합니다. 각 동작에는 사용 여부, 이름, 타입을 설정하며, 타입에 따라 세부 설정 항목이 달라집니다. 대부분의 동작 타입은 설정 메뉴에서 미리 등록한 리소스를 사용합니다(6부).
동작 영역이 비어 있으면 그 자리에 표시되는 동작 추가 버튼으로 추가합니다. 사용하지 않는 동작은 실행되지 않으며, 이름은 임의로 입력할 수 있습니다.
추가한 동작은 마우스 우클릭 메뉴에서 편집, 복제, 복사, 잘라내기, 삭제하거나 더블클릭하여 편집하며, 드래그 앤 드롭으로 순서를 바꿉니다. 조건은 조건 영역 안에서만, 동작은 동작 영역 안에서만 이동할 수 있습니다. 삭제한 동작은 복구할 수 없습니다. 자세한 조작 방법은 블록 공통 조작을 참고합니다.
동작 타입
| 분류 | 타입 | 설명 |
|---|---|---|
| 하드웨어 | I/O 장치 제어 | LED, 센서, LCD, 모터 등 다양한 I/O 장치를 제어합니다. |
| 시스템 | 변수 쓰기 | 변수에 값을 씁니다. 쓰기 옵션으로 반전, 사칙연산, 문자열 추가도 수행합니다. |
| SHELL 명령 실행 | 터미널 명령어를 실행합니다. 시스템 명령이나 외부 프로그램을 호출할 수 있습니다. | |
| 파일 읽기/쓰기 | 파일을 읽거나 씁니다. 텍스트와 바이너리 형식을 지원합니다. | |
| 파일 시스템 | 파일 또는 디렉토리를 생성, 삭제, 이동, 복사합니다. | |
| 시간 지연 | 설정한 시간만큼 대기합니다. 밀리초 단위의 일반 모드와 마이크로초 단위의 정밀 모드(0~999μs)가 있습니다. | |
| 타이머 | 타이머를 제어합니다. 시작, 정지, 초기화, 시간 설정, 현재 시간 다섯 가지 명령을 제공하며 경과 시간 측정이나 타임아웃 구현에 사용합니다. | |
| 데이터 | 컬렉션 | 컬렉션에 데이터를 추가, 삭제, 조회합니다. 리스트와 맵 타입을 지원합니다. |
| 데이터베이스 | 데이터베이스에 데이터를 저장하거나 조회합니다. SQL 및 Firebase 등을 지원합니다. | |
| 통계 계산 | 수집된 데이터의 평균, 최대, 최소, 합계 등을 실시간으로 계산합니다. | |
| 데이터 로깅 | 지정한 데이터 로깅 채널에 현재 변수 값을 기록합니다. | |
| 미디어 | 미디어 재생 | 오디오·비디오 파일이나 URL 을 재생, 일시정지, 정지합니다. |
| 이미지 보기 | 화면에 이미지를 표시합니다. 파일 경로 또는 URL 을 지정할 수 있습니다. | |
| 전자 악기 연주 | 전자 악기로 음을 재생합니다. 음계와 길이를 지정하거나 MIDI 파일을 재생할 수 있습니다. | |
| 카메라 | 카메라로 이미지를 캡처하거나 비디오 웹 스트리밍을 시작·정지합니다. | |
| 오디오 분석 | FFT(고속 푸리에 변환)로 오디오의 주파수와 크기를 실시간 분석합니다. | |
| 오디오 녹음 | 마이크에서 오디오를 녹음합니다. | |
| 오디오 변조 | 오디오 파일의 템포와 음높이를 변환합니다. | |
| AI | AI 분석 | 비디오·오디오에 AI 분석을 수행합니다. 아래 AI 분석 절을 참고합니다. |
| LLM AI 질의 | LLM AI 에 텍스트와 첨부 파일로 질의하고 응답을 변수에 저장합니다. | |
| 텍스트 음성 변환 (TTS) | AI 기반으로 텍스트를 음성으로 변환합니다. 내장 로컬 AI 모델과 온라인 AI 서비스를 지원합니다. | |
| 음성 텍스트 변환 (STT) | AI 기반으로 음성을 텍스트로 변환합니다. 내장 로컬 AI 모델과 온라인 AI 서비스를 지원합니다. | |
| IoT | 텔레그램 메시지 | 텔레그램 봇으로 메시지를 전송하거나 수신합니다. |
| 이메일 보내기 | SMTP 를 통해 이메일을 전송합니다. | |
| 푸시 알림 | 사용자의 모바일 앱으로 푸시 알림을 전송합니다. | |
| Zigbee장치 제어 | Zigbee 장치의 센서 값을 읽거나 액추에이터를 제어합니다. Zigbee2MQTT 를 통해 3,400여 종의 장치를 지원합니다. | |
| Home Assistant 연동 | Home Assistant 의 센서·스위치·조명을 제어하거나 Grablo 변수를 Home Assistant 에 노출합니다. | |
| 통신 | MQTT 통신 | IoT 표준 메시징 프로토콜인 MQTT 로 메시지를 발행(전송)하거나 구독(수신)합니다. |
| 모드버스 통신 | Modbus 프로토콜로 PLC 등 산업용 장비와 데이터를 주고받습니다. | |
| OPC UA 통신 | OPC UA 프로토콜로 산업용 장비와 통신합니다. | |
| HTTP 통신 | 웹 서버나 REST API 와 HTTP 요청을 주고받습니다. | |
| 사용자 정의 통신 | 시리얼, TCP, UDP, 웹소켓, 블루투스, 공유 메모리로 커스텀 프로토콜을 구현합니다. | |
| 제어 | PID 제어 | PID 알고리즘으로 온도, 모터 속도 등의 피드백 제어를 수행합니다. |
| 기타 | 사용자 동작 | 블록 코딩으로 동작을 직접 작성합니다. |
재생 종료 대기
미디어 재생, 전자 악기 연주, 텍스트 음성 변환, 오디오 변조 동작에는 재생 종료 대기 항목이 있습니다. 켜면 재생이 끝날 때까지 동작이 「진행 중」 상태로 남아 다음 동작이 실행되지 않고, 끄면 재생을 시작한 직후 「완료」 상태가 되어 다음 동작이 바로 실행됩니다. 재생과 동시에 다른 동작을 진행해야 한다면 이 항목을 끕니다.
상태 변수
일부 동작은 현재 상태를 숫자로 반환합니다. 반환된 값은 변수값 비교 조건과 조합하여 사용합니다.
| 동작 | 상태 값 |
|---|---|
| 미디어 재생 | 0 초기 상태 / 1 재생 중 / 2 일시 정지 / 3 정지 / 4 재생 완료 / 5 에러 |
| 전자 악기 연주 | 0 초기 상태 / 1 재생 중 / 2 일시 정지 / 3 정지 / 4 재생 완료 |
| 음성 텍스트 변환 | 0 초기 상태 / 1 듣는 중 / 2 변환 중 / 3 변환 완료 / 4 에러 |