Skip to main content
Ctrl+K
SimpleCore™ 0.0.dev documentation - Home SimpleCore™ 0.0.dev 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
        • Connecting to a device
        • Getting IP information
        • Filtering by section
        • Package details
        • Starting/Stopping a package
        • Configuring a package
        • Viewing API documentation
        • Saving the current configuration
        • Share a link
        • View the source code
        • Add to cart
        • Cart checkout
        • Using the demo wizard
    • SimpleSwitch™-terminal
      • SimpleSwitch™-launcher on the device
      • Windows and Linux app
      • Web Service
      • How to use the SimpleSwitch™-launcher
        • Connecting to a device
        • Getting IP information
        • Filtering by section
        • Package details
        • Starting/Stopping a package
        • Configuring a package
        • Viewing API documentation
        • Saving the current configuration
        • Share a link
        • View the source code
        • Add to cart
        • Cart checkout
        • Using the demo wizard
    • SimpleSwitch™ registry configuration
    • 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
      • I don’t have a physical display available
      • 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 LVGL
      • Build the project using an external tool
    • 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
    • Publish from SDK
      • Publish from command line
      • Publish from Visual Studio code
    • 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_CONFIGURE
        • SIMPLESWITCH_CONFIGURE_CONFIG
        • SIMPLESWITCH_CONFIGURE_MCPSERVER
        • SIMPLESWITCH_CONFIGURE_SCHEMA
        • SIMPLESWITCH_CONFIGURE_STARTUP
        • 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_INSTALL_GSTREAMER
        • SIMPLESWITCH_IS_TERMINAL_APP
        • SIMPLESWITCH_LAUNCHER_SECTIONS
        • SIMPLESWITCH_MAX_USER_SIZE
        • SIMPLESWITCH_NO_SIMPLECOREIO
        • SIMPLESWITCH_NO_SYSTEMD_NOTIFY
        • SIMPLESWITCH_PACKAGE_ADDITIONAL_TERMS
        • SIMPLESWITCH_PICTURE
        • SIMPLESWITCH_REBOOT_REQUIRED
        • SIMPLESWITCH_RECOMMENDED
        • SIMPLESWITCH_STARTUP_COMMAND
        • SIMPLESWITCH_SUPERSEDEDBY
        • SIMPLESWITCH_SYSTEM_REQUIREMENTS
        • SIMPLESWITCH_TERMINAL_VIRT_KEYBOARD
        • 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
      • Dynamically configure SimpleSwitch™ packages
      • Vendoring SimpleSwitch™ images
    • Create a custom SDK
      • SDK extension
      • SDK flavor
      • SDK templates packages
      • Integrate with VSCode
    • Add API documentation
    • 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

Incubator program

  • SimpleCore™ incubator program
    • List of BSP incubators
      • sm2s-imx93
      • sm2s-imx95
    • List of framework incubators
      • Go
      • NodeJS
      • Qt6-Commercial
      • Tauri
    • 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
    • List of hardware showcases
      • NFC
      • Xinli TCXD101IBLM

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
        • Automatically start applications
        • 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
    • How to work with journalctl
      • How to get all the logs with journalctl
      • How to get the logs for a certain time period
      • How to get the logs from a certain severity level
    • How to interact with temperature sensors
    • How to work with RTC (Real Time Clock)
  • 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 2026.1

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
      • Capabilities
      • DeviceInfo
      • GPIOExpander
      • hasNotOverlay
      • hasOverlay
      • hasOverlayOnHW
      • Interactive
      • Manual
      • ManualGPIO
      • needsHWMapFeatureOnHW
      • needsSDK
      • needsSDKFlavor
      • runsNotOn
      • runsOn
      • 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
      • How can I add new words in documentation?
      • 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
      • I have a BSP from the LDK and want to use it
      • 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
  • Service level agreement
  • Step-by-step guide base images
  • Troubleshooting
  • ...
  • base images
  • SDK
  • ...

Troubleshooting#

In case you are facing problems, please see our Troubleshooting guide

See also

  • Getting the IP address of the board
  • I cannot connect the device to my network
  • I don’t have a physical display available
  • Setup the DNS server

previous

Working with multiple displays and SimpleSwitch™

next

Getting the IP address of the board

© Copyright 2025, Tria Technologies GmbH.

Legal Statement
Service level agreement

Created using Sphinx 8.1.3.

Built with the PyData Sphinx Theme 0.16.1.