diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2012-02-08 09:47:11 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2012-03-08 12:07:53 -0800 |
commit | 7e23cd115c4ceca0b1cca78898b824472091813b (patch) | |
tree | e43f29f5ae38a305ba7376e84c06250d2776f80b | |
parent | eed16096e625d533d7cf19db3a459260aca25f01 (diff) | |
download | ast2050-yocto-poky-7e23cd115c4ceca0b1cca78898b824472091813b.zip ast2050-yocto-poky-7e23cd115c4ceca0b1cca78898b824472091813b.tar.gz |
documentation/dev-manual/dev-manual-common-tasks.xml: Writer notes added.
(From yocto-docs rev: 40d00bde1585dbd0d23bf999e70940e15d52d74f)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 06aa99b..1c89550 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -561,6 +561,52 @@ <section id="platdev-newmachine"> <title>Porting the Yocto Project to a New Machine</title> +<!-- +WRITER NOTES: + +I had this chat with Richard: + +scottrif: Terminology question: We speak of "New Machines" or "Adding a New Machine" + in YP. Are "Machines" restricted to architectures? In poky/meta/conf/machine we have .conf + files for the five architectures. What exactly does the term "Machine" mean? + + RP: no, each architecture has multiple different machines. A "machine" can correspond + to a particular reference board or hardware product + we just have one reference machine per architecture + We're a little vague sometimes as "machine" can refer to either an individual platform, + or in some cases a set of different platforms with common structure + (e.g. netbooks) + +scottrif: So our reference machines we supply are the five qemu* machines? + + RP: in oe-core, plus one "real" target in meta-yocto + (per arch) + +scottrif: I see four in meta-yocto/conf/machine. Shouldn't there be five if there is one + "real" target per architecture? + + RP: yes, we don't have one for x86_64 :/ + +scottrif: I think it is a bit difficult to map our four poky/meta-yocto/conf/machines to one of our + five architectures. Some have key words in there that identify the architecture but + beagleboard and atom-pc don't. + We have a section that describes adding a Machine Configuration file to Yocto and + it states that TARGET_ARCH is one of the most important variables that need to be + set in the .conf file. The four I am looking at don't have that variable. + + RP: That has changed a little now. You need to include the appropriate tune file + which will set it for you + People had a tendency not to set all the right pieces so it got abstracted + +scottrif: Got it. I see them in poky/meta/conf/machine/include. + +SOME CONCLUSIONS: + +I need to define the term machine. It is confusing. Then, this section needs to be cleared up +so that there are some definite steps on how to do this. I need more detail here. + +--> + <para> Adding a new machine to the Yocto Project is a straightforward process. This section provides information that gives you an idea of the changes you must make. |