Port TuyaOS to Android Platform

Last Updated on : 2025-06-24 06:50:55download

TuyaOS runs natively on the Android platform, requiring no secondary adaptation to directly access its core capabilities, including foundational OS features like pairing, device control, and OTA updates, as well as Wukong AI capabilities. On this basis, you can rapidly develop TuyaOS-powered devices and AI products by leveraging the Android system’s native capabilities. This topic describes how to port TuyaOS to the Android platform.

Preparations

After integrating the tuyaos_android SDK library and configuring the device license, you can develop functionalities as a standard Android application.

Procedure

The following describes the complete process of device pairing, activation, and using Wukong AI capabilities.

What you need to do:

  • Develop business logic using the tuyaos_android SDK.
  • Leverage either a Tuya-enabled app or build your proprietary apps with the App SDK.
Device (Android)Tuya-Enabled/Your Proprietary AppCloud ServicePower on, initialize, and enable pairing modeEnter Bluetooth LE pairing (broadcast beacon)Scan for and discover Bluetooth LE deviceConnect device and send pairing datacredentials (Wi-Fi optional)Generate/show QR codeScan QR code for pairing guideConnect device and send pairing data (Wi-Fi credentials)alt[Pairing over Bluetooth LE][Pairing in QR code mode]The device attempts to connect to the target Wi-Fi networkInitiate activation requestDevice is activatedActivated device gains:Core IoT features (DP data exchange, OTA updates)Wukong AI capabilitiesUser inputs multimodal data(text/audio stream/image/video/file)SDK packages & uploads datafor AI processing (Wukong AI service)Wukong AI service processes requestAI results streamed back to SDKSDK parses & renders AI output(such as TTS playback, screen display)loop[Repeatable AI interaction]Device (Android)Tuya-Enabled/Your Proprietary AppCloud Service

List of features

TuyaOS basic capabilities

Type Data point (DP)
Device pairing Reset device
Device pairing Pair over Bluetooth LE
Device pairing Pair in QR code mode
Control Send and report DP data
Control Send and report DP data over LAN
Firmware update OTA update
Signal strength Query signal strength

Wukong AI capabilities

ApplicationSDKCloudStart interactionInput videoInput audioInput textInput fileInput imageUpload multimodal data to the cloudComplete interactionCloud returns resultsOutput the informationApplicationSDKCloud

Help and support

If you have any problems with TuyaOS development or require additional development documents, you can post your questions in the TuyaOS section of the Tuya Developer Forum.