Building a Yocto Image for Raspberry - TeamViewer Support
<main> <article class="userContent"> <p><em>This article applies to all TeamViewer IoT users.</em></p><ul><li><a href="https://community.teamviewer.com/t5/TeamViewer-IoT-Knowledge-Base-EN/Building-a-Yocto-Image-for-Raspberry/ta-p/91297#toc-hId--1325925672" rel="nofollow noreferrer ugc">General</a></li><li><a href="https://community.teamviewer.com/t5/TeamViewer-IoT-Knowledge-Base-EN/Building-a-Yocto-Image-for-Raspberry/ta-p/91297#toc-hId--438421991" rel="nofollow noreferrer ugc">Requirements</a></li><li><a href="https://community.teamviewer.com/t5/TeamViewer-IoT-Knowledge-Base-EN/Building-a-Yocto-Image-for-Raspberry/ta-p/91297#toc-hId-449081690" rel="nofollow noreferrer ugc">How to setup</a></li></ul><h2 data-id="general">General</h2><p>The <a href="https://www.yoctoproject.org/" rel="nofollow noreferrer ugc">Yocto Project</a> enables the creation of custom Linux-based systems for embedded devices. </p><p>The <em>TeamViewer IoT Agent</em> will run on <em>Yocto Linux</em> devices given minimum requirements and configurations are met.</p><p>This article is an example how to build <em>Yocto Image</em> with <em>TeamViewer IoT Agent</em> for <em>Raspberry</em> using the layer provided in <em>GitHub</em>. Information about this <a href="https://github.com/teamviewer/meta-teamviewer-iot-agent" rel="nofollow noreferrer ugc">here</a> </p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/lithium_attachments/15628i39A461B2C6C1BD14.jpg" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/15628i39A461B2C6C1BD14.jpg" alt="Yocto_add_device.png" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p> </p><h2 data-id="requirements">Requirements</h2><p>You need some dependencies to develop projects in the Yocto Project. Please check <a href="https://www.yoctoproject.org/docs/1.8/yocto-project-qs/yocto-project-qs.html#yp-resources" rel="nofollow noreferrer ugc">here</a> for more information.</p><h2 data-id="how-to-setup">How to setup</h2><ol><li>Install dependencies based on OS version (use verified OS for building image). Check <a href="https://www.yoctoproject.org/docs/latest/ref-manual/ref-manual.html#required-packages-for-the-build-host" rel="nofollow noreferrer ugc">here</a></li><li>Open <em>Terminal</em> on <em>Host Machine</em> and run the commands below:</li></ol><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/lithium_attachments/14855iA266C5D2E7A77F86.jpg" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/lithium_attachments/14855iA266C5D2E7A77F86.jpg" alt="terminalonhost.png" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p> </p><ul><li>Clone poky project's zeus branch</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">git clone --branch=zeus git://git.yoctoproject.org/poky.git && cd poky </pre><ul><li>Clone raspberryPi and TeamViewer IoT agent meta-packages</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">git clone --branch=zeus git://git.yoctoproject.org/meta-raspberrypi git clone --branch=zeus https://github.com/teamviewer/meta-teamviewer-iot-agent </pre><ul><li>Configure Environment </li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">source oe-init-build-env </pre><ul><li>Add Layers to bitbake</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">bitbake-layers add-layer ../meta-raspberrypi bitbake-layers add-layer ../meta-teamviewer-iot-agent </pre><ul><li>Change the target Machine on the configuration file and set init manager to systemd</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">echo 'MACHINE = "raspberrypi3"' >> conf/local.conf echo 'DL_DIR = "${TOPDIR}/downloads"' >> conf/local.conf echo 'CONNECTIVITY_CHECK_URIS = "https://www.google.com/"' >> conf/local.conf echo '#Set Systemd to Init Manager' >> conf/local.conf echo 'DISTRO_FEATURES_append = " systemd"' >> conf/local.conf echo 'DISTRO_FEATURES_BACKFILL_CONSIDERED += "sysvinit"' >> conf/local.conf echo 'VIRTUAL-RUNTIME_init_manager = "systemd"' >> conf/local.conf </pre><ul><li>Append ssh and TeamViewer IoT agent layer, 50MB extra space, and set default password for root user</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">echo '#Append TeamViewer IoT agent layer' >> conf/local.conf echo 'IMAGE_INSTALL_append += " teamviewer-iot-agent"' >> conf/local.conf echo 'IMAGE_ROOTFS_EXTRA_SPACE ?= "50000"' >> conf/local.conf echo 'CORE_IMAGE_EXTRA_INSTALL += "openssh"' >> conf/local.conf echo 'INHERIT += "extrausers"' >> conf/local.conf echo 'EXTRA_USERS_PARAMS = "usermod -P raspberry root;"' >> conf/local.conf echo 'VOLATILE_LOG_DIR = "no"' >> conf/local.conf </pre><ul><li><strong>OPTIONAL - </strong>For installing Xvfb server in the target device to be able to use X11 features</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">echo '#X11' >> conf/local.conf echo 'DISTRO_FEATURES_append += " X11"' >> conf/local.conf </pre><ul><li><strong>OPTIONAL - </strong>For enable edge management with Docker in the target device</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">git clone --branch=zeus git://git.openembedded.org/meta-openembedded ../meta-openembedded git clone --branch=zeus git://git.yoctoproject.org/meta-virtualization ../meta-virtualization sed -i '$d' conf/bblayers.conf echo ' ${TOPDIR}/../meta-openembedded/meta-oe \' >> conf/bblayers.conf echo ' ${TOPDIR}/../meta-openembedded/meta-multimedia \' >> conf/bblayers.conf echo ' ${TOPDIR}/../meta-openembedded/meta-networking \' >> conf/bblayers.conf echo ' ${TOPDIR}/../meta-openembedded/meta-python \' >> conf/bblayers.conf echo ' ${TOPDIR}/../meta-openembedded/meta-filesystems \' >> conf/bblayers.conf echo ' ${TOPDIR}/../meta-virtualization \' >> conf/bblayers.conf echo ' "' >> conf/bblayers.conf bitbake-layers show-layers echo '#Docker layer for supporting Edge services' >> conf/local.conf echo 'DISTRO_FEATURES_append += " virtualization"' >> conf/local.conf echo 'IMAGE_ROOTFS_EXTRA_SPACE = "400000"' >> conf/local.conf </pre><ul><li>Run the command below to start the build</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">bitbake core-image-minimal </pre><p><strong><em>Notes: </em></strong><em>You can find target image tmp/deploy/images/raspberrypi3/ here with core-image-minimal-raspberrypi3 prefix. In case of failure or new bash ( terminal ) creation, after all steps executed you need to go to Project's directory and start again from Configure Environment. When using 'ssh' with the built image, the username is 'root' and the password is 'raspberry'. </em></p> </article> </main>
