PID Filter - Demultiplexer - Revision history

CityK: fixed links

2008-01-06T22:11:34Z

fixed links

← Older revision		Revision as of 22:11, 6 January 2008
Line 1:		Line 1:
	== Introduction ==		== Introduction ==

-	A raw [[~~MPEG2~~ Transport Stream]] consists data of all the services transmitted on a particular transponder. The task on the receiver side is to filter out the interesting packets and schedule them to their target decoders: Audio packets to the audio-decoder, video packets to the video decoder, subtitle packets to the subtitle decoder etc...	+	A raw [[MPEG-2 Transport Stream]] consists data of all the services transmitted on a particular transponder. The task on the receiver side is to filter out the interesting packets and schedule them to their target decoders: Audio packets to the audio-decoder, video packets to the video decoder, subtitle packets to the subtitle decoder etc...

-	~~MPEG2~~ TS packets are identified by the Packet ID, the PID. This is a 13-bit number located in the 2nd and 3rd byte of a TS packet.	+	MPEG-2 TS packets are identified by the Packet ID, the PID. This is a 13-bit number located in the 2nd and 3rd byte of a TS packet.

	== PID Filter Algorithm ==		== PID Filter Algorithm ==

Holger: /* PID Filter Sample Code (with sanity checks) */

2005-07-23T10:52:21Z

PID Filter Sample Code (with sanity checks)

← Older revision		Revision as of 10:52, 23 July 2005
Line 95:		Line 95:

	if (scrambling_control != 0)		if (scrambling_control != 0)
-	return 0;	+	return;

	if (pid_is_enabled(pid))		if (pid_is_enabled(pid))

Guidod: +cat

2005-04-02T22:29:35Z

+cat

← Older revision		Revision as of 22:29, 2 April 2005
Line 109:		Line 109:

	The MPEG table decoder receives now all tables of an enabled PID, these are usually related anyways.		The MPEG table decoder receives now all tables of an enabled PID, these are usually related anyways.
		+
		+	[[Category:Technology]]

Holger at 20:54, 1 November 2004

2004-11-01T20:54:33Z

← Older revision		Revision as of 20:54, 1 November 2004
Line 11:		Line 11:
	== PID Filter Sample Code (the easy way) ==		== PID Filter Sample Code (the easy way) ==

-	~~You need to implement a <tt>pid_is_enabled(unsigned short pid)</tt> function if you want to use this code.~~ This implementation ~~can be~~ trivial~~: simply keep a~~ PID table of 2^13 bits where every bit is set to '1' if this particular PID is enabled and '0' if it is disabled. The entire table has a size of 8kbit (1kByte). <tt>pid_is_enabled(~~unsigned short pid~~)</tt> simply tests if the bit on position '<pid>' is set.	+	This implementation uses a trivial PID table of 2^13 (=8192) bits where every bit is set to '1' if this particular PID is enabled and cleared to '0' if the PID is disabled. The entire table has a size of 8kbit (1kByte). <tt>pid_is_enabled()</tt> simply tests if the bit on position '<pid>' is set.

-	You can also organize you filters in a linked list and traverse this every time, but you don't need to do it that complicated...	+	You can also organize you filters in a linked list and traverse this every time, but you don't need to do it that complicated unless you really want...

	Here the code:		Here the code:

	<tt>		<tt>
		+	static unsigned char pid_table [1024] = { 0 };
		+
		+
		+	static inline
		+	void enable_pid (unsigned short pid)
		+	{
		+	unsigned int index = pid / 8;
		+	unsigned int bit = pid % 8;
		+	pid_table[index] \|= 1 << bit;
		+	}
		+
		+
		+	static inline
		+	void disable_pid (unsigned short pid)
		+	{
		+	unsigned int index = pid / 8;
		+	unsigned int bit = pid % 8;
		+	pid_table[index] &= ~(1 << bit);
		+	}
		+
		+
		+	static inline
		+	int pid_is_enabled (unsigned short pid)
		+	{
		+	unsigned int index = pid / 8;
		+	unsigned int bit = pid % 8;
		+	return (pid_table[index] & (1 << bit)) ? 1 : 0;
		+	}
		+
		+
	static inline		static inline
	unsigned short ts_pid (const unsigned char *ts_packet)		unsigned short ts_pid (const unsigned char *ts_packet)
Line 40:		Line 70:

	<tt>		<tt>
-	~~static inline~~
-	~~unsigned short ts_pid (const unsigned char *ts_packet)~~
-	{
-	~~return ((ts_packet[1] & 0x1f) << 8) + ts_packet[2];~~
-	}
-
-
	static		static
	void pidfilter_process_ts_packet (const unsigned char ts_packet[188])		void pidfilter_process_ts_packet (const unsigned char ts_packet[188])

Holger at 20:43, 1 November 2004

2004-11-01T20:43:25Z

← Older revision		Revision as of 20:43, 1 November 2004
Line 10:		Line 10:

	== PID Filter Sample Code (the easy way) ==		== PID Filter Sample Code (the easy way) ==
		+
		+	You need to implement a <tt>pid_is_enabled(unsigned short pid)</tt> function if you want to use this code. This implementation can be trivial: simply keep a PID table of 2^13 bits where every bit is set to '1' if this particular PID is enabled and '0' if it is disabled. The entire table has a size of 8kbit (1kByte). <tt>pid_is_enabled(unsigned short pid)</tt> simply tests if the bit on position '<pid>' is set.
		+
		+	You can also organize you filters in a linked list and traverse this every time, but you don't need to do it that complicated...
		+
		+	Here the code:

	<tt>		<tt>

Holger at 20:33, 1 November 2004

2004-11-01T20:33:57Z

← Older revision		Revision as of 20:33, 1 November 2004
Line 60:		Line 60:
	*		*
	* In any case no scrambled packets should arrive in the demux,		* In any case no scrambled packets should arrive in the demux,
-	* CSA descramblers are located before this stage of the pipeline.	+	* CSA descramblers are located before this stage of the pipeline,
		+	* so simply discard this garbage...
	*/		*/
	scrambling_control = (ts_packet[3] >> 6) & 0x03;		scrambling_control = (ts_packet[3] >> 6) & 0x03;

Holger at 20:32, 1 November 2004

2004-11-01T20:32:51Z

← Older revision		Revision as of 20:32, 1 November 2004
Line 20:		Line 20:

	static		static
-	void pidfilter_process_ts_packet (~~struct demux *d,~~ const unsigned char ts_packet[188])	+	void pidfilter_process_ts_packet (const unsigned char ts_packet[188])
	{		{
	unsigned short pid = ts_pid(ts_packet);		unsigned short pid = ts_pid(ts_packet);
Line 42:		Line 42:

	static		static
-	void pidfilter_process_ts_packet (~~struct demux *d,~~ const unsigned char ts_packet[188])	+	void pidfilter_process_ts_packet (const unsigned char ts_packet[188])
	{		{
	unsigned short pid = ts_pid(ts_packet);		unsigned short pid = ts_pid(ts_packet);

Holger at 20:32, 1 November 2004

2004-11-01T20:32:14Z

← Older revision		Revision as of 20:32, 1 November 2004
Line 20:		Line 20:

	static		static
-	void ~~process_ts_packet~~ (struct demux *d, const unsigned char ts_packet[188])	+	void pidfilter_process_ts_packet (struct demux *d, const unsigned char ts_packet[188])
	{		{
	unsigned short pid = ts_pid(ts_packet);		unsigned short pid = ts_pid(ts_packet);
Line 42:		Line 42:

	static		static
-	void ~~process_ts_packet~~ (struct demux *d, const unsigned char ts_packet[188])	+	void pidfilter_process_ts_packet (struct demux *d, const unsigned char ts_packet[188])
	{		{
	unsigned short pid = ts_pid(ts_packet);		unsigned short pid = ts_pid(ts_packet);

Holger at 20:22, 1 November 2004

2004-11-01T20:22:34Z

← Older revision		Revision as of 20:22, 1 November 2004
Line 71:		Line 71:
	}		}
	</tt>		</tt>
		+
		+	== Section Filtering ==
		+
		+	Most DVB Hardware decoders provide so called ''Section Filters'', these allow to specify which MPEG and DVB section tables we want to receive in a particular queue.
		+
		+	But in practice these tables are organized in a way that we want to update our clock, EPG state and DSM-CC caroussels continously and enable all section filters on a particular PID in most cases. So it's questionable whether it makes sense to implement a similiar solution in future designs, simple PID filtering is usually sufficient.
		+
		+	The MPEG table decoder receives now all tables of an enabled PID, these are usually related anyways.

Holger at 20:16, 1 November 2004

2004-11-01T20:16:17Z

New page

== Introduction ==

A raw [[MPEG2 Transport Stream]] consists data of all the services transmitted on a particular transponder. The task on the receiver side is to filter out the interesting packets and schedule them to their target decoders: Audio packets to the audio-decoder, video packets to the video decoder, subtitle packets to the subtitle decoder etc...

MPEG2 TS packets are identified by the Packet ID, the PID. This is a 13-bit number located in the 2nd and 3rd byte of a TS packet.

== PID Filter Algorithm ==

The algorithm is easy: we simply check the 13 PID bits and look whether this PID is enabled in our PID filter list.

== PID Filter Sample Code (the easy way) ==

<tt>
static inline
unsigned short ts_pid (const unsigned char *ts_packet)
{
return ((ts_packet[1] & 0x1f) << 8) + ts_packet[2];
}

static
void process_ts_packet (struct demux *d, const unsigned char ts_packet[188])
{
unsigned short pid = ts_pid(ts_packet);

if (pid_is_enabled(pid))
pass_packet_to_decoder(ts_packet);
}
</tt>

== PID Filter Sample Code (with sanity checks) ==

This slightly extended version of the above code contains additional sanity checks that have been useful in the past:

<tt>
static inline
unsigned short ts_pid (const unsigned char *ts_packet)
{
return ((ts_packet[1] & 0x1f) << 8) + ts_packet[2];
}

static
void process_ts_packet (struct demux *d, const unsigned char ts_packet[188])
{
unsigned short pid = ts_pid(ts_packet);
unsigned char scrambling_control;

/**
* check TS error indicator bit and discard broken packets...
*/
if (ts_packet[1] & 0x80) {
bad_packet_counter++;
return;
}

/**
* this makes no sense - however, some transponders like to send
* packets with scrambling bits set which contain gaga data (??).
*
* In any case no scrambled packets should arrive in the demux,
* CSA descramblers are located before this stage of the pipeline.
*/
scrambling_control = (ts_packet[3] >> 6) & 0x03;

if (scrambling_control != 0)
return 0;

if (pid_is_enabled(pid))
pass_packet_to_decoder(ts_packet);
}
</tt>