Testing Guidelines

This routine is non-volatile and takes about 30 minutes

When testing please ensure the display unit is directly connected to the OTTV Set Top Box or SBC with a suitable cable, and not through another device such as an amplifier. This is to reduce the possibility of external interference.

  • Download the latest CoreELEC (Stable, RC, Nightly, Public Alpha or Beta) Test Release
  • Prepare a removable medium ((μ)SD Card or USB Flash Drive) with the Test Release
  • Ensure the correct remote is setup
  • Boot the Test Release from the removable medium
  • Try if all features work:
    • Boot from:
      • SD
      • USB
    • Bluetooth
    • NIC (10/100/1gbit)
    • WiFi
    • Sound (HDMI Pass Through, Optical, Surround,…)
    • Video (720, 1080, 4K,…)
    • SSH
    • SMB
    • USB (ports recognized, inserted media mount,…)
    • CEC
  • Generate a system log and record the link
  • Shutdown the Test Release
  • Remove the (μ)SD Card or USB Flash Drive
  • Post your findings in the End User Forums together with:
    • the generated link(s)
    • the device name (make and model)

Sample Post

I tried CoreELEC Nexus 20.0 Alpha-3 build 2022-10-07 on device Ugoos AM7
I tested CoreELEC and booted successfully from USB using the reset button method
Bluetooth doesn't work
The WiFi connection is slow
Gigabit LAN only connects at 100Mbps
Randomly, the display turns black for a second, then comes back on

If a developper requires more information, would like you to do run some additional tests, or try a custom build, they will reach out to you.

This routine can also be used to troubleshoot your existing CoreELEC installation.

Terminal Sharing

A developper may require access to your device.

In such circumstances, the developper will contact you directly and request to establish a Terminal Sharing session.

Command line tools

The following list of command line tools can be used for troubleshooting CoreELEC:

Command Manual Function
lsattr Link list file attributes on a Linux second extended file system
lscpu Link display information about the CPU architecture
lsusb Link lists USB devices
lsof Link lists information about files opened
lsb_release Link print distribution specific information
lsmod Link show the status of modules in the Linux Kernel
ifconfig Link displays the status of the currently active interfaces
ethtool Link query or control network driver and hardware settings
dmesg Link print the kernel ring buffer
udevadm Link provides simple debugging mechanisms
cputemp display current CPU temperature
dispinfo collect display information with shareable link
| paste generate a shareable output link (eq: dmesg | paste)
udevadm info /sys/bus/sdio/devices/* list devices attached to the sdio bus
kodi-send --action="PlayMedia(/path/to/file.mkv)" play movie file
kodi-send --action="TakeScreenshot" take screenschot (saved in /storage/screenshots)
stress-ng --matrix 0 -t 1m stress test for one minute (network tools need to be installed)
dmesg > /storage/backup/dmesg.log save a local dmesg.log in /storage/backup/