mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-24 17:20:36 +00:00
255 lines
10 KiB
C
255 lines
10 KiB
C
/* asi.h
|
|
*
|
|
* Shared header file for the Linux user-space API for
|
|
* Linear Systems Ltd. DVB Master ASI interface boards.
|
|
*
|
|
* Copyright (C) 1999 Tony Bolger <d7v@indigo.ie>
|
|
* Copyright (C) 2000-2009 Linear Systems Ltd.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
*
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* 3. Neither the name of Linear Systems Ltd. nor the names of its
|
|
* contributors may be used to endorse or promote products derived from
|
|
* this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY LINEAR SYSTEMS LTD. "AS IS" AND ANY
|
|
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL LINEAR SYSTEMS LTD. OR CONTRIBUTORS
|
|
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
|
|
* OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
|
|
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
|
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* Linear Systems can be contacted at <http://www.linsys.ca/>.
|
|
*
|
|
*/
|
|
|
|
#ifndef _ASI_H
|
|
#define _ASI_H
|
|
|
|
/* Driver info */
|
|
#define ASI_DRIVER_NAME "asi"
|
|
|
|
#define ASI_MAJOR 61 /* Set to 0 for dynamic allocation.
|
|
* Otherwise, 61 is available.
|
|
* See /usr/src/linux/Documentation/devices.txt */
|
|
|
|
#define ASI_TX_BUFFERS_MIN 2 /* This must be at least 2 */
|
|
/* The minimum transmit buffer size must be positive, divisible by 8,
|
|
* and large enough that the buffers aren't transferred to the onboard FIFOs
|
|
* too quickly for the machine to handle the interrupts.
|
|
* This is especially a problem at startup, when the FIFOs are empty.
|
|
* Relevant factors include onboard FIFO size, PCI bus throughput,
|
|
* processor speed, and interrupt latency. */
|
|
#define ASI_TX_BUFSIZE_MIN 1024
|
|
#define ASI_RX_BUFFERS_MIN 2 /* This must be at least 2 */
|
|
#define ASI_RX_BUFSIZE_MIN 8 /* This must be positive and divisible by 8 */
|
|
|
|
#define ASI_TX_BUFFERS 54 /* This must be at least 2 */
|
|
#define ASI_TX_BUFSIZE 38352 /* This must be positive and divisible by 8 */
|
|
#define ASI_RX_BUFFERS 54 /* This must be at least 2 */
|
|
#define ASI_RX_BUFSIZE 38352 /* This must be positive and divisible by 8 */
|
|
|
|
/* Ioctl () definitions */
|
|
#define ASI_IOC_MAGIC '?' /* This ioctl magic number is currently free. See
|
|
* /usr/src/linux/Documentation/ioctl-number.txt */
|
|
|
|
#define ASI_IOC_TXGETCAP _IOR(ASI_IOC_MAGIC, 1, unsigned int)
|
|
#define ASI_IOC_TXGETEVENTS _IOR(ASI_IOC_MAGIC, 2, unsigned int)
|
|
#define ASI_IOC_TXGETBUFLEVEL _IOR(ASI_IOC_MAGIC, 3, unsigned int)
|
|
#define ASI_IOC_TXSETSTUFFING _IOW(ASI_IOC_MAGIC, 4, struct asi_txstuffing)
|
|
#define ASI_IOC_TXGETBYTECOUNT _IOR(ASI_IOC_MAGIC, 5, unsigned int)
|
|
/* #define ASI_IOC_TXGETFIFO _IOR(ASI_IOC_MAGIC, 6, int) */
|
|
#define ASI_IOC_TXGETTXD _IOR(ASI_IOC_MAGIC, 7, int)
|
|
#define ASI_IOC_TXGET27COUNT _IOR(ASI_IOC_MAGIC, 8, unsigned int)
|
|
/* Provide compatibility with applications compiled for older API */
|
|
#define ASI_IOC_TXSETPID_DEPRECATED _IOR(ASI_IOC_MAGIC, 9, unsigned int)
|
|
#define ASI_IOC_TXSETPID _IOW(ASI_IOC_MAGIC, 9, unsigned int)
|
|
#define ASI_IOC_TXGETPCRSTAMP _IOR(ASI_IOC_MAGIC, 10, struct asi_pcrstamp)
|
|
/* Provide compatibility with applications compiled for older API */
|
|
#define ASI_IOC_TXCHANGENEXTIP_DEPRECATED _IOR(ASI_IOC_MAGIC, 11, int)
|
|
#define ASI_IOC_TXCHANGENEXTIP _IOW(ASI_IOC_MAGIC, 11, int)
|
|
|
|
#define ASI_IOC_RXGETCAP _IOR(ASI_IOC_MAGIC, 65, unsigned int)
|
|
#define ASI_IOC_RXGETEVENTS _IOR(ASI_IOC_MAGIC, 66, unsigned int)
|
|
#define ASI_IOC_RXGETBUFLEVEL _IOR(ASI_IOC_MAGIC, 67, unsigned int)
|
|
/* #define ASI_IOC_RXSETREFRAME _IOW(ASI_IOC_MAGIC, 68, int) */
|
|
#define ASI_IOC_RXGETSTATUS _IOR(ASI_IOC_MAGIC, 69, int)
|
|
#define ASI_IOC_RXGETBYTECOUNT _IOR(ASI_IOC_MAGIC, 70, unsigned int)
|
|
/* #define ASI_IOC_RXGETFIFO _IOR(ASI_IOC_MAGIC, 71, int) */
|
|
#define ASI_IOC_RXSETINVSYNC _IOW(ASI_IOC_MAGIC, 72, int)
|
|
#define ASI_IOC_RXGETCARRIER _IOR(ASI_IOC_MAGIC, 73, int)
|
|
#define ASI_IOC_RXSETDSYNC _IOW(ASI_IOC_MAGIC, 74, int)
|
|
#define ASI_IOC_RXGETRXD _IOR(ASI_IOC_MAGIC, 75, int)
|
|
#define ASI_IOC_RXSETPF _IOW(ASI_IOC_MAGIC, 76, unsigned int [256])
|
|
/* #define ASI_IOC_RXSETPFE _IOW(ASI_IOC_MAGIC, 77, int) */
|
|
#define ASI_IOC_RXSETPID0 _IOW(ASI_IOC_MAGIC, 78, int)
|
|
#define ASI_IOC_RXGETPID0COUNT _IOR(ASI_IOC_MAGIC, 79, unsigned int)
|
|
#define ASI_IOC_RXSETPID1 _IOW(ASI_IOC_MAGIC, 80, int)
|
|
#define ASI_IOC_RXGETPID1COUNT _IOR(ASI_IOC_MAGIC, 81, unsigned int)
|
|
#define ASI_IOC_RXSETPID2 _IOW(ASI_IOC_MAGIC, 82, int)
|
|
#define ASI_IOC_RXGETPID2COUNT _IOR(ASI_IOC_MAGIC, 83, unsigned int)
|
|
#define ASI_IOC_RXSETPID3 _IOW(ASI_IOC_MAGIC, 84, int)
|
|
#define ASI_IOC_RXGETPID3COUNT _IOR(ASI_IOC_MAGIC, 85, unsigned int)
|
|
/* #define ASI_IOC_RXGETSTAMP _IOR(ASI_IOC_MAGIC, 86, unsigned int) */
|
|
#define ASI_IOC_RXGET27COUNT _IOR(ASI_IOC_MAGIC, 87, unsigned int)
|
|
#define ASI_IOC_RXGETSTATUS2 _IOR(ASI_IOC_MAGIC, 88, int)
|
|
/* Provide compatibility with applications compiled for older API */
|
|
#define ASI_IOC_RXSETINPUT_DEPRECATED _IOR(ASI_IOC_MAGIC, 89, int)
|
|
#define ASI_IOC_RXSETINPUT _IOW(ASI_IOC_MAGIC, 89, int)
|
|
#define ASI_IOC_RXGETRXD2 _IOR(ASI_IOC_MAGIC, 90, int)
|
|
|
|
#define ASI_IOC_GETID _IOR(ASI_IOC_MAGIC, 129, unsigned int)
|
|
#define ASI_IOC_GETVERSION _IOR(ASI_IOC_MAGIC, 130, unsigned int)
|
|
|
|
/* Transmitter event flag bit locations */
|
|
#define ASI_EVENT_TX_BUFFER_ORDER 0
|
|
#define ASI_EVENT_TX_BUFFER (1 << ASI_EVENT_TX_BUFFER_ORDER)
|
|
#define ASI_EVENT_TX_FIFO_ORDER 1
|
|
#define ASI_EVENT_TX_FIFO (1 << ASI_EVENT_TX_FIFO_ORDER)
|
|
#define ASI_EVENT_TX_DATA_ORDER 2
|
|
#define ASI_EVENT_TX_DATA (1 << ASI_EVENT_TX_DATA_ORDER)
|
|
|
|
/* Receiver event flag bit locations */
|
|
#define ASI_EVENT_RX_BUFFER_ORDER 0
|
|
#define ASI_EVENT_RX_BUFFER (1 << ASI_EVENT_RX_BUFFER_ORDER)
|
|
#define ASI_EVENT_RX_FIFO_ORDER 1
|
|
#define ASI_EVENT_RX_FIFO (1 << ASI_EVENT_RX_FIFO_ORDER)
|
|
#define ASI_EVENT_RX_CARRIER_ORDER 2
|
|
#define ASI_EVENT_RX_CARRIER (1 << ASI_EVENT_RX_CARRIER_ORDER)
|
|
#define ASI_EVENT_RX_AOS_ORDER 3
|
|
#define ASI_EVENT_RX_AOS (1 << ASI_EVENT_RX_AOS_ORDER)
|
|
#define ASI_EVENT_RX_LOS_ORDER 4
|
|
#define ASI_EVENT_RX_LOS (1 << ASI_EVENT_RX_LOS_ORDER)
|
|
#define ASI_EVENT_RX_DATA_ORDER 5
|
|
#define ASI_EVENT_RX_DATA (1 << ASI_EVENT_RX_DATA_ORDER)
|
|
|
|
/**
|
|
* asi_txstuffing - Transmitter stuffing parameters
|
|
* @ib: interbyte stuffing
|
|
* @ip: interpacket stuffing
|
|
* @normal_ip: FT0
|
|
* @big_ip: FT1
|
|
* @il_normal: IL0
|
|
* @il_big: IL1
|
|
**/
|
|
struct asi_txstuffing {
|
|
/* Number of K28.5 characters to insert between packet bytes */
|
|
unsigned int ib;
|
|
|
|
/* Base number of K28.5 characters to insert between packets,
|
|
* not including the two required by ASI */
|
|
unsigned int ip;
|
|
|
|
/* Number of packets with (ip) bytes of interpacket stuffing
|
|
* per finetuning cycle */
|
|
unsigned int normal_ip;
|
|
|
|
/* Number of packets with (ip + 1) bytes of interpacket stuffing
|
|
* per finetuning cycle */
|
|
unsigned int big_ip;
|
|
|
|
/* Number of packets with (ip) bytes of interpacket stuffing
|
|
* per interleaved finetuning cycle */
|
|
unsigned int il_normal;
|
|
|
|
/* Number of packets with (ip + 1) bytes of interpacket stuffing
|
|
* per interleaved finetuning cycle */
|
|
unsigned int il_big;
|
|
};
|
|
|
|
/**
|
|
* asi_pcrstamp - PCR - departure time pair
|
|
* @adaptation_field_length: adaptation field length
|
|
* @adaptation_field_flags: adaptation field flags
|
|
* @PCR: a program clock reference
|
|
* @count: departure time of this PCR, in 1 / 27 MHz
|
|
**/
|
|
struct asi_pcrstamp {
|
|
unsigned char adaptation_field_length;
|
|
unsigned char adaptation_field_flags;
|
|
unsigned char PCR[6];
|
|
long long int count;
|
|
};
|
|
|
|
/* Interface capabilities */
|
|
#define ASI_CAP_TX_MAKE204 0x00000004
|
|
#define ASI_CAP_TX_FINETUNING 0x00000008
|
|
#define ASI_CAP_TX_BYTECOUNTER 0x00000010
|
|
#define ASI_CAP_TX_SETCLKSRC 0x00000020
|
|
#define ASI_CAP_TX_FIFOUNDERRUN 0x00000040
|
|
#define ASI_CAP_TX_LARGEIB 0x00000080
|
|
#define ASI_CAP_TX_INTERLEAVING 0x00000100
|
|
#define ASI_CAP_TX_DATA 0x00000200
|
|
#define ASI_CAP_TX_RXCLKSRC 0x00000400
|
|
/* #define ASI_CAP_TX_COMPOSITEREF 0x00000800 */
|
|
#define ASI_CAP_TX_PCRSTAMP 0x00001000
|
|
#define ASI_CAP_TX_CHANGENEXTIP 0x00002000
|
|
#define ASI_CAP_TX_27COUNTER 0x00004000
|
|
#define ASI_CAP_TX_BYTESOR27 0x00008000
|
|
#define ASI_CAP_TX_TIMESTAMPS 0x00010000
|
|
#define ASI_CAP_TX_PTIMESTAMPS 0x00020000
|
|
#define ASI_CAP_TX_NULLPACKETS 0x00040000
|
|
|
|
#define ASI_CAP_RX_SYNC 0x00000004
|
|
#define ASI_CAP_RX_MAKE188 0x00000008
|
|
#define ASI_CAP_RX_BYTECOUNTER 0x00000010
|
|
/* #define ASI_CAP_RX_FIFOSTATUS 0x00000020 */
|
|
#define ASI_CAP_RX_INVSYNC 0x00000040
|
|
#define ASI_CAP_RX_CD 0x00000080
|
|
#define ASI_CAP_RX_DSYNC 0x00000100
|
|
#define ASI_CAP_RX_DATA 0x00000200
|
|
#define ASI_CAP_RX_PIDFILTER 0x00000400
|
|
#define ASI_CAP_RX_PIDCOUNTER 0x00000800
|
|
#define ASI_CAP_RX_4PIDCOUNTER 0x00001000
|
|
#define ASI_CAP_RX_FORCEDMA 0x00002000
|
|
#define ASI_CAP_RX_27COUNTER 0x00004000
|
|
#define ASI_CAP_RX_BYTESOR27 0x00008000
|
|
#define ASI_CAP_RX_TIMESTAMPS 0x00010000
|
|
#define ASI_CAP_RX_PTIMESTAMPS 0x00020000
|
|
#define ASI_CAP_RX_NULLPACKETS 0x00040000
|
|
#define ASI_CAP_RX_REDUNDANT 0x00080000
|
|
#define ASI_CAP_RX_DATA2 0x00100000
|
|
|
|
/* Transmitter clock source settings */
|
|
#define ASI_CTL_TX_CLKSRC_ONBOARD 0
|
|
#define ASI_CTL_TX_CLKSRC_EXT 1
|
|
#define ASI_CTL_TX_CLKSRC_RX 2
|
|
/* #define ASI_CTL_TX_CLKSRC_EXT_PAL 3 */
|
|
|
|
/* Transmitter mode settings */
|
|
#define ASI_CTL_TX_MODE_188 0
|
|
#define ASI_CTL_TX_MODE_204 1
|
|
#define ASI_CTL_TX_MODE_MAKE204 2
|
|
|
|
/* Receiver mode settings */
|
|
#define ASI_CTL_RX_MODE_RAW 0
|
|
#define ASI_CTL_RX_MODE_188 1
|
|
#define ASI_CTL_RX_MODE_204 2
|
|
#define ASI_CTL_RX_MODE_AUTO 3
|
|
#define ASI_CTL_RX_MODE_AUTOMAKE188 4
|
|
#define ASI_CTL_RX_MODE_204MAKE188 5
|
|
|
|
/* Timestamping settings */
|
|
#define ASI_CTL_TSTAMP_NONE 0
|
|
#define ASI_CTL_TSTAMP_APPEND 1
|
|
#define ASI_CTL_TSTAMP_PREPEND 2
|
|
|
|
/* Transport settings */
|
|
#define ASI_CTL_TRANSPORT_DVB_ASI 0
|
|
#define ASI_CTL_TRANSPORT_SMPTE_310M 1
|
|
|
|
#endif
|
|
|