base.bbclass: add support for SOC_FAMILY in COMPATIBLE_MACHINES
[openembedded.git] / recipes / ti / README
blob2fbb9f1bbc4ec7eff75a22287c2ad7a8ecbae39c
1 = Introduction = 
3 Depending on platform you need to download one or more components from the external URL and put in downloads directory.
5 Most components are 'TSPA' now, which mean OE can download them automagically, if a download fails, you should be able to find the archive you need at:
7 * C6000 Code Generation Tools v6.1.9 Linux (ti_cgt_c6000_6.1.9_setup_linux_x86.bin)
8         https://www-a.ti.com/downloads/sds_support/TICodegenerationTools/download.htm
9 * Generic download URI
10         http://software-dl.ti.com/dsps/dsps_registered_sw/sdo_sb/targetcontent/
12 = Version selection =
14 Tool versions are clustered per codec-engine release, since that combination gets the most testing. Like all other preferred-version files they stored in conf/distro/include:
16 angstrom-codec-engine-2.25-preferred-versions.inc
17 angstrom-codec-engine-2.25.01-preferred-versions.inc
19 You can select between them by putting the following in local.conf:
21 CE_VERSION = "2.25.01"
23 You will get a parsing failure if a non-existing version is selected.
25 = Recipe setup =
27 Since most of the recipes in this directory deal with a DSP (e.g OMAP3) or accelerators (e.g DM3xx) and have strict per platform version dependencies they are all machine specific. For things like codec-engine, kernel drivers and userspace samples this makes sense, since they are tied to a specific device or platform. For things like codegen and xdc-tools this is weird, but it's the least bad option currently.
29 The complete unpacked trees are staged to staging/machine/usr/share/ti/${PN}(-tree) and all the _INSTALL_DIR vars will point to that. To make this work there is a ti-staging.inc which contains:
31 PACKAGE_ARCH = "${MACHINE_ARCH}"
32 BASEPKG_HOST_SYS = "${MULTIMACH_HOST_SYS}"
33 PACKAGE_STRIP = "no"
35 The 'BASEPKG_HOST_SYS' bit is what makes it work, but cause trouble is you want to read from it, so ti-paths.inc does:
37 export CODEGEN_INSTALL_DIR_RECIPE    = "${installdir}/ti-cgt6x"
38 export CODEGEN_INSTALL_DIR    = "${STAGING_DIR}/${MULTIMACH_TARGET_SYS}/${CODEGEN_INSTALL_DIR_RECIPE}"
40 Which will point it to the machine specific staging like we want it to.