Documentation/boards/: Numerous grammar/typo/rendering fixes.
Various fixes related to fonts, rendering, grammar, etc., such as: * spelling mistakes * hyphenation * capitalization for proper names * proper bullet list formatting * sentence structure and so on. Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
This commit is contained in:
parent
baebac06f3
commit
0bee49e72c
|
@ -1,7 +1,7 @@
|
||||||
Cirrus Logic EP9301
|
Cirrus Logic EP9301
|
||||||
===================
|
===================
|
||||||
|
|
||||||
This boards is based on a Cirrus Logic EP9301 CPU. The board is shipped with:
|
This board is based on a Cirrus Logic EP9301 CPU. The board is shipped with:
|
||||||
|
|
||||||
* 16MiB NOR type Flash Memory
|
* 16MiB NOR type Flash Memory
|
||||||
* 32MiB synchronous dynamic RAM on CS3
|
* 32MiB synchronous dynamic RAM on CS3
|
||||||
|
|
|
@ -1,9 +1,9 @@
|
||||||
Freescale i.MX
|
Freescale i.MX
|
||||||
==============
|
==============
|
||||||
|
|
||||||
Freescale i.MX is traditionally very good supported under barebox.
|
Freescale i.MX is traditionally very well supported under barebox.
|
||||||
Depending on the SoC there are different Boot Modes supported. Older
|
Depending on the SoC, there are different Boot Modes supported. Older
|
||||||
SoCs up to i.MX31 only support the external Boot Mode. Newer SoCs
|
SoCs up to i.MX31 support only the external Boot Mode. Newer SoCs
|
||||||
can be configured for internal or external Boot Mode with the internal
|
can be configured for internal or external Boot Mode with the internal
|
||||||
boot mode being the more popular mode. The i.MX23 and i.MX28, also
|
boot mode being the more popular mode. The i.MX23 and i.MX28, also
|
||||||
known as i.MXs, are special. These SoCs have a completely different
|
known as i.MXs, are special. These SoCs have a completely different
|
||||||
|
@ -20,10 +20,10 @@ The Internal Boot Mode is supported on:
|
||||||
* i.MX53
|
* i.MX53
|
||||||
* i.MX6
|
* i.MX6
|
||||||
|
|
||||||
With the Internal Boot Mode the images contain a header which describes
|
With the Internal Boot Mode, the images contain a header which describes
|
||||||
where the binary shall be loaded and started. Also these headers contain
|
where the binary shall be loaded and started. These headers also contain
|
||||||
a so called DCD table which consists of register/value pairs. These are
|
a so-called DCD table which consists of register/value pairs. These are
|
||||||
executed by the Boot ROM and are used to configure the SDRAM. In barebox
|
executed by the Boot ROM and are used to configure the SDRAM. In barebox,
|
||||||
the i.MX images are generated with the ``scripts/imx/imx-image`` tool.
|
the i.MX images are generated with the ``scripts/imx/imx-image`` tool.
|
||||||
Normally it's not necessary to call this tool manually, it is executed
|
Normally it's not necessary to call this tool manually, it is executed
|
||||||
automatically at the end of the build process.
|
automatically at the end of the build process.
|
||||||
|
@ -36,8 +36,9 @@ SD card::
|
||||||
# otherwise:
|
# otherwise:
|
||||||
cat barebox-flash-image > /dev/sdd
|
cat barebox-flash-image > /dev/sdd
|
||||||
|
|
||||||
This will overwrite the partition table on the card. It can be preserved
|
The above will overwrite the MBR (and consequently the partition table)
|
||||||
with::
|
on the destination SD card. To preserve the MBR while writing the rest
|
||||||
|
of the image to the card, use::
|
||||||
|
|
||||||
dd if=images/barebox-freescale-imx51-babbage.img of=/dev/sdd bs=512 skip=1 seek=1
|
dd if=images/barebox-freescale-imx51-babbage.img of=/dev/sdd bs=512 skip=1 seek=1
|
||||||
|
|
||||||
|
@ -50,10 +51,10 @@ USB Boot
|
||||||
|
|
||||||
Most boards can be explicitly configured for USB Boot Mode or fall back
|
Most boards can be explicitly configured for USB Boot Mode or fall back
|
||||||
to USB Boot when no other medium can be found. The barebox repository
|
to USB Boot when no other medium can be found. The barebox repository
|
||||||
contains a USB upload tool. As it depends on the libusb development headers
|
contains a USB upload tool. As it depends on the libusb development headers,
|
||||||
it is not built by default. Enable it explicitly in ``make menuconfig``
|
it is not built by default. Enable it explicitly in ``make menuconfig``
|
||||||
and install the libusb development package. On Debian this can be done
|
and install the libusb development package. On Debian, this can be done
|
||||||
with ``apt-get install libusb-dev``. After compilation the tool can be used
|
with ``apt-get install libusb-dev``. After compilation, the tool can be used
|
||||||
with only the image name as argument::
|
with only the image name as argument::
|
||||||
|
|
||||||
scripts/imx/imx-usb-loader images/barebox-freescale-imx51-babbage.img
|
scripts/imx/imx-usb-loader images/barebox-freescale-imx51-babbage.img
|
||||||
|
@ -68,13 +69,13 @@ The External Boot Mode is supported by the older i.MX SoCs:
|
||||||
* i.MX27
|
* i.MX27
|
||||||
* i.MX31
|
* i.MX31
|
||||||
|
|
||||||
(It may be supported on newer SoCs aswell, but it is not widely used there)
|
(It may be supported on newer SoCs as well, but it is not widely used there.)
|
||||||
|
|
||||||
The External Boot Mode only supports booting from NOR and NAND flash. On NOR
|
The External Boot Mode supports booting only from NOR and NAND flash. On NOR
|
||||||
flash the binary is started directly on its physical address in memory. Booting
|
flash, the binary is started directly on its physical address in memory. Booting
|
||||||
from NAND flash is more complicated. The NAND flash controller copies the first
|
from NAND flash is more complicated. The NAND flash controller copies the first
|
||||||
2kb of the image to the NAND Controllers internal SRAM. This initial binary
|
2kb of the image to the NAND Controller's internal SRAM. This initial binary
|
||||||
portion is then has to:
|
portion then has to:
|
||||||
|
|
||||||
* Set up the SDRAM
|
* Set up the SDRAM
|
||||||
* Copy the initial binary to SDRAM to make the internal SRAM in the NAND flash
|
* Copy the initial binary to SDRAM to make the internal SRAM in the NAND flash
|
||||||
|
|
|
@ -3,7 +3,7 @@ Garz+Fricke Cupid
|
||||||
|
|
||||||
This CPU card is based on a Freescale i.MX35 CPU. The card is shipped with:
|
This CPU card is based on a Freescale i.MX35 CPU. The card is shipped with:
|
||||||
|
|
||||||
* 256MiB Nand flash
|
* 256MiB NAND flash
|
||||||
* 128MiB synchronous dynamic RAM
|
* 128MiB synchronous dynamic RAM
|
||||||
|
|
||||||
see http://www.garz-fricke.com/cupid-core_de.html for more information
|
see http://www.garz-fricke.com/cupid-core_de.html for more information
|
||||||
|
|
|
@ -37,5 +37,5 @@ Build the binary image::
|
||||||
**NOTE:** replace ''armv5compiler'' with your ARM v5 cross compiler,
|
**NOTE:** replace ''armv5compiler'' with your ARM v5 cross compiler,
|
||||||
e.g.: ''arm-1136jfs-linux-gnueabi-''
|
e.g.: ''arm-1136jfs-linux-gnueabi-''
|
||||||
|
|
||||||
The resulting binary image to be flashed will be barebox.bin, whereas
|
The resulting binary image to be flashed will be ``barebox.bin``, whereas
|
||||||
the file named just barebox is an ELF executable for ARM.
|
the file named just ``barebox`` is an ELF executable for ARM.
|
||||||
|
|
|
@ -8,5 +8,3 @@ This CPU card is based on a Freescale i.MX1 CPU. The card is shipped with:
|
||||||
* 16MiB NOR type Flash Memory
|
* 16MiB NOR type Flash Memory
|
||||||
* 16MiB synchronous dynamic RAM
|
* 16MiB synchronous dynamic RAM
|
||||||
* DM9000 network controller
|
* DM9000 network controller
|
||||||
|
|
||||||
It's the first i.MX board sha has ever ported Linux to.
|
|
||||||
|
|
|
@ -7,13 +7,15 @@ This CPU card is based on a Freescale i.MX23 CPU. The card is shipped with:
|
||||||
|
|
||||||
* 64 MiB synchronous dynamic RAM (DDR type)
|
* 64 MiB synchronous dynamic RAM (DDR type)
|
||||||
|
|
||||||
Memory layout when @b barebox is running:
|
Memory layout when barebox is running:
|
||||||
|
|
||||||
* 0x40000000 start of SDRAM
|
* 0x40000000 start of SDRAM
|
||||||
* 0x40000100 start of kernel's boot parameters
|
* 0x40000100 start of kernel's boot parameters
|
||||||
|
|
||||||
* below malloc area: stack area
|
* below malloc area: stack area
|
||||||
* below barebox: malloc area
|
* below barebox: malloc area
|
||||||
* 0x42000000 start of @b barebox
|
|
||||||
|
* 0x42000000 start of barebox
|
||||||
|
|
||||||
How to get the bootloader binary image
|
How to get the bootloader binary image
|
||||||
--------------------------------------
|
--------------------------------------
|
||||||
|
@ -32,20 +34,21 @@ How to prepare an MCI card to boot the "chumby one" with barebox
|
||||||
----------------------------------------------------------------
|
----------------------------------------------------------------
|
||||||
|
|
||||||
* Create four primary partitions on the MCI card
|
* Create four primary partitions on the MCI card
|
||||||
|
|
||||||
* the first one for the bootlets (about 256 kiB)
|
* the first one for the bootlets (about 256 kiB)
|
||||||
* the second one for the persistant environment (size is up to you, at least 256k)
|
* the second one for the persistant environment (size is up to you, at least 256k)
|
||||||
* the third one for the kernel (2 MiB ... 4 MiB in size)
|
* the third one for the kernel (2 MiB ... 4 MiB in size)
|
||||||
* the 4th one for the root filesystem which can fill the rest of the available space
|
* the fourth one for the root filesystem which can fill the rest of the available space
|
||||||
|
|
||||||
* Mark the first partition with the partition ID "53" and copy the
|
* Mark the first partition with the partition ID "53" and copy the
|
||||||
bootlets into this partition (currently not part of @b barebox!).
|
bootlets into this partition (currently not part of barebox!).
|
||||||
|
|
||||||
* Copy the default @b barebox environment into the second partition
|
* Copy the default barebox environment into the second partition
|
||||||
(no filesystem required).
|
(no filesystem required).
|
||||||
|
|
||||||
* Copy the kernel into the third partition (no filesystem required).
|
* Copy the kernel into the third partition (no filesystem required).
|
||||||
|
|
||||||
* Create the root filesystem in the 4th partition. You may copy an
|
* Create the root filesystem in the fourth partition. You may copy an
|
||||||
image into this partition or you can do it in the classic way:
|
image into this partition or you can do it in the classic way:
|
||||||
mkfs on it, mount it and copy all required data and programs into
|
mkfs on it, mount it and copy all required data and programs into
|
||||||
it.
|
it.
|
||||||
|
|
|
@ -6,13 +6,15 @@ This CPU card is based on an i.MX23 CPU. The card is shipped with:
|
||||||
* 32 MiB synchronous dynamic RAM (mobile DDR type)
|
* 32 MiB synchronous dynamic RAM (mobile DDR type)
|
||||||
* ENC28j60 based network (over SPI)
|
* ENC28j60 based network (over SPI)
|
||||||
|
|
||||||
Memory layout when @b barebox is running:
|
Memory layout when barebox is running:
|
||||||
|
|
||||||
* 0x40000000 start of SDRAM
|
* 0x40000000 start of SDRAM
|
||||||
* 0x40000100 start of kernel's boot parameters
|
* 0x40000100 start of kernel's boot parameters
|
||||||
|
|
||||||
* below malloc area: stack area
|
* below malloc area: stack area
|
||||||
* below barebox: malloc area
|
* below barebox: malloc area
|
||||||
* 0x41000000 start of @b barebox
|
|
||||||
|
* 0x41000000 start of barebox
|
||||||
|
|
||||||
How to get the bootloader binary image
|
How to get the bootloader binary image
|
||||||
--------------------------------------
|
--------------------------------------
|
||||||
|
|
|
@ -12,12 +12,13 @@ This CPU card is based on a Freescale i.MX28 CPU. The card is shipped with:
|
||||||
* 128 MiB NAND K9F1G08U0A (3.3V type)
|
* 128 MiB NAND K9F1G08U0A (3.3V type)
|
||||||
* PCA9554 GPIO expander
|
* PCA9554 GPIO expander
|
||||||
* DS1339 RTC
|
* DS1339 RTC
|
||||||
* LAN8710 Phy
|
* LAN8710 PHY
|
||||||
|
|
||||||
Supported baseboards
|
Supported baseboards
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
Supported baseboards are:
|
Supported baseboards are:
|
||||||
|
|
||||||
* KARO's Starterkit 5
|
* KARO's Starterkit 5
|
||||||
|
|
||||||
How to get barebox for 'KARO's Starterkit 5'
|
How to get barebox for 'KARO's Starterkit 5'
|
||||||
|
@ -34,9 +35,10 @@ Build the binary image::
|
||||||
**NOTE:** replace the armv5compiler with your ARM v5 cross compiler.
|
**NOTE:** replace the armv5compiler with your ARM v5 cross compiler.
|
||||||
|
|
||||||
**NOTE:** to use the result, you also need the following resources from Freescale:
|
**NOTE:** to use the result, you also need the following resources from Freescale:
|
||||||
|
|
||||||
* the 'bootlets' archive
|
* the 'bootlets' archive
|
||||||
* the 'elftosb2' encryption tool
|
* the 'elftosb2' encryption tool
|
||||||
* in the case you want to start @b barebox from an attached SD card
|
* in the case you want to start barebox from an attached SD card
|
||||||
the 'sdimage' tool from Freescale's 'uuc' archive.
|
the 'sdimage' tool from Freescale's 'uuc' archive.
|
||||||
|
|
||||||
Memory layout when barebox is running
|
Memory layout when barebox is running
|
||||||
|
@ -44,6 +46,8 @@ Memory layout when barebox is running
|
||||||
|
|
||||||
* 0x40000000 start of SDRAM
|
* 0x40000000 start of SDRAM
|
||||||
* 0x40000100 start of kernel's boot parameters
|
* 0x40000100 start of kernel's boot parameters
|
||||||
|
|
||||||
* below malloc area: stack area
|
* below malloc area: stack area
|
||||||
* below barebox: malloc area
|
* below barebox: malloc area
|
||||||
* 0x47000000 start of @b barebox
|
|
||||||
|
* 0x47000000 start of barebox
|
||||||
|
|
|
@ -1,20 +1,20 @@
|
||||||
Texas Instruments OMAP/AM335x
|
Texas Instruments OMAP/AM335x
|
||||||
=============================
|
=============================
|
||||||
|
|
||||||
Texas Intruments OMAP SoCs have a two staged boot process. The first stage is
|
Texas Instruments OMAP SoCs have a two-stage boot process. The first stage is
|
||||||
known as Xload which only loads the second stage bootloader. barebox can act as
|
known as Xload which only loads the second stage bootloader. barebox can act as
|
||||||
both the first and the second stage loader. To build as a first stage loader
|
both the first and the second stage loader. To build as a first stage loader,
|
||||||
build the \*_xload_defconfig for your board, for second stage build the normal
|
build the \*_xload_defconfig for your board; for second stage, build the normal
|
||||||
\*_defconfig for your board.
|
\*_defconfig for your board.
|
||||||
|
|
||||||
Bootstrapping a PandaBoard
|
Bootstrapping a PandaBoard
|
||||||
--------------------------
|
--------------------------
|
||||||
|
|
||||||
The Panda board boots from SD card. The OMAP Boot ROM code loads a file named
|
The PandaBoard boots from SD card. The OMAP Boot ROM code loads a file named
|
||||||
'MLO' on a bootable FAT partition on this card. There are several howtos and
|
'MLO' on a bootable FAT partition on this card. There are several howtos and
|
||||||
scripts on the net which describe how to prepare such a card (it needs a
|
scripts on the net which describe how to prepare such a card (it needs
|
||||||
special partitioning). The same procedure can be used for barebox. With such a
|
special partitioning). The same procedure can be used for barebox. With such a
|
||||||
card (assumed to be at /dev/sdc) the following can be used to build and install
|
card (assumed to be at /dev/sdc), the following can be used to build and install
|
||||||
barebox::
|
barebox::
|
||||||
|
|
||||||
# mount -t fat /dev/sdc1 /mnt
|
# mount -t fat /dev/sdc1 /mnt
|
||||||
|
@ -26,15 +26,16 @@ barebox::
|
||||||
# cp barebox.bin /mnt/barebox.bin
|
# cp barebox.bin /mnt/barebox.bin
|
||||||
# umount /mnt
|
# umount /mnt
|
||||||
|
|
||||||
Bootstrapping a Beagle board is the same with the corresponding Beagle board defconfigs
|
Bootstrapping a BeagleBoard is the same with the corresponding BeagleBoard defconfigs.
|
||||||
|
|
||||||
Networking
|
Networking
|
||||||
----------
|
----------
|
||||||
|
|
||||||
The Beagle board does not have ethernet, but a USB ethernet dongle can be used
|
The original BeagleBoard does not have Ethernet (the newer BeagleBoard-xM does),
|
||||||
for networking. the Panda board has an integrated USB ethernet converter which
|
but a USB Ethernet dongle can be used for networking. The PandaBoard has an
|
||||||
exactly behaves like an external dongle. Barebox does not automatically detect
|
integrated USB Ethernet converter which behaves exactly like an external dongle.
|
||||||
USB devices as this would have bad effects on boot time when USB is not needed.
|
Barebox does not automatically detect USB devices as this would have bad effects
|
||||||
|
on boot time when USB is not needed.
|
||||||
So you have to use the [[commands:usb|usb]] command to trigger USB detection.
|
So you have to use the [[commands:usb|usb]] command to trigger USB detection.
|
||||||
After this a network device should be present which can be used with the normal
|
After this a network device should be present which can be used with the normal
|
||||||
[[commands:dhcp|dhcp]] and [[commands:tftp|tftp]] commands.
|
[[commands:dhcp|dhcp]] and [[commands:tftp|tftp]] commands.
|
||||||
|
|
|
@ -6,41 +6,60 @@ This CPU card is based on a Samsung S3C2440 CPU. The card is shipped with:
|
||||||
* S3C2440\@400 MHz or 533 MHz (ARM920T/ARMv4T)
|
* S3C2440\@400 MHz or 533 MHz (ARM920T/ARMv4T)
|
||||||
* 16.9344 MHz crystal reference
|
* 16.9344 MHz crystal reference
|
||||||
* SDRAM 32/64/128 MiB
|
* SDRAM 32/64/128 MiB
|
||||||
|
|
||||||
* Samsung K4M563233E-EE1H (one or two devices for 32 MiB or 64 MiB)
|
* Samsung K4M563233E-EE1H (one or two devices for 32 MiB or 64 MiB)
|
||||||
|
|
||||||
* 2M x 32bit x 4 Banks Mobile SDRAM
|
* 2M x 32bit x 4 Banks Mobile SDRAM
|
||||||
* CL2\@100 MHz (CAS/RAS delay 19ns)
|
* CL2\@100 MHz (CAS/RAS delay 19ns)
|
||||||
* 105 MHz max
|
* 105 MHz max
|
||||||
* column address size is 9 bits
|
* column address size is 9 bits
|
||||||
* Row cycle time: 69ns
|
* Row cycle time: 69ns
|
||||||
|
|
||||||
* Samsung K4M513233C-DG75 (one or two devices for 64 MiB or 128 MiB)
|
* Samsung K4M513233C-DG75 (one or two devices for 64 MiB or 128 MiB)
|
||||||
|
|
||||||
* 4M x 32bit x 4 Banks Mobile SDRAM
|
* 4M x 32bit x 4 Banks Mobile SDRAM
|
||||||
* CL2\@100MHz (CAS/RAS delay 18ns)
|
* CL2\@100MHz (CAS/RAS delay 18ns)
|
||||||
* 111 MHz max
|
* 111 MHz max
|
||||||
* column address size is 9 bits
|
* column address size is 9 bits
|
||||||
* Row cycle time: 63ns
|
* Row cycle time: 63ns
|
||||||
|
|
||||||
* 64ms refresh period (4k)
|
* 64ms refresh period (4k)
|
||||||
* 90 pin FBGA
|
* 90 pin FBGA
|
||||||
* 32 bit data bits
|
* 32 bit data bits
|
||||||
* Extended temperature range (-25°C...85°C)
|
* Extended temperature range (-25°C...85°C)
|
||||||
|
|
||||||
* NAND Flash 32/64/128 MiB
|
* NAND Flash 32/64/128 MiB
|
||||||
|
|
||||||
* Samsung KM29U512T (NAND01GW3A0AN6)
|
* Samsung KM29U512T (NAND01GW3A0AN6)
|
||||||
|
|
||||||
* 64 MiB 3,3V 8-bit
|
* 64 MiB 3,3V 8-bit
|
||||||
* ID: 0xEC, 0x76, 0x??, 0xBD
|
* ID: 0xEC, 0x76, 0x??, 0xBD
|
||||||
|
|
||||||
* Samsung KM29U256T
|
* Samsung KM29U256T
|
||||||
|
|
||||||
* 32 MiB 3,3V 8-bit
|
* 32 MiB 3,3V 8-bit
|
||||||
* ID: 0xEC, 0x75, 0x??, 0xBD
|
* ID: 0xEC, 0x75, 0x??, 0xBD
|
||||||
|
|
||||||
* ST Micro
|
* ST Micro
|
||||||
|
|
||||||
* 128 MiB 3,3V 8-bit
|
* 128 MiB 3,3V 8-bit
|
||||||
* ID: 0x20, 0x79
|
* ID: 0x20, 0x79
|
||||||
|
|
||||||
* 30ns/40ns/20ns
|
* 30ns/40ns/20ns
|
||||||
|
|
||||||
* I2C interface, 100 KHz and 400 KHz
|
* I2C interface, 100 KHz and 400 KHz
|
||||||
|
|
||||||
* Real Time Clock
|
* Real Time Clock
|
||||||
|
|
||||||
* Dallas DS1337
|
* Dallas DS1337
|
||||||
* address 0x68
|
* address 0x68
|
||||||
|
|
||||||
* EEPROM
|
* EEPROM
|
||||||
|
|
||||||
* ST M24LC64
|
* ST M24LC64
|
||||||
* address 0x50
|
* address 0x50
|
||||||
* 16bit addressing
|
* 16bit addressing
|
||||||
|
|
||||||
* LCD interface
|
* LCD interface
|
||||||
* Touch Screen interface
|
* Touch Screen interface
|
||||||
* Camera interface
|
* Camera interface
|
||||||
|
@ -50,13 +69,16 @@ This CPU card is based on a Samsung S3C2440 CPU. The card is shipped with:
|
||||||
* 3 serial RS232 interfaces
|
* 3 serial RS232 interfaces
|
||||||
* Host and device USB interface, USB1.1 compliant
|
* Host and device USB interface, USB1.1 compliant
|
||||||
* Ethernet interface
|
* Ethernet interface
|
||||||
|
|
||||||
* 10Mbps, Cirrus Logic, CS8900A (on the CPU card)
|
* 10Mbps, Cirrus Logic, CS8900A (on the CPU card)
|
||||||
|
|
||||||
* SPI interface
|
* SPI interface
|
||||||
* JTAG interface
|
* JTAG interface
|
||||||
|
|
||||||
How to get the binary image:
|
How to get the binary image
|
||||||
|
---------------------------
|
||||||
|
|
||||||
Using the default configuration::
|
Configure with the default configuration::
|
||||||
|
|
||||||
make ARCH=arm a9m2440_defconfig
|
make ARCH=arm a9m2440_defconfig
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue