결론: AOOSTAR 화면 도구는 컨테이너에서 실행하고 ZimaOS 호스트에 apt로 설치하지 마세요
AOOSTAR WTR MAX 디스플레이는 USB/직렬 인터페이스를 통해 제어되며, 현재 이용 가능한 Linux 프로젝트는 커뮤니티에서 역공학한 소프트웨어입니다. ZimaOS는 어플라이언스 스타일 운영 체제이므로 apt install build-essential 같은 일반적인 Ubuntu 지침은 호스트 수준에서 적절한 방법이 아닙니다.
업스트림 참고 자료로 aoostar-rs 프로젝트 사용
aoostar-rs 화면 제어 도구는 디스플레이 켜기/끄기, 이미지 표시, 센서 패널 렌더링을 지원합니다. 작성자는 프로토콜이 역공학된 것이며 이론적으로 디스플레이 펌웨어를 충돌시키거나 손상시킬 수 있다고 명시적으로 경고합니다. 사용에 따른 위험은 사용자가 부담해야 합니다.
먼저 안정적인 직렬 장치 경로 확인
ls -l /dev/serial/by-id/
dmesg | grep -i -E 'ttyUSB|ttyACM'디스플레이가 항상 /dev/ttyUSB0일 것이라고 가정하기보다 /dev/serial/by-id/... 경로를 우선 사용하세요. 재부팅하거나 다른 USB 하드웨어를 연결하면 장치 번호가 변경될 수 있습니다.
필요한 장치만 컨테이너에 전달
Compose 서비스에서는 devices: 매핑을 사용해 직렬 장치를 지정한 다음, 일반 Linux 컨테이너 내부에서 aoostar-rs 바이너리를 실행할 수 있습니다. 먼저 privileged: true를 사용하지 않고 장치에 직접 액세스하는 방식으로 시작하세요. Docker는 Docker 장치 매핑에서 장치 액세스를 설명합니다.
Compose 스택을 시각적으로 관리하려는 경우 Portainer 요구 사항이 유용합니다.
포럼의 Dockerfile을 그대로 복사하지 마세요
커뮤니티 답변은 Linux 도구를 컨테이너화하고 UART를 전달하라는 방향에서는 맞지만, 빌드 단계 내부의 usermod -aG dialout $USER 같은 명령이 실행 중인 컨테이너에 호스트 장치 액세스 권한을 자동으로 부여하는 것은 아닙니다. 실제 장치 권한과 런타임 컨테이너 사용자를 확인하세요.
ZimaOS 기본 시스템을 수정하는 것보다 나은 이유
컨테이너를 사용하면 컴파일러 패키지와 실험적인 화면 소프트웨어를 어플라이언스의 루트 파일 시스템과 분리할 수 있습니다. ZimaOS 패키지 제한에서는 플랫폼의 경계를 설명하며, ZimaOS 앱 배포에서는 지원되는 방식을 안내합니다.
