Lines Matching +full:hardware +full:- +full:wise
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later OR GPL-2.0
15 hardware. It can be accessed through ``/dev/dvb/adapter?/audio?``. Data
35 -----
39 ---------------------
46 .. code-block:: c
56 .. flat-table::
57 :header-rows: 0
58 :stub-columns: 0
60 - ..
62 - ``AUDIO_SOURCE_DEMUX``
64 - :cspan:`1` Selects the demultiplexer (fed either by the frontend
67 - ..
69 - ``AUDIO_SOURCE_MEMORY``
71 - Selects the stream from the application that comes through
81 The data fed to the decoder is also controlled by the PID-filter.
85 -----
89 ------------------
96 .. code-block:: c
107 .. flat-table::
108 :header-rows: 0
109 :stub-columns: 0
111 - ..
113 - ``AUDIO_STOPPED``
115 - Audio is stopped.
117 - ..
119 - ``AUDIO_PLAYING``
121 - Audio is currently playing.
123 - ..
125 - ``AUDIO_PAUSE``
127 - Audio is frozen.
136 -----
140 ----------------------
147 .. code-block:: c
160 .. flat-table::
161 :header-rows: 0
162 :stub-columns: 0
164 - ..
166 - ``AUDIO_STEREO``
168 - Stereo.
170 - ..
172 - ``AUDIO_MONO_LEFT``
174 - Mono, select left stereo channel as source.
176 - ..
178 - ``AUDIO_MONO_RIGHT``
180 - Mono, select right stereo channel as source.
182 - ..
184 - ``AUDIO_MONO``
186 - Mono source only.
188 - ..
190 - ``AUDIO_STEREO_SWAPPED``
192 - Stereo, swap L & R.
201 -----
205 -------------
212 .. code-block:: c
222 .. flat-table::
223 :header-rows: 0
224 :stub-columns: 0
226 - ..
228 - ``unsigned int volume_left``
230 - Volume left channel.
233 - ..
235 - ``unsigned int volume_right``
237 - Volume right channel.
247 -----
251 ------------
258 .. code-block:: c
273 .. flat-table::
274 :header-rows: 0
275 :stub-columns: 0
277 - ..
279 - :rspan:`2` ``int AV_sync_state``
281 - :cspan:`1` Shows if A/V synchronization is ON or OFF.
283 - ..
285 - TRUE ( != 0 )
287 - AV-sync ON.
289 - ..
291 - FALSE ( == 0 )
293 - AV-sync OFF.
295 - ..
297 - :rspan:`2` ``int mute_state``
299 - :cspan:`1` Indicates if audio is muted or not.
301 - ..
303 - TRUE ( != 0 )
305 - mute audio
307 - ..
309 - FALSE ( == 0 )
311 - unmute audio
313 - ..
315 - `audio_play_state_t`_ ``play_state``
317 - Current playback state.
319 - ..
321 - `audio_stream_source_t`_ ``stream_source``
323 - Current source of the data.
325 - ..
327 - :rspan:`2` ``int bypass_mode``
329 - :cspan:`1` Is the decoding of the current Audio stream in
332 - ..
334 - TRUE ( != 0 )
336 - Bypass disabled.
338 - ..
340 - FALSE ( == 0 )
342 - Bypass enabled.
344 - ..
346 - `audio_mixer_t`_ ``mixer_state``
348 - Current volume settings.
357 -----
361 ---------------
366 .. code-block:: c
381 .. flat-table::
382 :header-rows: 0
383 :stub-columns: 0
385 - ..
387 - ``AUDIO_CAP_DTS``
389 - :cspan:`1` The hardware accepts DTS audio tracks.
391 - ..
393 - ``AUDIO_CAP_LPCM``
395 - The hardware accepts uncompressed audio with
396 Linear Pulse-Code Modulation (LPCM)
398 - ..
400 - ``AUDIO_CAP_MP1``
402 - The hardware accepts MPEG-1 Audio Layer 1.
404 - ..
406 - ``AUDIO_CAP_MP2``
408 - The hardware accepts MPEG-1 Audio Layer 2.
411 - ..
413 - ``AUDIO_CAP_MP3``
415 - The hardware accepts MPEG-1 Audio Layer III.
418 - ..
420 - ``AUDIO_CAP_AAC``
422 - The hardware accepts AAC (Advanced Audio Coding).
424 - ..
426 - ``AUDIO_CAP_OGG``
428 - The hardware accepts Vorbis audio tracks.
430 - ..
432 - ``AUDIO_CAP_SDDS``
434 - The hardware accepts Sony Dynamic Digital Sound (SDDS).
436 - ..
438 - ``AUDIO_CAP_AC3``
440 - The hardware accepts Dolby Digital ATSC A/52 audio.
441 Also known as AC-3.
450 -----
458 ----------
465 .. code-block:: c
472 .. flat-table::
473 :header-rows: 0
474 :stub-columns: 0
476 - ..
478 - ``int fd``
480 - File descriptor returned by a previous call to `open()`_.
482 - ..
484 - ``int request``
486 - :cspan:`1` Equals ``AUDIO_STOP`` for this command.
500 On success 0 is returned, on error -1 and the ``errno`` variable is set
502 :ref:`Generic Error Codes <gen-errors>` chapter.
505 -----
509 ----------
516 .. code-block:: c
523 .. flat-table::
524 :header-rows: 0
525 :stub-columns: 0
527 - ..
529 - ``int fd``
531 - File descriptor returned by a previous call to `open()`_.
533 - ..
535 - ``int request``
537 - :cspan:`1` Equals ``AUDIO_PLAY`` for this command.
551 On success 0 is returned, on error -1 and the ``errno`` variable is set
553 :ref:`Generic Error Codes <gen-errors>` chapter.
556 -----
560 -----------
567 .. code-block:: c
574 .. flat-table::
575 :header-rows: 0
576 :stub-columns: 0
578 - ..
580 - ``int fd``
582 - :cspan:`1` File descriptor returned by a previous call
585 - ..
587 - ``int request``
589 - Equals ``AUDIO_PAUSE`` for this command.
604 On success 0 is returned, on error -1 and the ``errno`` variable is set
606 :ref:`Generic Error Codes <gen-errors>` chapter.
609 -----
613 --------------
620 .. code-block:: c
627 .. flat-table::
628 :header-rows: 0
629 :stub-columns: 0
631 - ..
633 - ``int fd``
635 - :cspan:`1` File descriptor returned by a previous call
638 - ..
640 - ``int request``
642 - Equals ``AUDIO_CONTINUE`` for this command.
656 On success 0 is returned, on error -1 and the ``errno`` variable is set
658 :ref:`Generic Error Codes <gen-errors>` chapter.
661 -----
665 -------------------
672 .. code-block:: c
680 .. flat-table::
681 :header-rows: 0
682 :stub-columns: 0
684 - ..
686 - ``int fd``
688 - :cspan:`1` File descriptor returned by a previous call
691 - ..
693 - ``int request``
695 - Equals ``AUDIO_SELECT_SOURCE`` for this command.
697 - ..
699 - `audio_stream_source_t`_ ``source``
701 - Indicates the source that shall be used for the Audio stream.
713 is directly transferred from the onboard demux-device to the decoder.
714 Note: This only supports DVB-devices with one demux and one decoder so far.
719 On success 0 is returned, on error -1 and the ``errno`` variable is set
721 :ref:`Generic Error Codes <gen-errors>` chapter.
724 -----
728 --------------
735 .. code-block:: c
742 .. flat-table::
743 :header-rows: 0
744 :stub-columns: 0
746 - ..
748 - ``int fd``
750 - :cspan:`1` File descriptor returned by a previous call
753 - ..
755 - ``int request``
757 - :cspan:`1` Equals ``AUDIO_SET_MUTE`` for this command.
759 - ..
761 - :rspan:`2` ``int state``
763 - :cspan:`1` Indicates if audio device shall mute or not.
765 - ..
767 - TRUE ( != 0 )
769 - mute audio
771 - ..
773 - FALSE ( == 0 )
775 - unmute audio
793 On success 0 is returned, on error -1 and the ``errno`` variable is set
795 :ref:`Generic Error Codes <gen-errors>` chapter.
798 -----
802 -----------------
809 .. code-block:: c
816 .. flat-table::
817 :header-rows: 0
818 :stub-columns: 0
820 - ..
822 - ``int fd``
824 - :cspan:`1` File descriptor returned by a previous call
827 - ..
829 - ``int request``
831 - :cspan:`1` Equals ``AUDIO_AV_SYNC`` for this command.
833 - ..
835 - :rspan:`2` ``int state``
837 - :cspan:`1` Tells the DVB subsystem if A/V synchronization
840 - ..
842 - TRUE ( != 0 )
844 - AV-sync ON.
846 - ..
848 - FALSE ( == 0 )
850 - AV-sync OFF.
864 On success 0 is returned, on error -1 and the ``errno`` variable is set
866 :ref:`Generic Error Codes <gen-errors>` chapter.
869 -----
873 ---------------------
880 .. code-block:: c
887 .. flat-table::
888 :header-rows: 0
889 :stub-columns: 0
891 - ..
893 - ``int fd``
895 - :cspan:`1` File descriptor returned by a previous call
898 - ..
900 - ``int request``
902 - :cspan:`1` Equals ``AUDIO_SET_BYPASS_MODE`` for this command.
904 - ..
906 - :rspan:`2` ``int mode``
908 - :cspan:`1` Enables or disables the decoding of the current
910 - ..
912 - TRUE ( != 0 )
914 - Disable bypass
916 - ..
918 - FALSE ( == 0 )
920 - Enable bypass
932 the hardware can handle it.
937 On success 0 is returned, on error -1 and the ``errno`` variable is set
939 :ref:`Generic Error Codes <gen-errors>` chapter.
942 -----
946 --------------------
953 .. code-block:: c
961 .. flat-table::
962 :header-rows: 0
963 :stub-columns: 0
965 - ..
967 - ``int fd``
969 - :cspan:`1` File descriptor returned by a previous call
972 - ..
974 - ``int request``
976 - Equals ``AUDIO_CHANNEL_SELECT`` for this command.
978 - ..
980 - `audio_channel_select_t`_ ``ch``
982 - Select the output format of the audio (mono left/right, stereo).
999 On success 0 is returned, on error -1 and the ``errno`` variable is set
1001 :ref:`Generic Error Codes <gen-errors>` chapter.
1004 -----
1008 ----------------
1015 .. code-block:: c
1023 .. flat-table::
1024 :header-rows: 0
1025 :stub-columns: 0
1027 - ..
1029 - ``int fd``
1031 - :cspan:`1` File descriptor returned by a previous call
1034 - ..
1036 - ``int request``
1038 - Equals AUDIO_GET_STATUS for this command.
1040 - ..
1042 - ``struct`` `audio_status`_ ``*status``
1044 - Returns the current state of Audio Device.
1058 On success 0 is returned, on error -1 and the ``errno`` variable is set
1060 :ref:`Generic Error Codes <gen-errors>` chapter.
1063 -----
1067 ----------------------
1074 .. code-block:: c
1082 .. flat-table::
1083 :header-rows: 0
1084 :stub-columns: 0
1086 - ..
1088 - ``int fd``
1090 - :cspan:`1` File descriptor returned by a previous call
1093 - ..
1095 - ``int request``
1097 - Equals ``AUDIO_GET_CAPABILITIES`` for this command.
1099 - ..
1101 - ``unsigned int *cap``
1103 - Returns a bit array of supported sound formats.
1113 capabilities of the audio hardware.
1118 On success 0 is returned, on error -1 and the ``errno`` variable is set
1120 :ref:`Generic Error Codes <gen-errors>` chapter.
1123 -----
1127 ------------------
1134 .. code-block:: c
1141 .. flat-table::
1142 :header-rows: 0
1143 :stub-columns: 0
1145 - ..
1147 - ``int fd``
1149 - :cspan:`1` File descriptor returned by a previous call
1152 - ..
1154 - ``int request``
1156 - Equals ``AUDIO_CLEAR_BUFFER`` for this command.
1164 This ioctl call asks the Audio Device to clear all software and hardware
1170 On success 0 is returned, on error -1 and the ``errno`` variable is set
1172 :ref:`Generic Error Codes <gen-errors>` chapter.
1175 -----
1179 ------------
1186 .. code-block:: c
1193 .. flat-table::
1194 :header-rows: 0
1195 :stub-columns: 0
1197 - ..
1199 - ``int fd``
1201 - :cspan:`1` File descriptor returned by a previous call
1204 - ..
1206 - ``int request``
1208 - Equals ``AUDIO_SET_ID`` for this command.
1210 - ..
1212 - ``int id``
1214 - Audio sub-stream id.
1222 This ioctl selects which sub-stream is to be decoded if a program or
1227 See ITU-T H.222.0 | ISO/IEC 13818-1 for further description.
1230 id just the sub-stream id of the audio stream and only the first 5 bits
1236 On success 0 is returned, on error -1 and the ``errno`` variable is set
1238 :ref:`Generic Error Codes <gen-errors>` chapter.
1241 -----
1245 ---------------
1252 .. code-block:: c
1259 .. flat-table::
1260 :header-rows: 0
1261 :stub-columns: 0
1263 - ..
1265 - ``int fd``
1267 - :cspan:`1` File descriptor returned by a previous call
1270 - ..
1272 - ``int request``
1274 - Equals ``AUDIO_SET_MIXER`` for this command.
1276 - ..
1278 - ``audio_mixer_t *mix``
1280 - Mixer settings.
1293 On success 0 is returned, on error -1 and the ``errno`` variable is set
1295 :ref:`Generic Error Codes <gen-errors>` chapter.
1298 -----
1302 --------------------
1309 .. code-block:: c
1316 .. flat-table::
1317 :header-rows: 0
1318 :stub-columns: 0
1320 - ..
1322 - ``int fd``
1324 - :cspan:`1` File descriptor returned by a previous call
1327 - ..
1329 - ``int request``
1331 - Equals ``AUDIO_SET_STREAMTYPE`` for this command.
1333 - ..
1335 - ``int type``
1337 - Stream type.
1346 is useful if the stream offers several audio sub-streams like LPCM and
1349 Stream types defined in ITU-T H.222.0 | ISO/IEC 13818-1 are used.
1355 On success 0 is returned, on error -1 and the ``errno`` variable is set
1357 :ref:`Generic Error Codes <gen-errors>` chapter.
1359 .. flat-table::
1360 :header-rows: 0
1361 :stub-columns: 0
1363 - ..
1365 - ``EINVAL``
1367 - Type is not a valid or supported stream type.
1370 -----
1374 ------------------------------
1381 .. code-block:: c
1389 .. flat-table::
1390 :header-rows: 0
1391 :stub-columns: 0
1393 - ..
1395 - ``int fd``
1397 - :cspan:`1` File descriptor returned by a previous call
1400 - ..
1402 - ``int request``
1404 - Equals ``AUDIO_BILINGUAL_CHANNEL_SELECT`` for this command.
1406 - ..
1408 - ``audio_channel_select_t ch``
1410 - Select the output format of the audio (mono left/right, stereo).
1428 On success 0 is returned, on error -1 and the ``errno`` variable is set
1430 :ref:`Generic Error Codes <gen-errors>` chapter.
1433 -----
1437 ------
1442 .. code-block:: c
1451 .. flat-table::
1452 :header-rows: 0
1453 :stub-columns: 0
1455 - ..
1457 - ``const char *deviceName``
1459 - Name of specific audio device.
1461 - ..
1463 - :rspan:`3` ``int flags``
1465 - :cspan:`1` A bit-wise OR of the following flags:
1467 - ..
1469 - ``O_RDONLY``
1471 - read-only access
1473 - ..
1475 - ``O_RDWR``
1477 - read/write access
1479 - ..
1481 - ``O_NONBLOCK``
1482 - | Open in non-blocking mode
1491 blocking or non-blocking mode is described in the documentation for
1494 put into non-blocking mode (and vice versa) using the F_SETFL command
1505 .. flat-table::
1506 :header-rows: 0
1507 :stub-columns: 0
1509 - ..
1511 - ``ENODEV``
1513 - Device driver not loaded/available.
1515 - ..
1517 - ``EBUSY``
1519 - Device or resource busy.
1521 - ..
1523 - ``EINVAL``
1525 - Invalid argument.
1528 -----
1532 -------
1542 .. flat-table::
1543 :header-rows: 0
1544 :stub-columns: 0
1546 - ..
1548 - ``int fd``
1550 - :cspan:`1` File descriptor returned by a previous call
1561 .. flat-table::
1562 :header-rows: 0
1563 :stub-columns: 0
1565 - ..
1567 - ``EBADF``
1569 - Fd is not a valid open file descriptor.
1571 -----
1575 -------
1580 .. code-block:: c
1587 .. flat-table::
1588 :header-rows: 0
1589 :stub-columns: 0
1591 - ..
1593 - ``int fd``
1595 - :cspan:`1` File descriptor returned by a previous call
1598 - ..
1600 - ``void *buf``
1602 - Pointer to the buffer containing the PES data.
1604 - ..
1606 - ``size_t count``
1608 - Size of buf.
1622 .. flat-table::
1623 :header-rows: 0
1624 :stub-columns: 0
1626 - ..
1628 - ``EPERM``
1630 - :cspan:`1` Mode ``AUDIO_SOURCE_MEMORY`` not selected.
1632 - ..
1634 - ``ENOMEM``
1636 - Attempted to write more data than the internal buffer can hold.
1638 - ..
1640 - ``EBADF``
1642 - Fd is not a valid open file descriptor.