# Raspberry Pi 4 Model B - Yocto 5.0 "scarthgap" and later **URL:** \ **Category:** Yocto Project\ **Tags:** yocto, raspberry-pi-4, scarthgap\ **Created:** [July 17, 2024, 11:05am UTC](https://hub.mender.io/t/raspberry-pi-4-model-b-yocto-5-0-scarthgap-and-later/7024 "2024-07-17T11:05:52Z")\ **Posts on this page:** 6\ **Page:** 1
**Author:** ![TheYoctoJester](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/theyoctojester/32/1444_2.png) [@TheYoctoJester](https://hub.mender.io/u/TheYoctoJester)\ **Post date:** [July 17, 2024, 11:05am UTC](https://hub.mender.io/t/raspberry-pi-4-model-b-yocto-5-0-scarthgap-and-later/7024/1 "2024-07-17T11:05:52Z")
# Board description The Raspberry Pi 4 Model B is the probably most popular board of the Raspberry Pi family. ![raspberry-pi-4-labelled@2x-1c8c2d74ade597b9c9c7e9e2fff16dd4](https://canada1.discourse-cdn.com/flex036/uploads/mender/original/2X/b/bc8227f944cb3272967a1278b21d1677af05df5d.png) URL: [https://www.raspberrypi.org/products/raspberry-pi-4-model-b/](https://www.raspberrypi.org/products/raspberry-pi-4-model-b/) Wiki: [https://elinux.org/RPi\_Hub](https://elinux.org/RPi_Hub?target=_blank) # Test results Raspberry Pi 4 is one of the official reference devices of Mender and is easy to get started with. This device is continuously tested as part of Mender testing pipelines which assures high quality of the integration. ## Version notes This tutorial uses **scarthgap** as the primary target, which is the current LTS release by the Yocto Project. You can find more infomation on releases [here](https://wiki.yoctoproject.org/wiki/Releases). **NOTE: before the Yocto 5.0 release “`scarthgap`”, `meta-mender` and `meta-mender-community` used [Google Repo](https://hub.mender.io/t/google-repo/58) configuration files. Please see the [Raspberry Pi 4 Model B - Yocto 4.0 "kirkstone" and earlier](https://hub.mender.io/t/raspberry-pi-4-model-b-yocto-4-0-kirkstone-and-earlier/889) article for building these releases.** Supported releases for following the tutorial are: | Yocto Project | Tutorial applies | Maintenance | | --- | --- | --- | | scarthgap (5.0) | :test_works: | :test_works: LTS[1](#footnote1) | | nanbield (4.3) and older | :test_fails: | :test_fails: does not apply | 1. Disabled GRUB integration for ARM systems which is default in meta-mender/meta-mender-raspberrypi. U-Boot is still primary integration method for this platform. **Please note:** a failure in the “tutorial applies” column indicates that the instructions do not work without modification. Depending on the combination of release and host Linux distribution, installing other python versions or dependencies might provide a functional state. **Build** Means that the Yocto Project build using this Mender integration completes without errors and outputs images. **Runtime** Means that Mender has been verified to work on the board. For U-Boot-based boards, the [integration checklist](https://docs.mender.io/system-updates-yocto-project/board-integration/bootloader-support/u-boot/integration-checklist?target=_blank) has been verified. # Getting started ## Prerequisites - A supported Linux distribution and dependencies installed on your workstation/laptop as described in the [Yocto Development Manual](https://docs.yoctoproject.org/dev-manual/start.html#preparing-the-build-host) - NOTE. Instructions depend on which Yocto version you intend to use. - kas [installed](https://hub.mender.io/t/using-kas-to-reproduce-your-yocto-builds/6020) and in your `PATH`. ## Configuring the build ### Setup Yocto environment Create a directory for your `mender-raspberrypi5` setup to live in and clone the meta information. ```bash mkdir mender-raspberrypi4 && cd mender-raspberrypi4 ``` Clone the `meta-mender-community` layer: ```bash git clone https://github.com/theyoctojester/meta-mender-community \ -b scarthgap ``` ## Setup build environment Change into the cloned repository and create a directory to hold the build: ```bash cd meta-mender-community mkdir my-raspberrypi4 cd my-raspberrypi4 ``` Use `kas` to set up the build structure: ```bash kas shell ../kas/raspberrypi4.yml ``` This opens a sub-shell which is initialized for the build process. You can close it using the `exit` command. ### Configure Mender server URL (optional) This section is not required for a successful build but images that are generated by default are only suitable for usage with the Mender client in [Standalone deployments](https://docs.mender.io/artifact-creation/standalone-deployment), due to lack of server configuration. You can edit the `conf/local.conf` file to provide your Mender server configuration, ensuring the generated images and Mender Artifacts are connecting to the Mender server that you are using. There should already be a commented section in the generated `conf/local.conf` file and you can simply uncomment the relevant configuration options and assign appropriate values to them. Build for Hosted Mender: ```auto # To get your tenant token: # - log in to https://hosted.mender.io # - click your email at the top right and then "My organization" # - press the "COPY TO CLIPBOARD" # - assign content of clipboard to MENDER_TENANT_TOKEN # MENDER_SERVER_URL = "https://hosted.mender.io" MENDER_TENANT_TOKEN = "" ``` ### Building the image You can now proceed with building an image: ```bash bitbake core-image-minimal ``` Replace `core-image-minimal` with your desired image target. `core-image-minimal` is chosen as an example for short build time and minimal dependencies. ### Using the build output After a successful build, the images and build artifacts are: - `tmp/deploy/images/raspberrypi4/core-image-base-raspberrypi4.sdimg` - `tmp/deploy/images/raspberrypi4/core-image-base-raspberrypi4.mender` The disk image (with `.sdimg` suffix) is used to provision the device storage for devices without Mender running already. Please proceed to [the official documentation on provisioning a new device](https://docs.mender.io/system-updates-yocto-project/provisioning-a-new-device?target=_blank) for steps to do this. On the other hand, if you already have Mender running on your device and want to deploy a rootfs update using this build, you should use the [Mender Artifact](https://docs.mender.io/overview/artifact) files, which have `.mender` suffix. You can either deploy this Artifact in managed mode with the Mender server (upload it under Releases in the server UI) or by using the Mender client [standalone mode](https://docs.mender.io/artifact-creation/standalone-deployment). # References - The Mender integration layer for Raspberry Pi boards can be found in [meta-mender-community](https://github.com/mendersoftware/meta-mender-community/tree/master/meta-mender-raspberrypi?target=_blank). - The official [Mender documentation](https://docs.mender.io/) explains how Mender works. This is simply a board-specific complement to the official documentation. # Known issues ## Boot firmware files See [Updating Raspberry Pi boot firmware files using Yocto Project and Mender](https://hub.mender.io/t/updating-raspberry-pi-boot-firmware-files-using-yocto-project-and-mender/1719). See this [thread](https://groups.google.com/a/lists.mender.io/d/msg/mender/98PMIMUp8kA/cOvIes1gDAAJ) where the limitations of the boot firmware files on Raspberry Pi are discussed. ## Devicetree is not updated To be able to support update of Linux kernel and devicetree, Mender requires these to be installed in the `/boot` directory for each rootfs (normally `/dev/mmcblk0p2` and `/dev/mmcblk0p3`). On the other hand, the Raspberry Pi boot firmware requires that the DTB file is in the same partition as the boot firmware (`/dev/mmcblk0p1`) and the config.txt file. For now Mender will not use the DTB that is delivered with new artifacts and will continue to boot with the original DTB that was populated using the `sdimg` file. ## Problem using ‘dtoverlay=pi3-disable-bt’ > `pi3-disable-bt` disables the Bluetooth device and restores UART0/ttyAMA0 to GPIOs 14 and 15. It is also necessary to disable the system service that initialises the modem so it doesn’t use the UART There is currently a known issue with above functionality, that is to enable `UART0` on PIN 14 and 15. It is actually not something that is caused by Mender specifically, but Mender requires `U-Boot` to be present to support robust features such as roll-back. `U-Boot` is typically not enabled if you do a stock Raspberry Pi and some people are often surprised that the Bluetooth UART stopped working when they integrate `meta-mender`. The problem is in `U-Boot` which does conflicting configuration, and there is a workaround reported [here](https://github.com/agherzan/meta-raspberrypi/issues/374) and it has been reported to U-Boot but unclear when/if it will be fixed. * * * _If this post was useful to you, please press like, or leave a thank you note to the contributor who put valuable time into this and made it available to you. It will be much appreciated!_ ---
**Author:** ![maxhochlenertarnoldn](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/maxhochlenertarnoldn/32/2239_2.png) [@maxhochlenertarnoldn](https://hub.mender.io/u/maxhochlenertarnoldn)\ **Post date:** [July 17, 2024, 11:36am UTC](https://hub.mender.io/t/raspberry-pi-4-model-b-yocto-5-0-scarthgap-and-later/7024/2 "2024-07-17T11:36:19Z")
Thank you very much for taking the time to update the tutorial! ---
**Author:** ![TheYoctoJester](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/theyoctojester/32/1444_2.png) [@TheYoctoJester](https://hub.mender.io/u/TheYoctoJester)\ **Post date:** [October 31, 2024, 2:42pm UTC](https://hub.mender.io/t/raspberry-pi-4-model-b-yocto-5-0-scarthgap-and-later/7024/3 "2024-10-31T14:42:20Z")
5 posts were split to a new topic: [Trouble getting RPi4 to work](https://hub.mender.io/t/trouble-getting-rpi4-to-work/7287) ---
**Author:** ![wlbdv](https://avatars.discourse-cdn.com/v4/letter/w/f17d59/32.png) [@wlbdv](https://hub.mender.io/u/wlbdv)\ **Post date:** [February 7, 2025, 7:57am UTC](https://hub.mender.io/t/raspberry-pi-4-model-b-yocto-5-0-scarthgap-and-later/7024/4 "2025-02-07T07:57:30Z")
I recently started working with yocto because I want to set up a Mender Device Management with my Raspberry Pi 4. I came across this tutorial, which I found to be very helpful. With the help of the tutorial, I was able to successfully install a first image on my Raspberry Pi 4 and successfully connect to Mender. Now I want to install a first update and have proceeded as follows: Adjusted `local.conf` in `mender-raspberrypi4/meta-mender-community/my-raspberrypi4/build/conf/` to my needs: ```auto # change mender artifact name to be able to update the OS MENDER_ARTIFACT_NAME = "gha_autobuild v1.1" # add the mender connect feature to the built IMAGE_INSTALL:append = " mender-connect" MENDER_CONNECT_USER = "root" MENDER_CONNECT_SHELL = "/bin/bash" ``` A few questions have arisen: 1. Each time I use the command `kas shell ../kas/raspberrypi4.yml` it overwrites my customized `local.conf` under `mender-raspberrypi4/meta-mender-community/my-raspberrypi4/build/conf/local.conf` What do I have to change if I want to work on an existing project without it overwriting everything again? 2. Why do I have to specify `MACHINE=raspberrypi4` at the beginning of the `bitbake core-image-base` command? 3. The first build process writes the `core-image-base-raspberrypi4.mender` file. However, if I have adjusted the `local.conf` and run `MACHINE=raspberrypi4 bitbake core-image-base` again, it only recreates the sdimg file, but not the mender file, which is important to upload it as an artifact to Mender. Commands like `bitbake -c cleanall core-image-base` don’t solve the issue. ---
**Author:** ![TheYoctoJester](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/theyoctojester/32/1444_2.png) [@TheYoctoJester](https://hub.mender.io/u/TheYoctoJester)\ **Post date:** [February 11, 2025, 12:57pm UTC](https://hub.mender.io/t/raspberry-pi-4-model-b-yocto-5-0-scarthgap-and-later/7024/5 "2025-02-11T12:57:14Z")
HI @wlbdv, Thanks a lot for reaching out, and nice to hear you found this helpful. For your questions: 1. The core concept of `kas` is that the whole build is defined by the data given, and hence it re-creates `local.conf` based on the passed `.yml` files every time. The way to augment the information in `meta-mender-community` with your local settings is to use an override file as described at [Using kas to reproduce your Yocto builds](https://hub.mender.io/t/using-kas-to-reproduce-your-yocto-builds/6020#local-override-files-4). You would put your additions into a file like `wlbdev-mender.yml`, and then invoke `kas` like `kas shell ../kas/raspberrypi4.yml:wlbdev-mender.yml`. This way, whatever assignments you have in `wlbdev-mender.yml` will overwrite the given defaults. 2. good catch, that’s a leftover from the original `repo`-based tutorial. Fixed now. 3. the `core-image-base-raspberrypi4.mender` file is in fact a symlink to the last built artifact. I have just given it a test build, and after the second build the link is pointing to the newly created `.mender` file. Can you check if this is the case for you? Greetz, Josef ---
**Author:** ![TheYoctoJester](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/theyoctojester/32/1444_2.png) [@TheYoctoJester](https://hub.mender.io/u/TheYoctoJester)\ **Post date:** [April 2, 2025, 10:30am UTC](https://hub.mender.io/t/raspberry-pi-4-model-b-yocto-5-0-scarthgap-and-later/7024/6 "2025-04-02T10:30:44Z")
8 posts were split to a new topic: [RPi 4 not booting, want Secure Boot](https://hub.mender.io/t/rpi-4-not-booting-want-secure-boot/7685)