Flashing and Logging
Flash firmware
Connect the device to your PC. If using a virtual machine, map the serial port to the virtual machine.
For Linux and Mac users, run the command sudo usermod -aG dialout $USER to grant serial port permissions, and then reboot the system.
Run the command tos.py flash to flash the firmware, and select the correct flashing port. If multiple ports exist, try them sequentially.
⯠tos.py flash
[INFO]: Run Tuya Uart Tool.
[INFO]: Use default baudrate: [921600]
[INFO]: Use default start address: [0x00]
--------------------
1. /dev/ttyACM1
2. /dev/ttyACM0
--------------------
Select serial port: 2
[INFO]: Waiting Reset ...
[INFO]: unprotect flash OK.
[INFO]: sync baudrate 921600 success
Erasing: ââââââââââââââââââââââââââââââââââââââââ 100% 5 bytes/s 0:00:07 / 0:00:00
[INFO]: Erase flash success
Writing: âââââââââââââââââââââââââââââââââââââââ⸠100% 12 bytes/s â ¸ 0:00:38 / 0:00:01
[INFO]: Write flash success
[INFO]: CRC check success
[INFO]: Reboot done
[INFO]: Flash write success.
If a prompt Port [xxx] may be busy appears:
Wait approximately 1 minute and retry. Mapping duration varies depending on virtual machines and serial chip models.
Logging
Run the command tos.py monitor to view logs and select the correct log port.
To capture full logs, manually reset the device after running the command.
⯠tos.py monitor
[INFO]: Run Tuya Uart Tool.
--------------------
1. /dev/ttyACM1
2. /dev/ttyACM0
--------------------
Select serial port: 1
[INFO]: Open Monitor. (Quit: Ctrl+c)
[01-01 00:03:25 ty D][tuya_health.c:75] feed watchdog
[01-01 00:03:35 ty D][tuya_health.c:75] feed watchdog
[01-01 00:03:45 ty D][tuya_health.c:75] feed watchdog
[01-01 00:03:55 ty D][tuya_health.c:75] feed watchdog
To exit log viewing, press Ctrl + C and press the Enter key.
^C[INFO]: Press "Entry" ...
[INFO]: Monitor exit.
FAQs
Flashing failed
For more information, see Install drivers.
T5 series virtual machine mapping has delay
T5 series development boards may experience some delay when mapping serial ports in virtual machines.
The phenomenon is that after mapping, using the command ls /dev/tty*, you can see the device, but when using it, there will be a device busy prompt.
It can be used normally after about one minute.
Board connected to computer will have two serial port numbers
T5 series development boards will have two serial port numbers, one for flashing and one for logging.
In Windows, you can view the device name in the device manager list. The name with number A is the download port, and the name with number B is the log port.
In Linux or Mac systems, generally the device with the smaller number is the flash port, and the larger one is the log port.
If you can't be sure, you can test both serial ports when flashing firmware.
GUI version flashing tool is detected as a virus in Windows
You can place the tyutool_gui tool in a non-system drive (such as D drive), and add the directory to the exclusion list in Windows Security - Virus & threat protection settings.