doc/SPL/README.am335x-network

3  Some boards (like TI AM335x based ones) have quite big on-chip RAM and
9   1. You have to enable generic SPL configuration options (see
10 doc/README.SPL) as well as CONFIG_SPL_NET_SUPPORT,
13 SPL with support for booting over the network. Also you have to enable
15 board needs some board-specific initialization (TI AM335x EVM does).
16 If you want SPL to use some Vendor Class Identifier (VCI) you can set
20 script after boot:
28  3. Build U-Boot as usual
30     You will need u-boot.img and spl/u-boot.bin images to perform
31 network boot. Copy them to u-boot-restore.img and
32 u-boot-spl-restore.bin respectively to distinguish this version
37    - Install DHCP server and setup it to listen on the interface you
39 /etc/default/dhcpd or /etc/default/isc-dhcp-server). Make sure there
41    - Edit your dhcpd.conf and subnet declaration matching the address
43 to use. IMPORTANT! Both RBL and SPL use the image filename provided
45 raw SPL image -- u-boot-spl-restore.bin while SPL needs main U-Boot
46 image -- u-boot-restore.img). So you have to configure DHCP server to
47 provide different image filenames to RBL and SPL (and possibly another
48 one to main U-Boot). This can be done by checking Vendor Class
50 and you can set VCI used by SPL with CONFIG_SPL_NET_VCI_STRING option,
52    - If you plan to use TFTP server on another machine you have to set
53 server-name option to point to it.
54    - Here is sample configuration for ISC DHCPd, assuming the interface
58   range dynamic-bootp 192.168.8.100 192.168.8.199;
60   if substring (option vendor-class-identifier, 0, 10) = "DM814x ROM" {
61     filename "u-boot-spl-restore.bin";
62   } elsif substring (option vendor-class-identifier, 0, 17) = "AM335x U-Boot SPL" {
63     filename "u-boot-restore.img";
69   May the ROM bootloader sends another "vendor-class-identifier"
76 u-boot.img and spl/u-boot-spl-bin files from U-Boot build directory.
80 be executed after network boot to perform actual rescue actions. You
81 can use usual U-Boot commands from this script: tftp to load additional
84   2. Create script image from your script. From U-Boot build directory:
86 $ ./tools/mkimage -A arm -O U-Boot -C none -T script -d <your script> debrick.scr
92 loads u-boot.img and MLO. You have to create these files doing regular
95   4. Boot the board from the network, U-Boot will load debrick script
96 and run it after boot.