summaryrefslogtreecommitdiffstats
path: root/README.hardware
diff options
context:
space:
mode:
authorDarren Hart <dvhart@linux.intel.com>2010-12-16 16:48:31 (GMT)
committerRichard Purdie <rpurdie@linux.intel.com>2010-12-16 17:14:50 (GMT)
commit310b6e4df7b6bb7967dc1118195a1f9c8826cdb4 (patch)
treeb1e286100678aa808fb816bd7f573f94cd933b71 /README.hardware
parent6ae9a633c4f1b29af346bd980231d0591980c59f (diff)
downloadpoky-310b6e4df7b6bb7967dc1118195a1f9c8826cdb4.tar.gz
README.hardware: Add Atom PC image flashing documentation
Cover the basics of flashing images to physical media for the Atom PC MACHINE, as well as dealing with BIOSs that can only boot USB media in USB-ZIP mode. Signed-off-by: Darren Hart <dvhart@linux.intel.com>
Diffstat (limited to 'README.hardware')
-rw-r--r--README.hardware75
1 files changed, 75 insertions, 0 deletions
diff --git a/README.hardware b/README.hardware
index 270c71a..fe384b3 100644
--- a/README.hardware
+++ b/README.hardware
@@ -433,4 +433,79 @@ following differences:
433 $ cp ./tmp/deploy/images/gnu-tar /path/to/my-cf-card/gnu-tar 433 $ cp ./tmp/deploy/images/gnu-tar /path/to/my-cf-card/gnu-tar
434 434
435 435
436Intel Atom based PCs and devices (atom-pc)
437==========================================
436 438
439The atom-pc MACHINE is tested on the following platforms:
440
441 o Asus eee901
442 o Acer Aspire One
443 o Toshiba NB305
444 o Intel Embedded Development Board 1-N450 (Black Sand)
445
446and is likely to work on many unlisted atom based devices. The MACHINE type
447supports ethernet, wifi, sound, and i915 graphics by default in addition to
448common PC input devices, busses, and so on.
449
450Depending on the device, it can boot from a traditional hard-disk, a USB device,
451or over the network. Writing poky generated images to physical media is
452straightforward with a caveat for USB devices. The following examples assume the
453target boot device is /dev/sdb, be sure to verify this and use the correct
454device as the following commands are run as root and are not reversable.
455
456Hard Disk:
457 1. Build a directdisk image format. This will generate proper partition tables
458 that will in turn be written to the physical media. For example:
459
460 $ bitbake poky-image-minimal-directdisk
461
462 2. Use the "dd" utility to write the image to the raw block device. For example:
463
464 # dd if=poky-image-minimal-directdisk-atom-pc.hdddirect of=/dev/sdb
465
466USB Device:
467 1. Build an hddimg image format. This is a simple filesystem without partition
468 tables and is suitable for USB keys. For example:
469
470 $ bitbake poky-image-minimal-live
471
472 2. Use the "dd" utility to write the image to the raw block device. For
473 example:
474
475 # dd if=poky-image-minimal-live-atom-pc.hddimg of=/dev/sdb
476
477 If the device fails to boot with "Boot error" displayed, it is likely the BIOS
478 cannot understand the physical layout of the disk (or rather it expects a
479 particular layout and cannot handle anything else). There are two possible
480 solutions to this problem:
481
482 1. Change the BIOS USB Device setting to HDD mode. The label will vary by
483 device, but the idea is to force BIOS to read the Cylinder/Head/Sector
484 geometry from the device.
485
486 2. Without such an option, the BIOS generally boots the device in USB-ZIP
487 mode.
488
489 a. Configure the USB device for USB-ZIP mode:
490
491 # mkdiskimage -4 /dev/sdb 0 63 62
492
493 Where 63 and 62 are the head and sector count as reported by fdisk.
494 Remove and reinsert the device to allow the kernel to detect the new
495 partition layout.
496
497 b. Copy the contents of the poky image to the USB-ZIP mode device:
498
499 # mount -o loop poky-image-minimal-live-atom-pc.hddimg /tmp/image
500 # mount /dev/sdb4 /tmp/usbkey
501 # cp -rf /tmp/image/* /tmp/usbkey
502
503 c. Install the syslinux boot loader:
504
505 # syslinux /dev/sdb4
506
507 Install the boot device in the target board and configure the BIOS to boot
508 from it.
509
510 For more details on the USB-ZIP scenario, see the syslinux documentation:
511 http://git.kernel.org/?p=boot/syslinux/syslinux.git;a=blob_plain;f=doc/usbkey.txt;hb=HEAD