summaryrefslogtreecommitdiffstats
path: root/README.hardware
diff options
context:
space:
mode:
authorYang Wei <Wei.Yang@windriver.com>2014-03-31 14:01:59 -0400
committerRichard Purdie <richard.purdie@linuxfoundation.org>2014-03-31 23:04:36 +0100
commitbd072d84da325820dcff333fdcf169834f62d833 (patch)
tree6bb19eab8e87498eb24336685b2cde69f4cb5be2 /README.hardware
parent4226f9c6a19fbdac6c334860751c0ea6a0d1df13 (diff)
downloadpoky-bd072d84da325820dcff333fdcf169834f62d833.tar.gz
poky-bd072d84da325820dcff333fdcf169834f62d833.tar.bz2
poky-bd072d84da325820dcff333fdcf169834f62d833.zip
poky: add edgerouter information to README.hardware
Adding the summary, preparation and boot information for the newly introduced edgerouter BSP. (From meta-yocto rev: cc8c7a3c94d2cafe899adc7f8199237d4a72f205) Signed-off-by: Yang Wei <Wei.Yang@windriver.com> Signed-off-by: Bruce Ashfield <bruce.ashfield@windriver.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'README.hardware')
-rw-r--r--README.hardware81
1 files changed, 81 insertions, 0 deletions
diff --git a/README.hardware b/README.hardware
index 607062b59a..eccc7d3e6e 100644
--- a/README.hardware
+++ b/README.hardware
@@ -492,3 +492,84 @@ manually, you can automate the boot process with a boot script.
... Program from 0x87ff0000-0x88000000 at 0xbfff0000: .
4) Power cycle the board.
+EdgeRouter Lite(edgerouter)
+=====================================
+
+The EdgeRouter Lite is part of the EdgeMax series. It is an MIPS64 router(Cavium Octeon)
+with 512MB of RAM, which uses a USB pendrive for storage.
+
+Setup instructions
+------------------
+
+You will need the following:
+* NFS root setup on your workstation
+* TFTP server installed on your workstation
+* Straight-thru 9-conductor serial cable (DB9, M/F) connected from your
+ PC to UART1
+* Ethernet connected to the first ethernet port on the board
+
+--- Preparation ---
+
+Build an image (e.g. core-image-minimal) using "edgerouter" as the MACHINE.
+In the following instruction it is based on core-image-minimal. Another target
+may be similiar with it.
+
+--- Booting from NFS root ---
+
+Load the kernel, and boot the system as follows:
+
+ 1. Get the kernel (vmlinux) file from the tmp/deploy/images/edgerouter
+ directory, and make them available on your TFTP server.
+
+ 2. Connect the board's first serial port to your workstation and then start up
+ your favourite serial terminal so that you will be able to interact with
+ the serial console. If you don't have a favourite, picocom is suggested:
+
+ $ picocom /dev/ttyS0 -b 115200
+
+ 3. Power up or reset the board and press a key on the terminal when prompted
+ to get to the U-Boot command line
+
+ 4. Set up the environment in U-Boot:
+
+ => setenv ipaddr <board ip>
+ => setenv serverip <tftp server ip>
+
+ 5. Download the kernel and boot:
+
+ => tftp tftp $loadaddr vmlinux
+ => bootoctlinux $loadaddr coremask=0x3 root=/dev/nfs rw nfsroot=<nfsroot ip>:<rootfs path> ip=<board ip>:<server ip>:<gateway ip>:<netmask>:edgerouter:eth0:off mtdparts=phys_mapped_flash:512k(boot0),512k(boot1),64k@3072k(eeprom)
+
+--- Booting from USB root ---
+
+NOTE: Since the USB disk is inside the edgerouter box, its inconvenient for us to
+ plug and unplug the USB disk. So in the following instructions I assume that
+ you already boot the box from NFS. Additionally, since vmlinux is not installed
+ to core-minal-image-xxx by default, so its neccessary for us to copy it to USB
+ disk.
+
+Load the kernel, and boot the system as follows:
+ 1. Booting from NFS root
+
+ 2. Mount usb disk partition 2 and then extract the contens of
+ tmp/deploy/core-image-XXXX.tar.bz2 into it.
+
+ Before starting, copy core-image-minimal-xxx.tar.bz2 and vmlinux into
+ rootfs path on your workstation.
+
+ and then,
+
+ # mount /dev/sda2 /media/sda2
+ # tar -xvjpf core-image-minimal-XXX.tar.bz2 -C /media/sda2
+ # cp vmlinux /media/sda2/boot/vmlinux
+ # umount /media/sda2
+ # reboot
+
+ 3. Reboot the board and press a key on the terminal when prompted to get to the U-Boot
+ command line
+ # reboot
+
+ 4. Load the kernel and boot:
+
+ => ext2load usb 0:2 $loadaddr boot/vmlinux
+ => bootoctlinux $loadaddr coremask=0x3 root=/dev/sda2 rw rootwait mtdparts=phys_mapped_flash:512k(boot0),512k(boot1),64k@3072k(eeprom)