readme

vxworks源码源码解读是学习vxworks的最佳途径

				wdbportsvr BACKEND
				==================

A version of the WDB backend specialized for target serial line based
connection; does not require SLIP and serial line on the host system.
This backend supports either system-level or task-level views of the target,
depending on the target-agent configuration.


When you use the boardLab, you play with the following configuration :

								 -----------
								 |	   |
-  -  -  -  -  -  -  -  -  | 			      ---------- | Target1 |
						     /		 |	   |
          Host	           |			    /		 -----------
 ---------     -----------	  ---------------  /		 -----------
 |	  |    |         | TCP/IP |	         |/ Serial lines |	   |
 | tgtsvr |----| Backend |--------| portSeverver |-------------- | Target2 |
 |	  |    |         | |	  |	         |\		 |	   |
 ----------    -----------	  ---------------  \		 -----------
			   |			    \		 -----------
	          				     \		 |	   |
-  -  -  -  -  -  -  -  -  |			      -----------| Target3 |
								 |	   |
								 -----------

The idea
--------

  Using the existing connections to launch a target server with a target agent 
  configured for a raw serial connection (WDB_COMM_TYPE = WDB_COMM_SERIAL).
  There is no need to add a serial cable between your target and host.


How to use this backend
----------------------

  Resources

	The wdbportsvr backend configures some portServer parameters such as 
	line speed or flow control. So you must create a file (named
	portSvrConfig) in WIND_BASE/host/resource/wdb/wdbportsvr directory 
	containing the portServer root login and the portServer root password.

		Example :

		root
		wrsportserver

	For Windows only

	    - Install a expect's version compatible with Tcl8.0 on your PC.

		(you can find a Expect site for windows NT and windows 95
		 at http://bmrc.berkeley.edu/people/chaffee/expectnt.html
		 and download the snapshot_19 version).

	    - Create a wdbportsvr.tcl file in $(HOME)/.wind directory. This
              file set a variable for the expect path.

		Example :

		if {$env(WIND_HOST_TYPE) == "x86-win32"} {
		set expect_src  "D:\\Expect-5.21\\bin\\tclsh80.exe"
		}

  Target side

	Build a vxWorks image with WDB_COMM_TYPE = WDB_COMM_SERIAL.


  Host side

	To start a target server run the following command :

	tgtsvr "ip_address" -n "name" -B wdbportsvr -d "port_number"
			    -b "line_speed"

		ip_address  : The internet address of the portServer
			      (in Vannes  ip_address = 147.11.80.200
			       in Alameda ip_address = 147.11.22.20)

		name	    : The name of the target server

		port_number : The number of the portServer port connected 
				to your target. Get this number in 
				information windows in boarLab interface
				(field named : Port)


		line_speed  : The speed of the serial line defined by
				WDB_TTY_BAUD

	Example :

		tgtsvr 147.11.80.200 -n "myTarget" -B wdbportsvr -d 7 -b 38400

WARNING :
=========

	- If the target server exits abnormally, it's possible that the 
	  backend can't restore the portServer default parameters.


AVAILABILITY :
==============

	- Tornado 1.0.x via tor1_0_x cspec (only for UNIX)

	- Tornado 2.0 via tor2_0_x cspec (both for UNIX & WINDOWS)

NOTES :
=======

	- This backend is VERY USEFUL for testing system mode via serial line
	  without moving hardware around or reconfiguring anything.

	- This backend is for WRS use only but migth be given away to customers
	  with the boarLab stuff as unsupported utilities.