[Yocto-bsp] [PATCH v2] README.hardware: add edgerouter hardware support

[Bruce Ashfield]

On 2014-03-25, 11:06 PM, Yang,Wei wrote:
> On 03/21/2014 09:34 AM, Wei.Yang at windriver.com wrote:
>> From: Yang Wei <Wei.Yang at windriver.com>
>>
>> Signed-off-by: Yang Wei <Wei.Yang at windriver.com>
>> ---
>>
>>   Changes in v2:
>>
>>   * Add some steps to how to boot from USB disk
>>   * Add more descriptions in Preparation.
>>   * There is a duplication of "rw" in command line, so remove it.
> ping

This is in my tree, but until the 3.14 kernel is released, it is
in a holding pattern.

Bruce

>
> Regards
> Wei
>>
>>
>>   README.hardware |   81
>> +++++++++++++++++++++++++++++++++++++++++++++++++++++++
>>   1 file changed, 81 insertions(+)
>>
>> diff --git a/README.hardware b/README.hardware
>> index 607062b..eccc7d3 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 at 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 at 3072k(eeprom)
>