162306a36Sopenharmony_ci.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
262306a36Sopenharmony_ci.. c:namespace:: RC
362306a36Sopenharmony_ci
462306a36Sopenharmony_ci.. _lirc_set_wideband_receiver:
562306a36Sopenharmony_ci
662306a36Sopenharmony_ci********************************
762306a36Sopenharmony_ciioctl LIRC_SET_WIDEBAND_RECEIVER
862306a36Sopenharmony_ci********************************
962306a36Sopenharmony_ci
1062306a36Sopenharmony_ciName
1162306a36Sopenharmony_ci====
1262306a36Sopenharmony_ci
1362306a36Sopenharmony_ciLIRC_SET_WIDEBAND_RECEIVER - enable wide band receiver.
1462306a36Sopenharmony_ci
1562306a36Sopenharmony_ciSynopsis
1662306a36Sopenharmony_ci========
1762306a36Sopenharmony_ci
1862306a36Sopenharmony_ci.. c:macro:: LIRC_SET_WIDEBAND_RECEIVER
1962306a36Sopenharmony_ci
2062306a36Sopenharmony_ci``int ioctl(int fd, LIRC_SET_WIDEBAND_RECEIVER, __u32 *enable)``
2162306a36Sopenharmony_ci
2262306a36Sopenharmony_ciArguments
2362306a36Sopenharmony_ci=========
2462306a36Sopenharmony_ci
2562306a36Sopenharmony_ci``fd``
2662306a36Sopenharmony_ci    File descriptor returned by open().
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ci``enable``
2962306a36Sopenharmony_ci    enable = 1 means enable wideband receiver, enable = 0 means disable
3062306a36Sopenharmony_ci    wideband receiver.
3162306a36Sopenharmony_ci
3262306a36Sopenharmony_ciDescription
3362306a36Sopenharmony_ci===========
3462306a36Sopenharmony_ci
3562306a36Sopenharmony_ciSome receivers are equipped with special wide band receiver which is
3662306a36Sopenharmony_ciintended to be used to learn output of existing remote. This ioctl
3762306a36Sopenharmony_ciallows enabling or disabling it.
3862306a36Sopenharmony_ci
3962306a36Sopenharmony_ciThis might be useful of receivers that have otherwise narrow band receiver
4062306a36Sopenharmony_cithat prevents them to be used with some remotes. Wide band receiver might
4162306a36Sopenharmony_cialso be more precise. On the other hand its disadvantage it usually
4262306a36Sopenharmony_cireduced range of reception.
4362306a36Sopenharmony_ci
4462306a36Sopenharmony_ci.. note::
4562306a36Sopenharmony_ci
4662306a36Sopenharmony_ci    Wide band receiver might be implicitly enabled if you enable
4762306a36Sopenharmony_ci    carrier reports. In that case it will be disabled as soon as you disable
4862306a36Sopenharmony_ci    carrier reports. Trying to disable wide band receiver while carrier
4962306a36Sopenharmony_ci    reports are active will do nothing.
5062306a36Sopenharmony_ci
5162306a36Sopenharmony_ciReturn Value
5262306a36Sopenharmony_ci============
5362306a36Sopenharmony_ci
5462306a36Sopenharmony_ciOn success 0 is returned, on error -1 and the ``errno`` variable is set
5562306a36Sopenharmony_ciappropriately. The generic error codes are described at the
5662306a36Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter.
57