Skip to content

W
White Rabbit Switch - Software
Commit 03e1f4de authored by Alessandro Rubini's avatar Alessandro Rubini
Browse files
Options

doc: another step: update boot message and remove texinfo menus 

Signed-off-by: Alessandro Rubini's avatarAlessandro Rubini <rubini@gnudd.com>
parent 6db696dd
Hide whitespace changes
Inline Side-by-side
Showing with 35 additions and 89 deletions
doc/wrs-build.in
View file @ 03e1f4de
...@@ -77,19 +77,6 @@ If you do not need to modify/hack anything in the switch and just learn ...@@ -77,19 +77,6 @@ If you do not need to modify/hack anything in the switch and just learn
how to use it, you should first refer at the @b{User Guide} that you can how to use it, you should first refer at the @b{User Guide} that you can
find in the @url{http://www.ohwr.org/projects/wr-switch-sw/files} find in the @url{http://www.ohwr.org/projects/wr-switch-sw/files}
@menu
* Overview::
* Building::
* Flashing of WRS-3::
* Booting with Barebox::
* The Individual Build Steps::
* Code layout in a production switch::
* Schematics are Available::
* Older Hardware Releases::
* Installing from Jtag::
* Bugs and Troubleshooting::
@end menu
@c ########################################################################## @c ##########################################################################
@node Overview @node Overview
@chapter Overview @chapter Overview
...@@ -144,12 +131,6 @@ sets all environment variables, while keeping defaults from your ...@@ -144,12 +131,6 @@ sets all environment variables, while keeping defaults from your
preexisting environment -- so you can override anything even when preexisting environment -- so you can override anything even when
rebuilding it all from scratch. rebuilding it all from scratch.
@menu
* Portability::
* Environment Variables::
* Downloading Files::
@end menu
@c ========================================================================== @c ==========================================================================
@node Portability @node Portability
@section Portability @section Portability
...@@ -291,11 +272,6 @@ The messages of a download run are like the following ones: ...@@ -291,11 +272,6 @@ The messages of a download run are like the following ones:
@node Building @node Building
@chapter Building @chapter Building
@menu
* Building Procedure::
* Build Script Description::
@end menu
@c ========================================================================== @c ==========================================================================
@node Building Procedure @node Building Procedure
@section Building Procedure @section Building Procedure
...@@ -390,12 +366,6 @@ in this chapter. You might also want to check its embedded documentation using: ...@@ -390,12 +366,6 @@ in this chapter. You might also want to check its embedded documentation using:
/path/to/wr-switch-sw/build/wrs_build-all --help /path/to/wr-switch-sw/build/wrs_build-all --help
@end example @end example
@menu
* Release Package::
* Rebuilding Parts::
* Rebuilding From Scratch::
@end menu
@c -------------------------------------------------------------------------- @c --------------------------------------------------------------------------
@node Release Package @node Release Package
@subsection Release Package @subsection Release Package
...@@ -787,23 +757,22 @@ Initializing DDR... ...@@ -787,23 +757,22 @@ Initializing DDR...
loading applet isp-extram-at91sam9g45 at 0x00300000 loading applet isp-extram-at91sam9g45 at 0x00300000
Initializing DDR > Done Initializing DDR > Done
Erasing DDR > DONE
@c FIXME: this is different (we have magicstr separated now)
Loading DDR... Loading DDR...
@ 0x70000000 : /tmp/barebox.Fb09jx ; size 0x2f1bc (188Kb) @ 0x70000000 : /tmp/flash-wrs-tAqUAs/bb.new ; size 0x637b0 (397Kb)
@ 0x71000000 : /data/morgana/build-v3-fede/images/zImage ; size 0x16886c (1442Kb) @ 0x71000000 : /data/morgana/build-v4/images/zImage ; size 0x1afb44 (1726Kb)
@ 0x71fffff8 : /tmp/wrsflash-cpio.jrPKMY.cpio.gz ; size 0x128c722 (18993Kb) @ 0x717ffff8 : /tmp/flash-wrs-tAqUAs/magicstr ; size 0x8 (0Kb)
DDR: Writing 21119306 bytes at offset 0x0 buffer 70000000....ABCDEF @ 0x71800000 : /data/morgana/build-v4/images/wrs-initramfs.gz ; size 0x196f84 (1627Kb)
DDR: Writing 3842688 bytes at offset 0x0 buffer 70000000....ABCDEF
[...] Closing...
Installation procedure starts Formatting UBI device... done
Flashing kernel to /dev/mtd0 ... done
Getting tftp://192.168.16.1/wrs-firmware.tar ... done Getting tftp://192.168.16.1/wrs-firmware.tar ... done
Mounting target filesystem... done Extracting filesystem... done
Uncompressing image... done
@end smallexample @end smallexample
The longest steps are erasing @i{dataflash} (it takes 2 minutes) and
the last three steps: formatting, tftp and extraction; each of them takes
around 1 minute.
Please note that the IP address used in the TFTP transfer depends on Please note that the IP address used in the TFTP transfer depends on
the DHCP handshake: the value above is what your developers use. the DHCP handshake: the value above is what your developers use.
The name @t{wrs-firmware.tar}, on the other hand, is hardwired: The name @t{wrs-firmware.tar}, on the other hand, is hardwired:
...@@ -819,37 +788,36 @@ where you will see messages like these: ...@@ -819,37 +788,36 @@ where you will see messages like these:
-I- -- AT91SAM9G45-EK -I- -- AT91SAM9G45-EK
[...] [...]
-I- End of applet (command : 2 --- status : 0) -I- End of applet (command : 2 --- status : 0)
[...] [...]
barebox 2014.04.0 #1 Tue Jun 24 09:05:43 CEST 2014
barebox 2012.05.0 (Oct 26 2012 - 20:51:43) Board: White Rabbit Switch
Board: CERN White Rabbit Switch V3
[...] [...]
Booting kernel for NAND flashing procedure
Uncompressing Linux... done, booting the kernel. 100Mbps full duplex link detected
DHCP client bound to address 192.168.16.246
[...] [...]
Uncompressing Linux... done, booting the kernel.
Installation procedure starts
Flashing kernel to /dev/mtd0 ...
Writing data to block 0 at offset 0x0
Writing data to block 1 at offset 0x20000
[...] [...]
/etc/init.d/wrs-boot-procedure: Running
Getting tftp://192.168.16.1/wrs-image.tar.gz ... done
Mounting target filesystem... done Formatting UBI device... [...] done
Uncompressing image... done UBI: attaching mtd1 to ubi0
UBI: physical eraseblock size: 131072 bytes (128 KiB)
UBI: logical eraseblock size: 129024 bytes
UBI: smallest flash I/O unit: 2048
UBI: sub-page size: 512
[...] [...]
Getting tftp://192.168.16.1/wrs-firmware.tar ... done
UBIFS: mounted UBI device 0, volume 1, name "usr"
Extracting filesystem... done
Requesting system reboot
Restarting system.
@end smallexample @end smallexample
@menu Please note, however, that many more messages flow, as
* Flash Script Description:: formatting/mounting/umounting UBI devices is very verbose in the
@end menu kernel. The sequence above is a summary of what happens at
installation time.
@c ------------------------------------------------------------------- @c -------------------------------------------------------------------
@node Flash Script Description @node Flash Script Description
...@@ -965,10 +933,6 @@ the menu is re-entered automatically. ...@@ -965,10 +933,6 @@ the menu is re-entered automatically.
The other entries are provided to help developers. The other entries are provided to help developers.
@menu
* The Compiler::
@end menu
@c ========================================================================== @c ==========================================================================
@node Description of the menus @node Description of the menus
@section Description of the menus @section Description of the menus
...@@ -1074,19 +1038,6 @@ so it doesn't run the DHCP client. ...@@ -1074,19 +1038,6 @@ so it doesn't run the DHCP client.
This chapter details the individual build steps, for the users that want This chapter details the individual build steps, for the users that want
to customize their switch in any way. to customize their switch in any way.
@menu
* The Compiler::
* Buildroot::
* The IPL::
* The Boot Loader::
* The Linux Kernel::
* Kernel Modules::
* PTPd::
* User Space Applications::
* VHDL Binaries::
* The Complete Filesystem::
@end menu
@c ========================================================================== @c ==========================================================================
@node The Compiler @node The Compiler
@section The Compiler @section The Compiler
...@@ -1628,11 +1579,6 @@ the backplane has been shipped commercially; you are interested in ...@@ -1628,11 +1579,6 @@ the backplane has been shipped commercially; you are interested in
previous versions only if you are an early developer and have one of previous versions only if you are an early developer and have one of
those in your hands. those in your hands.
@menu
* DIP Switch HW version::
@end menu
@c ========================================================================== @c ==========================================================================
@node DIP Switch HW version @node DIP Switch HW version
@section DIP Switch HW version @section DIP Switch HW version
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment