uboot/doc
Luka Perkov d131ad68c6 kwboot: boot kirkwood SoCs over a serial link
The kwboot program boots boards based on Marvell's Kirkwood platform
via Xmodem over their integrated UART.

Signed-off-by: Daniel Stodden <daniel.stodden@googlemail.com>
Acked-by: Luka Perkov <uboot@lukaperkov.net>
Tested-By: Holger Brunck <holger.brunck@keymile.com>
Tested-By: David Purdy <david.c.purdy@gmail.com>
Tested-by: Simon Guinot <simon.guinot@sequanux.org>
2012-07-07 14:07:32 +02:00
..
SPL ARM: omap3: Set SPL stack size to 8KB, image to 54KB. 2012-05-15 08:31:41 +02:00
device-tree-bindings Prepare v2012.04-rc2; minor Coding Style cleanup 2012-04-16 23:13:51 +02:00
uImage.FIT
I2C_Edge_Conditions
README-integrator
README.440-DDR-performance
README.AMCC-eval-boards-cleanup
README.ARM-SoC
README.ARM-memory-map
README.AVR32
README.AVR32-port-muxing doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.COBRA5272
README.EVB-64260-750CX
README.INCA-IP
README.IPHASE4539
README.IceCube
README.JFFS2
README.JFFS2_NAND
README.LED
README.LED_display
README.Lite5200B_low_power
README.MBX
README.MPC866
README.Modem
README.N1213
README.NDS32
README.NetConsole
README.OFT
README.OXC
README.PIP405
README.POST
README.PlanetCore
README.RPXClassic
README.RPXlite
README.SBC8560
README.SNTP doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.SPL doc: fix typos 2012-02-12 10:11:32 +01:00
README.Sandpoint8240 doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.TQM8260
README.VLAN
README.ag101
README.ag102 board/adp-ag102: add configuration of adp-ag102 2012-04-22 16:58:23 +08:00
README.alaska8220
README.amigaone
README.arm-caches
README.arm-relocation
README.at91 doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.at91-soc
README.atmel_mci ATMEL: remove old atmel_mci driver 2012-03-13 12:06:42 +01:00
README.autoboot
README.bamboo
README.bedbug
README.bitbangMII
README.blackfin
README.bus_vcxk
README.cfi
README.cmi
README.commands doc: complete, typos 2012-02-14 11:02:46 -07:00
README.commands.itest
README.commands.spl Add cmd_spl command 2012-03-27 22:05:28 +02:00
README.console
README.davinci arm, da850evm: Add an SPL for SPI boot 2011-12-24 10:23:30 +01:00
README.davinci.nand_spl
README.db64360
README.db64460
README.designware_eth
README.dnp5370
README.dns
README.drivers.eth
README.ebony doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.enetaddr
README.evb64260
README.fads
README.fdt-control
README.fsl-ddr doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.fsl-hwconfig
README.generic_usb_ohci
README.hawkboard Changes to move hawkboard to the new spl infrastructure 2012-02-12 10:11:33 +01:00
README.hwconfig
README.idma2intr
README.imx5
README.imx31
README.imximage imximage: Add support for i.MX6 2012-02-12 10:11:25 +01:00
README.iomux
README.kmeter1
README.korat
README.kwbimage
README.link-local net: Add link-local addressing support 2012-05-23 17:53:08 -05:00
README.lynxkdi
README.m28 mx28: Split the README into a common part and a m28 specific part 2012-04-16 14:53:58 +02:00
README.m68k
README.m5253evbe
README.m5373evb
README.m5475evb
README.m52277evb
README.m53017evb
README.m54455evb
README.marubun-pcmcia
README.menu common, menu: show menu on startup if CONFIG_MENU_SHOW is defined 2012-02-12 10:11:24 +01:00
README.mergerbox
README.mips
README.mpc5xx
README.mpc74xx
README.mpc83xx.ddrecc
README.mpc83xxads
README.mpc85xxads doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.mpc85xxcds
README.mpc832xemds doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.mpc837xemds doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.mpc837xerdb
README.mpc7448hpc2
README.mpc8313erdb
README.mpc8315erdb
README.mpc8323erdb
README.mpc8349itx
README.mpc8360emds doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.mpc8536ds
README.mpc8544ds doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.mpc8569mds
README.mpc8572ds doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.mpc8610hpcd
README.mpc8641hpcn
README.mvbc_p doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.mvblm7 doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.mvsmr doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.mx6qsabrelite mx6qsabrelite: Add boot switch setting information into the README 2012-04-16 14:53:58 +02:00
README.mx28_common mx28: Split the README into a common part and a m28 specific part 2012-04-16 14:53:58 +02:00
README.mx28evk mx28evk: Fix PSWITCH key position 2012-07-07 14:07:29 +02:00
README.mx35pdk
README.nand nand: extend .raw accesses to work on multiple pages 2012-05-18 17:34:31 -05:00
README.nand-boot-ppc440
README.ne2000
README.nhk8815
README.ns9750dev
README.ocotea doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.ocotea-PIBS-to-U-Boot
README.omap-ulpi-viewport usb: ulpi: Add omap-ulpi-view port support 2012-02-12 10:11:30 +01:00
README.omap3
README.omap730p2
README.p1_p2_rdb_pc
README.p1022ds
README.p1023rds
README.p2020rdb doc: Fix some typos in different files 2012-03-27 13:31:37 +02:00
README.p2041rdb
README.p3060qds Coding Style cleanup 2011-12-19 12:03:40 +01:00
README.p4080ds
README.phytec.pcm030
README.ppc440
README.pxe pxe: parse initrd file from append string 2012-06-21 22:35:34 +02:00
README.qemu_mips
README.s5pc1xx
README.sandbox
README.sata
README.sbc8349
README.sbc8548 Prepare v2012.04-rc2; minor Coding Style cleanup 2012-04-16 23:13:51 +02:00
README.sbc8641d
README.sched
README.scrapyard MIPS: remove broken "tb0229" board 2011-12-12 14:26:48 +01:00
README.serial_multi
README.sh
README.sh7757lcr sh: sh7757lcr: add supporting for MMCIF 2012-03-26 10:09:30 +09:00
README.sh7785lcr
README.sha1
README.silent
README.simpc8313
README.spear
README.srio-boot-corenet powerpc/corenet_ds: Document for the boot from SRIO 2012-04-24 23:58:32 -05:00
README.standalone
README.stxxtc
README.switch_config arm,davinci: update for enbw_cmc board 2012-07-07 14:07:21 +02:00
README.timll
README.ubi
README.ublimage
README.update
README.usb
README.video
README.xpedite1k
README.zeus
feature-removal-schedule.txt miiphy: Note that miiphy_* API is deprecated 2011-12-05 22:17:06 +01:00
git-mailrc Update net subsystem maintainer in doc/git-mailrc 2012-04-03 19:56:34 -05:00
kwboot.1 kwboot: boot kirkwood SoCs over a serial link 2012-07-07 14:07:32 +02:00
mkimage.1 doc/mkimage.1: Fix -D/-f options formatting 2011-12-23 20:11:46 +01:00

README.zeus

Storage of the board specific values (ethaddr...)
-------------------------------------------------

The board specific environment variables that should be unique
for each individual board, can be stored in the I2C EEPROM. This
will be done from offset 0x80 with the length of 0x80 bytes. The
following command can be used to store the values here:

=> setdef de:20:6a:ed:e2:72 de:20:6a:ed:e2:73 AB0001

	  ethaddr           eth1addr          serial#

Now those 3 values are stored into the I2C EEPROM. A CRC is added
to make sure that the values get not corrupted.


SW-Reset Pushbutton handling:
-----------------------------

The SW-reset push button is connected to a GPIO input too. This
way U-Boot can "see" how long the SW-reset was pressed, and a
specific action can be taken. Two different actions are supported:

a) Release after more than 5 seconds and less then 10 seconds:
   -> Run POST

   Please note, that the POST test will take a while (approx. 1 min
   on the 128MByte board). This is mainly due to the system memory
   test.

b) Release after more than 10 seconds:
   -> Restore factory default settings

   The factory default values are restored. The default environment
   variables are restored (ipaddr, serverip...) and the board
   specific values (ethaddr, eth1addr and serial#) are restored
   to the environment from the I2C EEPROM. Also a bootline parameter
   is added to the Linux bootline to signal the Linux kernel upon
   the next startup, that the factory defaults should be restored.

The command to check this sw-reset status and act accordingly is

=> chkreset

This command is added to the default "bootcmd", so that it is called
automatically upon startup.

Also, the 2 LED's are used to indicate the current status of this
command (time passed since pushing the button). When the POST test
will be run, the green LED will be switched off, and when the
factory restore will be initiated, the reg LED will be switched off.


Loggin of POST results:
-----------------------

The results of the POST tests are logged in a logbuffer located at the end
of the onboard memory. It can be accessed with the U-Boot command "log":

=> log show
<4>POST memory PASSED
<4>POST cache PASSED
<4>POST cpu PASSED
<4>POST uart PASSED
<4>POST ethernet PASSED

The DENX Linux kernel tree has support for this log buffer included. Exactly
this buffer is used for logging of all kernel messages too. By enabling the
compile time option "CONFIG_LOGBUFFER" this support is enabled. This way you
can access the U-Boot log messages from Linux too.

2007-08-10, Stefan Roese <sr@denx.de>