libdvbv5  1.6.3
Library to work with Digital TV devices on Linux
descriptors.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2011-2012 - Mauro Carvalho Chehab
3  * Copyright (c) 2012-2014 - Andre Roth <neolynx@gmail.com>
4  *
5  * This program is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU General Public License
7  * as published by the Free Software Foundation version 2
8  * of the License.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18  * Or, point your browser to http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
19  */
20 
45 #ifndef _DESCRIPTORS_H
46 #define _DESCRIPTORS_H
47 
48 #include <unistd.h>
49 #include <stdint.h>
50 #include <arpa/inet.h>
51 
56 #define DVB_MAX_PAYLOAD_PACKET_SIZE 4096
57 
62 #define DVB_CRC_SIZE 4
63 
64 
65 #ifndef _DOXYGEN
66 struct dvb_v5_fe_parms;
67 #endif
68 
80 typedef void (*dvb_table_init_func)(struct dvb_v5_fe_parms *parms,
81  const uint8_t *buf, ssize_t buflen,
82  void **table);
83 
89 
90 #ifndef _DOXYGEN
91 #define bswap16(b) do {\
92  b = ntohs(b); \
93 } while (0)
94 
95 #define bswap32(b) do {\
96  b = ntohl(b); \
97 } while (0)
98 
99 /* Deprecated */
100 #define DVB_DESC_HEADER() \
101  uint8_t type; \
102  uint8_t length; \
103  struct dvb_desc *next
104 
105 #endif /* _DOXYGEN */
106 
118 struct dvb_desc {
119  uint8_t type;
120  uint8_t length;
121  struct dvb_desc *next;
122 
123  uint8_t data[];
124 } __attribute__((packed));
125 
126 #ifndef _DOXYGEN
127 
128 #define dvb_desc_foreach( _desc, _tbl ) \
129  for( struct dvb_desc *_desc = _tbl->descriptor; _desc; _desc = _desc->next ) \
130 
131 #define dvb_desc_find(_struct, _desc, _tbl, _type) \
132  for( _struct *_desc = (_struct *) _tbl->descriptor; _desc; _desc = (_struct *) _desc->next ) \
133  if(_desc->type == _type) \
134 
135 #endif /* _DOXYGEN */
136 
137 #ifdef __cplusplus
138 extern "C" {
139 #endif
140 
147 uint32_t dvb_bcd(uint32_t bcd);
148 
158 void dvb_hexdump(struct dvb_v5_fe_parms *parms, const char *prefix,
159  const unsigned char *buf, int len);
160 
182 int dvb_desc_parse(struct dvb_v5_fe_parms *parms, const uint8_t *buf,
183  uint16_t buflen, struct dvb_desc **head_desc);
184 
191 void dvb_desc_free (struct dvb_desc **list);
192 
200 void dvb_desc_print(struct dvb_v5_fe_parms *parms, struct dvb_desc *desc);
201 
202 #ifdef __cplusplus
203 }
204 #endif
205 
214 typedef int (*dvb_desc_init_func) (struct dvb_v5_fe_parms *parms,
215  const uint8_t *buf, struct dvb_desc *desc);
216 
224 typedef void (*dvb_desc_print_func)(struct dvb_v5_fe_parms *parms,
225  const struct dvb_desc *desc);
226 
233 typedef void (*dvb_desc_free_func) (struct dvb_desc *desc);
234 
249  const char *name;
253  ssize_t size;
254 };
255 
260 extern const struct dvb_descriptor dvb_descriptors[];
261 
592  /* ISO/IEC 13818-1 */
610 
629 
630  /* ETSI EN 300 468 V1.11.1 (2010-04) */
631 
696 
697  /* SCTE 35 2004 */
699 
702  /* From http://www.etherguidesystems.com/Help/SDOs/ATSC/Semantics/Descriptors/Default.aspx */
704 
705  /* From http://www.coolstf.com/tsreader/descriptors.html */
707 
708  /* ISDB Descriptors, as defined on ABNT NBR 15603-1 2007 */
709 
713 
753 
754  /* ATSC descriptors - ATSC A/65:2009 spec */
768 };
769 
770 /* Please see desc_extension.h for extension_descriptor types */
771 
772 #endif
multilingual_bouquet_name descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:660
maximum_bitrate descriptor - ISO/IEC 13818-1
Definition: descriptors.h:605
CA_contract_information descriptor - ABNT NBR 15603-1 2007.
Definition: descriptors.h:725
ancillary_data descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:675
metadata_std descriptor - ISO/IEC 13818-1
Definition: descriptors.h:623
const dvb_table_init_func dvb_table_initializers[256]
Table with all possible descriptors.
emergency_information descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:750
series descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:735
iod descriptor - ISO/IEC 13818-1
Definition: descriptors.h:613
bouquet_name descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:639
partial_transport_stream descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:667
external_es_id descriptor - ISO/IEC 13818-1
Definition: descriptors.h:616
extended_channel_name descriptor - SCTE 35 2004
Definition: descriptors.h:700
atsc_service_location descriptor - ATSC A/65:2009
Definition: descriptors.h:760
int(* dvb_desc_init_func)(struct dvb_v5_fe_parms *parms, const uint8_t *buf, struct dvb_desc *desc)
Function prototype for the descriptors parsing init code.
Definition: descriptors.h:214
frequency_list descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:666
ISDBT terrestrial_delivery_system descriptor - ABNT NBR 15603-1 2007.
Definition: descriptors.h:748
mpeg4_audio descriptor - ISO/IEC 13818-1
Definition: descriptors.h:612
hierarchy descriptor - ISO/IEC 13818-1
Definition: descriptors.h:595
std descriptor - ISO/IEC 13818-1
Definition: descriptors.h:608
DTS descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:691
broadcaster_Name descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:738
ibp descriptor - ISO/IEC 13818-1
Definition: descriptors.h:609
content_availability descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:744
stuffing descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:634
subtitling descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:657
hierarchical_transmission descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:714
dvb_desc_free_func free
Definition: descriptors.h:252
local_time_offset descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:656
service_availability descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:682
flexmux_timing descriptor - ISO/IEC 13818-1
Definition: descriptors.h:628
partial_transport_stream_time descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:717
basic_local_event descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:730
void dvb_desc_free(struct dvb_desc **list)
frees a dvb_desc linked list
struct dvb_desc * next
Definition: descriptors.h:121
CUE_identifier descriptor - SCTE 35 2004.
Definition: descriptors.h:698
short_smoothing_buffer descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:665
extended_event descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:646
TVA_id descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:685
atsc_genre descriptor - ATSC A/65:2009
Definition: descriptors.h:767
short_node_information descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:733
carousel_id descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:710
logical_channel_number descriptor - SCTE 35 2004
Definition: descriptors.h:706
dvb_desc_init_func init
Definition: descriptors.h:250
const char * name
Definition: descriptors.h:249
multiplexbuffer descriptor - ISO/IEC 13818-1
Definition: descriptors.h:619
void dvb_hexdump(struct dvb_v5_fe_parms *parms, const char *prefix, const unsigned char *buf, int len)
dumps data into the logs in hexadecimal format
connected_transmission descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:743
metadata descriptor - ISO/IEC 13818-1
Definition: descriptors.h:622
CA_EMM_TS descriptor - ABNT NBR 15603-1 2007.
Definition: descriptors.h:724
atsc_component_name descriptor - ATSC A/65:2009
Definition: descriptors.h:762
video_stream descriptor - ISO/IEC 13818-1
Definition: descriptors.h:593
private_data_specifier descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:663
service_location descriptor - SCTE 35 2004
Definition: descriptors.h:701
uint32_t dvb_bcd(uint32_t bcd)
Converts from BCD to CPU integer internal representation.
target_background_grid descriptor - ISO/IEC 13818-1
Definition: descriptors.h:598
metadata_pointer descriptor - ISO/IEC 13818-1
Definition: descriptors.h:621
uint8_t length
Definition: descriptors.h:120
dvb_desc_print_func print
Definition: descriptors.h:251
private_data_indicator descriptor - ISO/IEC 13818-1
Definition: descriptors.h:606
component descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:648
video_decode_control descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:722
transport_stream_information descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:727
satellite_delivery_system descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:635
reference descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:731
country_availability descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:641
multilingual_service_name descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:661
related_content descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:684
stream_identifier descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:650
multiplex_buffer_utilization descriptor - ISO/IEC 13818-1
Definition: descriptors.h:603
carousel_compatible_composite descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:746
iso639_language descriptor - ISO/IEC 13818-1
Definition: descriptors.h:601
short_event descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:645
data_component descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:751
ipmp descriptor - ISO/IEC 13818-1
Definition: descriptors.h:625
STC_reference descriptor - ABNT NBR 15603-1 2007.
Definition: descriptors.h:734
void(* dvb_desc_free_func)(struct dvb_desc *desc)
Function prototype for the descriptors memory free code.
Definition: descriptors.h:233
partial_reception descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:749
AVC_video descriptor - ISO/IEC 13818-1.
Definition: descriptors.h:624
announcement_support descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:678
uint8_t data[]
Definition: descriptors.h:123
hyperlink descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:719
component_name descriptor - SCTE 35 2004
Definition: descriptors.h:703
AVC_timing_and_HRD descriptor - ISO/IEC 13818-1.
Definition: descriptors.h:626
digital_copy_control descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:715
default_authority descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:683
descriptors
List containing all descriptors used by Digital TV MPEG-TS.
Definition: descriptors.h:591
system_clock descriptor - ISO/IEC 13818-1
Definition: descriptors.h:602
fmc descriptor - ISO/IEC 13818-1
Definition: descriptors.h:615
AAC descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:692
transport_stream descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:671
cell_list descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:676
copyright descriptor - ISO/IEC 13818-1
Definition: descriptors.h:604
multilingual_component descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:662
SI_parameter descriptor - ABNT NBR 15603-1 2007.
Definition: descriptors.h:737
time_shifted_event descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:647
parental_rating descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:653
application_signalling descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:679
audio_component descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:718
time_slice_fec_identifier descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:687
atsc_time_shifted_service descriptor - ATSC A/65:2009
Definition: descriptors.h:761
network_identifier descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:716
DSNG descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:672
void(* dvb_desc_print_func)(struct dvb_v5_fe_parms *parms, const struct dvb_desc *desc)
Function prototype for the descriptors parsing print code.
Definition: descriptors.h:224
cell_frequency_link descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:677
fmxbuffersize descriptor - ISO/IEC 13818-1
Definition: descriptors.h:618
content_labeling descriptor - ISO/IEC 13818-1
Definition: descriptors.h:620
extension descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:695
FTA_content_management descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:694
component_group descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:739
video_window descriptor - ISO/IEC 13818-1
Definition: descriptors.h:599
Keeps data needed to handle the DVB frontend.
Definition: dvb-fe.h:118
multilingual_network_name descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:659
data_contents descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:721
event_group descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:736
mpeg4_video descriptor - ISO/IEC 13818-1
Definition: descriptors.h:611
teletext descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:654
download_content descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:723
ds_alignment descriptor - ISO/IEC 13818-1
Definition: descriptors.h:597
conditional_access descriptor - ISO/IEC 13818-1
Definition: descriptors.h:600
service_list descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:633
PDC descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:673
atsc_DCC_departing_request descriptor - ATSC A/65:2009
Definition: descriptors.h:763
data_broadcast descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:668
node_relation descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:732
scrambling descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:669
target_area descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:720
smoothing_buffer descriptor - ISO/IEC 13818-1
Definition: descriptors.h:607
atsc_DCC_arriving_request descriptor - ATSC A/65:2009
Definition: descriptors.h:764
atsc_redistribution_control descriptor - ATSC A/65:2009
Definition: descriptors.h:765
Contains the parser information for the MPEG-TS parser code.
Definition: descriptors.h:248
atsc_caption_service descriptor - ATSC A/65:2009
Definition: descriptors.h:757
content_identifier descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:686
terrestrial_delivery_system descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:658
service_move descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:664
const struct dvb_descriptor dvb_descriptors[]
Contains the parsers for the several descriptors.
CA_identifier descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:651
network_name descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:632
logo_transmission descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:729
linkage descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:642
Linked list containing the several descriptors found on a MPEG-TS table.
Definition: descriptors.h:118
mpeg2_aac_audio descriptor - ISO/IEC 13818-1
Definition: descriptors.h:627
atsc_content_advisory descriptor - ATSC A/65:2009
Definition: descriptors.h:758
atsc_ac3_audio descriptor - ATSC A/65:2009
Definition: descriptors.h:756
system_management descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:752
CA_service descriptor - ABNT NBR 15603-1 2007.
Definition: descriptors.h:726
void dvb_desc_print(struct dvb_v5_fe_parms *parms, struct dvb_desc *desc)
prints the contents of a struct dvb_desc linked list
extended_broadcaster descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:728
adaptation_field_data descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:680
cable_delivery_system descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:636
mosaic descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:649
void(* dvb_table_init_func)(struct dvb_v5_fe_parms *parms, const uint8_t *buf, ssize_t buflen, void **table)
Function prototype for a function that initializes the descriptors parsing on a table.
Definition: descriptors.h:80
content descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:652
muxcode descriptor - ISO/IEC 13818-1
Definition: descriptors.h:617
service descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:640
deferred_association_tags descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:712
audio_stream descriptor - ISO/IEC 13818-1
Definition: descriptors.h:594
service_group descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:745
conditional_playback descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:747
LDT_linkage descriptor - ABNT NBR 15603-1 2007.
Definition: descriptors.h:742
S2_satellite_delivery_system descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:689
atsc_ATSC_private_information descriptor - ATSC A/65:2009
Definition: descriptors.h:766
board_information descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:741
atsc_extended_channel descriptor - ATSC A/65:2009
Definition: descriptors.h:759
enhanced_AC_3 descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:690
sl descriptor - ISO/IEC 13818-1
Definition: descriptors.h:614
NVOD_reference descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:643
int dvb_desc_parse(struct dvb_v5_fe_parms *parms, const uint8_t *buf, uint16_t buflen, struct dvb_desc **head_desc)
parse MPEG-TS descriptors
service_identifier descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:681
association_tag descriptor - ABNT NBR 15603-1 2007
Definition: descriptors.h:711
VBI_data descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:637
AC_3 descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:674
atsc_stuffing descriptor - ATSC A/65:2009
Definition: descriptors.h:755
XAIT_location descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:693
registration descriptor - ISO/IEC 13818-1
Definition: descriptors.h:596
time_shifted_service descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:644
data_broadcast_id descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:670
uint8_t type
Definition: descriptors.h:119
ECM_repetition_rate descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:688
VBI_teletext descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:638
telephone descriptor - ETSI EN 300 468 V1.11.1 (2010-04)
Definition: descriptors.h:655
SI_prime_transport_stream descriptor - ABNT NBR 15603-1 2007.
Definition: descriptors.h:740