libavformat/mpegts.h

   1 /*
   2  * MPEG-2 transport stream defines
   3  * Copyright (c) 2003 Fabrice Bellard
   4  *
   5  * This file is part of FFmpeg.
   6  *
   7  * FFmpeg is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2.1 of the License, or (at your option) any later version.
  11  *
  12  * FFmpeg is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with FFmpeg; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  20  */
  21
  22 #ifndef AVFORMAT_MPEGTS_H
  23 #define AVFORMAT_MPEGTS_H
  24
  25 #include "avformat.h"
  26
  27 #define TS_FEC_PACKET_SIZE 204
  28 #define TS_DVHS_PACKET_SIZE 192
  29 #define TS_PACKET_SIZE 188
  30 #define TS_MAX_PACKET_SIZE 204
  31
  32 #define NB_PID_MAX 8192
  33 #define USUAL_SECTION_SIZE 1024 /* except EIT which is limited to 4096 */
  34 #define MAX_SECTION_SIZE 4096
  35
  36 #define SYNC_BYTE 0x47
  37 #define STUFFING_BYTE 0xFF
  38 #define SYSTEM_CLOCK_FREQUENCY_DIVISOR 300 /* convert 27 MHz to 90 kHz */
  39
  40 /* pids */
  41 #define PAT_PID         0x0000 /* Program Association Table */
  42 #define CAT_PID         0x0001 /* Conditional Access Table */
  43 #define TSDT_PID        0x0002 /* Transport Stream Description Table */
  44 #define IPMP_PID        0x0003
  45 /* PID from 0x0004 to 0x000F are reserved */
  46 #define NIT_PID         0x0010 /* Network Information Table */
  47 #define SDT_PID         0x0011 /* Service Description Table */
  48 #define BAT_PID         0x0011 /* Bouquet Association Table */
  49 #define EIT_PID         0x0012 /* Event Information Table */
  50 #define RST_PID         0x0013 /* Running Status Table */
  51 #define TDT_PID         0x0014 /* Time and Date Table */
  52 #define TOT_PID         0x0014
  53 #define NET_SYNC_PID    0x0015
  54 #define RNT_PID         0x0016 /* RAR Notification Table */
  55 /* PID from 0x0017 to 0x001B are reserved for future use */
  56 /* PID value 0x001C allocated to link-local inband signalling shall not be
  57  * used on any broadcast signals. It shall only be used between devices in a
  58  * controlled environment. */
  59 #define LINK_LOCAL_PID  0x001C
  60 #define MEASUREMENT_PID 0x001D
  61 #define DIT_PID         0x001E /* Discontinuity Information Table */
  62 #define SIT_PID         0x001F /* Selection Information Table */
  63 /* PID from 0x0020 to 0x1FFA may be assigned as needed to PMT, elementary
  64  * streams and other data tables */
  65 #define FIRST_OTHER_PID 0x0020
  66 #define  LAST_OTHER_PID 0x1FFA
  67 /* PID 0x1FFB is used by DigiCipher 2/ATSC MGT metadata */
  68 /* PID from 0x1FFC to 0x1FFE may be assigned as needed to PMT, elementary
  69  * streams and other data tables */
  70 #define NULL_PID        0x1FFF /* Null packet (used for fixed bandwidth padding) */
  71
  72 /* m2ts pids */
  73 #define M2TS_PMT_PID                      0x0100
  74 #define M2TS_PCR_PID                      0x1001
  75 #define M2TS_VIDEO_PID                    0x1011
  76 #define M2TS_AUDIO_START_PID              0x1100
  77 #define M2TS_PGSSUB_START_PID             0x1200
  78 #define M2TS_TEXTSUB_PID                  0x1800
  79 #define M2TS_SECONDARY_AUDIO_START_PID    0x1A00
  80 #define M2TS_SECONDARY_VIDEO_START_PID    0x1B00
  81
  82 /* table ids */
  83 #define PAT_TID         0x00 /* Program Association section */
  84 #define CAT_TID         0x01 /* Conditional Access section */
  85 #define PMT_TID         0x02 /* Program Map section */
  86 #define TSDT_TID        0x03 /* Transport Stream Description section */
  87 /* TID from 0x04 to 0x3F are reserved */
  88 #define M4OD_TID        0x05
  89 #define NIT_TID         0x40 /* Network Information section - actual network */
  90 #define ONIT_TID        0x41 /* Network Information section - other network */
  91 #define SDT_TID         0x42 /* Service Description section - actual TS */
  92 /* TID from 0x43 to 0x45 are reserved for future use */
  93 #define OSDT_TID        0x46 /* Service Description section - other TS */
  94 /* TID from 0x47 to 0x49 are reserved for future use */
  95 #define BAT_TID         0x4A /* Bouquet Association section */
  96 #define UNT_TID         0x4B /* Update Notification Table section */
  97 #define DFI_TID         0x4C /* Downloadable Font Info section */
  98 /* TID 0x4D is reserved for future use */
  99 #define EIT_TID         0x4E /* Event Information section - actual TS */
 100 #define OEIT_TID        0x4F /* Event Information section - other TS */
 101 #define EITS_START_TID  0x50 /* Event Information section schedule - actual TS */
 102 #define EITS_END_TID    0x5F /* Event Information section schedule - actual TS */
 103 #define OEITS_START_TID 0x60 /* Event Information section schedule - other TS */
 104 #define OEITS_END_TID   0x6F /* Event Information section schedule - other TS */
 105 #define TDT_TID         0x70 /* Time Date section */
 106 #define RST_TID         0x71 /* Running Status section */
 107 #define ST_TID          0x72 /* Stuffing section */
 108 #define TOT_TID         0x73 /* Time Offset section */
 109 #define AIT_TID         0x74 /* Application Information section */
 110 #define CT_TID          0x75 /* Container section */
 111 #define RCT_TID         0x76 /* Related Content section */
 112 #define CIT_TID         0x77 /* Content Identifier section */
 113 #define MPE_FEC_TID     0x78 /* MPE-FEC section */
 114 #define RPNT_TID        0x79 /* Resolution Provider Notification section */
 115 #define MPE_IFEC_TID    0x7A /* MPE-IFEC section */
 116 #define PROTMT_TID      0x7B /* Protection Message section */
 117 /* TID from 0x7C to 0x7D are reserved for future use */
 118 #define DIT_TID         0x7E /* Discontinuity Information section */
 119 #define SIT_TID         0x7F /* Selection Information section */
 120 /* TID from 0x80 to 0xFE are user defined */
 121 /* TID 0xFF is reserved */
 122
 123 /* ISO/IEC 13818-1 Table 2-34 - Stream type assignments */
 124 #define STREAM_TYPE_VIDEO_MPEG1     0x01
 125 #define STREAM_TYPE_VIDEO_MPEG2     0x02
 126 #define STREAM_TYPE_AUDIO_MPEG1     0x03
 127 #define STREAM_TYPE_AUDIO_MPEG2     0x04
 128 #define STREAM_TYPE_PRIVATE_SECTION 0x05
 129 #define STREAM_TYPE_PRIVATE_DATA    0x06
 130 #define STREAM_TYPE_AUDIO_AAC       0x0f
 131 #define STREAM_TYPE_AUDIO_AAC_LATM  0x11
 132 #define STREAM_TYPE_VIDEO_MPEG4     0x10
 133 /** ISO/IEC 14496-1 (MPEG-4 Systems) SL-packetized stream or FlexMux stream
 134     carried in PES packets */
 135 #define STREAM_TYPE_ISO_IEC_14496_PES     0x12
 136 /** ISO/IEC 14496-1 (MPEG-4 Systems) SL-packetized stream or FlexMux stream
 137     carried in ISO_IEC_14496_section()s */
 138 #define STREAM_TYPE_ISO_IEC_14496_SECTION 0x13
 139 #define STREAM_TYPE_METADATA        0x15
 140 #define STREAM_TYPE_VIDEO_H264      0x1b
 141 /** ISO/IEC 14496-3 Audio, without using any additional transport syntax,
 142     such as DST, ALS and SLS */
 143 #define STREAM_TYPE_AUDIO_MPEG4     0x1c
 144 #define STREAM_TYPE_VIDEO_MVC       0x20
 145 #define STREAM_TYPE_VIDEO_JPEG2000  0x21
 146 #define STREAM_TYPE_VIDEO_HEVC      0x24
 147 #define STREAM_TYPE_VIDEO_VVC       0x33
 148 #define STREAM_TYPE_VIDEO_CAVS      0x42
 149 #define STREAM_TYPE_VIDEO_AVS2      0xd2
 150 #define STREAM_TYPE_VIDEO_AVS3      0xd4
 151 #define STREAM_TYPE_VIDEO_VC1       0xea
 152 #define STREAM_TYPE_VIDEO_DIRAC     0xd1
 153
 154 /* stream_type values [0x80, 0xff] are User Private */
 155 #define STREAM_TYPE_BLURAY_AUDIO_PCM_BLURAY             0x80
 156 #define STREAM_TYPE_BLURAY_AUDIO_AC3                    0x81
 157 #define STREAM_TYPE_BLURAY_AUDIO_DTS                    0x82
 158 #define STREAM_TYPE_BLURAY_AUDIO_TRUEHD                 0x83
 159 #define STREAM_TYPE_BLURAY_AUDIO_EAC3                   0x84
 160 #define STREAM_TYPE_BLURAY_AUDIO_DTS_HD                 0x85
 161 #define STREAM_TYPE_BLURAY_AUDIO_DTS_HD_MASTER          0x86
 162 #define STREAM_TYPE_BLURAY_AUDIO_EAC3_SECONDARY         0xa1
 163 #define STREAM_TYPE_BLURAY_AUDIO_DTS_EXPRESS_SECONDARY  0xa2
 164 #define STREAM_TYPE_BLURAY_SUBTITLE_PGS                 0x90
 165 #define STREAM_TYPE_BLURAY_SUBTITLE_TEXT                0x92
 166
 167 #define STREAM_TYPE_SCTE_DATA_SCTE_35 0x86 /* ANSI/SCTE 35 */
 168
 169 #define STREAM_TYPE_ATSC_AUDIO_AC3  0x81 /* ATSC A/52 */
 170 #define STREAM_TYPE_ATSC_AUDIO_EAC3 0x87 /* ATSC A/52 */
 171
 172 /* HTTP Live Streaming (HLS) Sample Encryption
 173    see "MPEG-2 Stream Encryption Format for HTTP Live Streaming",
 174 https://developer.apple.com/library/archive/documentation/AudioVideo/Conceptual/HLS_Sample_Encryption/ */
 175 #define STREAM_TYPE_HLS_SE_VIDEO_H264 0xdb
 176 #define STREAM_TYPE_HLS_SE_AUDIO_AAC  0xcf
 177 #define STREAM_TYPE_HLS_SE_AUDIO_AC3  0xc1
 178 #define STREAM_TYPE_HLS_SE_AUDIO_EAC3 0xc2
 179
 180
 181 /* ISO/IEC 13818-1 Table 2-22 */
 182 #define STREAM_ID_PROGRAM_STREAM_MAP        0xbc
 183 #define STREAM_ID_PRIVATE_STREAM_1          0xbd
 184 #define STREAM_ID_PADDING_STREAM            0xbe
 185 #define STREAM_ID_PRIVATE_STREAM_2          0xbf
 186 #define STREAM_ID_AUDIO_STREAM_0            0xc0
 187 #define STREAM_ID_VIDEO_STREAM_0            0xe0
 188 #define STREAM_ID_ECM_STREAM                0xf0
 189 #define STREAM_ID_EMM_STREAM                0xf1
 190 #define STREAM_ID_DSMCC_STREAM              0xf2
 191 #define STREAM_ID_TYPE_E_STREAM             0xf8
 192 #define STREAM_ID_METADATA_STREAM           0xfc
 193 #define STREAM_ID_EXTENDED_STREAM_ID        0xfd
 194 #define STREAM_ID_PROGRAM_STREAM_DIRECTORY  0xff
 195
 196 /* ISO/IEC 13818-1 Table 2-45 */
 197 #define VIDEO_STREAM_DESCRIPTOR      0x02
 198 #define REGISTRATION_DESCRIPTOR      0x05
 199 #define ISO_639_LANGUAGE_DESCRIPTOR  0x0a
 200 #define IOD_DESCRIPTOR               0x1d
 201 #define SL_DESCRIPTOR                0x1e
 202 #define FMC_DESCRIPTOR               0x1f
 203 #define METADATA_DESCRIPTOR          0x26
 204 #define METADATA_STD_DESCRIPTOR      0x27
 205 /* descriptor_tag values [0x40, 0xff] are User Private */
 206
 207 /* DVB descriptor tag values [0x40, 0x7F] from
 208    ETSI EN 300 468 Table 12: Possible locations of descriptors */
 209 #define NETWORK_NAME_DESCRIPTOR      0x40
 210 #define SERVICE_LIST_DESCRIPTOR      0x41
 211 #define SERVICE_DESCRIPTOR           0x48
 212 #define STREAM_IDENTIFIER_DESCRIPTOR 0x52
 213 #define TELETEXT_DESCRIPTOR          0x56
 214 #define SUBTITLING_DESCRIPTOR        0x59
 215 #define AC3_DESCRIPTOR               0x6a /* AC-3_descriptor */
 216 #define ENHANCED_AC3_DESCRIPTOR      0x7a /* enhanced_AC-3_descriptor */
 217 #define DTS_DESCRIPTOR               0x7b
 218 #define EXTENSION_DESCRIPTOR         0x7f
 219
 220 /* DVB descriptor_tag_extension values from
 221    ETSI EN 300 468 Table 109: Possible locations of extended descriptors */
 222 #define SUPPLEMENTARY_AUDIO_DESCRIPTOR 0x06
 223
 224 /** see "Dolby Vision Streams Within the MPEG-2 Transport Stream Format"
 225 https://professional.dolby.com/siteassets/content-creation/dolby-vision-for-content-creators/dolby-vision-bitstreams-in-mpeg-2-transport-stream-multiplex-v1.2.pdf */
 226 #define DOVI_VIDEO_STREAM_DESCRIPTOR 0xb0
 227
 228 #define DATA_COMPONENT_DESCRIPTOR 0xfd /* ARIB STD-B10 */
 229
 230 typedef struct MpegTSContext MpegTSContext;
 231
 232 MpegTSContext *avpriv_mpegts_parse_open(AVFormatContext *s);
 233 int avpriv_mpegts_parse_packet(MpegTSContext *ts, AVPacket *pkt,
 234                                const uint8_t *buf, int len);
 235 void avpriv_mpegts_parse_close(MpegTSContext *ts);
 236
 237 typedef struct SLConfigDescr {
 238     int use_au_start;
 239     int use_au_end;
 240     int use_rand_acc_pt;
 241     int use_padding;
 242     int use_timestamps;
 243     int use_idle;
 244     int timestamp_res;
 245     int timestamp_len;
 246     int ocr_len;
 247     int au_len;
 248     int inst_bitrate_len;
 249     int degr_prior_len;
 250     int au_seq_num_len;
 251     int packet_seq_num_len;
 252 } SLConfigDescr;
 253
 254 typedef struct Mp4Descr {
 255     int es_id;
 256     int dec_config_descr_len;
 257     uint8_t *dec_config_descr;
 258     SLConfigDescr sl;
 259 } Mp4Descr;
 260
 261 /*
 262  * ETSI 300 468 descriptor 0x6A(AC-3)
 263  * Refer to: ETSI EN 300 468 V1.11.1 (2010-04) (SI in DVB systems)
 264  */
 265 typedef struct DVBAC3Descriptor {
 266     uint8_t  component_type_flag;
 267     uint8_t  bsid_flag;
 268     uint8_t  mainid_flag;
 269     uint8_t  asvc_flag;
 270     uint8_t  reserved_flags;
 271     uint8_t  component_type;
 272     uint8_t  bsid;
 273     uint8_t  mainid;
 274     uint8_t  asvc;
 275 } DVBAC3Descriptor;
 276
 277 /**
 278  * Parse an MPEG-2 descriptor
 279  * @param[in] fc                    Format context (used for logging only)
 280  * @param st                        Stream
 281  * @param stream_type               STREAM_TYPE_xxx
 282  * @param pp                        Descriptor buffer pointer
 283  * @param desc_list_end             End of buffer
 284  * @return <0 to stop processing
 285  */
 286 int ff_parse_mpeg2_descriptor(AVFormatContext *fc, AVStream *st, int stream_type,
 287                               const uint8_t **pp, const uint8_t *desc_list_end,
 288                               Mp4Descr *mp4_descr, int mp4_descr_count, int pid,
 289                               MpegTSContext *ts);
 290
 291 /**
 292  * Check presence of H264 startcode
 293  * @return <0 to stop processing
 294  */
 295 int ff_check_h264_startcode(AVFormatContext *s, const AVStream *st, const AVPacket *pkt);
 296
 297 #endif /* AVFORMAT_MPEGTS_H */