Next revision | Previous revision |
en:templates:meta-tq_qs_tqma57xx [2018/08/07 18:54] – created liedmann | en:templates:meta-tq_qs_tqma57xx [2022/08/04 15:02] (current) – external edit 127.0.0.1 |
---|
The //meta-tq// layer extends the //Yocto Project's// reference system //Poky// to provide support for a selection of TQ Embedded CPU Modules, including the <label mod_name>MOD_NAME</label>. | The //meta-tq// layer extends the //Yocto Project's// reference system //Poky// to provide support for a selection of TQ Embedded CPU Modules, including the <label mod_name>MOD_NAME</label>. |
| |
It uses the same codebase as the [[..:arm:<label mod_name>MOD_NAME</label>:linux:overview|PTXdist based TQ Linux BSPs]] and therefore provides the same versions of U-Boot and Linux kernel, but doesn't define a specific root filesystem configuration. | It uses the same codebase as the [[..:arm:<label mod_name>MOD_NAME</label>:linux:ptxdist:overview|PTXdist based TQ Linux BSPs]] and therefore provides the same versions of U-Boot and Linux kernel, but doesn't define a specific root filesystem configuration. |
| |
The instructions on this page refer to the BSP and ancillary tools listed in the following table: | The instructions on this page refer to the BSP and ancillary tools listed in the following table: |
| |
^ BSP Revision((refers to the revision of the [[..:arm:<label mod_name>MOD_NAME</label>:linux:overview|PTXdist based TQ Linux BSP]], which provides the codebase of U-Boot and Linux kernel)) ^ <label bsp_rev>BSP_REV</label> ^ | ^ BSP Revision((refers to the revision of the [[..:arm:<label mod_name>MOD_NAME</label>:linux:ptxdist:overview|PTXdist based TQ Linux BSP]], which provides the codebase of U-Boot and Linux kernel)) ^ <label bsp_rev>BSP_REV</label> ^ |
^ ++meta-tq release|\\ [[https://github.com/tq-systems/meta-tq/releases|all releases]]++ | [[https://github.com/tq-systems/meta-tq/releases/tag/<label mod_name>MOD_NAME</label>.BSP.SW.<label mtq_reltag>META-TQ_RELTAG</label>|<label mod_name>MOD_NAME</label>.BSP.SW.<label mtq_reltag>META-TQ_RELTAG</label>]] | | ^ ++meta-tq release|\\ [[https://github.com/tq-systems/meta-tq/releases|all releases]]++ | [[https://github.com/tq-systems/meta-tq/releases/tag/<label yocto_rel_branch>YOCTO_REL_BRANCH</label>.<label mod_name_mtq>MOD_NAME_MTQ</label>.BSP.SW.<label bsp_rev>BSP_REV</label>|<label yocto_rel_branch>YOCTO_REL_BRANCH</label>.<label mod_name_mtq>MOD_NAME_MTQ</label>.BSP.SW.<label bsp_rev>BSP_REV</label>]] | |
^ Yocto Project / Poky Release | ++<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label> - <label yocto_rel_name>YOCTO_REL_NAME</label>|\\ ''git clone -b <label yocto_rel_branch>YOCTO_REL_BRANCH</label> git:%%//%%git.yoctoproject.org%%/%%poky.git''\\ [[http://<label yocto_rel_base_url>YOCTO_REL_BASE_URL</label>/yocto-<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>/<label yocto_rel_tarball>YOCTO_REL_TARBALL</label>|<label yocto_rel_tarball>YOCTO_REL_TARBALL</label>]]++ | | ^ Yocto Project / Poky Release | ++<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label> - <label yocto_rel_name>YOCTO_REL_NAME</label>|\\ ''git clone -b <label yocto_rel_branch>YOCTO_REL_BRANCH</label> git:%%//%%git.yoctoproject.org%%/%%poky.git''\\ [[http://<label yocto_rel_base_url>YOCTO_REL_BASE_URL</label>/yocto-<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>/<label yocto_rel_tarball>YOCTO_REL_TARBALL</label>|<label yocto_rel_tarball>YOCTO_REL_TARBALL</label>]]++ | |
^ Target machine((i.e. value for [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable)) | <label mod_name_code>MOD_NAME_CODE</label>-<label mb_name_code>MB_NAME_CODE</label> | | ^ Target machine((i.e. value for [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable)) | <label mtq_machines>MTQ_MACHINES</label> | |
^ U-Boot | <label uboot_version>UBOOT_VERSION</label> | | ^ U-Boot | <label uboot_version>UBOOT_VERSION</label> | |
^ Linux Kernel | <label linux_kernel>LINUX_KERNEL</label> | | ^ Linux Kernel | <label linux_kernel>LINUX_KERNEL</label> | |
| [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/yocto-project-qs/yocto-project-qs.html#welcome|Welcome!]] | <wrap info round>Introduction and basic information about the //Yocto Project//</wrap> | | | [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/yocto-project-qs/yocto-project-qs.html#welcome|Welcome!]] | <wrap info round>Introduction and basic information about the //Yocto Project//</wrap> | |
| [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/yocto-project-qs/yocto-project-qs.html#yp-intro|Introducing the Yocto Project Development Environment]] | ::: | | | [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/yocto-project-qs/yocto-project-qs.html#yp-intro|Introducing the Yocto Project Development Environment]] | ::: | |
| [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/yocto-project-qs/yocto-project-qs.html#yp-resources|Setting Up to Use the Yocto Project]] | <wrap info round>Description of basic requirements for using the //Yocto Project// (also cf. [[..:arm:<label mod_name>MOD_NAME</label>:yocto:meta-tq_qs#Prerequisites]] above)</wrap> | | | [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/yocto-project-qs/yocto-project-qs.html#yp-resources|Setting Up to use the Yocto Project]] | <wrap info round>Description of basic requirements for using the //Yocto Project// (also cf. [[..:arm:<label mod_name>MOD_NAME</label>:linux:yocto:quickstart_yocto#Prerequisites]] above)</wrap> | |
| [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/yocto-project-qs/yocto-project-qs.html#releases|Yocto Project Release]] | <wrap info round>Instructions on how to install a release of the //Yocto Project// on the Build Host</wrap>\\ \\ <WRAP alert round> | | [[http://<label yocto_doc_base_url>YOCTO_DOC_BASE_URL</label>/<label yocto_rel_ver_major>YOCTO_REL_VER_MAJOR</label>.<label yocto_rel_ver_minor>YOCTO_REL_VER_MINOR</label>/yocto-project-qs/yocto-project-qs.html#releases|Yocto Project Release]] | <wrap info round>Instructions on how to install a release of the //Yocto Project// on the Build Host</wrap>\\ \\ <WRAP alert round> |
<code> | <code> |
</WRAP><WRAP block> | </WRAP><WRAP block> |
==== Building an Image for Hardware ==== | ==== Building an Image for Hardware ==== |
1. Create a Local Copy of the //meta-tq// Repository: | 1. Create a Local Copy of <label mtq_repos>MTQ_REPOS</label> |
<code> | <code> |
$ cd $HOME/poky | $ cd $HOME/poky |
$ git clone -b <label yocto_rel_branch>YOCTO_REL_BRANCH</label> https://github.com/tq-systems/meta-tq.git | $ git clone -b <label yocto_rel_branch>YOCTO_REL_BRANCH</label><label yocto_rel_branch_module>YOCTO_REL_BRANCH_MODULE</label> https://github.com/tq-systems/meta-tq.git |
</code> | </code> |
2. Configure the Build: | 3. Initialize the Build Environment: |
| <code> |
| $ source oe-init-build-env |
| </code> |
| 3. Configure the Build((valid machines are\\ <label mtq_machines>MTQ_MACHINES</label>)): |
<code> | <code> |
$ cd $HOME/poky/build | $ cd $HOME/poky/build |
$ bitbake-layers add-layer "../meta-tq" | $ bitbake-layers add-layer "../meta-tq" |
$ echo 'MACHINE = "<label mod_name_code>MOD_NAME_CODE</label>-<label mb_name_code>MB_NAME_CODE</label>"' >> conf/local.conf | $ bitbake-layers add-layer "../meta-ti" |
| $ echo 'MACHINE = "<label mtq_machine_default>MTQ_MACHINE_DEFAULT</label>"' >> conf/local.conf |
</code> | </code> |
3. Build an Image for <label stk_name>STK_NAME</label>: | 4. Build an Image for <label stk_name>STK_NAME</label>: |
<code> | <code> |
$ bitbake core-image-minimal | $ bitbake <label mtq_image>MTQ_IMAGE</label> |
</code> | </code> |
<wrap help round center 80%>The resulting image is ''tmp/deploy/images/<label mod_name_code>MOD_NAME_CODE</label>-<label mb_name_code>MB_NAME_CODE</label>/core-image-minimal-<label mod_name_code>MOD_NAME_CODE</label>-<label mb_name_code>MB_NAME_CODE</label>.wic''</wrap>\\ | <wrap help round center 80%>The resulting image is ''tmp/deploy/images/<label mtq_machine_default>MTQ_MACHINE_DEFAULT</label>((valid machines are\\ <label mtq_machines>MTQ_MACHINES</label>))/<label mtq_image>MTQ_IMAGE</label>-<label mtq_machine_default>MTQ_MACHINE_DEFAULT</label>((valid machines are\\ <label mtq_machines>MTQ_MACHINES</label>)).wic''</wrap>\\ |
4. Write the Image((''TARGET_DEVICE'' has to be an SD card)) | 5. Write the Image((valid machines are\\ <label mtq_machines>MTQ_MACHINES</label>))((''TARGET_DEVICE'' has to be an SD card)) |
<code> | <code> |
$ sudo dd if=tmp/deploy/images/<label mod_name_code>MOD_NAME_CODE</label>-<label mb_name_code>MB_NAME_CODE</label>/core-image-minimal-<label mod_name_code>MOD_NAME_CODE</label>-<label mb_name_code>MB_NAME_CODE</label>.wic of=TARGET_DEVICE | $ sudo dd if=tmp/deploy/images/<label mtq_machine_default>MTQ_MACHINE_DEFAULT</label>/<label mtq_image>MTQ_IMAGE</label>-<label mtq_machine_default>MTQ_MACHINE_DEFAULT</label>.wic of=TARGET_DEVICE |
</code> | </code> |
5. Boot the <label stk_name>STK_NAME</label> from SD card (cf. [[..:arm:<label mod_name>MOD_NAME</label>:<label mb_name_code>MB_NAME_CODE</label>:dip_switches|<label mb_name>MB_NAME</label> DIP switche settings]]) | 6. Boot the <label stk_name>STK_NAME</label> from SD card (cf. [[..:arm:<label mod_name>MOD_NAME</label>:<label mb_name_code>MB_NAME_CODE</label>:dip_switches|<label mb_name>MB_NAME</label> DIP switch settings]]) |
</WRAP> | | </WRAP> | |