VxWorks BSP主要配置文件 config.h 和 Makefile 注解

config.h

/*
This file contains the configuration parameters for the CPU evaluation board.
*/

#ifndef INCconfigh
#define INCconfigh

/* BSP version/revision identification, before configAll.h */
#define BSP_VER_1_2 1
#define BSP_VER_1_1 1
#define BSP_VERSION "1.2" /* A Tornado 2.0 BSP */
#define BSP_REV "/3" /* 0 for first revision */

#include "configAll.h" /* 这个文件定义了VxWorks所有的缺省设置 */


/*
* Define ONE of the following to specify the revision of the PPC405GP chip
* you are using. Undefine all others. sysModel() will return
* "Unknown processor" if the correct selection is not made.
*/

/*
* Default boot line
*/

/* 

       解释: 这一行对配置网络,连通Target Server及下载调试程序非常重要 

       DEFAULT_BOOT_LINE 的原意是为没有NVRAM的target设计的,这样用户就不需要在每次系统启动是手工输入这些参数了. 

       系统启动网络时xxxEndLoad()会解释这一行并按这一行的定义进行加载. 
       
       Emac(0,0) : 启动设备,可是是软盘,硬盘,PCMCIA卡等 其他的设备名称如:

fd为软盘,(0,0)表示第一个软驱,3.5寸盘.
dc则表示从DEC 21x4x 芯片启动,即系统有NVRAM存在,这种方式现在已不采用.
elpci表示启动设备为3COM EtherLink XL PCI网卡.
fei:Intel 82559 EtherExpress网卡.
ene: NE2000网卡
ELT: 3COM以太网卡
EEX: Intel网卡
ata: ATA/IDE 硬盘 ............

405GP: 主机名
vXworks 从主机加载的VxWorks文件
h=172.16.1.159 主机的IP地址

e=172.16.254.52 目标机的IP地址,若网络启动Target Server时,这个IP必须和主机上Target Server配置的Target IP地址一致,且设置Back End选项为wdbrpc
u=xxx 用户名,pw=xxx 密码: 若通过网络加载调试时,主机的Ftp服务器和目标机的用户名和密码必须相同
tn=vxTarget 目标机名称

*/

#define DEFAULT_BOOT_LINE
"Emac(0,0)405GP:vxWorks h=172.16.1.159 e=172.16.254.52
u=xxx pw=xxx tn=vxTarget"

/*
* 内存设置.
* 如果定义了LOCAL_MEM_AUTOSIZE则SDRAM的大小会在Boot时指定
*/

#undef LOCAL_MEM_AUTOSIZE /* 运行时内存大小 */
#define LOCAL_MEM_SIZE 0x02000000 /* 32MB 内存缺省 */
#define LOCAL_MEM_LOCAL_ADRS 0x00000000 /* 内存基地址为 0 */
#define USER_RESERVED_MEM 0 /* see sysMemTop() */

/*
* Define SDRAM_ECC_ENABLE to enable ECC if an ECC SDRAM DIMM is detected
* during SDRAM auto-configuration. If not defined, ECC will not be enabled
* if an ECC SDRAM DIMM is detected, and the DIMM will be used as a normal DIMM.
*/

#undef SDRAM_ECC_ENABLE


/* 解释: 这里主要设置系统的内存分配定义,若分配不当,则系统不能正常加载和运行.

ROM_TEXT_ADRS, ROM_SIZE, RAM_HIGH_ADRS, 和RAM_LOW_ADRS 在config.h和Makefile文件中都要定义,且必须要保持一致,这些地址的定义一定要参照VxWorks 加载执行过程,硬件手册,MMU和VxWorks的大小进行.主要原则是保证VxWorks image 在ROM和RAM中都要有一定的运行空间且高效运行,可参见 VxWorks BSP和启动过程.

*/
#define ROM_BASE_ADRS 0xfff80000 /* ROM的基地址 */
#define ROM_TEXT_ADRS (ROM_BASE_ADRS + 0x100) /* 程序指针和堆栈指针 */
#define ROM_WARM_ADRS (ROM_TEXT_ADRS+0x0004) /* 热启动入口地址 */
#define ROM_SIZE 0x0007f000 /* ROM大小 512KB */
#define RAM_LOW_ADRS 0x00010000 /* RAM 低地址运行 vxWorks */
#define RAM_HIGH_ADRS 0x00C00000 /* RAM 高地址存储 bootrom */
#define USER_RESERVED_MEM 0 /* 用户保留地址 */


/*
* Cache options 定义缓存
*/

#define INCLUDE_CACHE_SUPPORT

#define USER_D_CACHE_ENABLE
#define USER_I_CACHE_ENABLE
#undef USER_D_CACHE_MODE
#define USER_D_CACHE_MODE (CACHE_COPYBACK)


/*
* 405 timers (PIT, FIT, WDT) 可由外部时钟驱动或者CPU驱动
*/

#define TIMER_CLOCK_EXTERNAL

/*
* Optional timestamp support
*/

#undef INCLUDE_TIMESTAMP

/*
* Auxilliary Timer rates 定义辅助计时器频率
*/

#ifdef TIMER_CLOCK_EXTERNAL
#define AUX_CLK_RATE_MIN (EXT_TIMER_CLK_FREQ / (1 << 21) )
#define AUX_CLK_RATE_MAX (EXT_TIMER_CLK_FREQ / (1 << 9) )
#define AUX_CLK_RATE_DEFAULT (EXT_TIMER_CLK_FREQ / (1 << 17) )
#else

/* ZZZZZZZZZZZ todo put rates in for system clock derived timer clock */

#endif

/*
* Watchdog Timer rates
*/

#define WDT_RATE_MIN 1 /* minimum watchdog timer rate */
#define WDT_RATE_MAX 5000 /* maximum watchdog timer rate */

/* 实时时钟设置 */

#define INCLUDE_RTC

/* 去除不需要的网络驱动 */

#undef INCLUDE_EI
#undef INCLUDE_EX
#undef INCLUDE_ENP
#undef INCLUDE_LN
#undef INCLUDE_SM_NET
#undef INCLUDE_SM_SEQ_ADDR


/* #define for software floating point support */

#undef INCLUDE_SW_FP

/* 定义串口 Serial port configuration */

#define INCLUDE_SERIAL


/* PCI 设置,PCI configuration */

#define INCLUDE_PCI

#ifdef INCLUDE_PCI
/*
* Three programmable processor local memory address to PCI memory address
* mappings. If a region is enabled, PMMx_LOCAL_ADRS must be between
* PCI_MEMORY_START and PCI_MEMORY_END. If PMMx_PCI_HIGH_ADRS is non-zero in
* an enabled region, 64 bit dual cycle addresses will be generated on the
* PCI bus for this region.
*/

//定义PCI设备的初始化地址 参见 PCI设备(网卡)初始化代码分析


# define PMM0_LOCAL_ADRS PCI_MEMORY_START // 定义PCI空间起始地址
# define PMM0_PCI_LOW_ADRS 0x80000000 // 定义PCI空间低位地址
# define PMM0_PCI_HIGH_ADRS 0x00000000 // 定义PCI空间高位地址
# define PMM0_PCI_MASK_ATTRIB (PMM_MASK_512MB | PMM_ENABLE)

# define PMM1_LOCAL_ADRS PMM_UNUSED
# define PMM1_PCI_LOW_ADRS PMM_UNUSED
# define PMM1_PCI_HIGH_ADRS PMM_UNUSED
# define PMM1_PCI_MASK_ATTRIB PMM_UNUSED

# define PMM2_LOCAL_ADRS PMM_UNUSED
# define PMM2_PCI_LOW_ADRS PMM_UNUSED
# define PMM2_PCI_HIGH_ADRS PMM_UNUSED
# define PMM2_PCI_MASK_ATTRIB PMM_UNUSED

/*
* PCI memory address to processor local memory address mapping. If a region
* is enabled, PTMx_LOCAL_ADRS must be within the two Local memory / peripheral
* regions (0x00000000-0x7FFFFFFF, or 0F0000000-0xFFFFFFFF)
*/
# define PTM1_LOCAL_ADRS LOCAL_MEM_LOCAL_ADRS
# define PTM1_SIZE_ATTRIB PTM_SIZE_2GB | PTM_ENABLE

# define PTM2_LOCAL_ADRS PTM_UNUSED
# define PTM2_SIZE_ATTRIB PTM_UNUSED

#endif /* INCLUDE_PCI */

/*
* 如果支持网络,本地EMAC和PCI网卡,必须有一个被选取,两者都是END形式驱动
*/
#define INCLUDE_NETWORK /* 支持网络 */
#define INCLUDE_EMAC_NETWORK /* 405GP 本地 EMAC 网络 */
#undef INCLUDE_PCI_NETWORK /* PCI 网络 */

/*
* The board does not have the Ethernet MAC address of the EMAC stored
* in any sort of NVRAM. Modify the 12 digit string below to match the decal
* that is on your board.
*/

#ifdef INCLUDE_EMAC_NETWORK
#define DEFAULT_EMAC_HW_ADDR "xxxxxxxxxxxx" /* 网络硬件地址,即MAC地址 */
#endif

/*
* WDB 通过网络Enhanced Network Driver加载调试程序,若网络加载调试,必须定义此项
*/


#define WDB_COMM_TYPE WDB_COMM_SERIAL /*首先默认使用串口通信*/
#define WDB_TTY_CHANNEL 0 /*使用第一个串口


#ifdef INCLUDE_NETWORK
#define INCLUDE_END
#undef WDB_COMM_TYPE
#define WDB_COMM_TYPE WDB_COMM_END /* 定义网络通信, END 驱动 */
#else
#undef WDB_COMM_TYPE
#define WDB_COMM_TYPE WDB_COMM_SERIAL /* 定义串口通信,和PC机串口连接 */
#undef WDB_TTY_CHANNEL
#define WDB_TTY_CHANNEL 0 /* 串口1 */
#endif /* INCLUDE_NETWORK */

/*************** 此处定义一些杂项 */

#ifdef NUM_TTY
#undef NUM_TTY
#endif
#define NUM_TTY 2 /* 定义了两个串口终端,*/


#ifdef WDB_TTY_BAUD
#undef WDB_TTY_BAUD
#endif
#define WDB_TTY_BAUD 57600 /* 波特率设置 9600, 19200, 38400, 57600, 115200 */

#ifdef CONSOLE_BAUD_RATE
#undef CONSOLE_BAUD_RATE
#endif
#define CONSOLE_BAUD_RATE 57600


#undef INCLUDE_ENV_VARS /* unix compatable environment variables */
#undef INCLUDE_TIMEX /* timexLib for exec timing */
#undef INCLUDE_HW_FP
#undef INCLUDE_TFTP_CLIENT /* used by autoboot from ftp server*/

#define INCLUDE_SW_FP
#define INCLUDE_ELF
#define INCLUDE_NET_SHOW
#define INCLUDE_PING
#undef INCLUDE_DEMO /* only for vxWorks bsp test */
#define ETHERNET_ADR_SET /* only for bootrom used */
#define INCLUDE_USER_APPL /* Startup the user's application in dos makefile project */
#undef PCIDEBUG

#ifdef INCLUDE_USER_APPL
#define USER_APPL_INIT _appEntry()
#endif

#endif /* INCconfigh */
#if defined(PRJ_BUILD)
#include "prjParams.h"
#endif



Makefile


# Makefile - make rules for board
#
#*/

CPU = PPC40x
TOOL = gnu

TGT_DIR=$(WIND_BASE)/target
include $(TGT_DIR)/h/make/defs.bsp
include $(TGT_DIR)/h/make/make.$(CPU)$(TOOL)
include $(TGT_DIR)/h/make/defs.$(WIND_HOST_TYPE)

## Only redefine make definitions below this point, or your definitions will
## be overwritten by the makefile stubs above.


TARGET_DIR = xxx
VENDOR = IBM
BOARD = xxx

RELEASE = vxWorks vxWorks.st bootrom_uncmp.hex

USR_ENTRY = usrInit


# ROM_TEXT_ADRS, ROM_SIZE, RAM_HIGH_ADRS, 和RAM_LOW_ADRS 在config.h,Makefile和Makefile.*文件中 # 都要定义,且必须要保持一致,


ROM_TEXT_ADRS = fff80100 # ROM 起始地址
ROM_SIZE = 0007f000 # ROM 空间大小

RAM_LOW_ADRS = 00010000 # RAM 低地址 vxWorks */
RAM_HIGH_ADRS = 00C00000 # RAM 高地址存储 bootrom */

HEX_FLAGS = -a 100

#ADDED_CFLAGS = -gdwarf -O0 # for debug

MACH_EXTRA = appentry.o # 注意:这里加载用户的程序模块,程序调用在usrRoot()

BOOTCONFIG = bootconfig.c # bsp bootconfig.c for bootrom


## Only redefine make definitions above this point, or the expansion of
## makefile target dependencies may be incorrect.

include $(TGT_DIR)/h/make/rules.bsp
include $(TGT_DIR)/h/make/rules.$(WIND_HOST_TYPE)


  

       Tornado for x86下BSP的生成,下载和Target Server的配置实例,Pentium主机,3Com网卡,软盘引导,ftp下载VxWorks映像。 


       1.在C:TornadotargetconfigpcPentium目录下修改BSP文件config.h。


#elif (CPU_VARIANT == PENTIUM)
#define DEFAULT_BOOT_LINE
"elt(0,0)HOST:c:\Tornado\target\config\pcPentium\vxWorks
h=90.0.0.3 e=90.0.0.50 u=target pw=target tn=target"

#define INCLUDE_ELT //3Com网卡
#define INCLUDE_END //END驱动 


       2.打开Tornado选择新建一个bootable vxworks image,选择建 A BSP,选择pcPentium,建完后编译就可以在相应的目录下生成vxworks的映像文件。 

       3.制作bootrom;选择Build Boot Rom,选择pcPentium,再选择bootrom_uncmp,生成 bootrom_uncmp。拷贝 bootrom_uncmp到hostx86-win32bin下,插入空白盘到软区,在dos界面进入目录hostx86-win32bin下,用命令"mkboot a: bootrom_uncmp "生成引导盘 

       4. 在Start > Programs > Tornado2 > FTP Server,点开Security下的user/rights菜单,新建用户User Name:target,Password:target,Home Directory为VxWorks映像所在目录如 C:TornadotargetconfigpcPentium。注意这些配置要和config.h中的一致。 

       5.将bootrom的启动盘插入目标机的软驱,启动目标机,系统从软驱启动,随后登陆FTP,从主机下载vxworks文件,目标机提示7秒内按任意键选择Boot方式(手工,自动),手工方式可对FTP用户,口令,IP等参数进行修改。通常是等待7秒后系统autoboot。 

       屏幕显示:

Attached TCP/IP interface to elt0.
Attaching network interface lo0... done. //TCP/IP网络连接成功

Loading... 602128 //通过ftp下载VxWorks映像
Starting at 0x01080000 //下载成功,从RAM_LOW_ADRS 0x01080000
开始执行VxWorks系统

Attached TCP/IP interface to elt unit 0
Attaching interface lo0...done //TCP/IP网络连接成功
(注意这里网络初始化成功和上边的不同,上边是Bootrom映像网络初始化来下载VxWorks,这里VxWorks系统初始化网络。)

VxWorks

Copyright 1984-1998 Wind River Systems, Inc.

CPU: xxxx --- Intel x82
VxWorks: 5.4
BSP version: 1.2/4
Creation date: Jan xx 2001
WDB: Ready. 


       至此目标机系统启动完成。 


       6.配置Target Server下载应用程序. 


       打开Tornado,在Tools菜单下选择Target Sever再选择configure进行配置(Tools > Target Server > Configure > New)给出Target Server名字描述如net00.在 (Target Server Properties > Back End)选择WdbRpc. Target Name/IP Address 框内输入Target的IP: 90.0.0.50. Core File and Symbols选项(Target Server Properties > Core File and
Symbols): C:TornadotargetconfigpcPentiumvxWorks等等。配置的内容根据系统的具体情况定。点击Launch启动Target Sever,随后在主界 面下选择已启动的Target Sever就可以下载 *.o或*.out程序。