본문으로 건너뛰기

GUI - tyutool 그래픽 도구

개요​

tyutool은 TuyaOpen용 플래시 및 디바이스 인증 도구입니다. 시리얼 포트로 펌웨어와 디바이스 인증 정보(UUID, AuthKey)를 기록합니다. GUI와 CLI 두 버전이 있으며 이 페이지에서는 GUI를 다룹니다.

위험

tyutool의 인증 기능은 TuyaOpen 프로젝트에만 적용됩니다. TuyaOpen 인증 코드와 TuyaOS 인증 코드는 서로 호환되지 않습니다.

Windows, Linux 및 macOS에서 실행할 수 있습니다. 현재 V2와 V3가 제공됩니다.

  • V3(최신): Rust(Tauri 2) + Vue 3로 다시 작성되었으며 크로스 플랫폼 호환성이 좋습니다. Mac 사용자에게 권장하고 일괄 플래시 및 인증을 지원하지만 오디오 디버깅은 지원하지 않습니다.
  • V2: 오디오 디버깅을 포함한 기존의 전체 기능을 제공합니다.
노트

오디오 디버깅이 필요하면 V2를 다운로드하세요. V3의 전체 기능은 tyutool V3 사용 가이드를 참고하세요.

플랫폼소스(권장)
Githubgithub-source
Giteegitee-source
버전Github
V3v3.0.8
V2v2.3.2

V3 플랫폼별 권장 다운로드의 x.x.x는 버전 번호입니다. 최신 버전은 Releases에서 확인하세요.

플랫폼권장 파일자동 업데이트비고
Windows x86_64★ tyutool-gui_windows_x86_64_nsis_x.x.x.exe✅NSIS 설치 프로그램
Windows x86_64tyutool-gui_windows_x86_64_portable_x.x.x.zip❌설치 없이 사용
macOS Universal★ tyutool-gui_macos_universal_dmg_x.x.x.dmg✅DMG 설치 프로그램
macOS Universaltyutool-gui_macos_universal_portable_x.x.x.tar.gz❌압축 해제 후 실행
Linux x86_64★ tyutool-gui_linux_x86_64_appimage_x.x.x.AppImage✅chmod +x 후 실행
Linux aarch64★ tyutool-gui_linux_aarch64_appimage_x.x.x.AppImage✅chmod +x 후 실행
노트

tos.py flash는 내부적으로 tyutool_cli를 호출합니다. tyutool_gui는 tyutool_cli 위에 구축된 그래픽 인터페이스입니다.

펌웨어 플래시​

  1. 칩을 선택합니다.
  2. Browse를 클릭하고 _QIO가 포함된 bin 펌웨어를 선택합니다.
  3. 플래시에 사용할 디바이스 포트를 선택합니다.
  4. Start flash를 클릭합니다.
tyutool 플래시 화면
팁

기본 플래시 baud rate는 921600입니다. 속도를 높일 수 있지만 baud rate가 너무 높으면 플래시에 실패할 수 있습니다.

디바이스 인증 정보 기록​

  1. Authorize 탭을 클릭합니다.
  2. 인증 시리얼 포트와 baud rate를 선택합니다.
  3. UUID와 AuthKey를 입력합니다.
  4. Start Authorization을 클릭합니다.
tyutool 인증 화면
팁

인증 UART와 플래시 UART는 동일합니다. 기본 UART 구성(baud rate 115200, 데이터 비트 8, 정지 비트 1, 패리티 없음)을 유지하세요.

정보

TuyaOpen UUID와 AuthKey는 Tuya IoT Platform에서 받거나 Tuya 공식 Taobao 스토어에서 구매할 수 있습니다.

FAQ​

write 단계에서 항상 실패합니다​

CH34x 계열은 드라이버를 설치하거나 업데이트하세요.

Mac에서는 설치 후 Security Settings에서 드라이버 로드를 허용합니다. 정상 설치되면 cu.wchusb로 시작하는 이름으로 인식됩니다.

MacOS 13에서는 Privacy & Security에서 허용합니다.

MacOS 13
MacOS 13