We are developing for you.

Tweaking built OS

Optional step 6

If you completed steps 1-5, you now have everything ready to run Bee Mobile iDesk on your board.
You may proceed to iDesk getting started which desribes how to download, install and run sample projects on the embedded board.
Now that you successfully bitbaked your entire OS, there are a few tweaks that you can perform to it though, which will make your OS even more useful.

Adding Bee Mobile Yocto layer

Bee Mobile layer called meta-beemobile will add several features and upated to your OS. We will explore them one by one in this article. That way, you will understand these tweaks and may decide how or if you will update them.

  1. In your Fedora VM, Start Visual Studio Code.
  2. File → Open Folder → open /home/developer/fsimx6-Y2024.04.1/build/yocto-fus/sources folder.
  3. Terminal → New Terminal folder.
  4. Verify in terminal, that you are located in /home/developer/fsimx6-Y2024.04.1/build/yocto-fus/sources folder. 
    pwd

    If not, then cd into it.

  5. Git clone meta-beemobile layer.

    git clone https://git.beemobile4.net/git/Yocto -b sources-meta-beemobile
mv Yocto meta-beemobile

    6. This will download Bee Mobile Yocto layer called meta-beemobile to your Fedora VM.

  6. Edit /home/developer/fsimx6-Y2024.04.1/build/yocto-fus/build-fsimx6-fus-imx-xwayland/conf/bblayers.conf file. Add this line to its end: 
    BBLAYERS += "${BSPDIR}/sources/meta-beemobile"

    This will ensure, that bitbake command will “see” it and actually use it.

What’s inside meta-beemobile

Filename or Folder Description
conf/layer.conf Primary layer configuration file.
recipes-config/images/fus-image-mono.bbappend This files tells bitbake what to do, when bitbake fus-image-mono command is invoked. The EXTRA_USERS_PARAMS tells it, to modify root user so that his default shell is bash. This is useful during further software development. Then, it tells it to install (run) further recipes: mono, tzdata, libgdiplus. These are brought by meta-mono layer.
Finally, it tells it to run another set of tasks defined by rootfs-custom, rootfs-weston and deploy-fonts tasks.
recipes-core/images/fus-image-std.bbappend This tells bitbake, then when building (baking) fus-image-std (part of fus-image-mono), it should run tasks rootfs-custom and rootfs-weston.
recipes-core/root-config This is the folder which contains (defines) rootfs-custom and rootfs-weston tasks.
rootfs-custom.bb Copies files bashrc and bash_profile from files folder into the target OS into home folder of root user. If you inspect content of bashrc file, you will see, that this presets some aliases for root user. Feel free to modify these the way your prefer.
rootfs-weston.bb Copies weston.ini and 01Background.jpg files into root file system of target OS. The weston.ini is put into /etc/xdg/weston folder thus altering default configuration of weston. The 01Background.jpg image file is stored into: /usr/share/weston folder. It is the custom background image which will be used as background of Weston Window Manager.
recipes-support/fonts/files Contains custom fonts to be deployed to target OS so that they are found and used by Mono runtime. Feel free to add/remove fonts based on your requirements.
recipes-support/deploy-fonts.bb The actual recipe file, which tells bitbake how to execute deploy-fonts task.
recipes-support/deploy-file/files Contains files to be copied into the OS build output folder within the Fedora VM file system. In other words, these files are not deployed into the root file system of OS being built. Instead, they are deployed to the build output folder, where the OS image is stored after bitbake is done building it. It is the /home/developer/fsimx6-Y2024.04.1/build/yocto-fus/build-fsimx6-fus-imx-xwayland/tmp/deploy/images/fsimx6 folder. The two files contain scripts, that will copy the necessary files from the build output folder to your SD Card, as once the build process is done, copying the built OS onto an SD card will likely be the next step you’ll want to perform. Feel free to tweak these files according to your requirements.
recipes-kernel/linux Finally, this is very important recipe folder. The linux-fus.bbappend file is a recipe extension. It extends linux-fus.bb recipe (located at meta-fus/recipes-kernel/linux/linux-fus.bb). It tells it to patch the kernel building script with a patch file located in meta-beemobile/recipes-kernel/linux/linux-fus/enable-uinput-fsimx6.patch. This patch extends the OS kernel with uinput module.

So there you have it. Hopefully you will find at least some recipes from meta-beemobile layer useful. If not, feel free to alter them based on your requirements.

Rebuild the OS and re-deploy

  1. Ensure that bitbake “sees” the new meta-beemobile layer: 
    bitbake-layers show-layers

    After the command executes, you should see a line, that says
    meta-beemobile /home/developer/fsimx6-Y2024.04.1/build/yocto-fus/sources/meta-beemobile 6
    If you do, go to the next command to rebuild the OS.

  2. Rebuild the OS.

    bitbake fus-image-mono

  3. When rebuilt, deploy it according to the same instructions as in the previous article.

Documentation notice

Information may change over time

Created
Last technically reviewed

Technical details on this page may change as vendor tools, board support packages, operating system images, and runtime versions evolve.

This page was last technically reviewed on May 5, 2026. If your setup differs from the one described here, please contact us for help.

Contact us View services