TLSR SWire programmer
** Option 1: Use TB-04-KIT or TB-04 / 03F module (TLSR8253 chip) and USB-COM (PL2303HX or CH340 chip).
Pin PD3 (OUT) --> RESET, Pin PD4 (SWM) <-> SWS, Pin PB4 (OUT) --> Power (max 16 mA)
** Option 2:
TLSR8269 chip for direct USB connection
https://aliexpress.ru/item/1005008700896018.html
Pin PB1 (OUT) --> RESET, Pin PA7 (SWM) <-> SWS, Pin PB4 (OUT) --> Power, Pin PE2 - USB_DM, PE3 - USB_DP
The current version of the 'TlsrPgm.py' program is tested with chips only: TLSR8250, TLSR8251, TLSR8253, TLSR8258, TLSR8266, TLSR8269. The firmware for the module works with all types of TLSR82xx chips via SWM-SWS connection.
- How to write TLSRPGM program to TB-03F-KIT or TB-04-KIT.
- TLSRPGM Usage Examples:
Options: wsl /usr/bin/python3 TlsrPgm.py
usage: TlsrPgm [-h] [-p PORT] [-b BAUD] [-t TRST] [-a ACT] [-z ZW] [-s] [-c] [-r] [-g] [-m] [-w] [-u] {rf,we,wf,es,ea,fsr,fsw,rs,ws,wsb,wsw,wsd,ra,wa,i,ds,df,da,dc,sws} ... TLSR82xx TlsrPgm version 03.12.25 positional arguments: {rf,we,wf,es,ea,fsr,fsw,rs,ws,wsb,wsw,wsd,ra,wa,i,ds,df,da,dc,sws} Run TlsrPgm {command} -h for additional help rf Read Flash to binary file we Write file to Flash with sectors erases wf Write file to Flash without sectors erases es Erase Region (sectors) of Flash ea Erase All Flash fsr Read Flash Status Register fsw Write Flash Status Register rs Read SWire address to binary file ws Write file to Swire addres wsb Write byte to Swire addres wsw Write 16-bit word to Swire address wsd Write 32-bit word to Swire address ra Read Analog Registers to binary file wa Write file to Analog Registers i External Chip Information ds Dump Swire (Registers or SRAM) df Dump Flash da Dump Analog Registers dc Show uit32 register or SRAM addres sws SWS Printf (PGM version >= 0.0.0.4 is used) options: -h, --help show this help message and exit -p, --port PORT Serial port device (default: COM1) -b, --baud BAUD UART Baud Rate (default: 230400) -t, --trst TRST Hard Reset Time ms (default: 0 ms) -a, --act ACT Activation Time ms (0-off, default: 0 ms) -z, --zw ZW Wait Start CPU (default: 0 sec) (before main processing) -s, --stopcpu CPU Stop (before main processing) -c, --cpustall CPU Stall (before main processing) -r, --run CPU Run (post main processing) -g, --go CPU Go (post main processing) -m, --mrst Soft Reset (MCU Reboot) (post main processing) -w, --wrktime Show Worked Time -u, --u2b Use 2 bytes swire address (TLSR826x) Chip info: wsl /usr/bin/python3 TlsrPgm.py -s -p/dev/ttyS3 i
======================================================= TLSR825x TlsrPgm version 25.11.20 ------------------------------------------------------- Open /dev/ttyS3, 230400 bit/s... ok PGM: ChipID: 0x5562 (TLSR825x), ver: 0.0.0.1 swdiv 5, addrlen 3, swbuf [5a 00 06 02 00 05], pwr On SWire bit rate: 0.9600 Mbits/s === PreProcess ======================================== CPU Stop... ok === Process =========================================== Chip ID: 0x5562, rev: 0x02 CPU PC=0x000000 ([0x0602] = 0x05) Flash JEDEC ID: 0xC86013, Size: 512 kbytes ------------------------------------------------------- FLASH UID: 000000: 41 50 32 31 36 39 33 01 00 40 00 f1 fe e5 ff ff 000010: c8 01 ff ff ff ff ff ff ff ff ff ff ff ff ff ff ------------------------------------------------------- FLASH: 000000: 26 80 00 00 00 00 5d 02 4b 4e 4c 54 30 04 88 00 000010: ae 80 00 00 00 00 00 00 a4 4f 01 00 00 00 00 00 ------------------------------------------------------- ANALOG REGISTERS: 000000: 48 4c a4 4f 48 02 ff 1d 05 00 00 7b c4 80 00 00 000010: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 40 000020: 54 00 00 00 00 00 00 00 00 00 00 2e 1f 15 00 00 000030: 20 20 80 80 07 20 00 00 00 ff 00 00 00 00 00 00 000040: 39 29 aa 00 80 00 00 00 00 00 00 00 ff ff ff 0f 000050: 07 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 000060: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 000070: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 01 000080: 48 4c a4 4f 48 02 ff 1d 05 00 00 7b c4 80 00 00 000090: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 40 0000a0: 54 00 00 00 00 00 00 00 00 00 00 2e 1f 15 00 00 0000b0: 20 20 80 80 07 20 00 00 00 ff 00 00 00 00 00 00 0000c0: 62 29 aa 00 80 00 00 00 00 00 00 00 ff ff ff 0f 0000d0: 07 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0000e0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0000f0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 01 ------------------------------------------------------- REGISTERS: 000060: 7c f7 c7 83 08 30 06 00 02 00 02 00 01 02 1f 00 000070: 00 04 00 04 00 00 00 00 00 00 00 64 00 02 62 55 Read Full Flash: TlsrPgm.py -w -t100 -a200 -c -pCOM3 -b1500000 rf 0 0x80000 ff_512k.bin
======================================================= TLSR825x TlsrPgm version 25.11.20 ------------------------------------------------------- Open COM3, 230400 bit/s... ok PGM: ChipID: 0x5562 (TLSR825x), ver: 0.0.0.1 swdiv 5, addrlen 3, swbuf [5a 00 06 02 00 05], pwr On SWire bit rate: 0.9600 Mbits/s Set Speed UART PGM board 3000000 bits/s... ok ReOpen COM3, 3000000 bit/s... ok === PreProcess ======================================== Hard reset Ext.MCU 5 ms... ok Activate 20 ms... ok CPU PC=0x000000 CPU Stall... ok === Process =========================================== Outfile: ff_512k.bin Read Flash from 0x000000 to 0x080000... Worked Time: 11.305 sec Read the dump of RAM (on the fly, waiting for the SoC to exit sleep): TlsrPgm.py -pCOM6 -b1500000 -z10 -c -g ds 0x848000 0x10
======================================================= TLSR82xx TlsrPgm version 03.12.25 ------------------------------------------------------- Open COM6, 230400 bit/s... ok PGM: ChipID: 0x5562 (TLSR825x), ver: 0.0.0.5 swdiv 5, addrlen 3, swbuf [5a 00 06 02 00 05], pwr On SWire bit rate: 0.9600 Mbits/s Set Speed UART PGM board 1500000 bits/s... ok ReOpen COM6, 1500000 bit/s... ok === PreProcess ======================================== CPU PC=0x00000574 CPU Stall ([0x0602] = 0x06) === Process =========================================== ------------------------------------------------------- REGISTERS: 848000: 9c ad 90 b0 f6 ef ad fe 68 6d 1a b1 fd ef fe ed === Post-Process ====================================== CPU Go... ok В FW UART2SWire версии 0.0.0.4 программатора и “TlsrPgm.py” добавлена функция вывода сообщений printf() через соединение SWM-SWS по протоколу Telink SWire.
Приложен пример c sws_printf() для SoC TLSR825x (в SampleSwsPrintf).
В “TlsrPgm.py” желательна установка COM-порта на 500000 или 921600 Baud.
Но данный функционал полностью работоспособн и на стандартной скорости в 230400, устанавливаемой в “TlsrPgm.py” по умолчанию.
При работе SWire на скорости 0.9600 Mbits/s номинальный выдаваемый поток находится в пределах около 500000 Baud, если переводить это на COM порт.
При меньших установках скорости COM-порта и непрерывной работе printf() будут вставляться межкадровые задержки в опросе SWire...
Для скорости COM-порта ниже 115200 Baud уже следует увеличить время ожидания в “SWS_WAITING_TIMEOUT”.
В FW UART2SWire версии 0.0.0.5 программатора и “TlsrPgm.py” добавлена ускоренная функция чтения PC с остановкой или stall CPU.
Ранее наблюдались пропуски при быстрых пробуждениях и засыпаниях SoC. Теперь это обрабатывается на максимальной скорости SWire, без пауз между командами.
- Соединить PD4(SWM) и SWS на PB-0xx
- Выполнить (изменив номер порта на используемый модулем PB-0xx):
TlsrPgm.py -pCOM6 i Диаграмма шины и описание регистров Telink SWire контроллера: TelinkSWire.pdf
Это вырезка из ранней документации на чип TLSR8266 выложеной на сайте Telink много лет назад. В текущих версиях datasheet на чипы TRLS82xx этот раздел удален.