http://wiki.openwrt.org/oldwiki/openwrtdocs/hardware/linksys/wrt54gl

Linksys WRT54GL

The WRT54GL is basically a v4.0 WRT54G that still runs Linux. The 1.0 version of this model has serial numbers starting with

CL7A
; version 1.1 models have serial numbers starting with
CL7B
and
CL7C
. As of August 2006, version 1.1 appears to be shipping worldwide. See the WRT54GL thread in the forum. The model number shown on the package, the front panel, and the sticker on the underside of the unit is WRT54GL. The FCC ID sticker says it is WT54GV40, so it is substantially identical to a WRT54G v4.0/WRT54GS v3.0.

NOTE: This howto is written for OpenWrt Kamikaze 7.09 and later versions.

Supported Versions

Model S/N OpenWrt Kamikaze
WRT54GL v1 CL7A (./)
WRT54GL v1.1 CL7B (./)
WRT54GL v1.1 CL7C (./)

NOTE: In pre 8.09_RC1 the wireless part is only supported on the 2.4 Kernel version of Kamikaze. The 2.6 Kernel runs fine on the box, but (because the wl.o driver from Broadcom is only available for 2.4 Kernels and the opensource b43 driver is not ready yet) the wireless does not work if you flash a image with a 2.6 Kernel. (the 8.09_RC1 fixes this issue and wlan works on 2.6)

For wireless support on Kernel 2.6 it is recommended to use trunk snapshots or releases newer than and including "Backfire" 10.3 — Jo-Philipp Wich 2010/03/17 21:19

Hardware

Info

Architecture: MIPS
Vendor: Broadcom
Bootloader: CFE
System-On-Chip: Broadcom 5352EKPB
CPU Speed: 200 Mhz
Flash-Chip: EON EN29LV302B-70TCP
Flash size: 4 MiB
RAM: 16 MiB
Wireless: Broadcom BCM43xx 802.11b/g (integrated)
Ethernet: Switch in CPU
USB: No
Serial: Yes
JTAG: Yes

Serial port

The WRT54GL has a 10 pin connection slot on the board called JP1 (JP2 on some v1.1 boards). This slot provides two TTL serial ports at 3.3V. Neither of the ports use hardware flow control, you need to use software flow control instead. Other routers may have similar connections. These two TTL serial ports on the WRT54GL router can be used as standard Serial Ports similiar to the serial ports you may have on your PC. In order to do this though you need a line driver chip that can raise the signal levels to RS-232 levels. You can not directly connect a serial port header to the board and expect it to work. That method will only work with devices that can connect to TTL serial ports at 3.3V. Connecting two which have 3.3V directly will work (TX - RX, RX - TX, GND - GND). Standard RS-232 devices cannot be directly connected which accounts for nearly all serial PC devices.

Once the modification is made you can have at most two serial ports to use for connecting devices etc. By default, OpenWrt uses the first serial port to access the built-in serial console on the router. You can connect to it at 115200,8,N,1 using a terminal program like Putty, SecureCRT or minicom for example. This is helpful because if you have problems communicating with your router this method will allow you easy access connecting over a serial console. By default this leaves you with one serial port left, however, there is a method to turn the console off giving you access to both ports if you really need them. It isn't recommended but it can be done.

Pin 2 3.3V Pin 4 TX_0 Pin 6 RX_0 Pin 8 Not connected Pin 10 GND
Pin 1 3.3V Pin 3 TX_1 Pin 5 RX_1 Pin 7 Not connected Pin 9 GND

wrt54gl_v11_serialport___.jpg

JTAG

The JTAG port is a unpopulated 12-pin header and is located next to the serial port header. A simple unbuffered should work fine.

Pin 2 GND Pin 4 GND Pin 6 GND Pin 8 GND Pin 10 GND Pin 12 GND
Pin 1 nTRST* Pin 3 TDI Pin 5 TDO Pin 6 TMS Pin 9 TDK Pin 11 nSRST*

* Not used on an unbuffered JTAG cable.

wrt54gl_v11_jtagport___.jpg

See JTAG Cable for more JTAG details.

Photos

Opening the case

To remove the front cover you simply pop the front of the case off after removing the antennas. Please note that the warranty will be voided.

There are two screws holding the PCB to the bottom cover.

Installation

You MUST MUST MUST first install version 2.4 kernel before you attempt to install a 2.6! The nvram paramaters are unavailable in 2.6. So don't install 2.6 versions on this box until you've installed 2.4 first and done this step.

Right after flashing at your first login set a few NVRAM parameters.

nvram set boot_wait=on
nvram set boot_time=10
nvram commit && reboot

NOTE: You do not have to touch any other NVRAM parameters. After this point NVRAM is no longer used.

Using the Linksys web GUI

It is possible to install OpenWrt directly with the Linksys web GUI. If you are initially installing OpenWrt use the Linksys web GUI. This is the easiest way.

  • Download the openwrt-wrt54g-squashfs.bin firmware image from the brcm-2.4 folder to your PC. DO NOT DOWNLOAD AND INSTALL THE 2.6 VERSION!! YOU WON'T BE ABLE TO SET nvram boot_wait=on in it, because it has no nvram command. So first instal 2.4 even if that isn't what you want, then upgrade later.
  • Open http://192.168.1.1/Upgrade.asp in your browser or manually go to http://192.168.1.1 → Administration → Firmware Upgrade
  • Upload openwrt-wrt54g-squashfs.bin
  • Wait 2 minutes. The router will reboot itself automatically after the upgrade is complete.
  • You are done! You should be able to telnet to your router (IP address: 192.168.1.1) and start configuring.

Using the TFTP method

Once you have set the NVRAM parameters above it is possible to use a TFTP client to flash OpenWrt. The TFTP method is also the recommended way to restore the original Linksys firmware or switch to other third-party firmwares.

  • Unplug the router's power cord.
  • Connect the router's LAN1 port directly to your PC.
  • Configure your PC with a static IP address between 192.168.1.2 and 192.168.1.254. E. g. 192.168.1.2 (gateway and DNS is not required).
  • Download the openwrt-wrt54g-squashfs.bin firmware image to your PC
  • Execute the TFTP commands (the commands are for Linux) below:

tftp 192.168.1.1
tftp> binary
tftp> trace
tftp> put openwrt-wrt54g-squashfs.bin
  • Plug the power on and the TFTP transfer should start immediately
  • Wait 2 minutes. The router will reboot itself automatically after the upgrade is complete.
  • You are done! You should be able to telnet to your router (IP address: 192.168.1.1) and start configuring.

Using the mtd command line tool

If you have already installed OpenWrt and like to reflash for e.g. upgrading to a new OpenWrt version. It is important that you put the firmware image into the ramdisk (/tmp) before you start flashing.

cd /tmp/
wget http://downloads.openwrt.org/kamikaze/8.09/brcm-2.4/openwrt-brcm-2.4-squashfs.trx
mtd write /tmp/openwrt-brcm-2.4-squashfs.trx linux && reboot

Linksys WRT54GL specific configuration

Interfaces

The default network configuration is:

Interface Name Description Default configuration
br-lan LAN & WiFi 192.168.1.1/24
vlan0 (eth0.0) LAN ports (1 to 4) None
vlan1 (eth0.1) WAN port DHCP
wl0 WiFi Disabled

Switch Ports (for VLANs)

Numbers 0-3 are Ports 1-4 as labeled on the unit, number 4 is the Internet (WAN) on the unit, 5 is the internal connection to the router itself. Don't be fooled: Port 1 on the unit is number 3 when configuring VLANs. vlan0 = eth0.0, vlan1 = eth0.1 and so on.

Port Switch port
Internet (WAN) 4
LAN 1 3
LAN 2 2
LAN 3 1
LAN 4 0

Failsafe mode

If you forgot your password, broken one of the startup scripts, firewalled yourself or corrupted the JFFS2 partition, you can get back in by using OpenWrt's failsafe mode.

Boot into failsafe mode

  • Unplug the router's power cord.
  • Connect the router's LAN1 port directly to your PC.
  • Configure your PC with a static IP address between 192.168.1.2 and 192.168.1.254. E. g. 192.168.1.2 (gateway and DNS is not required).
  • Plug the power on and wait for the DMZ LED to light up.
  • While the DMZ LED is on immediately press any button (Reset and Secure Easy Setup will work) a few times .
  • If done right the DMZ LED will quickly flash 3 times every second.
  • You should be able to telnet to the router at 192.168.1.1 now (no username and password)

What to do in failsafe mode?

NOTE: The root file system in failsafe mode is the SquashFS partition mounted in readonly mode. To switch to the normal writable root file system run mount_root and make any changes. Run mount_root now.

  1. Forgot/lost your password and you like to set a new one

passwd

  1. Forgot the routers IP address

uci get network.lan.ipaddr

  1. You accidentally run 'ipkg upgrade' or filled up the flash by installing to big packages (clean the JFFS2 partition and start over)

mtd -r erase rootfs_data If you are done with failsafe mode power cycle the router and boot in normal mode.

Buttons

The Linksys WRT54GL has two buttons. They are Reset and Secure Easy Setup. The buttons can be used with hotplug events. E. g. [#wifitoggle WiFi toggle].

BUTTON Event
Reset reset
Secure Easy Setup ses

Basic configuration

Configure WAN for Internet access

DHCP (e.g. for cable internet)

DHCP on the WAN port of the router is the default configuration.

uci set network.wan.proto=dhcp
uci commit network
ifup wan

TIP: Do not forget to power cycle your cable modem so it knows of the new MAC address of your router. Also make sure you use different subnets for the WAN and LAN networks.

If you need to clone MAC address on the WAN port use MAC address cloning. This is done with the macaddr option in the wan section.

uci set network.wan.macaddr=11:22:33:aa:bb:cc
uci commit network
ifup wan

PPPoE

With Kamikaze 7.09 PPPoE works out-of-the-box. All required packages are already installed in the default image. To configure PPPoE with UCI, do this:

uci set network.wan.proto=pppoe
uci set network.wan.username=
uci set network.wan.password=
uci commit network
ifup wan

QoS

Install the qos-scripts package

ipkg install qos-scripts

Basic QoS configuration using UCI:

uci set qos.wan.upload=192            # Upload speed in KB
uci set qos.wan.download=2048 # Download speed in KB
uci commit qos

Start QoS and enable on next boot

/etc/init.d/qos start
/etc/init.d/qos enable

Dynamic DNS

Please see Dynamic DNS.

WiFi

Enable WiFi

uci set wireless.wl0.disabled=0
uci commit wireless && wifi

WiFi encryption

WiFi toggle

Turn WiFi on/off with the Reset or Easy Secure Setup [#Buttons button]. Please see the WiFi toggle Wiki page.

Hardware mods

This section is under construction…

Adding an MMC/SD card

The GPIO (General Purpose Input/Output) lines can be used to add a SD card in SPI mode. There are 4 points in additional to power and ground needs to be connected. WRT54GL uses GPIO line 2 instead of GPIO line 5 (WRT54G v3.0 and lower) for DI, make sure to use the appropriate driver.

http://wiki.openwrt.org/OpenWrtDocs/Hardware/Linksys/WRT54GL/mmc_gif?action=AttachFile&do=get&target=mmc.gif 1. CS - Chip Select for the SD card GPIO 7 (0x80)
2. DI - Data in on the SD card. GPIO 2 (0x04)
3. VSS - Ground is a good thing GND
4. VDD - We need power of course. 3.3 V will do the job 3.3 V
5. CLK - The clock we generate for the SD card GPIO 3 (0x08)
6. VSS2 - Another ground is also a good thing GND
7. DO - Data out from the SD card GPIO 4 (0x10)

Photos for the soldering points:

  • +3.3V and GND
  • GPIO 2 and 3
  • GPIO 4 and 7

The MMC driver is available in Kamikaze 7.07+ (package kmod-broadcom-mmc) and as an optimized version of the original mmc.o module (which currently has best compatibility).

tar zxvf mmc-v1.3.4-gpio2.tgz
cp mmc-v1.3.4-gpio2/mmc.o /lib/module/2.4.34/

To manually set up the SD card, use the following commands:

echo 0x9c > /proc/diag/gpiomask
insmod mmc
dmesg

Mount vfat (i.e. fat ,fat32) or ext3 formatted partition:

ipkg install kmod-fs-vfat
ipkg install kmod-fs-ext3
mount /dev/mmc/disc0/part1 /mnt/ # alternatively add -t vfat or ext3

See MMC for details.

Relocate the writable filesystem to the SD card and let the SquashFS (boot and read-only) parition stay on the flash chip. Any changes and new packages will then be stored on the SD card.

See OpenWrtDocs/KamikazeConfiguration/PackagesOnExternalMediaHowTo and OpenWrtDocs/KamikazeConfiguration/BootFromExternalMediaHowTo for details.

Config /etc/config/bootfromexternalmedia:

config bootfromexternalmedia
option target '/mnt'
option device '/dev/mmc/disc0/part1'
option gpiomask '0x9c'
option modules 'mmc jbd ext3'
option enabled '1'

Other Info

v1.2

I have seen revision v1.2 in the shop. The sales guy told me it would not run homebrew linux. So i ended up buying a WRTG54GS which i now sucks and works. :) Has anyone seen a v1.2 revision to work?

just bought a WRT54GL (22 Nov 2007), and it'a v1.1 CL7B*** (manufactured 09/2007 ? date on the FCC/CE label) - NathaelPajani

I bought a WRT54GL today and received a v1.1 so I would expect that this is still the latest version. OTOH LinkSys claimed that the GL version is specifically targeted at hackers that customize their WRT, so why would they sell one that can not be customized? Did anybody else already see a v1.2 at all? – TorstenLandschoff

I tell you. I had the Package in my Hand. I backed of buying i because, as i sayed, had no confimation it will work. It was at Arlt in Freiburg im Breisgau, Germany. Possibly only a -DE Version?

I bought an WRT54GL-DE last week (11/07) from amazon and the device looks like an international version (I think there are no german versions). The version is 1.1, it was manufactured in 08/2007. –x3k6a2

Mine is the same version and manufacturing date, v1.1 made in 08/2007, brought here 27-Dec-2007 at a local store. The "-DE" label seems to be sort of a marketing trick. In fact, even the manual on CD-ROM is labeled "english-only". – StHoffmann

I bought a new WRT54GL in Germany at amazon.de (in May 07) The Revision is v1.1. The router was manufactured in 01/2007. I can see this date on a sticker on the bottom of the router. – ThomasBrinkmann

The WRT54GL is Linksys' response to angry customers. For a long time, they had the original WRT54G, which was hackable, but when they joined with Cisco they made it so you were unable to hack the router. Thus, the 54GL. Version 1.1 is the current release, and as of yet there is no v1.2. –CharlesEddy

I do not trust this man. –MilesNordin

Flashing via JTAG

I successfully bricked my WRT54GL v1.1 and had no other chance as taking JTAG to debrick it. Following the instructions written on the Wiki and HairyDairyMaid, I tried my best - but wrt54g kept saying that he does not know what flash-chip is on my board. After some time of searching with google, I found an solution written by some people from DD-WRT: http://www.dd-wrt.com/phpBB2/viewtopic.php?t=28295.

They did not give any evidence for their research, but seems to work - EON EN29LV320B is an AMD 29LV320MB chip…. Hope this helps someone… –OliverSchmidt


Back to top

oldwiki/openwrtdocs/hardware/linksys/wrt54gl.txt · Last modified: 2010/09/18 01:54 by realopty

You are here: OpenWrt Wiki » The "oldwiki" namespace » OpenWrt Documentation » Hardware list » Linksys hardware notes » Linksys WRT54GL