Prototype a Temperature and Humidity Sensor with Bluetooth Module SDK

Last Updated onInvalid date


The temperature and humidity sensor is widely used in the smart home. The data of temperature and humidity collected by the sensor can be the trigger for executing home automation.

For example, when the indoor temperature exceeds a preset value, such as 29°C, the air conditioner is automatically turned on to cool down the room. When the temperature drops below a preset value, such as 23°C, the air conditioner is automatically turned off. When the indoor temperature drops below a lower preset value, such as 12°C, the air conditioner is automatically turned on to heat the room. Air conditioner automation can be used to keep a preferred indoor temperature, conserve energy, and cut down utility bills. This allows users to enjoy superior comfort all the way.

Based on the Tuya IoT Platform, you can prototype a smart temperature and humidity sensor from scratch with a few simple steps. This demo describes how to quickly prototype a smart temperature and humidity sensor with the demo code and Tuya Sandwich development board.


Hardware (5)
  • Tuya Sandwich function board of temperature and humidity sensor


    The function board contains a Sensirion's temperature and humidity sensor—SHT30-DIS. The Inter-Integrated Circuit (IIC) protocol is used to establish communication between integrated circuits (ICs) and support the clock frequency of up to 1 MHz.more

  • Tuya Sandwich BLE SoC master control board (BT3L)


    You can download different types of Bluetooth Low Energy (BLE) SoC no-code firmware from the [Tuya IoT Platform]( and use the firmware with applicable function boards. You can also develop firmware based on the SDK.more

  • Tuya Sandwich DC power supply board


    Power other components of the Tuya Sandwich Evaluation Kit.more

  • Telink Burning and Debugging Tool (BDT)


    Flash the firmware to the module.more

  • 5V Micro USB adapter or 12V adapter


    Power the power board.more


  • Step 1: Create a product and download the development materials

    1. Log in to the Tuya IoT Platform.

    2. Create a product that adopts the custom solution. For more information, see Create Products.

      Create a product Select a protocol

    3. Select functions for the temperature and humidity sensor. The following figure shows the functions that are selected in this demo.

      Selected functions

    4. On the Device Panel tab, select an app panel that suites the product. For more information, see Design App UI.

    5. In the step of Hardware Development, select the Self-developed Module SDK, and set the required fields. In this example, Chipset Platform is set to General CPU. Self-developed Module SDK

    6. In the Download Documents section, you can download the SDK.

      Download Documents

  • Step 2: Compile code

    After the downloaded SDK is decompressed, you can open the tuya_ble_app folder and check the application demo and documentation. You can follow the sht3x demo in the SHT3x directory and modify the code to implement sensing functionality.

    1. Modify device information in the tuya_ble_app_demo.h file, including APP_PRODUCT_ID, APP_BUILD_FIRMNAME, and TY_APP_VER_STR. The following list describes the information:

      • APP_PRODUCT_ID is generated when you create a product in Step 1. PID

      • APP_BUILD_FIRMNAME is the firmware identifier. This is the unique identification of the firmware. This information is verified during flashing authorization and cannot be modified. Firmware identifier

      • TY_APP_VER_STR is the firmware version that is used to mark the version of the updated firmware during OTA updates.

    2. Modify the IIC configuration in shx.h based on the hardware circuit of the development board. This allows you to define I/O pins that are used by the sensor. When you use the sensor, keep the default I/O pin settings.

    3. After you modify the shx.h file, compile the Telink project. Then, the system automatically applies the modified values to the application code and generates the firmware for production and updates in the ble_sdk_multimode\8258_module folder.
      Compile the project

  • Step 3: Flash the firmware and authorize the development board

    • Test stage

      You can use the Telink Burning and Debugging Tool (BDT) to flash the production firmware that is generated in Step 2 to the development board for testing. However, in this case, the module cannot connect to the app, including Tuya Smart, Smart Life, and OEM app. To test the device by using the app, you must get the authorization code and enable permanent authorization of the module on the Cloud Module Burning Authorization Platform. For more information, see the next section “Production stage”.


    • Production stage

      Log in to the Tuya IoT Platform and go to Tuya Service & Support to submit a ticket and request technical support from Tuya Smart. Technical support engineers can help you upload the firmware and apply for an authorization code for flashing and authorization.

      Service and Support

    After you get the authorization code, you can proceed with flashing and authorization. For more information, see Authorization and programming in Firmware Programming and Authorization. An authorized module can be connected to the Tuya IoT Platform.
    Flashing and Authorization Platform

  • Step 4: Pair the device with the app

    The device is connected to the network over the BLE protocol. Perform the following steps:

    1. Download the Tuya Smart app, tap the plus sign + in the top right corner of the homepage, and then add a Bluetooth temperature and humidity sensor.
      Add a temperature and humidity sensor

    2. Enable the Bluetooth function of the mobile phone and start to discover the device.
      Auto Scan

    3. Tap the discovered device to pair the device.

    For more information, see Third-Party Access.

  • Step 5: (Optional) Smart speaker service

    You can integrate popular voice assistants into your products. Go to Tuya Value Added Service and click Smart Voice to find more.

    Smart speaker service

    After your device is certified, you can see the voice assistant logo on the product information page. Follow the Third-Party Tutorial to associate the device with the voice assistant platform and enable device control with voices.
    Auto Scan Auto Scan

    For more information, see Third-Party Access.


You have prototyped a smart temperature and humidity sensor. You can quickly and easily build smart product prototypes from scratch and accelerate the development process by using the Tuya IoT Platform and Tuya Sandwich Evaluation Kit.