dsmcc_carousel_descriptor.c

dvbsnoop is a DVB/MPEG stream analyzer program. The program can be used to sniff, monitor, debug, d

/*
$Id: dsmcc_carousel_descriptor.c,v 1.23 2004/11/03 21:00:50 rasc Exp $ 


 DVBSNOOP

 a dvb sniffer  and mpeg2 stream analyzer tool
 http://dvbsnoop.sourceforge.net/

 (c) 2001-2004   [e-mail] (rasc)


 -- Private TAG Space  DSM-CC
 -- DSM-CC Descriptors
 -- ISO 13818-6  // TR 102 006  //  TS 102 812




$Log: dsmcc_carousel_descriptor.c,v $
Revision 1.23  2004/11/03 21:00:50  rasc
 - New: "premiere.de" private tables and descriptors (tnx to Peter.Pavlov, Premiere)
 - New: cmd option "-privateprovider <provider name>"
 - New: Private provider sections and descriptors decoding
 - Changed: complete restructuring of private descriptors and sections

Revision 1.22  2004/02/24 23:03:05  rasc
private data of DSMCC::DSI
BIOP::ServiceGatewayInformation()
IOP::IOR()

Revision 1.21  2004/02/20 22:18:38  rasc
DII complete (hopefully)
BIOP::ModuleInfo  (damned, who is spreading infos over several standards???)
maybe someone give me a hint on the selector_byte info!!!
some minor changes...

Revision 1.20  2004/02/17 23:54:13  rasc
Bug (not fixed yet): DSM-CC  DII Carousel Descriptor Loop is strange

Revision 1.19  2004/02/15 20:46:10  rasc
DSM-CC  data/object carousell continued   (DSI, DII, DDB, DCancel)

Revision 1.18  2004/02/15 01:01:02  rasc
DSM-CC  DDB (DownloadDataBlock Message)
DSM-CC  U-N-Message  started
Carousel Descriptors completed

Revision 1.17  2004/02/09 21:24:57  rasc
AIT descriptors
minor redesign on output routines

Revision 1.16  2004/01/22 22:58:29  rasc
deleting modul  (again?)
somehow  obsolete module re-appeared??? (or I forgot something)

Revision 1.15  2004/01/11 21:01:31  rasc
PES stream directory, PES restructured

Revision 1.14  2004/01/02 22:59:59  rasc
DSM-CC  modules renaming...

Revision 1.13  2004/01/02 22:25:35  rasc
DSM-CC  MODULEs descriptors complete

Revision 1.12  2004/01/01 20:31:22  rasc
PES program stream map, minor descriptor cleanup

Revision 1.11  2004/01/01 20:09:19  rasc
DSM-CC INT/UNT descriptors
PES-sync changed, TS sync changed,
descriptor scope
other changes

Revision 1.10  2003/12/27 18:17:17  rasc
dsmcc PES dsmcc_program_stream_descriptorlist

Revision 1.9  2003/11/01 21:40:27  rasc
some broadcast/linkage descriptor stuff

Revision 1.8  2003/10/29 20:54:56  rasc
more PES stuff, DSM descriptors, testdata



*/


#include "dvbsnoop.h"
#include "descriptor.h"
#include "dsmcc_carousel_descriptor.h"
#include "dsmcc_int_unt_descriptor.h"
#include "private/userdefs.h"
#include "strings/dsmcc_str.h"
#include "misc/hexprint.h"
#include "misc/output.h"





/*
  determine descriptor type and print it...
  !!! DSMCC_CAROUSEL descriptors are in a private tag space !!!

  The userInfo field of BIOP::ModuleInfo shall be structured as a
  loop of descriptors which enables the use of Module descriptors
  as defined in DVB Data Carousels.


  return byte length
*/

int  descriptorDSMCC_CAROUSEL (u_char *b)

{
 int len;
 int id;


  id  =  (int) b[0];
  len = ((int) b[1]) + 2;

  out_NL (4);
  out_S2B_NL (4,"DSM-CC_CAROUSEL-DescriptorTag: ",id,
		  dsmccStrDSMCC_CAROUSEL_DescriptorTAG (id));
  out_SB_NL  (5,"Descriptor_length: ",b[1]);

  // empty ??
  len = ((int)b[1]) + 2;
  if (b[1] == 0)
	 return len;

  // print hex buf of descriptor
  printhex_buf (9, b,len);



  switch (b[0]) {

     case 0x01:  descriptorDSMCC_type (b); break;
     case 0x02:  descriptorDSMCC_name (b); break;
     case 0x03:  descriptorDSMCC_info (b); break;
     case 0x04:  descriptorDSMCC_module_link (b); break;
     case 0x05:  descriptorDSMCC_crc32 (b); break;
     case 0x06:  descriptorDSMCC_location (b); break;
     case 0x07:  descriptorDSMCC_est_download_time (b); break;
     case 0x08:  descriptorDSMCC_group_link (b); break;
     case 0x09:  descriptorDSMCC_compressed_module (b); break;
     case 0x0A:  descriptorDSMCC_subgroup_association (b); break;

	// MHP
     case 0x70:  descriptorDSMCC_MHP_label (b); break;
     case 0x71:  descriptorDSMCC_MHP_caching_priority (b); break;
     case 0x72:  descriptorDSMCC_MHP_content_type (b); break;

     default: 
	if (b[0] < 0x80) {
	    out_nl (0,"  ----> ERROR: unimplemented descriptor (DSM-CC_CAROUSEL context), Report!");
	}
	// descriptor_any (b);
	descriptor_PRIVATE (b,DSMCC_CAROUSEL);
	break;
  } 


  return len;   // (descriptor total length)
}








/* 
 * EN 301 192  / TR 102 006
 * private DSM-CC CAROUSEL descriptors
 *
 * 0x00 - 0x0A currently allocated by DVB
 * 0x0B - 0x6F reserved for future use by DVB
 * 0x70 - 0x7F reserved for DVB MHP
 * 0x80 - 0xFF private descriptors 
 *
 * e.g.:
 * The userInfo field of BIOP::ModuleInfo shall be structured as a
 * loop of descriptors which enables the use of Module descriptors
 * as defined in DVB Data Carousels.
 */





/*
  0x01 - type
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_type (u_char *b)
{
  int        len;

  // descriptor_tag	= b[0];
  len		        = b[1];

  print_std_ascii (4, "Text: ", b+2, len);
}




/*
  0x02 - name
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_name (u_char *b)
{
  int        len;

  // descriptor_tag	= b[0];
  len		        = b[1];

  print_text_468A (4, "Text: ", b+2, len);
}



/*
  0x03 - info
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_info (u_char *b)
{
  int        len;
  u_char     ISO639_language_code[4];


  // descriptor_tag	= b[0];
  len		        = b[1];

  getISO639_3 (ISO639_language_code, b+2);
  out_nl (4,"  ISO639_language_code:  %3.3s", ISO639_language_code);

  print_text_468A (4, "Text: ", b+5, len-3);
}


/*
  0x04 - module_link
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_module_link (u_char *b)
{

  // descriptor_tag	= b[0];
  // len	        = b[1];
 
  outBit_S2x_NL(4,"position: ",  b,16, 8,
			(char *(*)(u_long)) dsmccStr_GroupModuleLinkPosition);
  outBit_Sx_NL (4,"module_id: ", b,24,16);
}




/*
  0x05 - crc
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_crc32 (u_char *b)
{

  // descriptor_tag	= b[0];
  // len	        = b[1];
 
  outBit_Sx_NL (4,"CRC: ", b,16,32);
}



/*
  0x06 - location
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_location (u_char *b)
{

  // descriptor_tag	= b[0];
  // len	        = b[1];
 
  outBit_S2Tx_NL (4,"location: ", b,16, 8,
	   "--> refers to component_tag in stream_identifier_descriptor"); 
}


/*
  0x07 - est_download_time
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_est_download_time (u_char *b)
{

  // descriptor_tag	= b[0];
  // len	        = b[1];
 
  outBit_S2Tx_NL (4,"est_download_time: ", b,16, 32, "(seconds)");
}




/*
  0x08 - group link
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_group_link (u_char *b)
{

  // descriptor_tag	= b[0];
  // len	        = b[1];
 
  outBit_S2x_NL(4,"position: ",  b,16, 8,
			(char *(*)(u_long)) dsmccStr_GroupModuleLinkPosition);
  outBit_Sx_NL (4,"group_id: ", b,24,32);
}



/*
  0x09 -  compressed_module
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_compressed_module (u_char *b)
{

  // descriptor_tag	= b[0];
  // len	        = b[1];

  outBit_S2x_NL(4,"compression_method: ",  b,16, 8,
			(char *(*)(u_long)) dsmccStr_compression_method);
  outBit_S2Tx_NL (4,"original_size: ", b,24,32, "(bytes)");

  // Module data stored in the following structure: 
  // zlib structure(){
  //	compression_method 1
  //	flags_check 1
  //	compressed_data n
  // 	check value 4
  // }

}




/*
  0x0A - subgroup_association
  ETSI EN 301 192  (ISO 13818-6)
*/

void descriptorDSMCC_subgroup_association (u_char *b)
{
 descriptorDSMCC_ssu_subgroup_association (b);
}












/*
  0x70 -  MHP label descriptor
  ETSI  TS 102 812  v 1.2.1
*/

void descriptorDSMCC_MHP_label (u_char *b)
{
  int len;

  // tag	= b[0];
  len	        = b[1];

  print_text_UTF8 (4, "label: ", b+2, len);
}



/*
  0x71 -  MHP caching priority descriptor
  ETSI  TS 102 812  v 1.2.1
*/

void descriptorDSMCC_MHP_caching_priority (u_char *b)
{

  // tag	= b[0];
  // len        = b[1];

  outBit_Sx_NL (4,"priority_value: ", 		b, 16, 8);
  outBit_S2x_NL(4,"transparency_level: ",	b, 24, 8,
			(char *(*)(u_long)) dsmccStrMHP_caching_transparency_level);
}




/*
  0x72 -  MHP content type descriptor
  ETSI  TS 102 812  v 1.2.1
*/

void descriptorDSMCC_MHP_content_type (u_char *b)
{
  int  len;

  // tag	= b[0];
  len        = b[1];

  print_text_UTF8 (4, "content_type_data: ", b+2, len);
}