uhammer_arm_bsp_readme.txt

uhammer_arm_bsp的主板支持包简要说明

/* readme.txt - LSI ARM BSP user manual */

/* Copyright 2000-2001 Hambor, Inc. */

/*
modification history
--------------------
11a,10oct2k, Xiong Hui,   written for U_Hammer  ethernet switch by uhammer Team.

*/

内容目录：
○。 版本信息
一。 功能与用途
二。 文件清单
三。 使用指导
四。 实验指导：建立Tornado WDB调试环境


○。 版本信息：
     名称     ：U_hammer以太网交换机 Board Support Packages For Tornado WDB, 
     版本号   ：Version 1.0  
     发布时间 ：2001年01月16日
     设计者   ：熊 辉

一。 功能与用途：
          1. 支持串口BOOTROM引导;
	      2. 支持串口Tornado WDB 调试

二。 文件清单：共计76个文件
    1. 使用说明： readme.txt
    2. 编译控制： makefile
    3. 源程序  ：

三。 使用指导：
 (○） 使用准备：
 1. 请备份本BSP， 保持目录名UHAM_BSP_SIO
 2. 修改系统文件autoexec.bat
    将<tornado_arm>/host/x86-win32/bin/torvar.bat的内容拷入autoexec.bat，重启动主机
 
 3. BootRom引导波特率115200， 系统仅提供一个串口。串口加载通道为 0.

（一）生成 串口引导bootrom

      步骤1. 备份并编辑.../UHAM_BSP_SIO/config.h
	        在config.h中找到宏定义 #undef INCLUDE_TSFS_BOOT
			 修改为：#define INCLUDE_TSFS_BOOT
			
			根据联接需要修改：#define WDB_TTY_CHANNEL 1
       步骤2. 进入DOS命令行方式， 进入  .../UHAM_BSP_SIO

       步骤3. 执行make bootrom.hex
       生成 录制文件bootrom.hex 完毕
      

 （二）生成 WDB串口调试vxWorks
     
      步骤1. 备份并编辑.../UHAM_BSP_SIO/config.h
	        在config.h中找到宏定义 #undef INCLUDE_TSFS_BOOT
			 修改为：#define INCLUDE_TSFS_BOOT
      步骤2. 启动Tornado 2.0 for ARM集成编辑环境
          建立新的工程(create bootable vxWorks image project),
	      假设工程名project_name 工程路径 project_dir
       BSP选择使用本BSP: ../UHAM_BSP_SIO

      步骤3. (可选项)在WorkSpace窗/vxWork栏/<project>树 选择VxWorks配置栏,  根据需要配置vxWorks模块
	   操作方法说明： 使用鼠标键，  
           1) 鼠标左键选择vxWorks配置图标树项目，
	          右键点击，出现浮动窗菜单选择
			  左键选择 Include/Exclude "配置项目", 达到配置/省略 vxWorks模块
           
	   2) 鼠标左键双击vxWorks配置图标树项目，可以观察配置项目属性与参数 

       常用配置Include：
            1) Development Tool Component
		      -> Select WDB Connect
			     -> WDB serial Connect

			  -> Show Routine
			     -> memory show routine
				 -> message queue show routine
				 -> semaphore show routine
				 -> stdio show routine
				 -> symbol table show routine
				 -> task show routine
			  -> Symbol Table Component
			     -> error status table
				 -> symbol table
				 -> symbol table initialize component
				    -> initialize symbol table
					-> select symbol initialize table
					   -> built in symbol initilize table
	   2) network component
		      -> network device 
			     -> END attach interface
				 -> END interface support
              -> network protocols
			     -> network application
				    -> PING Client
				 -> network debugging
				    -> Network Show Routine
					-> TCP Show Routine
					-> UDP Show Routine

    步骤4. file/save workspace

    步骤5. 使用菜单项 配置vxWorks的WDB 串口通道与引导参数
     1)  Project -> Find Object -> Type Parameter -> DEFAULT_BOOT_LINE
       -> find
       修改宏定义 DEFAULT_BOOT_LINE 
	        "tsfs(0,0)host:/vxWorks h=192.168.0.72 e=192.168.0.33 u=test1 pw=drv tn=board1 f=0x00"

			根据需要修改参数：
			h  = 主机IP地址
			e  = 目标机IP地址
			u  = ftp server 用户
			pw = ftp server 用户口令
            tn = 目标板网络机器名

     2) (可选项)Project -> Find Object -> Type Parameter -> WDB_TTY_CHANNEL
       -> find 检查 WDB_TTY_CHANNEL CONSOLE_TTY 
      	   应该  WDB_TTY_CHANNEL  = 0
	         CONSOLE_TTY = NONE
    步骤6.  file/save workspace
    
    步骤7. 检查.h文件 External Dependencies/prjParams.h
       宏定义的赋值符合用户修改
	   #undef DEFAULT_BOOT_LINE
       #define DEFAULT_BOOT_LINE \
	        "tsfs(0,0)host:/vxWorks h=192.168.0.72 e=192.168.0.33 u=test1 pw=drv tn=board1 f=0x00"
    
    步骤9. 检查.h文件 External Dependencies/prjParams.h
       宏定义的赋值符合用户修改
      	   应该  WDB_TTY_CHANNEL  = 0
	         CONSOLE_TTY = NONE
    
    步骤10.  file/save workspace
    
    步骤11. (重要)修改.c 文件 prjConfig.c
       找到函数 void usrIosCoreInit (void)
       如下添加语句
    void usrIosCoreInit (void)
    {
     
      sysStartType = BOOT_CLEAR ; /* 添加语句 */

	  说明：此语句修改全局变量，废除bootrom的热引导参数，改用vxWorks引导参数
      
     步骤12. File/Save workspace
	 
     步骤13. (重要)Build/Rebuild all

     步骤14. (重要) 检查上述代码修改工作是否有效完成.  如果没有成功,重复步骤3. 到步骤13.
         说明：由于Tornado缺陷，上叙配置不一定会成功，步骤14是必要的。
    
     
     步骤15. 编译输出窗提示，编译成功， 得到〈project_dir〉/default/vxWorks文件
	     同时，双击检查WorkSpace窗/File栏/<project_name>树/Object Module枝/vxWorks项目
		 完毕。
		 

四。实验指导：建立Tornado WDB调试环境
  
  (一）主机与目标机的通讯联接方案
   Tornado WDB调试，根据boot通讯方式与WDB通讯方式，可以有四种方式：
	1) bootrom网口加载WDB 网口通讯 vxWorks ，需要可执行代码（网口引导bootrom + WDB网口调试vxWorks)
	2) bootrom网口加载WDB 串口通讯 vxWorks ，需要可执行代码（网口引导bootrom + WDB串口调试vxWorks)
	3) bootrom串口加载WDB 网口通讯 vxWorks ，需要可执行代码（串口引导bootrom + WDB网口调试vxWorks)
	4) bootrom串口加载WDB 串口通讯 vxWorks ，需要可执行代码（串口引导bootrom + WDB串口调试vxWorks)

    由用户确定联接方案。 参照第三节方法，生成bootrom.hex文件与vxWorks文件。
	bootrom.hex 通过编程器录入U_Hammer 512K bootrom Flash 器件
	WDB vxWorks由bootrom引导加载入U_Hammer SDRAM
  
  
  （二）实验指导：bootrom串口加载WDB vxWorks 
        步骤1,（可选项） 参照第三节方法，生成 串口引导bootrom
               获得文件 bootrom.hex
	       通过编程器录入U_Hammer 512K bootrom Flash 器件
		     
	步骤2, 参照第三节方法，生成 WDB调试vxWorks
                获得文件 vxWorks  路径 project_dir
        
	步骤3, 串口联接U_Hammer 交换机(目标机）与 PC机(主机)

	步骤4, 启动Tornado，
             使用菜单项  Tools -> Target Server -> Configuration ->new 
             键入用户配置名<mycfg>
             
	 在Tools -> Target Server -> Configuration 对话框中, 作如下配置:
             target server properties : Back End
               Available Back : wdbserial 
                 Serial Port : 用户选择  Baud Rate : 9600
 	     
             Target Name/IP Address : 本机IP地址

             target server properties : core file and symbol
                勾file : <project_dir>/default/vxWorks 
                （与上述生成 WDB调试vxWorks路径/文件一致）

             target server properties : Target Server File System
               勾Enable File System
               Root : <project_dir>/default
               勾 read/write  
               与上述生成 WDB调试vxWorks路径一致）
         
             target server properties : Console and Direction
               勾Create Console Windows
    
       步骤5 执行按钮命令, Launch , 启动Target Server
       主机Target Server 等待 与目标机 Boot Image的Target Agent 作串口tsfs连接

     	
       步骤6, 启动UHammer 交换机，
	    Target Server 检测到串口WDB联接信号，弹出WDB Console DOS 命令行窗
	    UHammer 交换机bootrom程序输出提示信息到WDB Console DOS 命令行窗
		       观察与配置UHammer引导参数
        
	   步骤7, WDB Console DOS 命令行窗口键入c,可修改引导参数
	      例如:
		  本机(PC主机）地址
		  host addr: 192.168.0.200
			  
		  U_Hammer 交换机（目标机）地址
		  enet addr: 192.168.0.201


        步骤8, WDB Console DOS 命令行窗口键入@ 或 $，开始串口加载WDB vxWorks从PC主机到U_Hammer目标机
               约等待5分钟，。。
	   WDB Console DOS 命令行窗口 输出提示  Start At : xxxxx, 
          表示已经加载WDB vxWorks进入SDRAM， 程序执行由Boot Image 跳转至WDB Image
               
	   WDB Console DOS 命令行窗消失，
	   表示WDB Agent 执行成功，等待与Tornado WDB Server联接
        
	   步骤9 （重要）鼠标右键点击 Windows窗右下角的Target Server图标，出现浮动菜单，选择shut down
          关闭 Target Server

		完毕。