Bug 4907 - Add an external sourcery chain example with documentation
Summary: Add an external sourcery chain example with documentation
Status: RESOLVED FIXED
Alias: None
Product: General Docs
Classification: Documentation
Component: docs-general (show other bugs)
Version: unspecified
Hardware: x86 Multiple
: Medium normal
Target Milestone: 1.8
Assignee: Christopher Larson
QA Contact:
URL:
Whiteboard: 19 February 2015: RESOLVED
Depends on:
Blocks:
 
Reported: 2013-07-25 07:10 UTC by Laszlo Papp
Modified: 2015-02-19 23:26 UTC (History)
6 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: Done (doc changes complete)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Laszlo Papp 2013-07-25 07:10:53 UTC
This is not available in the currently released documentation. Perhaps, it is available in the next, but even then, we would need a more thorough documentation, preferably with a concrete example.

See, what the Linaro guys wrote up for reference: http://arago-project.org/wiki/index.php/Setting_Up_Build_Environment
Comment 2 Laszlo Papp 2013-07-25 09:08:42 UTC
Can you show me a real world example, and not just plain documentation?
Comment 3 Scott Rifenbark 2013-07-25 09:13:27 UTC
Yes - real-world examples are good and I can include one.  Can you tell me though if the information that is currently there would allow a person to use an external toolchain?  Knowing if that is true or not would help me better develop where to put an example.
Comment 4 Laszlo Papp 2013-07-25 09:15:08 UTC
See bug 4908 which has been blocking my full-time job since yesterday.
Comment 5 Scott Rifenbark 2013-10-31 17:37:17 UTC
Setting target for 1.6.
Comment 6 Laszlo Papp 2014-04-10 09:35:58 UTC
Phew, I seem to have been frustrated here earlier. I sincerely apologize about that.

I think the only issue that I see now is that the EXTERNAL_TOOLCHAIN variable is not documented in the "glossary".

If that is added, that would satisfy me for now.

Here is an example for the mentor graphics code sourcery toolchain:

    EXTERNAL_TOOLCHAIN = "/usr/local/arm-2009q1"

It is basically setting the path to the toolchain root if I understand it correctly, but I may be wrong.
Comment 7 Paul Eggleton 2014-04-10 10:06:53 UTC
The tricky thing is the parts of this that matter (as in the parts that read EXTERNAL_TOOLCHAIN) are no longer in OE-Core. We could still document usage of  meta-sourcery as an example of external toolchain usage, but it would need to be done in cooperation with the Mentor Graphics folks that maintain it and at this point in the release cycle it's 1.7 material.
Comment 8 Laszlo Papp 2014-04-10 10:23:31 UTC
That is fine, Paul.
Comment 9 Scott Rifenbark 2014-04-10 13:31:45 UTC
Hi,

Based on the comments, I am pushing this one to 1.7.  Also changing to ACCEPTED so the filters don't catch the bug for NEEDINFO.

Thanks, 
Scott
Comment 10 Scott Rifenbark 2014-06-16 07:09:13 UTC
Paul,

What can be done now with this bug?  Is it appropriate to document meta-sourcery as an example of external toolchain usage as you suggested?  Does Mentor need to be consulted/worked with?

Thanks, 
Scott
Comment 11 Scott Rifenbark 2014-07-08 12:47:20 UTC
Setting the milestone to M3.  I still need some guidance on this so when Paul gets back I can hopefully get that.

Scott
Comment 12 Paul Eggleton 2014-08-07 15:05:22 UTC
So, I'm marking this as ACCEPTED rather than NEEDINFO since it is now assigned to me rather than Scott.
Comment 13 Paul Eggleton 2014-11-27 16:46:12 UTC
I feel like I'm actually not very well set up to write about external toolchain setup.

Chris, can I ask you to take care of this? Scott just needs some raw background material for the manual, if you could send him something that would be great.
Comment 14 Christopher Larson 2015-01-28 00:27:58 UTC
Sorry for the delay on this. Scott, I think the readme over at https://github.com/MentorEmbedded/meta-sourcery should be current and covers the usage of the layer. I'll leave it to you as to whether to duplicate it or link to it. Essentially you add the layer to bblayers and set EXTERNAL_TOOLCHAIN = "/path/to/toolchain/install".
Comment 15 Scott Rifenbark 2015-02-13 19:12:07 UTC
Hi, 

I have adjusted the documentation to address this situation.  Please review the following areas:

  http://www.yoctoproject.org/docs/1.8/adt-manual/adt-manual.html#optionally-using-an-external-toolchain

  http://www.yoctoproject.org/docs/1.8/ref-manual/ref-manual.html#var-TCMODE

thanks, 
Scott
Comment 16 Laszlo Papp 2015-02-13 19:20:35 UTC
Thank you, Scott.
Comment 17 Christopher Larson 2015-02-13 20:21:06 UTC
Looks good.
Comment 18 Scott Rifenbark 2015-02-19 23:26:01 UTC
Hi, 

Looks like we have approvals for this fix.  I am marking the issue RESOLVED and setting the documentation flag to "done."

Thanks,
Scott