summaryrefslogtreecommitdiffstats
path: root/README.hardware
diff options
context:
space:
mode:
Diffstat (limited to 'README.hardware')
-rw-r--r--README.hardware163
1 files changed, 1 insertions, 162 deletions
diff --git a/README.hardware b/README.hardware
index 85f033057e..3cdb7a2459 100644
--- a/README.hardware
+++ b/README.hardware
@@ -47,7 +47,6 @@ Hardware Reference Boards
47The following boards are supported by the meta-yocto-bsp layer: 47The following boards are supported by the meta-yocto-bsp layer:
48 48
49 * Freescale MPC8315E-RDB (mpc8315e-rdb) 49 * Freescale MPC8315E-RDB (mpc8315e-rdb)
50 * Ubiquiti Networks RouterStation Pro (routerstationpro)
51 50
52For more information see the board's section below. The appropriate MACHINE 51For more information see the board's section below. The appropriate MACHINE
53variable value corresponding to the board is given in brackets. 52variable value corresponding to the board is given in brackets.
@@ -59,6 +58,7 @@ Consumer Devices
59The following consumer devices are supported by the meta-yocto-bsp layer: 58The following consumer devices are supported by the meta-yocto-bsp layer:
60 59
61 * Intel x86 based PCs and devices (genericx86) 60 * Intel x86 based PCs and devices (genericx86)
61 * Ubiquiti Networks EdgeRouter Lite (edgerouter)
62 62
63For more information see the device's section below. The appropriate MACHINE 63For more information see the device's section below. The appropriate MACHINE
64variable value corresponding to the device is given in brackets. 64variable value corresponding to the device is given in brackets.
@@ -240,167 +240,6 @@ Load the kernel and dtb (device tree blob), and boot the system as follows:
240 => bootm 1000000 - 2000000 240 => bootm 1000000 - 2000000
241 241
242 242
243Ubiquiti Networks RouterStation Pro (routerstationpro)
244======================================================
245
246The RouterStation Pro is an Atheros AR7161 MIPS-based board. Geared towards
247networking applications, it has all of the usual features as well as three
248type IIIA mini-PCI slots and an on-board 3-port 10/100/1000 Ethernet switch,
249in addition to the 10/100/1000 Ethernet WAN port which supports
250Power-over-Ethernet.
251
252Setup instructions
253------------------
254
255You will need the following:
256* A serial cable - female to female (or female to male + gender changer)
257 NOTE: cable must be straight through, *not* a null modem cable.
258* USB flash drive or hard disk that is able to be powered from the
259 board's USB port.
260* tftp server installed on your workstation
261
262NOTE: in the following instructions it is assumed that /dev/sdb corresponds
263to the USB disk when it is plugged into your workstation. If this is not the
264case in your setup then please be careful to substitute the correct device
265name in all commands where appropriate.
266
267--- Preparation ---
268
2691) Build an image (e.g. core-image-minimal) using "routerstationpro" as the
270MACHINE
271
2722) Partition the USB drive so that primary partition 1 is type Linux (83).
273Minimum size depends on your root image size - core-image-minimal probably
274only needs 8-16MB, other images will need more.
275
276 # fdisk /dev/sdb
277 Command (m for help): p
278
279 Disk /dev/sdb: 4011 MB, 4011491328 bytes
280 124 heads, 62 sectors/track, 1019 cylinders, total 7834944 sectors
281 Units = sectors of 1 * 512 = 512 bytes
282 Sector size (logical/physical): 512 bytes / 512 bytes
283 I/O size (minimum/optimal): 512 bytes / 512 bytes
284 Disk identifier: 0x0009e87d
285
286 Device Boot Start End Blocks Id System
287 /dev/sdb1 62 1952751 976345 83 Linux
288
2893) Format partition 1 on the USB as ext3
290
291 # mke2fs -j /dev/sdb1
292
2934) Mount partition 1 and then extract the contents of
294tmp/deploy/images/core-image-XXXX.tar.bz2 into it (preserving permissions).
295
296 # mount /dev/sdb1 /media/sdb1
297 # cd /media/sdb1
298 # tar -xvjpf tmp/deploy/images/core-image-XXXX.tar.bz2
299
3005) Unmount the USB drive and then plug it into the board's USB port
301
3026) Connect the board's serial port to your workstation and then start up
303your favourite serial terminal so that you will be able to interact with
304the serial console. If you don't have a favourite, picocom is suggested:
305
306 $ picocom /dev/ttyUSB0 -b 115200
307
3087) Connect the network into eth0 (the one that is NOT the 3 port switch). If
309you are using power-over-ethernet then the board will power up at this point.
310
3118) Start up the board, watch the serial console. Hit Ctrl+C to abort the
312autostart if the board is configured that way (it is by default). The
313bootloader's fconfig command can be used to disable autostart and configure
314the IP settings if you need to change them (default IP is 192.168.1.20).
315
3169) Make the kernel (tmp/deploy/images/vmlinux-routerstationpro.bin) available
317on the tftp server.
318
31910) If you are going to write the kernel to flash (optional - see "Booting a
320kernel directly" below for the alternative), remove the current kernel and
321rootfs flash partitions. You can list the partitions using the following
322bootloader command:
323
324 RedBoot> fis list
325
326You can delete the existing kernel and rootfs with these commands:
327
328 RedBoot> fis delete kernel
329 RedBoot> fis delete rootfs
330
331--- Booting a kernel directly ---
332
3331) Load the kernel using the following bootloader command:
334
335 RedBoot> load -m tftp -h <ip of tftp server> vmlinux-routerstationpro.bin
336
337You should see a message on it being successfully loaded.
338
3392) Execute the kernel:
340
341 RedBoot> exec -c "console=ttyS0,115200 root=/dev/sda1 rw rootdelay=2 board=UBNT-RSPRO"
342
343Note that specifying the command line with -c is important as linux-yocto does
344not provide a default command line.
345
346--- Writing a kernel to flash ---
347
3481) Go to your tftp server and gzip the kernel you want in flash. It should
349halve the size.
350
3512) Load the kernel using the following bootloader command:
352
353 RedBoot> load -r -b 0x80600000 -m tftp -h <ip of tftp server> vmlinux-routerstationpro.bin.gz
354
355This should output something similar to the following:
356
357 Raw file loaded 0x80600000-0x8087c537, assumed entry at 0x80600000
358
359Calculate the length by subtracting the first number from the second number
360and then rounding the result up to the nearest 0x1000.
361
3623) Using the length calculated above, create a flash partition for the kernel:
363
364 RedBoot> fis create -b 0x80600000 -l 0x240000 kernel
365
366(change 0x240000 to your rounded length -- change "kernel" to whatever
367you want to name your kernel)
368
369--- Booting a kernel from flash ---
370
371To boot the flashed kernel perform the following steps.
372
3731) At the bootloader prompt, load the kernel:
374
375 RedBoot> fis load -d -e kernel
376
377(Change the name "kernel" above if you chose something different earlier)
378
379(-e means 'elf', -d 'decompress')
380
3812) Execute the kernel using the exec command as above.
382
383--- Automating the boot process ---
384
385After writing the kernel to flash and testing the load and exec commands
386manually, you can automate the boot process with a boot script.
387
3881) RedBoot> fconfig
389 (Answer the questions not specified here as they pertain to your environment)
3902) Run script at boot: true
391 Boot script:
392 .. fis load -d -e kernel
393 .. exec
394 Enter script, terminate with empty line
395 >> fis load -d -e kernel
396 >> exec -c "console=ttyS0,115200 root=/dev/sda1 rw rootdelay=2 board=UBNT-RSPRO"
397 >>
3983) Answer the remaining questions and write the changes to flash:
399 Update RedBoot non-volatile configuration - continue (y/n)? y
400 ... Erase from 0xbfff0000-0xc0000000: .
401 ... Program from 0x87ff0000-0x88000000 at 0xbfff0000: .
4024) Power cycle the board.
403
404EdgeRouter Lite(edgerouter) 243EdgeRouter Lite(edgerouter)
405===================================== 244=====================================
406 245