diff options
Diffstat (limited to 'CUSTOMIZE.md')
-rw-r--r-- | CUSTOMIZE.md | 61 |
1 files changed, 35 insertions, 26 deletions
diff --git a/CUSTOMIZE.md b/CUSTOMIZE.md index f3d8a5dd..5069dba8 100644 --- a/CUSTOMIZE.md +++ b/CUSTOMIZE.md @@ -1,4 +1,4 @@ -# Customizing images with AMD Features +# 4. Customizing images with AMD Features AMD supports various features and software components that can be enabled by setting the corresponding configuration variable to a @@ -9,37 +9,41 @@ them to be installed/available on your image, or can be configured: * **VULKAN - Vulkan driver and Loader Layer.** - It is required to run Vulkan based applications. Vulkan is a new - generation graphics and compute API that provides high-efficiency, - cross-platform access to modern GPUs. +> It is required to run Vulkan based applications. Vulkan is a new +> generation graphics and compute API that provides high-efficiency, +> cross-platform access to modern GPUs. * **MPV \* - Video player based on MPlayer/mplayer2** - MPV is a movie player based on MPlayer and mplayer2. It supports a - wide variety of video file formats, audio and video codecs, and - subtitle types. +> MPV is a movie player based on MPlayer and mplayer2. It supports a +> wide variety of video file formats, audio and video codecs, and +> subtitle types. * **COMMERCIAL MULTIMEDIA \* - License restricted multimedia components** - Certain multimedia formats require license restricted codecs and - software components which are not included in build by default. +> Certain multimedia formats require license restricted codecs and +> software components which are not included in build by default. * **MULTI DISPLAY - Multiple display support** - You can connect multiple displays with AMD machines. The display - configuration/arrangement can be configured using this. +> You can connect multiple displays with AMD machines. The display +> configuration/arrangement can be configured using this. * **ON-TARGET DEVELOPMENT - SDK for on-target development** - gcc, make, autotools, autoconf, build-essential etc. +> gcc, make, autotools, autoconf, build-essential etc. * **ON-TARGET DEBUGGING - tools for on-target debugging** - gdb, gdbserver, strace, mtrace +> gdb, gdbserver, strace, mtrace * **ON-TARGET PROFILING - tools for on-target profiling** - lttng, babeltrace, systemtap, powertop, valgrind +> lttng, babeltrace, systemtap, powertop, valgrind + +* **RT KERNEL - Realtime Kernel support** + +> Linux kernel with PREEMPT_RT patch --- #### Disclaimer @@ -64,15 +68,16 @@ target. #### Supported Features -| Feature | Configuration variable | Configuration values | Default value | Supported BSPs | -|:----------------------|:------------------------------|:---------------------------------------|:--------------|:---------------| -| VULKAN | INCLUDE_VULKAN | yes, no | no | r1000 | -| MPV | INCLUDE_MPV | yes, no | no | r1000 | -| COMMERCIAL MULTIMEDIA | INCLUDE_COMMERCIAL_MULTIMEDIA | yes, no | no | r1000 | -| MULTI DISPLAY | MULTI_DISPLAY_MODE | auto, mirrored, extended-v, extended-h | auto | r1000 | -| ON-TARGET DEVELOPMENT | EXTRA_IMAGE_FEATURES_append | tools-sdk | | r1000 | -| ON-TARGET DEBUGGING | EXTRA_IMAGE_FEATURES_append | tools-debug | | r1000 | -| ON-TARGET PROFILING | EXTRA_IMAGE_FEATURES_append | tools-profile | | r1000 | +| Feature | Configuration variable | Configuration values | Default value | Supported BSPs | +|:----------------------|:------------------------------|:---------------------------------------|:--------------|:--------------------| +| VULKAN | INCLUDE_VULKAN | yes, no | no | r1000, v1000 | +| MPV | INCLUDE_MPV | yes, no | no | r1000, v1000 | +| COMMERCIAL MULTIMEDIA | INCLUDE_COMMERCIAL_MULTIMEDIA | yes, no | no | r1000, v1000 | +| MULTI DISPLAY | MULTI_DISPLAY_MODE | auto, mirrored, extended-v, extended-h | auto | r1000, v1000 | +| ON-TARGET DEVELOPMENT | EXTRA_IMAGE_FEATURES_append | tools-sdk | | r1000, v1000, e3000 | +| ON-TARGET DEBUGGING | EXTRA_IMAGE_FEATURES_append | tools-debug | | r1000, v1000, e3000 | +| ON-TARGET PROFILING | EXTRA_IMAGE_FEATURES_append | tools-profile | | r1000, v1000, e3000 | +| RT KERNEL | RT_KERNEL_AMD | yes, no | no | e3000 | #### Example configuration in local.conf ```sh @@ -85,11 +90,15 @@ MULTI_DISPLAY_MODE = "auto" EXTRA_IMAGE_FEATURES_append = " tools-sdk" EXTRA_IMAGE_FEATURES_append = " tools-debug" EXTRA_IMAGE_FEATURES_append = " tools-profile" + +# Please run 'bitbake -c clean virtual/kernel' before configuring RT_KERNEL_AMD +RT_KERNEL_AMD = "yes" ``` --- #### What's next -Continue to [section 2 - build](BUILD.md#23-start-the-build) and -restart the image build as `bitbake <image-name>`, and deploy the -new image to see the changes take effect. +Continue to "Section 2 - Setting up and starting a build" +([BUILD.md](BUILD.md#23-start-the-build)) and restart the image build +as `bitbake <image-name>`, and deploy the new image to see the +changes take effect. |