summaryrefslogtreecommitdiffstats
path: root/documentation/bsp-guide
diff options
context:
space:
mode:
authorKristi Rifenbark <kristi.rifenbark@gmail.com>2017-11-17 16:30:16 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2017-12-09 14:29:08 +0000
commit4a71d17172989a860aa192ec6e89e28d6cda5cbd (patch)
tree1c746050d74cba57724e61ac7e71b8cbcfadea9c /documentation/bsp-guide
parent3716b1f51e87ca71ca8002819baf55f19128571e (diff)
downloadpoky-4a71d17172989a860aa192ec6e89e28d6cda5cbd.tar.gz
bsp-guide: WIP Removing yocto-bsp
(From yocto-docs rev: 056cc0c1dab79df6911552a690ca6b4dc302cc8b) Signed-off-by: Kristi Rifenbark <kristi.rifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/bsp-guide')
-rw-r--r--documentation/bsp-guide/bsp.xml88
1 files changed, 24 insertions, 64 deletions
diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
index d7b6f15b26..21672b43ce 100644
--- a/documentation/bsp-guide/bsp.xml
+++ b/documentation/bsp-guide/bsp.xml
@@ -1612,46 +1612,34 @@
1612 <title>Creating a new BSP Layer Using the yocto-bsp Script</title> 1612 <title>Creating a new BSP Layer Using the yocto-bsp Script</title>
1613 1613
1614 <para> 1614 <para>
1615 The <filename>yocto-bsp</filename> script creates a new 1615 [SOMETHING ABOUT CREATING A GENERAL LAYER USING bitbake-layers SCRIPT]
1616 <link linkend='bsp-layers'>BSP layer</link> for any architecture supported 1616 The [MODIFICATION NAME] sub-command creates a new
1617 by the Yocto Project, as well as QEMU versions of the same. 1617 <link linkend='bsp-layers'>BSP layer</link> for any architecture
1618 The default mode of the script's operation is to prompt you for information needed 1618 supported by the Yocto Project, as well as QEMU versions of the same.
1619 to generate the BSP layer. 1619 The default mode of the script's operation is to prompt you for
1620 information needed to generate the BSP layer.
1620 </para> 1621 </para>
1621 1622
1622 <para> 1623 <para>
1623 For the current set of BSPs, the script prompts you for various important 1624 For the current set of BSPs, the [SCRIPT] prompts you for various
1624 parameters such as: 1625 important parameters such as:
1625 <itemizedlist> 1626 <itemizedlist>
1626 <listitem><para>The kernel to use</para></listitem> 1627 <listitem><para>[PAREMETER 1]</para></listitem>
1627 <listitem><para>The branch of that kernel to use (or re-use)</para></listitem> 1628 <listitem><para>[PARAMETER 2]</para></listitem>
1628 <listitem><para>Whether or not to use X, and if so, which drivers to use</para></listitem> 1629 <listitem><para>[PARAMETER 3]</para></listitem>
1629 <listitem><para>Whether to turn on SMP</para></listitem> 1630 <listitem><para>[PARAMETER 4]</para></listitem>
1630 <listitem><para>Whether the BSP has a keyboard</para></listitem> 1631 <listitem><para>[PARAMETER 5]</para></listitem>
1631 <listitem><para>Whether the BSP has a touchscreen</para></listitem> 1632 <listitem><para>[PARAMETER 6]</para></listitem>
1632 <listitem><para>Remaining configurable items associated with the BSP</para></listitem> 1633 <listitem><para>[PARAMETER 7]</para></listitem>
1633 </itemizedlist> 1634 </itemizedlist>
1634 </para> 1635 </para>
1635 1636
1636 <para> 1637 <para>
1637 You use the <filename>yocto-bsp create</filename> sub-command to create 1638 [ASSUMING STEP ONE IS RUNNING bitbake-layers TO CREATE GENERIC LAYER - INTRO]
1638 a new BSP layer. 1639 For instructions on how to create a general layer using the
1639 This command requires you to specify a particular kernel architecture 1640 <filename>bitbake-layers</filename> script see the
1640 (<filename>karch</filename>) on which to base the BSP. 1641 "<ulink url='&YOCTO_DOCS_DEV_URL;#creating-a-general-layer-using-the-bitbake-layers-script'>Creating a General Layer Using the <filename>bitbake-layers</filename> Script</ulink>"
1641 Assuming you have sourced the environment, you can use the 1642 section.
1642 <filename>yocto-bsp list karch</filename> sub-command to list the
1643 architectures available for BSP creation as follows:
1644 <literallayout class='monospaced'>
1645 $ yocto-bsp list karch
1646 Architectures available:
1647 powerpc
1648 x86_64
1649 i386
1650 arm
1651 qemu
1652 mips
1653 mips64
1654 </literallayout>
1655 </para> 1643 </para>
1656 1644
1657 <para> 1645 <para>
@@ -1667,7 +1655,7 @@
1667 </para> 1655 </para>
1668 1656
1669 <para> 1657 <para>
1670 As the <filename>yocto-bsp create</filename> command runs, default values for 1658 [ASSUMING SIMLILAR ACTION OCCURS]As the [SUBCOMMAND] command runs, default values for
1671 the prompts appear in brackets. 1659 the prompts appear in brackets.
1672 Pressing enter without supplying anything on the command line or pressing enter 1660 Pressing enter without supplying anything on the command line or pressing enter
1673 with an invalid response causes the script to accept the default value. 1661 with an invalid response causes the script to accept the default value.
@@ -1681,39 +1669,10 @@
1681 <para> 1669 <para>
1682 Following is the complete example: 1670 Following is the complete example:
1683 <literallayout class='monospaced'> 1671 <literallayout class='monospaced'>
1684 $ yocto-bsp create myarm qemu 1672[INSERT EXAMPLE]
1685 Checking basic git connectivity...
1686 Done.
1687
1688 Which qemu architecture would you like to use? [default: i386]
1689 1) i386 (32-bit)
1690 2) x86_64 (64-bit)
1691 3) ARM (32-bit)
1692 4) PowerPC (32-bit)
1693 5) MIPS (32-bit)
1694 6) MIPS64 (64-bit)
1695 3
1696 Would you like to use the default (4.8) kernel? (y/n) [default: y]
1697 Do you need a new machine branch for this BSP (the alternative is to re-use an existing branch)? [y/n] [default: y]
1698 Getting branches from remote repo git://git.yoctoproject.org/linux-yocto-4.8.git...
1699 Please choose a machine branch to base this BSP on: [default: standard/base]
1700 1) standard/arm-versatile-926ejs
1701 2) standard/base
1702 3) standard/beaglebone
1703 4) standard/edgerouter
1704 5) standard/fsl-mpc8315e-rdb
1705 6) standard/mti-malta32
1706 7) standard/mti-malta64
1707 8) standard/qemuarm64
1708 9) standard/qemuppc
1709 1
1710 Would you like SMP support? (y/n) [default: y]
1711 Does your BSP have a touchscreen? (y/n) [default: n]
1712 Does your BSP have a keyboard? (y/n) [default: y]
1713
1714 New qemu BSP created in meta-myarm
1715 </literallayout> 1673 </literallayout>
1716 Take a closer look at the example now: 1674 Take a closer look at the example now:
1675 [UPDATE EXAMPLE STRUCTURE BASED ON NEW INSTRUCTIONS]
1717 <orderedlist> 1676 <orderedlist>
1718 <listitem><para>For the QEMU architecture, 1677 <listitem><para>For the QEMU architecture,
1719 the script first prompts you for which emulated architecture to use. 1678 the script first prompts you for which emulated architecture to use.
@@ -1765,6 +1724,7 @@
1765 /usr/local/src/yocto/meta-myarm \ 1724 /usr/local/src/yocto/meta-myarm \
1766 " 1725 "
1767 </literallayout> 1726 </literallayout>
1727 [YOCTO-KERNEL WILL BE REMOVED - THIS NEEDS UPDATED WITH NEW INFO]
1768 Adding the layer to this file allows the build system to build the BSP and 1728 Adding the layer to this file allows the build system to build the BSP and
1769 the <filename>yocto-kernel</filename> tool to be able to find the layer and 1729 the <filename>yocto-kernel</filename> tool to be able to find the layer and
1770 other Metadata it needs on which to operate. 1730 other Metadata it needs on which to operate.