CEC Linux Driver for SECO X86 Boards

Sources for SECO CEC Driver. Based on Linux CEC Framework. Compiles successfully with Linux Kernel 5.6. For older kernels, please checkout the corresponding tag.

Compatible with:

• UDOO X86 (all versions)

Requirements

• Linux Kernel >= 4.19 with CEC_NOTIFIER support
• UDOO Firmware version >= 1.06 Refer to this page about FW update process.

In order to use the driver, there are several methods:

• Run Linux Kernel >=5.0 with CONFIG_VIDEO_SECO_CEC and, optionally, CONFIG_VIDEO_SECO_RC (for IR) enabled
• Use DKMS (Dynamic Kernel Module System)
• Compile and mount the module manually

DKMS

DKMS is an automatic system for mounting and managing Linux external modules. It is really useful in case of a kernel update or for automounting the module at boot.

# install dependencies (make, git, ecc..)
sudo apt install git build-essential linux-headers-`uname -r` dkms

# clone repo
git clone https://github.com/ektor5/secocec

# go to dir
cd secocec

# create dkms directory
sudo mkdir '/usr/src/secocec-1.0'

# copy files
sudo cp seco-cec.? dkms.conf Makefile '/usr/src/secocec-1.0'

# install module
sudo dkms install secocec/1.0 -k `uname -r`

Now at reboot the module will be mounted automatically.

Compile

# install dependencies (make, git, ecc..)
sudo apt install git build-essential linux-headers-`uname -r`

# clone repo
git clone https://github.com/ektor5/secocec

# go to dir
cd secocec

# compile
make

The module should appear as seco-cec.ko.

Mount

This module depends on the Linux CEC Framework Module, and it needs to be loaded first.

modprobe cec

Note: this module conflicts with the official SMBus driver i2c-i801 and therefore it needs to be blacklisted. On Ubuntu should already be blacklisted.

echo "blacklist i2c-i801" > /etc/modprobe.d/i2c-i801.conf

Load the module:

insmod seco-cec.ko

Done!

Use

To test the device from userspace (/dev/cec0), there are several programs ready to use in v4l-utils tools package (available to install via apt):

• cec-ctl: An application to control cec devices
• cec-compliance: An application to verify remote CEC devices
• cec-follower: An application to emulate CEC followers

Check the corresponding man pages for info.

When loaded, the CEC framework will spawn an RC input device for the RC Passthrough Feature. It can be managed with the IR framework and tools (eg.: ir-keytable).

Consumer IR

The driver manages also the IR receiver, when loaded it will generate automatically an RC input device.

It can be managed via ir-keytable as well.

Debug

To compile the module with debug messages:

make DEBUG=1

Feel free to open issues or mail me directly. Make sure to include dmesg, lsmod, etc.. in the bug report.

Credits

Author: Ettore Chimenti
Thanks to: Hans Verkuil

Copyright (C) 2020, Seco Spa
Copyright (C) 2020, Aidilab