meta-raspberrypi/docs/extra-build-config.md

6 <http://www.yoctoproject.org/docs/latest/ref-manual/ref-manual.html>
32 See: <https://www.raspberrypi.com/documentation/computers/config_txt.html#memory-options>
36 …erland`. Be aware that `userland` has not support for 64-bit arch. If you disable `vc4` on a 64-bi…
50 See: <https://www.raspberrypi.com/documentation/computers/config_txt.html#licence-key-and-codec-opt…
85 …b`. The "mmc" is required to load an image from the SD card, following the u-boot specification. S…
96 Mode" is officially supported by the Raspberry Pi and does not void warranty. Check
101 Example official settings for Turbo Mode in Raspberry Pi 2:
108 See: <https://www.raspberrypi.com/documentation/computers/config_txt.html#overclocking-options>
113 By default the video mode for these is autodetected on boot: the HDMI mode is
115 mode is defaulted to NTSC using a 4:3 aspect ratio. Check the config.txt for a
120 Example to force HDMI output to 720p in CEA mode:
125 See: <https://www.raspberrypi.com/documentation/computers/configuration.html#hdmi-configuration>
140 This will enable the firmware to fall back to off-line compositing of Dispmanx
141 elements. Normally the compositing is done on-line, during scanout, but cannot
142 handle too many elements. With off-line enabled, an off-screen buffer is
144 of elements) is high, compositing will happen off-line into the buffer.
163 ## Boot to U-Boot
165 To have u-boot load kernel image, set in your local.conf:
169 This will select the appropriate image format for use with u-boot automatically.
171 be overridden to select the exact kernel image type (eg. zImage) and u-boot
174 To operate correctly, U-Boot requires `enable_uart=1` in `config.txt` file for
177 * Raspberry Pi 3 32-bit
178 * Raspberry Pi 3 64-bit
179 * Raspberry Pi 4 32-bit
180 * Raspberry Pi 4 64-bit
189 * Set this 3 kernel variables (in kernel's do_configure:prepend in linux-raspberrypi.inc after the …
191   - kernel_configure_variable BLK_DEV_INITRD y
192   - kernel_configure_variable INITRAMFS_SOURCE ""
193   - kernel_configure_variable RD_GZIP y
196   - `INITRAMFS_IMAGE = "<name for your initramfs image>"`
197   - `INITRAMFS_IMAGE_BUNDLE = "1"`
198   - `BOOT_SPACE = "1073741"`
199   - `INITRAMFS_MAXSIZE = "315400"`
200   - `IMAGE_FSTYPES:pn-${INITRAMFS_IMAGE} = "${INITRAMFS_FSTYPES}"`
209 FATPAYLOAD is a simple space-separated list of files to be copied:
214 listed in the DEPLOYPAYLOAD as a space-separated list of entries.
218     DEPLOYPAYLOAD = "example1-${MACHINE}:example1 example2"
239 Furthermore, to auto-load I2C kernel modules set:
241     KERNEL_MODULE_AUTOLOAD:rpi += "i2c-dev i2c-bcm2708"
249   - This will enable SPI bus and i2c device-trees, it will also setup
255 Below is a list of currently supported PiTFT models in meta-raspberrypi, the
269 Screen LCD, HDMI interface (<http://www.waveshare.com/7inch-HDMI-LCD-C.htm>) Rev
280 operations - 60fps h264 decode, high quality deinterlace - which aren't
289 * <https://github.com/RPi-Distro/repo/issues/22>
293 The standard USB driver only supports host mode operations.  Users who
302 that usually supports host mode operations is disabled for power saving reasons.
303 Users who want to use the 2 USB built-in ports or the other ports provided via
316 separated list ("1,2"), a range("1-3"), or a mixture of these ("1,3-5")
318     ISOLATED_CPUS = "1-2"
326 See: <https://openlabs.co/OSHW/Raspberry-Pi-802.15.4-radio>
330 In order to use CAN with an MCP2515-based module, set the following variables:
353 * PiCAN2 (16 MHz crystal): <http://skpang.co.uk/catalog/pican2-canbus-board-for-raspberry-pi-23-p-1…
354 * WaveShare RS485 CAN HAT (8 MHz or 12 MHz crystal): <https://www.waveshare.com/rs485-can-hat.htm>
355 …uo (16 MHz crystal): <http://skpang.co.uk/catalog/pican2-duo-canbus-board-for-raspberry-pi-23-p-14…
364 This will add device tree overlays gpio-ir and gpio-ir-tx to config.txt.
366 GPIO pin for gpio-ir is set to 18 and the pin for gpio-ir-tx is 17. Both pins
369 ## Enable gpio-shutdown
371 When using device tree kernels, set this variable to enable gpio-shutdown:
376 the gpio-keys kernel module in the image. If System V init is used, additional
387 ## Enable One-Wire Interface
389 One-wire is a single-wire communication bus typically used to connect sensors
390 to the RaspberryPi. The Raspberry Pi supports one-wire on any GPIO pin, but
391 the default is GPIO 4. To enable the one-wire interface explicitly set it in
397 discovered via all 1-Wire busses check the interface with this command
406 If double-quotes are needed in the lines you are adding you can use single
409 For example, to add a comment containing a double-quote and a configuration
419 Because this unicam device ( bcm2835-unicam ) as of now is used by libcamera opensource.
437 * <https://www.raspberrypi.org/blog/an-open-source-camera-stack-for-raspberry-pi-using-libcamera/>
441 Support for WM8960 based sound cards such as the WM8960 Hi-Fi Sound Card HAT for Raspberry Pi from …
445 You may need to adjust volume and toggle switches that are off by default
447     amixer -c1 sset 'Headphone',0 80%,80%
448     amixer -c1 sset 'Speaker',0 80%,80%
449     amixer -c1 sset 'Left Input Mixer Boost' toggle
450     amixer -c1 sset 'Left Output Mixer PCM' toggle
451     amixer -c1 sset 'Right Input Mixer Boost' toggle
452     amixer -c1 sset 'Right Output Mixer PCM' toggle
478 To enable Raspberry Pi Distro VLC, the `meta-openembedded/meta-multimedia` layer must be
481 VLC does not support HW accelerated video decode through MMAL on a 64-bit OS.
491 to `local.conf`. Adding `vlc` to `IMAGE_INSTALL` will then default to building the oe-core
492 implementation of ffmpeg and the meta-openembedded/meta-multimedia implementation of VLC.
496     PREFERRED_PROVIDER_vlc = "rpidistro-vlc"
497     PREFERRED_PROVIDER_ffmpeg = "rpidistro-ffmpeg"
498     PREFERRED_PROVIDER_libav = "rpidistro-ffmpeg"
499     PREFERRED_PROVIDER_libpostproc = "rpidistro-ffmpeg"
503     DISPLAYNUM=$(tvservice -l | tail -c 2)
505 … VLC_SETTINGS="-I dummy --vout=mmal_vout --mmal-resize --mmal-display hdmi-$MMAL_DISPLAY --no-dbus"