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 Log: http://ix.io/4cBL
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:
CoreELEC Terminal
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 |
Command lines and scripts
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/ |