Skip to content

Web BDT

Environment Preparation

Web BDT

The original download tool of Telink is BDT , which can be used on Windows platform. If you use the original BDT tool to download the bin file, you can ignore the following content. However, the new download tool is recommended to use.

In order to make the tool cross-platform, at the same time, users can use it immediately without having to download and install the tool, Telink has launched a new Web-based downloading and debugging tool called Web BDT Web BDT (it is open source, supports secondary development). Users can download and debug the program through the web page, the web page supports Windows, Linux, macOS, Android and other platforms, you only need a compatible web browser. (It is suggested to use the latest version of Chrome or Edge browser.

Burning EVK libusb Driver Installation

The Web BDT controls Telink burning EVK (a downloader and debugger) via Web USB. In order to use Web BDT, you need to install libusb driver on your computer, while traditional BDT tools control Telink burning EVK via USB printer driver that comes with Windows. To avoid frequent driver switching when using both Web BDT and traditional BDT on Windows platforms, you need to update the firmware program of the Telink burning EVK itself. After updating, the USB PID can be switched by pressing SW2 on the Telink burning EVK.

  1. If the single LED of Telink Burning EVK is always on after powering up, there is no need to update the firmware, otherwise you need to download the corresponding V4.0 firmware to the module board, update the firmware through the old BDT tool and power up again.

  2. The corresponding LED states of BDT and Web BDT are shown in the figure below. The traditional BDT is indicated by a green light, Web BDT is indicated by a blue light, and the USB PID can be switched and the LED state can be changed by pressing key SW2. ( After switching states, it needs restart.)


  3. Before using Web BDT, you need to install the libusb driver once, as follows, in two steps:

    • Download Zadig
    • Telink burning EVK is set to blue light indicating status (if you change the LED status after powering up, you need to restart the device to take effect for the setting). Connect to the PC via USB and install the libusb driver, the process is shown in the picture below, the driver installation will take around tens of seconds or even longer, it needs to wait patiently.

Normal Operation

Hardware Connection

  • Connect Burning EVK and computer using USB cable. Take the mboard for example, connect the SWM, 3V3, GND of Burning EVK to the SWS, 3V3, GND of mboard baseboard correspondingly.
  • Switch to the LED blue state via SW2 on the Burning EVK (skip this step and the next step if it was already switched to this state during the last connection).
  • Reconnect USB

Open Web BDT

Click "install" to install the webpage as a native application on your computer or mobile phone, and automatically add desktop shortcuts, users can also fix the application to the taskbar. With offline storage and background synchronization technology, the web page can be used without internet access (except for downloading the program from the server).

Download local bin file

  1. Select the main chip model or open source board model.
  2. Click connect, select "Telink Web Debugger" in the pop-up dialog box, and click "Connect".
  3. Click File Import, select the local bin file (before that, you can click "SWS" to test whether the debugging interface is connected properly).
  4. Click Download (you can reset it after power on or click "Reset").

Download Online bin file

Take the ZigBee coordinator firmware of the mboard module board as an example.

  1. Select the board model as mboard and click connect.
  2. Select the Multi Addr Download tab.
  3. Select the bin file on the server in the right column, and select zigbee_coordinator.
  4. Click "MultiDownload" (then restart the board, or click "Reset").

Exception Processing

If the download program is abnormal, try to refresh the page and reconnect the device and click "SWS". If it returns OK then click "Activate" and wait for it to return OK and then carry out normal download. If it returns fail, check the hardware connection.

Advanced Operation

Download Detailed User Guide in pdf

There are details in the user guide on looking at variables, debugging programs, and solutions for having code hibernation situations where it is difficult to connect to the SWS debugging interface. Web BDT details