Difference between revisions of "Connect to a modified router"

From Embedded Xinu
Jump to navigation Jump to search
m (How to connect moved to HOWTO:Connect to a modified router: Moving this page in line with the other HOWTOs)
(changed structure to align with other HOWTOs, more left to fill in)
Line 1: Line 1:
Once we have the router powered up, connecting is as simple as plugging the [[Pictures|serial ports]] into a machine with the proper software to communicate over it (such as [http://www.columbia.edu/kermit/ Kermit]).
+
== Summary ==
 +
 
 +
This will explain how to connect to the serial ports on a modified LinkSys WRT54G using serial communication software such as the open source [http://www.columbia.edu/kermit/ Kermit].
 +
 
 +
== Before Starting ==
 +
 
 +
=== Expose a serial port on the router ===
 +
 
 +
You must have successfully modified a LinkSys WRT54G to expose at least its first serial port in such a way that you can connect it to another machine with serial communications software.  If you have not done so yet, please see [[HOWTO:Modify the Linksys hardware]]
 +
 
 +
=== Acquire serial communication software ===
 +
 
 +
A solid open source suite of communication software known as Kermit has served us well as a method of communicating with the WRT54G.  C-Kermit, the UNIX compatible implementation, is available for download at their website [http://www.columbia.edu/kermit/ck80.html].
 +
 
 +
== Steps to Connect to the Router ==
 +
 
 +
=== Task One: Power up the Router ===
 +
 
 +
Yes, that means plug it in.
 +
 
 +
=== Task Two: Connect Serial (& Optionally Network) Cable(s) ===
 +
 
 +
Ensure that the connection is going from UART0 (the first serial port--you ''did'' label them didn't you?) as this is where the console will be running.
 +
 
 +
Also, because the goal is to upload custom code to the router, it would be a good idea to connect the router to your network by wiring it up via one of the numbered LAN ports on the back of the router (NOT the Internet/WAN port).
 +
 
 +
=== Task Three: Configure your Serial Communication Software ===
 +
 
 +
The connection used by the router's serial port is fairly standard: 115200bps, with 8 data bits, no parity bit, and 1 stop bit, or 8N1.
  
 
In our setup, once running Kermit on the external machine, we connected by typing in:<br/>
 
In our setup, once running Kermit on the external machine, we connected by typing in:<br/>
Line 17: Line 45:
 
|}
 
|}
  
Once connected, you may need to press <code>Enter</code> to get a console from [[OpenWRT]].
+
=== Task Four: Connect to the OpenWRT Console ===
 +
 
 +
In Kermit, after the configuration commands have been entered, it was as easy as typing <code>connect</code>.  Once connected, press <code>Enter</code> to get a console from [[OpenWRT]]. This should function just about identically to the ssh console, and if it works correctly, it means that the serial port has been correctly installed.
 +
 
 +
=== Task Five: Access to the Common Firmware Environment CLI ===
 +
 
  
Also, because the goal is to upload custom kernels to the router, it would be a good idea to connect the router to your network by wiring it up via one of the numbered LAN ports on the back of the router (NOT the Internet/WAN port).
+
== What to do next? ==

Revision as of 13:51, 6 March 2007

Summary

This will explain how to connect to the serial ports on a modified LinkSys WRT54G using serial communication software such as the open source Kermit.

Before Starting

Expose a serial port on the router

You must have successfully modified a LinkSys WRT54G to expose at least its first serial port in such a way that you can connect it to another machine with serial communications software. If you have not done so yet, please see HOWTO:Modify the Linksys hardware

Acquire serial communication software

A solid open source suite of communication software known as Kermit has served us well as a method of communicating with the WRT54G. C-Kermit, the UNIX compatible implementation, is available for download at their website [1].

Steps to Connect to the Router

Task One: Power up the Router

Yes, that means plug it in.

Task Two: Connect Serial (& Optionally Network) Cable(s)

Ensure that the connection is going from UART0 (the first serial port--you did label them didn't you?) as this is where the console will be running.

Also, because the goal is to upload custom code to the router, it would be a good idea to connect the router to your network by wiring it up via one of the numbered LAN ports on the back of the router (NOT the Internet/WAN port).

Task Three: Configure your Serial Communication Software

The connection used by the router's serial port is fairly standard: 115200bps, with 8 data bits, no parity bit, and 1 stop bit, or 8N1.

In our setup, once running Kermit on the external machine, we connected by typing in:

set line /dev/tty000      to connect to the device talking to the router.
set serial 8n1      which is not really necessary since this is default.
set speed 115200      as given to us in the router specifications.

Task Four: Connect to the OpenWRT Console

In Kermit, after the configuration commands have been entered, it was as easy as typing connect. Once connected, press Enter to get a console from OpenWRT. This should function just about identically to the ssh console, and if it works correctly, it means that the serial port has been correctly installed.

Task Five: Access to the Common Firmware Environment CLI

What to do next?