Skip to main content
Ctrl+K
SimpleCore™ 2025.6 documentation - Home SimpleCore™ 2025.6 documentation - Home
  • SimpleSwitch™
  • Scotty
  • SimpleCore™ Distro
  • SimpleCore™ BSP
  • Github
  • Youtube
  • SimpleSwitch™
  • Scotty
  • SimpleCore™ Distro
  • SimpleCore™ BSP
  • Github
  • Youtube
  • Hardware supported by SimpleCore™

SimpleSwitch

  • What is SimpleSwitch™?
  • Device unboxing
  • Setup your workspace
  • Additional hardware you will need
  • Step-by-step guide base images
    • Base image downloads
    • Flashing a base image
      • Flashing base images (QEMU)
      • Installing to eMMC
      • Automatic resizing of the SDCard
      • SimpleSwitch™ containers on SDCard
    • Configure base board and external hardware
      • Configure base board and external hardware via command line interface
        • Select peripherals support and display (sm2s-imx8mini)
        • Select peripherals support and display (sm2s-imx8nano)
        • Select peripherals support and display (sm2s-imx8plus)
        • Select peripherals support and display (sm2s-imx93)
        • Select peripherals support and display (sm2s-imx95)
        • Select peripherals support and display (Intel SOM)
      • Configure base board and external hardware via SimpleSwitch™-launcher
    • Configure Weston desktop
    • simpleswitch-helper
      • simpleswitch-helper enable/disable
      • simpleswitch-helper install/uninstall
      • simpleswitch-helper interactive
      • simpleswitch-helper log
      • simpleswitch-helper restore
      • simpleswitch-helper run
      • simpleswitch-helper start/stop
      • simpleswitch-helper status
    • container-helper
      • Github container registry (GHCR)
      • Local container registry
    • SimpleCoreIO™
      • Access cameras
      • How to use CAN
      • Access GPIOs
      • How to use I2C
      • Access network
      • How to use SPI
      • Access USB
    • Container downloads and demo applications
    • SimpleSwitch™-launcher
      • SimpleSwitch™-launcher on the device
      • Windows and Linux app
      • Web Service
      • How to use the SimpleSwitch™-launcher
    • Application Notes
      • Working with DBus from a SimpleSwitch™ package
      • Working with multiple displays and SimpleSwitch™
    • Troubleshooting
      • Getting the IP address of the board
      • I cannot connect the device to my network
      • Setup the DNS server
  • Step-by-step guide SDK
    • SDK downloads
    • SDK extensions
    • Getting started with C/C++
      • Build the project using an external tool
    • Getting started with DTS
    • Getting started with Flutter
      • External Flutter packages
    • Getting started with Python
      • External python dependencies
    • Getting started with Qt
      • Register at Qt
      • Start a Qt project
      • Using Qt with a Makefile
      • Using Qt Creator
      • Qt Community Edition
    • Getting started with Rust
    • Getting started with web development
    • SDK tools
      • Generate a SimpleSwitch™ package
        • Autostart
        • Bind mount
        • Debug features
        • Package dependencies
        • Package size
        • Persistent storage
        • Update mode
      • Deploy a SimpleSwitch™ package
      • SimpleSwitch™ logging
      • Manage SimpleSwitch™ packages
      • Remote debug a SimpleSwitch™ package
      • SimpleSwitch™ manifest
        • Autostart a SimpleSwitch™ package
        • SimpleSwitch™ package debug flag
        • Depend on other SimpleSwitch™ packages
        • Mount external files and folders
        • Set SimpleSwitch™ package license
        • Persist user data of a SimpleSwitch™ package
        • Depend on system services (capabilities)
      • Load additional kernel drivers
    • Visual Studio code integration
      • Setup VSCode
      • Create, compile, package and deploy an application
      • Debugging with VSCode
  • SimpleSwitch™ from Yocto
    • Introduction to scotty
    • Build and integrate with Yocto
      • Create your project layer
        • Create a project specific layer
      • Create a recipe
      • Create your own SimpleSwitch™ package
    • SimpleSwitch™ from Yocto
      • SimpleSwitch™ images
        • SIMPLESWITCH_DEBUG
        • SIMPLESWITCH_PACKAGES
      • SimpleSwitch™ packages
        • SIMPLESWITCH_AUTOSTART
        • SIMPLESWITCH_BIND_MOUNTS
        • SIMPLESWITCH_CATEGORIES
        • SIMPLESWITCH_CONFLICTS
        • SIMPLESWITCH_CONTAINER_FORCED_ARCH_EXPAND
        • SIMPLESWITCH_DEPENDENCIES
        • SIMPLESWITCH_INSTALL_COMMAND
        • SIMPLESWITCH_INSTALL_DEJAVU_FONTS_BASE
        • SIMPLESWITCH_INSTALL_DEJAVU_FONTS_CONDENSED
        • SIMPLESWITCH_INSTALL_DISPLAY_DRIVERS
        • SIMPLESWITCH_LAUNCHER_SECTIONS
        • SIMPLESWITCH_MAX_USER_SIZE
        • SIMPLESWITCH_NO_SIMPLECOREIO
        • SIMPLESWITCH_NO_SYSTEMD_NOTIFY
        • SIMPLESWITCH_PACKAGE_ADDITIONAL_TERMS
        • SIMPLESWITCH_PICTURE
        • SIMPLESWITCH_RECOMMENDED
        • SIMPLESWITCH_STARTUP_COMMAND
        • SIMPLESWITCH_SUPERSEDEDBY
        • SIMPLESWITCH_SYSTEM_REQUIREMENTS
        • SIMPLESWITCH_UNINSTALL_COMMAND
        • SIMPLESWITCH_VIDEO_LINK
        • SIMPLESWITCH_XDG_RUNTIME_DIR
      • SimpleSwitch™ out of docker containers
        • DOCKERIMAGE_REGISTRY
      • SimpleSwitch™ docker package
      • Pre-provision your SimpleSwitch™ images
    • Create a custom SDK
      • SDK extension
      • SDK flavor
      • SDK templates packages
      • Integrate with VSCode
    • Install additional packages to the base image
  • From SimpleSwitch™ to production
    • Alice’s product
    • Bob’s product
    • Eve’s product
    • Frank’s product
  • SimpleSwitch™ for Ubuntu

SimpleCore™ tools

  • SimpleCore™ tools
    • Scotty
      • Getting started
      • scotty docker image options
        • SCOTTY_DOCKER_IMAGE
        • Use a scotty release version for development
        • Use the scotty development version
      • Scotty commands
        • bitbake
        • command
        • createlayer
        • docker-update
        • export
        • find
        • foreach
        • freeze
        • generate-docs
        • get-files
        • info
        • recipe-update
        • runqemu
        • setup
        • shell
        • update
        • upgrade
        • version
      • Setup your build
      • Building a full image
      • Using Scotty on Windows
      • scotty-config.yaml
      • Scotty host helper
        • scotty-check-layer-test
        • scotty-data-gen
        • scotty-doc-link-checker
        • scotty-dynamic-matrix
        • scotty-layer-coverage
        • scotty-oeqa-report-enhancer
        • scotty-qa-log-filter
        • scotty-shutdown-check
        • scotty-start-vm
        • scotty-stop-vm
        • scotty-testreport
        • scotty-update-recipes-notification
      • Scotty project specific settings
    • The detect-secrets tool
    • Pre-commit tool
    • libvirt VM bundle tool
    • scotty-test
    • scotty-docker
    • Bumper

Incubator program

  • SimpleCore™ incubator program
    • List of BSP incubators
      • sm2s-imx93
      • sm2s-imx95
    • List of framework incubators
      • Go
      • NodeJS
      • Qt6-Commercial
    • List of ip incubators
      • Chromium
      • Avnet IOTConnect
      • MediaSaver
      • Multiinput
      • SimpleNLP
      • SimpleVoice
      • Multi-language virtual keyboard
      • Captive WiFi portal
    • List of demo incubators
      • Intelligent coffee machine demo
      • RetroArch
      • SimpleCore Games
      • Ticketing machine

SimpleCore distribution

  • SimpleCore™ distribution
  • SimpleCore™ distribution optional features
    • License export
  • HOWTOs
    • How to work with simplecore-distro
      • Getting started with SimpleCore™ distribution
      • Create a project specific layer
      • Flashing and running the image
        • i.MX8 SOCs
        • Apollo Lake or Elkhart Lake SOCs
        • QEMU
        • Flashing from SDcard/USB stick to eMMC
        • Flash using bmaptool
        • Flash using dd
        • Flash using Etcher
      • Create your own DISTRO based on SimpleCore™
      • Get the current Linux kernel configuration
      • Monitor the system load
      • Kernel modules
      • SimpleCore™ application notes
        • Example Recipes
    • How to work with peripherals
      • How to use CAN
      • How to use GPIOs
      • How to check the GPU
      • How to use I2C
      • How to check PCI devices
      • How to use SPI
      • How to use UART
      • How to check USB devices
      • How to use Bluetooth and WiFi
      • How to set the brightness of a screen
      • How to check block devices (eMMC, SDcard, USB storage)
      • How to work with input devices
    • How to work with Weston
      • Configure Weston based desktop
        • desktop-config configuration files
        • desktop-config templates
        • desktop-config launcher configuration
        • desktop-config resolution config
        • desktop-config brightness config
        • desktop-config custom weston configuration
        • Add custom templates and other configuration
      • How to map a touchscreen
      • Debugging Weston
      • Remote Desktop support for weston
      • VNC support for weston
      • Weston application environment
    • How to work with systemd
      • Managing wired connection with systemd-networkd
      • Create a systemd service
      • Manage devices with udev
    • Custom Logos and branding
      • Create you custom logo
        • Set your own logo
        • Fine-tune your custom logo
        • Set logo resolutions
      • System wide rotation settings
  • Application notes
    • Web browsers Comparison
    • Comparing EP5 variants
  • Known issues

SimpleCore™ Mainline BSP

  • SimpleCore™ BSP documentation
    • Known SimpleCore™ BSP issues
  • i.MX8 BSP Layer
    • Configuration
      • sm2s-imx8mini Machine
      • sm2s-imx8nano Machine
      • sm2s-imx8plus Machine
    • Flashing internal eMMC with uuu tool
    • Setting U-Boot’s environment variables
    • How the exact device tree is selected by u-boot
  • Intel BSP Layer
    • Configuration
      • SM2S-INTEL-ALL
  • meta-dts-community

SimpleCore™ BSP IMX95

  • SimpleCore™ BSP IMX95 documentation
    • Known SimpleCore™ BSP issues
  • i.MX95 BSP Layer
    • Configuration
      • sm2s-imx95 Machine

SimpleCore™ BSP IMX93

  • SimpleCore™ BSP IMX93 documentation
    • Known SimpleCore™ BSP issues
  • i.MX93 BSP Layer
    • Configuration
      • sm2s-imx93 Machine

Advanced Manifest topics

  • SimpleCore™ Manifests

Advanced SimpleCore™ tools topics

  • Build matrix in CI
    • Build configuration
    • Specialized configuration
    • Upgrade check configuration
    • Documentation build configuration
  • Test reporting tool
  • Update policy
  • Recipe upgrade check

Changelog

  • Changes in 2025.6

Test report

  • Test Report
    • qemux86-64: simplecore-simpleswitch-os-image test report
    • qemux86-64: simplecore-simpleswitch-os-weston-image test report
    • qemux86-64: simplecore-simpleswitch-sdk test report
    • qemux86-64: simplecore-simpleswitch-test-image test report
    • qemux86-64: simplecore-weston-demo-image test report
    • sm2s-imx8mini: simplecore-simpleswitch-os-image test report
    • sm2s-imx8mini: simplecore-simpleswitch-os-weston-image test report
    • sm2s-imx8mini: simplecore-simpleswitch-sdk test report
    • sm2s-imx8nano: simplecore-simpleswitch-os-image test report
    • sm2s-imx8nano: simplecore-simpleswitch-os-weston-image test report
    • sm2s-imx8nano: simplecore-simpleswitch-sdk test report
    • sm2s-imx8plus: simplecore-simpleswitch-os-image test report
    • sm2s-imx8plus: simplecore-simpleswitch-os-weston-image test report
    • sm2s-imx8plus: simplecore-simpleswitch-sdk test report
    • sm2s-imx93: simplecore-simpleswitch-os-image test report
    • sm2s-imx93: simplecore-simpleswitch-os-weston-image test report
    • sm2s-imx93: simplecore-simpleswitch-sdk test report
    • sm2s-imx95: simplecore-simpleswitch-os-image test report
    • sm2s-imx95: simplecore-simpleswitch-os-weston-image test report
    • sm2s-imx95: simplecore-simpleswitch-sdk test report
    • sm2s-intel-all: simplecore-simpleswitch-os-image test report
    • sm2s-intel-all: simplecore-simpleswitch-os-weston-image test report
    • sm2s-intel-all: simplecore-simpleswitch-sdk test report

Developers guide

  • Developer’s guide
    • scotty in a nutshell
    • A brief guide to testing
      • GPIOExpander
      • hasNotOverlay
      • hasOverlay
      • hasOverlayOnHW
      • Interactive
      • Manual
      • ManualGPIO
      • needsHWMapFeatureOnHW
      • needsSDK
      • needsSDKFlavor
      • skipIfMachineHasHWMapFeature
      • skipIfMachineHasNotHWMapFeature
      • SimpleCoreTestExtensions
      • BoardExtensions
      • ContainerExtensions
      • GPIOExpanderExtensions
      • LauncherExtensions
      • MqttExtensions
      • GraphicalExtensions
      • SDKExtensions
      • TestContainerExtensions
      • UtilityExtensions
    • CI
      • Managing scotty build configurations
      • CI graphs
        • Bumping an application
        • How CI configuration is handled
        • Downstream stream pipeline
      • Upstream, downstream, different types of runners
    • Frequently asked questions
      • I need to patch a 3rd party layer
      • The CI complains about one of my commit messages
      • Why are my merged documentation changes not visible on the server?
      • How can I force a new CI run?
      • I got a pull request assigned for review that I was not working on
      • How can I run all the linter tools locally?
      • Scotty keeps reverting my changes
      • Scotty is missing some tools/libraries
      • I need to patch something in scotty/Sphinx
      • My release version of scotty doesn’t work with the latest sources?
      • Scotty uses outdated sources
      • How can I test my changes to the SDK test cases?
      • How can I test my changes to the test cases?
      • How can I test my documentation changes?
      • How can I test my SDK extension?

Legal

  • Legal statement
  • HOWTOs
  • Custom Logos and branding
  • Create you custom logo
  • Fine-tune your custom logo

Fine-tune your custom logo#

To fine tune your custom logo you can configure the following options out of your custom distribution configuration.

Set the background color#

To change the background color of your weston desktop and the splash screen you can use

LOGO_BACKGROUND_COLOR = "#<RGB color code>"

e.g.

# black background
LOGO_BACKGROUND_COLOR = "#000000"

# white background
LOGO_BACKGROUND_COLOR = "#ffffff"

Set the complementary color#

To change the complementary color used in the splash screen you can use. This color will be used e.g. for the background of the progress bar in the splash screen. It is advised to take the complementary color of LOGO_BACKGROUND_COLOR

LOGO_COMPLEMENTARY_COLOR = "#<RGB color code>"

e.g.

# Loading bar with black foreground
LOGO_COMPLEMENTARY_COLOR = "#000000"

# Loading bar with white foreground
LOGO_BACKGROUND_COLOR = "#ffffff"

Configure the highlight color#

To change the highlight color used in the splash screen you can use. This color will be used e.g. for the foreground color of the progress bar in the splash screen.

LOGO_HIGHLIGHT_COLOR = "#<RGB color code>"

e.g.

# Loading bar with white color
LOGO_BACKGROUND_COLOR = "#ffffff"

# Loading bar with yellow color
LOGO_BACKGROUND_COLOR = "#ffff00"

Set the boot message#

In the splash screen you can set a boot message. Leave empty to disable.

LOGO_BOOT_MESSAGE = "<your message>"

e.g.

LOGO_BOOT_MESSAGE = "Starting my custom distribution..."

Scale the logo#

The images are scaled by default to 50% of available height of the screen size. You can change this factor by editing

LOGO_ASSET_SCALE = "<scaling factor 0.0 - 1.0 >"

e.g.

# will scale your image to 75% of the available height
LOGO_ASSET_SCALE = "0.75"

Specific settings per asset#

By default for all types of generated output the same settings are applied. If you want to configure different settings, you can edit the following variables

For the kernel logo

# scaling factor
_LOGO_ASSET_SCALE_KERNEL = "<0.0 - 1.0>"
# image used for this logo
_LOGO_KERNEL = "<filename>"

For the splash screen

# scaling factor
_LOGO_ASSET_SCALE_SPLASH = "<0.0 - 1.0>"
# image used for this logo
_LOGO_SPLASH = "<filename>"

For the weston desktop background

# scaling factor
_LOGO_ASSET_SCALE_BACKGROUND = "<0.0 - 1.0>"
# image used for this logo
_LOGO_BACKGROUND = "<filename>"

For the weston desktop icon

# scaling factor
_LOGO_ASSET_SCALE_ICON = "<0.0 - 1.0>"
# image used for this logo
_LOGO_ICON = "<filename>"

See also

  • Create your own DISTRO based on SimpleCore™

  • Set logo resolutions

previous

Set your own logo

next

Set logo resolutions

On this page
  • Set the background color
  • Set the complementary color
  • Configure the highlight color
  • Set the boot message
  • Scale the logo
  • Specific settings per asset

© Copyright 2025, Tria Technologies GmbH.

Legal Statement

Created using Sphinx 8.1.3.

Built with the PyData Sphinx Theme 0.16.1.