xref: /openbmc/u-boot/doc/README.lynxkdi (revision cb5473205206c7f14cbb1e747f28ec75b48826e2)
11f4bb37dSwdenk			   LYNX KDI SUPPORT
21f4bb37dSwdenk
31f4bb37dSwdenk		    Last Update: July 20, 2003
41f4bb37dSwdenk=======================================================================
51f4bb37dSwdenk
61f4bb37dSwdenkThis file describes support for LynuxWorks KDI within U-Boot. Support
71f4bb37dSwdenkis enabled by defining CONFIG_LYNXKDI.
81f4bb37dSwdenk
91f4bb37dSwdenk
101f4bb37dSwdenkLYNXOS AND BLUECAT SUPPORTED
111f4bb37dSwdenk============================
121f4bb37dSwdenkBoth LynxOS and BlueCat linux KDIs are supported. The implementation
131f4bb37dSwdenkautomatically detects which is being booted. When you use mkimage
141f4bb37dSwdenkyou should specify "lynxos" for both (see target-specific notes).
151f4bb37dSwdenk
161f4bb37dSwdenk
171f4bb37dSwdenkSUPPORTED ARCHITECTURE/TARGETS
181f4bb37dSwdenk==============================
191f4bb37dSwdenkThe following targets have been tested:
201f4bb37dSwdenk
211f4bb37dSwdenk-PowerPC  MPC8260ADS
221f4bb37dSwdenk
231f4bb37dSwdenk
241f4bb37dSwdenkFILES TO LOOK AT
251f4bb37dSwdenk================
261f4bb37dSwdenkinclude/lynxkdi.h    -defines a simple struct passed to a kdi.
271f4bb37dSwdenkcommon/lynxkdi.c     -implements the call to the kdi.
281f4bb37dSwdenkcommon/cmd_bootm.c   -top-level command implementation ("bootm").
291f4bb37dSwdenk
301f4bb37dSwdenk
311f4bb37dSwdenk====================================================================
321f4bb37dSwdenkTARGET SPECIFIC NOTES
331f4bb37dSwdenk====================================================================
341f4bb37dSwdenk
351f4bb37dSwdenkMPC8260ADS
361f4bb37dSwdenk===========
371f4bb37dSwdenkThe default LynxOS and BlueCat implementations require some
381f4bb37dSwdenkmodifications to the config file.
391f4bb37dSwdenk
401f4bb37dSwdenkEdit include/configs/MPC8260ADS.h to use the following:
411f4bb37dSwdenk
42*6d0f6bcfSJean-Christophe PLAGNIOL-VILLARD#define CONFIG_SYS_IMMR	0xFA200000
43*6d0f6bcfSJean-Christophe PLAGNIOL-VILLARD#define CONFIG_SYS_BCSR	0xFA100000
44*6d0f6bcfSJean-Christophe PLAGNIOL-VILLARD#define CONFIG_SYS_BR1_PRELIM	0xFA101801
451f4bb37dSwdenk
461f4bb37dSwdenkWhen creating a LynxOS or BlueCat u-boot image using mkimage,
471f4bb37dSwdenkyou must specify the following:
481f4bb37dSwdenk
491f4bb37dSwdenkBoth:    -A ppc -O lynxos -T kernel -C none
501f4bb37dSwdenkLynxOS:  -a 0x00004000 -e 0x00004020
511f4bb37dSwdenkBlueCat: -a 0x00500000 -e 0x00507000
521f4bb37dSwdenk
531f4bb37dSwdenkTo pass the MAC address to BlueCat you should define the
541f4bb37dSwdenk"fcc2_ether_addr" parameter in the "bootargs" environment
551f4bb37dSwdenkvariable. E.g.:
561f4bb37dSwdenk
571f4bb37dSwdenk==> setenv bootargs fcc2_ether_addr=00:11:22:33:44:55:66
58