가장 흔한 원인은 RUN 을 클릭하지 않은 경우입니다. 로직 작성과 실행은 분리되어 있으므로 상단의 RUN 버튼을 클릭하고, 디바이스 아이콘이 연결 상태(녹색)인지 함께 확인합니다.

프로젝트 생성 시 선택한 디바이스와 실제 연결된 컨트롤러의 보드가 다른 경우입니다. 프로젝트의 디바이스를 실제 보드로 변경하거나, 여러 보드에서 사용할 프로젝트라면 All Devices 로 설정합니다(3부).

컨트롤러와 다른 네트워크(외부 인터넷, 셀룰러 등)에서 연결하면 원격 연결 트래픽을 사용합니다. 원격 연결에는 매월 무료 한도가 있으며, 한도를 모두 사용하면 다음 초기화일까지 외부 연결이 제한됩니다. 같은 네트워크에서의 연결은 한도와 무관하게 계속 사용할 수 있습니다.

실행 중에는 일부 항목이 편집 잠금 상태가 됩니다. STOP 으로 정지한 뒤 수정하고 다시 RUN 을 클릭합니다.

센서 감지값은 짧은 시간에 참과 거짓을 반복할 수 있습니다. 너무 자주 만족된다면 참이 유지되는 시간 옵션으로 판정을 안정화합니다(4부). 반대로 거의 만족되지 않는다면 비교 연산자와 비교 대상 값이 변수 타입과 일치하는지 확인합니다.

AI 분석은 동작이므로 해당 동작을 포함한 제어의 조건이 만족되어야 실행됩니다. 상시 분석이 필요하다면 조건을 항상 만족 또는 한번만 만족으로 설정하여 분석이 계속 실행되도록 구성합니다.

설정 → 카메라에서 카메라가 정상적으로 등록되어 있는지, 다른 프로그램이 같은 카메라를 사용 중이지 않은지 확인합니다. USB 카메라는 케이블이나 허브 불량이 원인일 수 있으므로 다른 케이블 또는 포트에 연결하여 증상이 재현되는지 확인합니다.

위젯은 컨트롤러가 연결되어 RUN 중일 때 실제 값을 표시합니다. 정지 상태의 편집 화면에서 기본값만 표시되는 것은 정상 동작입니다.

먼저 해당 동작이 실행되었는지 확인합니다. 조건이 만족되지 않으면 동작도 실행되지 않습니다. 텔레그램과 이메일은 설정에 등록한 봇 토큰과 서버 정보가 올바른지도 확인합니다.

오디오 서버가 PulseAudio 인 구형 운영체제에서 자주 발생합니다. 자원이 제한된 기기에서 PulseAudio 의 버퍼링과 스케줄링이 오디오 끊김을 일으키기 쉽습니다. PipeWire 를 기본 오디오 서버로 쓰는 최신 버전으로 올리는 것이 가장 확실한 해결책입니다. 라즈베리파이 OS 와 데비안은 Bookworm 이상, 우분투는 24.04 LTS 이상이 해당합니다.

Grablo 는 미디어 재생과 오디오 녹음에 VLC 를 사용합니다. .deb 패키지로 설치하면 VLC 가 의존성으로 함께 설치되므로 별도 작업이 필요하지 않지만, VLC 가 없는 환경에서는 이 오류가 표시됩니다. 컨트롤러 터미널에서 아래 명령으로 설치합니다.

sudo apt-get update
sudo apt-get install -y vlc

로그인 계정에 관리자(sudo) 권한이 없어서 발생합니다. 컨트롤러에 접속한 뒤 su 로 root 계정으로 전환하고 /etc/sudoers 에 계정을 추가합니다. 접속 방법은 부록 B를 참고합니다.

su
nano /etc/sudoers

파일에 아래 형식으로 한 줄을 추가하고 저장한 뒤 다시 설치합니다.

계정이름 ALL=(ALL:ALL) ALL

파일 업로드는 디바이스에 연결된 상태에서만 가능합니다. 연결 상태인데도 업로드할 수 없다면 무료 저장 용량(1GB)을 모두 사용했을 수 있으므로 사용하지 않는 파일을 정리합니다(3부).