xref: /openbmc/u-boot/doc/README.lynxkdi (revision 1f4bb37d6bcae59b18a2438f3cdca6545a831ab5)
1*1f4bb37dSwdenk			   LYNX KDI SUPPORT
2*1f4bb37dSwdenk
3*1f4bb37dSwdenk		    Last Update: July 20, 2003
4*1f4bb37dSwdenk=======================================================================
5*1f4bb37dSwdenk
6*1f4bb37dSwdenkThis file describes support for LynuxWorks KDI within U-Boot. Support
7*1f4bb37dSwdenkis enabled by defining CONFIG_LYNXKDI.
8*1f4bb37dSwdenk
9*1f4bb37dSwdenk
10*1f4bb37dSwdenkLYNXOS AND BLUECAT SUPPORTED
11*1f4bb37dSwdenk============================
12*1f4bb37dSwdenkBoth LynxOS and BlueCat linux KDIs are supported. The implementation
13*1f4bb37dSwdenkautomatically detects which is being booted. When you use mkimage
14*1f4bb37dSwdenkyou should specify "lynxos" for both (see target-specific notes).
15*1f4bb37dSwdenk
16*1f4bb37dSwdenk
17*1f4bb37dSwdenkSUPPORTED ARCHITECTURE/TARGETS
18*1f4bb37dSwdenk==============================
19*1f4bb37dSwdenkThe following targets have been tested:
20*1f4bb37dSwdenk
21*1f4bb37dSwdenk-PowerPC  MPC8260ADS
22*1f4bb37dSwdenk
23*1f4bb37dSwdenk
24*1f4bb37dSwdenkFILES TO LOOK AT
25*1f4bb37dSwdenk================
26*1f4bb37dSwdenkinclude/lynxkdi.h    -defines a simple struct passed to a kdi.
27*1f4bb37dSwdenkcommon/lynxkdi.c     -implements the call to the kdi.
28*1f4bb37dSwdenkcommon/cmd_bootm.c   -top-level command implementation ("bootm").
29*1f4bb37dSwdenk
30*1f4bb37dSwdenk
31*1f4bb37dSwdenk====================================================================
32*1f4bb37dSwdenkTARGET SPECIFIC NOTES
33*1f4bb37dSwdenk====================================================================
34*1f4bb37dSwdenk
35*1f4bb37dSwdenkMPC8260ADS
36*1f4bb37dSwdenk===========
37*1f4bb37dSwdenkThe default LynxOS and BlueCat implementations require some
38*1f4bb37dSwdenkmodifications to the config file.
39*1f4bb37dSwdenk
40*1f4bb37dSwdenkEdit include/configs/MPC8260ADS.h to use the following:
41*1f4bb37dSwdenk
42*1f4bb37dSwdenk#define CFG_IMMR	0xFA200000
43*1f4bb37dSwdenk#define CFG_BCSR	0xFA100000
44*1f4bb37dSwdenk#define CFG_BR1_PRELIM	0xFA101801
45*1f4bb37dSwdenk
46*1f4bb37dSwdenkWhen creating a LynxOS or BlueCat u-boot image using mkimage,
47*1f4bb37dSwdenkyou must specify the following:
48*1f4bb37dSwdenk
49*1f4bb37dSwdenkBoth:    -A ppc -O lynxos -T kernel -C none
50*1f4bb37dSwdenkLynxOS:  -a 0x00004000 -e 0x00004020
51*1f4bb37dSwdenkBlueCat: -a 0x00500000 -e 0x00507000
52*1f4bb37dSwdenk
53*1f4bb37dSwdenkTo pass the MAC address to BlueCat you should define the
54*1f4bb37dSwdenk"fcc2_ether_addr" parameter in the "bootargs" environment
55*1f4bb37dSwdenkvariable. E.g.:
56*1f4bb37dSwdenk
57*1f4bb37dSwdenk==> setenv bootargs fcc2_ether_addr=00:11:22:33:44:55:66
58