IPC Scanning App's QR Code for Pairing

The mobile app connects to the router and generates a QR code. The device scans the QR code, extracts information from it, and then connects to the router to complete cloud activation.

Process

Development guide

Prerequisites

• Install a Tuya-enabled mobile app that can generate a QR code.
• The device can read QR codes, such as with a ZBar integration.
• The camera has good focus accuracy.

API setup

• Set the pairing mode to wireless.

  apps/tuya_demo_ipc/src/user_main.c
  
  connect_mode = PARING_MODE_WIFI_AP
  

• Set the connection mode to wireless.

  TUYA_IPC_LINK_TYPE_E link_type = TUYA_IPC_LINK_WIFI;
  ipc_sdk_run_var.net_info.link_type = link_type;
  

• Adapt tkl_wifi.c.

  The development framework provides a set of APIs for Linux. You need to adapt the implementation to your specific hardware.

• Pass the QR code reading to the SDK.

  OPERATE_RET tuya_ipc_direct_connect(IN CONST CHAR_T *p_str, IN CONST TUYA_IPC_DIRECT_CONNECT_TYPE_E source);
  

FAQs

Why can’t the device read the QR code generated on the mobile app?

1. Screenshot the QR code and try reading it using another mobile app to verify if the device has a problem with reading the QR code.
2. Check if the device has integrated with a QR code reading algorithm, such as the ZBar library.
3. Check if the YUV or JPEG image the device obtains and passes to the QR code reading algorithm is clear.

Why can’t the device be activated despite successfully scanning the QR code?

1. Check the SSID and password of the router input on the mobile app.
2. Check if the pairing mode and connection mode are set correctly. The recommended pairing mode and connection mode are PARING_MODE_WIFI_AP and TUYA_IPC_LINK_WIFI respectively.
3. Check if all the required tkl_wifi.c APIs are adapted.
4. Verify if tkl_wifi_init(WIFI_EVENT_CB cb) proactively notifies the SDK of the current network status when the network changes.

How to determine if a device needs network configuration? When can the QR code recognition function be enabled?

When the status of the status callback function TUYA_IPC_Status_Changed_cb is TUYA_IPC_STATUS_NETCFG_START, it indicates that the device requires network configuration, and the QR code recognition function can be enabled at this time.

How to perform QR code network configuration for 4G and wired products?

Invoke gw_user_token_bind and pass in the recognized token.

Why does the SDK invoke tkl_wifi_station_connect 20 seconds after tuya_ipc_direct_connect is invoked?

Check the TKL interface. If tkl_wifi_ioctl is not implemented, you can return OPRT_NOT_SUPPORTED directly.