Usage:
-A, --list-devices List all cec devices
-d, --device <dev> Use device <dev> instead of /dev/cec0
If <dev> starts with a digit, then /dev/cec<dev> is used.
-D, --driver <driver> Use a cec device with this driver name
-a, --adapter <adapter> Use a cec device with this adapter name
-p, --phys-addr <addr> Use this physical address
-e, --phys-addr-from-edid <path>
Set physical address from this EDID file
-E, --phys-addr-from-edid-poll <path>
Continuously poll the EDID file for changes, and update the
physical address whenever there is a change
-o, --osd-name <name> Use this OSD name
-V, --vendor-id <id> Use this vendor ID
-x, --physical-address Show the physical address
-l, --logical-address Show first configured logical address
-L, --logical-addresses Show all configured logical addresses
-C, --clear Clear all logical addresses
-n, --no-reply Toggle 'don't wait for a reply'
-N, --non-blocking Transmit messages in non-blocking mode
-t, --to <la> Send message to the given logical address
-f, --from <la> Send message from the given logical address
By default use the first assigned logical address
-r, --show-raw Show the raw CEC message (hex values)
-s, --skip-info Skip Driver Info output
-S, --show-topology Show the CEC topology
-P, --poll Send poll message
-h, --help Display this help message
--help-all Show all help messages
-T, --trace Trace all called ioctls
-v, --verbose Turn on verbose reporting
--version Show version information
-w, --wall-clock Show timestamps as wall-clock time (implies -v)
-W, --wait-for-msgs Wait for messages and events for up to --monitor-time secs.
--cec-version-1.4 Use CEC Version 1.4 instead of 2.0
--allow-unreg-fallback Allow fallback to Unregistered
--no-rc-passthrough Disable the RC passthrough
--reply-to-followers The reply will be sent to followers as well
--raw-msg Transmit the message without validating it (must be root)
--timeout <ms> Set the reply timeout in milliseconds (default is 1000 ms)
--tv This is a TV
--record This is a recording and playback device
--tuner This is a tuner device
--playback This is a playback device
--audio This is an audio system device
--processor This is a processor device
--switch This is a pure CEC switch
--cdc-only This is a CDC-only device
--unregistered This is an unregistered device
--feat-record-tv-screen Signal the Record TV Screen feature
--feat-set-osd-string Signal the Set OSD String feature
--feat-deck-control Signal the Deck Control feature
--feat-set-audio-rate Signal the Set Audio Rate feature
--feat-sink-has-arc-tx Signal the sink ARC Tx feature
--feat-source-has-arc-rx Signal the source ARC Rx feature
--rc-tv-profile-1 Signal RC TV Profile 1
--rc-tv-profile-2 Signal RC TV Profile 2
--rc-tv-profile-3 Signal RC TV Profile 3
--rc-tv-profile-4 Signal RC TV Profile 4
--rc-src-dev-root Signal that the RC source has a Dev Root Menu
--rc-src-dev-setup Signal that the RC source has a Dev Setup Menu
--rc-src-contents Signal that the RC source has a Contents Menu
--rc-src-media-top Signal that the RC source has a Media Top Menu
--rc-src-media-context Signal that the RC source has a Media Context Menu
-m, --monitor Monitor CEC traffic
-M, --monitor-all Monitor all CEC traffic
--monitor-pin Monitor low-level CEC pin
--monitor-time <secs> Monitor for <secs> seconds (default is forever)
--ignore <la>,<opcode> Ignore messages from logical address <la> and opcode
<opcode> when monitoring. 'all' can be used for <la>
or <opcode> to match all logical addresses or opcodes.
To ignore poll messages use 'poll' as <opcode>.
--store-pin <to> Store the low-level CEC pin changes to the file <to>.
Use - for stdout.
--analyze-pin <from> Analyze the low-level CEC pin changes from the file <from>.
Use - for stdin.
--test-reliability <secs>
Test CEC line reliability. It continuously transmits <Give Physical Address>
for <secs> seconds, checking that the broadcast reply is always the same.
If <secs> is 0, then keep trying forever.
--test-standby-wakeup-cycle [polls=<n>][,sleep=<secs>][,hpd-may-be-low=<0/1>]
Test standby-wakeup cycle behavior of the display. It polls up to
<n> times (default 15), waiting for a state change. If
that fails it waits <secs> seconds (default 10) before
retrying this.
If <hpd-may-be-low> is 1, then the HPD is allowed to be low when in standby.
--stress-test-standby-wakeup-cycle cnt=<count>[,polls=<n>][,max-sleep=<maxsecs>][,min-sleep=<minsecs>][,seed=<seed>][,repeats=<reps>][,sleep-before-on=<secs1>][,sleep-before-off=<secs2>][,hpd-may-be-low=<0/1>]
Standby-Wakeup cycle display <count> times. If 0, then never stop.
It polls up to <n> times (default 30), waiting for a state change.
If <maxsecs> is non-zero (0 is the default), then sleep for
a random number of seconds between <minsecs> (0 is the default) and <maxsecs>
before each <Standby> or <Image View On> message.
If <seed> is specified, then set the randomizer seed to
that value instead of using the current time as seed.
If <reps> is specified, then repeat the <Image View On> and
<Standby> up to <reps> times. Note: should not be needed!
If <secs1> is specified, then sleep for <secs1> seconds
before transmitting <Image View On>.
If <secs2> is specified, then sleep for <secs2> seconds
before transmitting <Standby>.
If <hpd-may-be-low> is 1, then the HPD is allowed to be low when in standby.
--stress-test-random-standby-wakeup-cycle cnt=<count>[,max-sleep=<maxsecs>][,min-sleep=<minsecs>][,seed=<seed>][,hpd-may-be-low=<0/1>]
Randomly transmit <Standby> or <Image View On> up to <count> times.
If <count> is 0, then never stop. After each transmit wait between
<min-sleep> (default 0) and <max-sleep> (default 10) seconds.
If <seed> is specified, then set the randomizer seed to
that value instead of using the current time as seed.
If <hpd-may-be-low> is 1, then the HPD is allowed to be low when in standby.
This test does not check if the display reached the new state,
it checks if the display can handle this situation without
locking up. After every 10 cycles it attempts to properly
wake up the display and check if that works. If not, this test fails.
--help-abort Show help for the Abort feature
--help-audio-rate-control Show help for the Audio Rate Control feature
--help-audio-return-channel-control Show help for the Audio Return Channel Control feature
--help-capability-discovery-and-control Show help for the Capability Discovery and Control feature
--help-deck-control Show help for the Deck Control feature
--help-device-menu-control Show help for the Device Menu Control feature
--help-device-osd-transfer Show help for the Device OSD Transfer feature
--help-dynamic-audio-lipsync Show help for the Dynamic Audio Lipsync feature
--help-htng Show help for the HTNG feature
--help-osd-display Show help for the OSD Display feature
--help-one-touch-play Show help for the One Touch Play feature
--help-one-touch-record Show help for the One Touch Record feature
--help-power-status Show help for the Power Status feature
--help-remote-control-passthrough Show help for the Remote Control Passthrough feature
--help-routing-control Show help for the Routing Control feature
--help-standby Show help for the Standby feature
--help-system-audio-control Show help for the System Audio Control feature
--help-system-information Show help for the System Information feature
--help-timer-programming Show help for the Timer Programming feature
--help-tuner-control Show help for the Tuner Control feature
--help-vendor-specific-commands Show help for the Vendor Specific Commands feature
--custom-command cmd=<byte>[,payload=<byte>[:<byte>]*]
Send custom message
Options (91)
| Option | Description | Source |
|---|---|---|
-A, --list-devices | List all cec devices. | help + man |
-d, --device dev | Use device <dev> instead of /dev/cec0 If <dev> starts with a digit, then /dev/cec<dev> is used. | help + man |
-D, --driver driver | Use a cec device that has driver name <drv>, as returned by the CEC_ADAP_G_CAPS ioctl. | help + man |
-a, --adapter adapter | Use a cec device that has adapter name <adap-name>, as returned by the CEC_ADAP_G_CAPS ioctl. | help + man |
-p, --phys-addr addr | Use this physical address. | help + man |
-e, --phys-addr-from-edid path | Parse the given EDID file (in raw binary format) and extract the physical address. | help + man |
-E, --phys-addr-from-edid-poll path | Continuously poll the EDID file for changes, and update the physical address whenever there is a change | help + man |
-o, --osd-name name | Use this OSD name. | help + man |
-V, --vendor-id id | Use this vendor ID. | help + man |
-x, --physical-address | Show the physical address. | help + man |
-l, --logical-address | Show first configured logical address or nothing if the device is unconfigured. | help + man |
-L, --logical-addresses | Show all configured logical addresses or nothing if the device is unconfigured. | help + man |
-C, --clear | Clear all logical addresses, leaving the CEC device unconfigured. | help + man |
-n, --no-reply | By default when sending a CEC message that expects a reply this utility will wait for that reply. | help + man |
-N, --non-blocking | Transmit messages in non-blocking mode. | help + man |
-t, --to la | Send the message to the given logical address (0-15). | help + man |
-f, --from la | Send message from the given logical address By default use the first assigned logical address | help + man |
-r, --show-raw | Show the raw CEC message (hex values) | help + man |
-s, --skip-info | Skip the Driver Info output section. | help + man |
-S, --show-topology | Show the CEC topology, detecting which other CEC devices are on the CEC bus. | help + man |
-P, --poll | Send a poll message. | help + man |
-h, --help | Display this help message | help + man |
--help-all | Prints the help message for all options. | help + man |
-T, --trace | Trace all called ioctls. | help + man |
-v, --verbose | Turn on verbose reporting. | help + man |
--version | Show version information. | help + man |
-w, --wall-clock | Show timestamps as wall-clock time (implies -v) | help + man |
-W, --wait-for-msgs | Wait for messages and events for up to --monitor-time secs. | help |
--cec-version-1.4 | Use CEC Version 1.4 instead of 2.0 (the default). | help + man |
--allow-unreg-fallback | Allow fallback to Unregistered if all logical addresses are claimed. | help + man |
--no-rc-passthrough | Disable the RC passthrough. | help + man |
--reply-to-followers | The reply will be sent to followers as well. | help + man |
--raw-msg | Transmit the message without validating it (must be root) | help |
--timeout ms | Set the reply timeout in milliseconds (default is 1000 ms). | help + man |
--tv | Configure the CEC adapter as a TV. | help + man |
--record | Configure the CEC adapter as a recording and playback device. | help + man |
--tuner | Configure the CEC adapter as a tuner device. | help + man |
--playback | Configure the CEC adapter as a playback device. | help + man |
--audio | Configure the CEC adapter as an audio system device. | help + man |
--processor | Configure the CEC adapter as a processor device. | help + man |
--switch | Configure the CEC adapter as a pure CEC switch. | help + man |
--cdc-only | Configure the CEC adapter as a CDC-only device. | help + man |
--unregistered | Configure the CEC adapter as an unregistered device. | help + man |
--feat-record-tv-screen | Signal the Record TV Screen feature. | help + man |
--feat-set-osd-string | Signal the Set OSD String feature. | help + man |
--feat-deck-control | Signal the Deck Control feature. | help + man |
--feat-set-audio-rate | Signal the Set Audio Rate feature. | help + man |
--feat-sink-has-arc-tx | Signal the sink ARC Tx feature. | help + man |
--rc-tv-profile-1 | Signal RC TV Profile 1. | help + man |
--rc-tv-profile-2 | Signal RC TV Profile 2. | help + man |
--rc-tv-profile-3 | Signal RC TV Profile 3. | help + man |
--rc-tv-profile-4 | Signal RC TV Profile 4. | help + man |
--rc-src-dev-root | Signal that the RC source has a Dev Root Menu. | help + man |
--rc-src-dev-setup | Signal that the RC source has a Dev Setup Menu. | help + man |
--rc-src-contents | Signal that the RC source has a Contents Menu. | help + man |
--rc-src-media-top | Signal that the RC source has a Media Top Menu. | help + man |
--rc-src-media-context | Signal that the RC source has a Media Context Menu. | help + man |
-m, --monitor | Start monitoring CEC traffic. | help + man |
-M, --monitor-all | Start monitoring all CEC traffic. | help + man |
--monitor-pin | Start monitoring and analyzing the low-level CEC pin transitions. | help + man |
--monitor-time secs | Monitor for the given number of seconds, then exit. | help + man |
--ignore la | Ignore messages from logical address <la> and opcode <opcode> when monitoring. | help + man |
--store-pin to | Store the low-level CEC pin changes to the file <to>. | help + man |
--analyze-pin from | Analyze the low-level CEC pin changes from the file <from>. | help + man |
--test-reliability secs | This option tests the CEC reliability by transmitting <Give Physical Addr> up to <secs> seconds (or forever if <secs> is 0) and check if the reply is always the same. | help + man |
--test-standby-wakeup-cycle polls=<n | Test standby-wakeup cycle behavior of the display. | help |
--stress-test-standby-wakeup-cycle cnt=<count | Standby-Wakeup cycle display <count> times. | help |
--stress-test-random-standby-wakeup-cycle cnt=<count | Randomly transmit <Standby> or <Image View On> up to <count> times. | help |
--help-abort | Show help for the Abort feature | help |
--help-audio-rate-control | Show help for the Audio Rate Control feature. | help + man |
--help-deck-control | Show help for the Deck Control feature. | help + man |
--help-device-menu-control | Show help for the Device Menu Control feature. | help + man |
--help-device-osd-transfer | Show help for the Device OSD Transfer feature. | help + man |
--help-dynamic-audio-lipsync | Show help for the Dynamic Audio Lipsync feature. | help + man |
--help-htng | Show help for the Hospitality Profile Next Generation feature. | help + man |
--help-osd-display | Show help for the OSD Display feature. | help + man |
--help-one-touch-play | Show help for the One Touch Play feature. | help + man |
--help-one-touch-record | Show help for the One Touch Record feature. | help + man |
--help-power-status | Show help for the Power Status feature. | help + man |
--help-remote-control-passthrough | Show help for the Remote Control Passthrough feature. | help + man |
--help-routing-control | Show help for the Routing Control feature. | help + man |
--help-standby | Show help for the Standby feature. | help + man |
--help-system-audio-control | Show help for the System Audio Control feature. | help + man |
--help-system-information | Show help for the System Information feature. | help + man |
--help-timer-programming | Show help for the Timer Programming feature. | help + man |
--help-tuner-control | Show help for the Tuner Control feature. | help + man |
--help-vendor-specific-commands | Show help for the Vendor Specific Commands feature. | help + man |
--custom-command cmd=<byte | Send custom message | help |
--feat-source-has-arc-rx | Signal the source ARC Rx feature. (in the manual page but not in --help) | man |
--help-audio-return-channel-control | Show help for the Audio Return Channel Control feature. (in the manual page but not in --help) | man |
--help-capability-discovery-and-control | Show help for the Capability Discovery and Control feature. (in the manual page but not in --help) | man |