Debrick Wireless Router Using TUMPA Lite and zJTAG

From TIAO's Wiki
Jump to: navigation, search

10 PCS, 10cm x 10cm, 2 layers prototype for $38.80 shipped!








Buy various JTAG cables for your Satellite Receiver, Cable Modem, Wireless Router, Standard Wiggler from http://www.easymg.com and http://www.diygadget.com


Overview

The TIAO USB Multi Protocol Adapter Lite(TUMPA Lite) is a multi-functional USB communication adapter for hobbyists or engineers. The adapter is based on FDTI's flagship communication chip FT232H, a USB 2.0 Hi-Speed (480Mb/s) to UART/FIFO IC. It has one multi-protocol synchronous serial engines (MPSSEs) which allow for communication using JTAG, I2C and SPI.

The following link will bring you to the manual of TUMPA Lite: TIAO USB Multi Protocol Adapter Lite User's Manual

In this tutorial, we are going to show you how to debrick a wireless router using TUMPA Lite and zJTAG. We use WRT54GS as an example, however, it doesn't mean than you can only debrick WRT54GS with TUMPA Lite and zJTAG. You can follow the same instruction to debrick other wireless routers.

Required Hardware and Software

Solder the IDC headers onto the TUMPA Lite

The first step you need to do is to solder the IDC headers onto the board. The headers are standard 2.54mm IDC headers thus it is very easy to solder.

This is what you will receive from us:

Lite-p-1.png
  • TUMPA Lite board
  • 2 x 80 PIN IDC header
  • Female to female solderless jumper wire (8 PCS)

You don't need to solder all headers. If your only purpose is to use TUMPA Lite to debrick your router or cable modem, you only need to solder JTAG headers.

Since I have my solder iron warmed up already, I soldered all headers:

Lite-p-2.png

Disassemble your router

The first step is to disassemble your router. In this example, the WRT54GS is very easy to disassemble. See reference here: Debrick Routers Using JTAG Cable. If you don't know how to disassemble your router, just search it on google :-)

Locate the JTAG Header/Pin on the router's PCB board

The JTAG pin on the WRT54GS is the JP2. See reference here: Debrick Routers Using JTAG Cable

Install TUMPA Drivers

We have tutorials for TUMPA driver installation. TUMPA Lite driver installation is very similar to TUMPA driver installation below:

How to install TIAO USB Multi Protocol Adapter Driver on Windows XP

How to install TIAO USB Multi Protocol Adapter Driver on Windows Vista or Windows 7

Once the driver is installed, unplug TUMPA Lite from your USB port.

Make The Connections

Once you have identified the JTAG pins on your router, you can connect the router with TUMPA Lite board with the supplied female to female flex cable.

The pinout on the router is as follows:

nTRST  1   2 GND
TDI    3   4 GND
TDO    5   6 GND
TMS    7   8 GND
TCK    9  10 GND
nSRST 11  12 GND


and the pinout one the TUMPA Lite is:


Lite-jtag.png


Pin # FT232H Pin Description
1 Not Connected Not Connected
3 AD5 nTRST
5 AD1 TDI
7 AD3 TMS
9 AD0 TCK
11 AD7 RTCK
13 AD2 TDO
15 AD4 RST
17 AD6 DBGRQ
19 AC0 DBGACK
2 Not Connected Not Connected
4, 6, 8, 10, 12, 14, 16, 18, 20 GND GND

Or if you use GPIO P2 pins:

Lite-p2.png

These pins are either power pins or directly connected to GPIO pins of FT232H.

Pin #           Description
1, 2   GND
3, 4   +3.3V of TUMPA Lite's onboard LDO output.
5, 6   +3.3V of TUMPA Lite's onboard LDO output.
7, 8   +5V output (from USB)
9, 10   +5V output (from USB)
11, 12   GND
13, 14   AD0
15, 16   AD1
17, 18   AD2
19, 20   AD3
21, 22   AD4
23, 24   AD5
25, 26   AD6
27, 28   AD7


Thus, it is easy to make the connections. (Make sure both router and TUMPA Lite are not powered on)

If you use TUMPA Lite's JTAG pins:

Use a flex female to female to connect TDI together (PIN 3 on Router to PIN 5 on TUMPA Lite's 20 PIN JTAG Header
Use a flex female to female to connect TCK together (PIN 9 on Router to PIN 9 on TUMPA Lite's 20 PIN JTAG Header
Use a flex female to female to connect TMS together (PIN 7 on Router to PIN 7 on TUMPA Lite's 20 PIN JTAG Header
Use a flex female to female to connect TDO together (PIN 5 on Router to PIN 13 on TUMPA Lite's 20 PIN JTAG Header
Use a flex female to female to connect GND together (PIN 4 on Router to PIN 4 on TUMPA Lite's 20 PIN JTAG Header


Or if you use TUMPA Lite's GPIO Header 2 P2: (which is what I am using)

Use a flex female to female to connect TDI together (PIN 3 on Router to PIN 5 (AD1) on TUMPA Lite's P2 header
Use a flex female to female to connect TCK together (PIN 9 on Router to PIN 9 (AD0) on TUMPA Lite's P2 header
Use a flex female to female to connect TMS together (PIN 7 on Router to PIN 7 (AD3) on TUMPA Lite's P2 header
Use a flex female to female to connect TDO together (PIN 5 on Router to PIN 13 (AD2) on TUMPA Lite's P2 header
Use a flex female to female to connect GND together (PIN 4 on Router to PIN 4 (GND) on TUMPA Lite's P2 header


So, it would look like this:

Lite-p-3.png
Lite-p-4.png
Lite-p-5.png


OK, double check the connections, do not power on both router and TUMPA Lite yet.

Get zJTAG Ready

Download zJTAG and unzip it to an empty directory. In my example, I unzipped it to E:\diy\zjtag directory.

Double check connections make sure they are correct and secure. Then, connect router to the power outlet and connect TUMPA Lite to your computer's USB port via an USB cable (USB A to Mini B, most digital cameras and camcorders use this kind of cable).

Run zJTAG to Debrick Your Router

It's time to debrick your router now. First, open a DOS prompt window, run
zjtag
without parameters will give you all the command line options.

The following are useful commands:

-probeonly -> Detect router's CPU and Flash chip.
-erase:<area name> -> example: -erase:NVRAM
-backup:<area name> -> example: -backup:CFE
-flash:<area name> -> example: -flash:Kernel
Also, the most important flag is JTAG clock speed divider
/L1:<divider>
. TUMPA Lite can clock TCK as high as 30Mhz, however most router's CPU cannot handle such high clock speed, thus you will have to slow down the clock to make it work.

This is the formula:

Speed in KHz = 30000 / (divider + 1)

For example, if you give the following option:

/L1:3

The TCK clock speed is 7500KHz or 7.5MHz (30000/(3+1)).

By default, zJTAG will detect TUMPA. However since we are using TUMPA Lite, we need to pass TUMPA Lite's cable id to zJTAG. The cable id is 3 for TUMPA Lite:

/cable:3

Let's detect the CPU and Flash now by running the following command:

zJTAG -probeonly /cable:3 /L1:3

Lite-1.png

Most time, you only need to erase NVRAM, so let's do it:

E:\diy\zjtag>zjtag.exe -erase:NVRAM  /cable:3 /L1:3

        ==============================================
               zJTAG EJTAG Debrick Utility V0.9
        ==============================================

cableid=3, cabletype=0

 Set I/O speed to 7500 KHz

USB TAP device has been initialized. Please confirm VREF signal connected!
Press any key to continue... ONCE target board is powered on!

Probing bus ... Done

Detected IR chain Length is 8

CPU assumed running under LITTLE endian

CPU Chip ID: 00010100011100010010000101111111 (1471217F)
*** Found a Broadcom manufactured BCM4712 REV 01 CPU ***

    - EJTAG IMPCODE ....... : 00000000100000000000100100000100 (00800904)
    - EJTAG Version ....... : 1 or 2.0
    - EJTAG DMA Support ... : Yes
    - EJTAG Implementation flags: R4k MIPS32

Issuing Processor / Peripheral Reset ... Done
Enabling Memory Writes ... Done
Halting Processor ... <Processor Entered Debug Mode!> ... Done
Clearing Watchdog ... Done
Loading CPU Configuration Code ... Skipped

Probing Flash at Address: 0x1FC00000 ...
Detected Chip ID (VenID:DevID = 0089 : 0017)
*** Found a Intel 28F640J3 4Mx16       (8MB) Flash Chip from Intel

    - Flash Chip Window Start .... : 1C000000
    - Flash Chip Window Length ... : 00800000
    - Selected Area Start ........ : 1C7E0000
    - Selected Area Length ....... : 00020000

*** You Selected to Erase the NVRAM.BIN ***

=========================
Erasing Routine Started
=========================
Total Blocks to Erase: 1

Erasing block: 64 (addr = 1C7E0000)...Done
=========================
Erasing Routine Complete
=========================
elapsed time: 3 seconds


 *** REQUESTED OPERATION IS COMPLETE ***


E:\diy\zjtag>

It's always a good idea to check the result of an erase or flash by running a backup command to compare the output.

In the case of erase, after the action, each bit of the whole area should be 1 (or each byte should be 0xFF). In the case of flash, always use a binary comparator software to compare the backup image after the flash with the original one.

So, let's do a backup and see if erase command was indeed good:



E:\diy\zjtag>zjtag.exe -backup:NVRAM  /cable:3 /L1:3

        ==============================================
               zJTAG EJTAG Debrick Utility V0.9
        ==============================================

cableid=3, cabletype=0

 Set I/O speed to 7500 KHz

USB TAP device has been initialized. Please confirm VREF signal connected!
Press any key to continue... ONCE target board is powered on!

Probing bus ... Done

Detected IR chain Length is 8

CPU assumed running under LITTLE endian

CPU Chip ID: 00010100011100010010000101111111 (1471217F)
*** Found a Broadcom manufactured BCM4712 REV 01 CPU ***

    - EJTAG IMPCODE ....... : 00000000100000000000100100000100 (00800904)
    - EJTAG Version ....... : 1 or 2.0
    - EJTAG DMA Support ... : Yes
    - EJTAG Implementation flags: R4k MIPS32

Issuing Processor / Peripheral Reset ... Done
Enabling Memory Writes ... Done
Halting Processor ... <Processor Entered Debug Mode!> ... Done
Clearing Watchdog ... Done
Loading CPU Configuration Code ... Skipped

Probing Flash at Address: 0x1FC00000 ...
Detected Chip ID (VenID:DevID = 0089 : 0017)
*** Found a Intel 28F640J3 4Mx16       (8MB) Flash Chip from Intel

    - Flash Chip Window Start .... : 1C000000
    - Flash Chip Window Length ... : 00800000
    - Selected Area Start ........ : 1C7E0000
    - Selected Area Length ....... : 00020000

*** You Selected to Backup the NVRAM.BIN ***

=========================
Backup Routine Started
=========================

Saving NVRAM.BIN.SAVED_20120922_154936 to Disk...
Done  (NVRAM.BIN.SAVED_20120922_154936 saved to Disk OK)

bytes written: 131072
=========================
Backup Routine Complete
=========================
elapsed time: 4 seconds


 *** REQUESTED OPERATION IS COMPLETE ***


E:\diy\zjtag>
Open the file
NVRAM.BIN.SAVED_20120922_154936
in any Hex editor you will see all bytes are changed to 0xFF. This should resolve your problem. If this doesn't work, erase the kernel (firmware):
zJTAG -erase:kernel /cable:3 /L1:3
then reflash the kernel via TFTP (see TFTP Flashing)

Or still doesn't work, you may need to flash CFE:

zJTAG -flash:CFE /cable:3 /L1:3

The CFE bin files in the repository all have MAC addresses that DO NOT MATCH your hardware, you will need to edit it before you flash it to your router. Please read Debrick Routers Using JTAG Cable first.

Again, to make sure flash is really successful, run a backup command after flash and compare the content with the original one to make sure.

If flash doesn't work or erase doesn't work, try to lower the speed by giving a larger divider, e.g. in my case, use

/L1:4

will decrease TCK to 6Mhz.


One more suggestion is, always backup each area and whole flash before you do anything to it. You never know!









Buy various JTAG cables for your Satellite Receiver, Cable Modem, Wireless Router, Standard Wiggler from http://www.easymg.com and http://www.diygadget.com



10 PCS, 10cm x 10cm, 2 layers prototype for $38.80 shipped!