dwww Home | Manual pages | Find package

CEC-FOLLOWER(1)                  User Commands                  CEC-FOLLOWER(1)

NAME
       cec-follower - An application to emulate CEC followers

SYNOPSIS
       cec-follower [-h] [-d <dev>] [other options]

DESCRIPTION
       The  cec-follower  tool  is  used to emulate CEC followers. Based on the
       configured logical address(es) of the CEC device it will emulate the CEC
       behavior accordingly.

       Configuring the CEC device is done using cec-ctl. Certain CEC  function-
       alities  are  only emulated if the corresponding Device Features flag is
       set (these are set when configuring with cec-ctl). These are:

           - Audio Return Channel (RX and TX)
           - Audio Rate Control
           - Deck Control
           - Record TV screen

       cec-follower is basically a message loop, waiting for messages to arrive
       and taking the appropriate action for each  message  (incoming  messages
       can be shown with the --show-msgs option). The follower maintains an in-
       ternal  state with appropriate parameters such as volume, current active
       source, power state and so on (state  changes  can  be  shown  with  the
       --show-state option).

       It  also  aims to be a reference implementation on how a follower should
       behave.

       cec-follower will keep track of incoming messages and  look  for  viola-
       tions  of the CEC specification with regards to timings. For example, it
       will warn if it receives the same message again within  200ms  after  it
       replied  <Feature Abort> ["Unrecognized Opcode"] to that message, and it
       will check that press and hold behavior is done properly.

       cec-follower will periodically send out  polling  messages  to  discover
       when a remote device is removed or a new one has appeared. When a device
       is  removed,  the recorded information about it is cleared. Each logical
       address is polled about once every 15 seconds. In between polls,  remov-
       ing a remote device or replacing it with a new one is not detected.

       When  running  compliance tests with cec-compliance, cec-follower should
       be run on the same device to act  on  incoming  messages  that  are  not
       replies  to  messages  sent by the compliance tool. Before each test-run
       cec-follower should be restarted if it is running, to initialize the em-
       ulated device with a clean and known initial state.

OPTIONS
       -d, --device <dev>
              Use device <dev> as the CEC device. If <dev> is  a  number,  then
              /dev/cec<dev> is used.

       -D, --driver <drv>
              Use  a  cec device that has driver name <drv>, as returned by the
              CEC_ADAP_G_CAPS ioctl.  This option can be combined  with  -a  to
              uniquely  identify a CEC device without having to rely on the de-
              vice node number.

       -a, --adapter <adap-name>
              Use a cec device that has adapter name <adap-name>,  as  returned
              by  the  CEC_ADAP_G_CAPS ioctl.  This option can be combined with
              -D to uniquely identify a CEC device without having  to  rely  on
              the device node number.

       -v, --verbose
              Turn on verbose reporting.

       --version
              Show version information.

       -w, --wall-clock
              Show  timestamps  as  wall-clock time. This also turns on verbose
              reporting.

       -T, --trace
              Trace all called ioctls. Useful for debugging.

       -h, --help
              Prints the help message.

       -n, --no-warnings
              Turn off warning messages.

       -e, --exclusive
              If   specified,   then   the   follower   uses   exclusive   mode
              (CEC_MODE_EXCL_FOLLOWER).

       -m, --show-msgs
              Show received messages.

       -s, --show-state
              Show state changes from the emulated device.

       --service-by-dig-id
              Report digital services by digital ID instead of by channel.

       --standby
              Start the follower in the Standby status.

       --toggle-power-status <secs>
              Toggle  the  power status every <secs> seconds. Only supported if
              the follower is emulating a TV.

       -i, --ignore <la>,<opcode>
              Ignore messages from logical address <la>  and  opcode  <opcode>.
              'all'  can  be used for <la> or <opcode> to match all logical ad-
              dresses or opcodes.

       --ignore-standby <n>
              Ignore every <n>th received Standby message.

       --ignore-view-on <n>
              Ignore every <n>th received Image/Text View On message.

EXIT STATUS
       On success, it returns 0. Otherwise, it will return the error code.

BUGS
       This manual page is a work in progress.

       Bug reports or questions about this utility should be sent to the linux-
       media@vger.kernel.org mailinglist.

SEE ALSO
       cec-compliance(1), cec-ctl(1)

v4l-utils 1.30.1                  August 2016                   CEC-FOLLOWER(1)

Generated by dwww version 1.16 on Mon Oct 12 00:35:17 CEST 2026.