Skip to main content
Ctrl+K
SimpleCore™ 2025.3.3 documentation - Home SimpleCore™ 2025.3.3 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
    • SimpleSwitch™-launcher
    • Configure base board and external hardware
      • Select peripherals support and display (sm2s-imx8mini)
      • Select peripherals support and display (sm2s-imx8nano)
      • Select peripherals support and display (sm2s-imx8plus)
    • Configure Weston desktop
    • simpleswitch-helper
      • simpleswitch-helper enable/disable
      • simpleswitch-helper install/uninstall
      • 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
    • 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
    • Getting started with C/C++
      • External dependencies
      • Package feed
    • Getting started with DTS
      • External dependencies
      • Package feed
    • Getting started with Flutter
      • External dependencies
      • Package feed
    • Getting started with package manager usage
    • Getting started with Python
      • External dependencies
      • Package feed
    • Getting started with Qt
      • External dependencies
      • Package feed
    • Getting started with web development
      • External dependencies
      • Package feed
    • 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
    • SDK extensions
    • Visual Studio code integration
      • Setup VSCode
      • Create, compile, package and deploy an application
      • Debugging with VSCode
  • SimpleSwitch™ from Yocto
    • Build and integrate with Yocto
      • Create your project layer
        • Create a project specific layer
        • Create your project specific image
        • Setup a workspace with project specific layer(s)
        • Create a scotty-config.yaml
      • Create a recipe
    • Create a custom SDK
      • SDK extension
      • SDK flavor
      • SDK templates packages
      • Integrate with VSCode
    • 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
  • 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
      • Running scotty on a different docker image
      • Scotty commands
        • bitbake
        • command
        • 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
    • The detect-secrets tool
    • Pre-commit tool
    • libvirt VM bundle tool
    • scotty-test
    • scotty-docker
    • Bumper

Incubator program

  • SimpleCore™ incubator program
    • Go
    • NodeJS
    • Chromium
    • Avnet IOTConnect
    • MediaSaver
    • Multiinput
    • SimpleVoice
    • Multi-language virtual keyboard
    • Captive WiFi portal
    • 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
      • Create your project specific image
      • Setup a workspace with project specific layer(s)
      • Create a scotty-config.yaml
      • 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
      • SimpleCore™ example images
        • Weston demo image
      • 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
      • 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™ 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

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.3.3

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-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

Legal

  • Legal statement
  • Step-by-step guide base images
  • Troubleshooting

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
  • Setup the DNS server

previous

Working with multiple displays and SimpleSwitch™

next

Getting the IP address of the board

© Copyright 2024, Avnet Embedded GmbH.

Legal Statement

Created using Sphinx 8.1.3.

Built with the PyData Sphinx Theme 0.16.1.