Testbed Readme - Revision history

MediaWiki default at 00:55, 4 October 2008

2008-10-04T00:55:28Z

MediaWiki default at 04:56, 29 September 2008

2008-09-29T04:56:43Z

MediaWiki default at 04:47, 29 September 2008

2008-09-29T04:47:36Z

MediaWiki default at 04:44, 29 September 2008

2008-09-29T04:44:31Z

MediaWiki default at 04:30, 29 September 2008

2008-09-29T04:30:52Z

MediaWiki default at 04:16, 29 September 2008

2008-09-29T04:16:19Z

Yliu: New page: == Presetup: == login with proper account, know the bandwidth and frequency of DVB-H network, start PCI card with the following command /DVB-H/Dta1xx/Dta1xxInit start ==File folder stru...

2008-09-19T03:59:24Z

New page: == Presetup: == login with proper account, know the bandwidth and frequency of DVB-H network, start PCI card with the following command /DVB-H/Dta1xx/Dta1xxInit start ==File folder stru...

New page

== Presetup: ==
login with proper account, know the bandwidth and frequency of DVB-H network, start PCI card with the following command
/DVB-H/Dta1xx/Dta1xxInit start

==File folder structures==

(1) /nsltester/DVBH-Encapsulator

this folder is used to keep Encapsulator source files, whenever you change something in Encapsulator, you need to make again. See
/nsltester/DVBH-Encapsulator/Makefile for more details

make

make install

(they are installed to /usr/local/bin)

(2) /nsltester/DVBH-Encapsulator/doxgen

this folder is used for doxgen of DVB-H Encapsulator

(3) /nsltester/DVBH-Encapsulator/media

this folder is used to keep video source files

(4) /nsltester/DVBH-Encapsulator/<test*>/log4crc

this files is used to control the log level, remember DVB-H Encapsulator use log4c, the log files are kept in
/nsltester/DVBH-Encapsulator/<test*>/logs

Note: each test will have its own log files, e.g. for test1, the logs are under /nsltester/DVBH-Encapsulator/test1/logs

(5) /nsltester/DVBH-Encapsulator/test*

these folders are used for DVB-H demo, each folder test a feature.

==Test1: only play one video program, no ESG==

cd /nsltester/DVBH-Encapsulator/test1
./run.py (it will call test1.sh, see the following for details)

After the test:
./stop.py (it just do some system call to kill process)

steps:

1.1 start vlc to play the video file (done by test1.sh)

1.2 start DataAggregator (proxy) to get the packet (done by test1.sh)

1.3 start timeslicer (done by test1.sh)

1.4 add PSI/SI info (done by run.py)

1.5 use Dtplay to send DVB-H signal (done by run.py)

==Test2: one video program and its ESG==

cd /nsltester/DVBH-Encapsulator/test2
./run.py (it will call test2.sh, see the following for details)

After the test:
./stop.py

steps:

2.1 (a) start vlc to play the video file (done by test2.sh)

2.1 (b) start flute to send ESG files (done by test2.sh)

2.2 (a) start DataAggregator (proxy) to get the packet from vlc (done by test2.sh)

2.2 (b) start DataAggregator (proxy) to get the packet from flute (done by test2.sh)

2.3 start timeslicer (done by test2.sh)

2.4 add PSI/SI info (done by run.py)

2.5 use Dtplay to send DVB-H signal (done by run.py)

==Test3: three video programs, and one ESG==

cd /nsltester/DVBH-Encapsulator/test3
./run.py (it will call test3.sh, see the following for details)

After the test:
./stop.py

steps:

3.1 (a) start vlc to play three video files (done by test3.sh)

3.1 (b) start flute to send ESG files (done by test3.sh)

3.2 (a) start three DataAggregator (proxy) to get the packet from vlc (done by test3.sh)

3.2 (b) start one DataAggregator (proxy) to get the packet from flute (done by test3.sh)

3.3 start timeslicer (done by test3.sh)

3.4 add PSI/SI info (done by run.py)

3.5 use Dtplay to send DVB-H signal (done by run.py)

@@ Line 56: / Line 56: @@
 # mux PSI/SI tables with the MPEG-2 traffic stream (by run.py)
 # start Dtplay to send MPEG-2 traffic stream over-the-air (by run.py)
 == Start Test Cases with Web UI ==
 XXX to be completed XXX

@@ Line 3: / Line 3: @@
 The subversion link of the mobile TV project is:
 https://cs-svn.cs.surrey.sfu.ca/svn/nsl
-The directory should be self-contained: users can set up a base station with only Ubuntu and our project directory. To achieve this, please keep our code within the project directory, and create symbolic links if necessary. For example, Apache server may access web files, which reside in /home/cly/DVB-H/web, through a link.
+The directory should be self-contained: users can set up a base station with only Ubuntu and our project directory. To achieve this, please keep our code within the project directory, and create symbolic links if necessary. For example, Apache server may access web files, which reside in /home/cly/DVB-H/web, through a link. Notice that we keep binaries that do not come with Ubuntu packages (such as timeslicer and sec2ts) in our bin/ directories. Common binaries (such as argtable2-dev) are installed through apt-get in /usr or /usr/local.
 The current directory structure is as the following:
@@ Line 37: / Line 37: @@
 `-- logs                           log files of log4c, whose granularity is controlled by log4crc
 </pre>
 The run.py, launch.sh, and stop.py, describe how we invoke/combine the utilities for a complete base station solution. We give a high-level, itemized, startup procedure below. Please read these three scripts for more details.

@@ Line 38: / Line 38: @@
 </pre>
-The run.py, launch.sh, and stop.py, reveal details on how we connect the utilities together for a complete base station solution. We give a high-level, itemized, startup procedure below. Please read these three scripts for more details.
+The run.py, launch.sh, and stop.py, describe how we invoke/combine the utilities for a complete base station solution. We give a high-level, itemized, startup procedure below. Please read these three scripts for more details.
+# start vlc to stream video files  (by launch.sh)
-Common steps to start the DVB-H service:
+# start flute to send ESG files (by launch.sh)
-# start vlc to stream video files  (by test2.sh)
+# start dataaggregator to capture packets from vlc into temp files (by launch.sh)
-# start flute to send ESG files (by test2.sh)
+# start dataaggregator to capture packets from flute into temp files (by launch.sh)
-# start dataaggregator to capture packets from vlc into temp files (by test2.sh)
+# start timeslicer to encapsulate IP streams into a MPEG-2 traffic stream  (by launch.sh)
 # call python code to generate PSI/SI tables, and store them in a temp file (by run.py)
 # mux PSI/SI tables with the MPEG-2 traffic stream (by run.py)
 # start Dtplay to send MPEG-2 traffic stream over-the-air (by run.py)

@@ Line 38: / Line 38: @@
 </pre>
+Common steps to start the DVB-H service:
-== Presetup: ==
+# start vlc to stream video files  (by test2.sh)
-login with proper account, know the bandwidth and frequency of DVB-H network, start PCI card with the following command
+# start flute to send ESG files (by test2.sh)
-  /DVB-H/Dta1xx/Dta1xxInit start
+# start dataaggregator to capture packets from vlc into temp files (by test2.sh)
+# start dataaggregator to capture packets from flute into temp files (by test2.sh)
-==File folder structures==
+# start timeslicer to encapsulate IP streams into a MPEG-2 traffic stream  (by test2.sh)
+# call python code to generate PSI/SI tables, and store them in a temp file (by run.py)
-(1) /nsltester/DVBH-Encapsulator
+# mux PSI/SI tables with the MPEG-2 traffic stream (by run.py)
+# start Dtplay to send MPEG-2 traffic stream over-the-air (by run.py)

@@ Line 5: / Line 5: @@
 The directory should be self-contained: users can set up a base station with only Ubuntu and our project directory. To achieve this, please keep our code within the project directory, and create symbolic links if necessary. For example, Apache server may access web files, which reside in /home/cly/DVB-H/web, through a link.
-The current directory structure looks like:
+The current directory structure is as the following:
-<tt><pre>
+<pre>
+.
 |-- bin                           binaries for DVB-H service
@@ Line 23: / Line 23: @@
 `-- web                          web user interface
      `-- configs
-</pre></tt>
+</pre>

← Older revision		Revision as of 04:16, 29 September 2008
Line 1:		Line 1:
		+	== Directory Structure of DVB-H Project ==
		+
		+	The subversion link of the mobile TV project is:
		+	https://cs-svn.cs.surrey.sfu.ca/svn/nsl
		+	The directory should be self-contained: users can set up a base station with only Ubuntu and our project directory. To achieve this, please keep our code within the project directory, and create symbolic links if necessary. For example, Apache server may access web files, which reside in /home/cly/DVB-H/web, through a link.
		+
		+	The current directory structure looks like:
		+	<tt><pre>
		+	.
		+	\|-- bin binaries for DVB-H service
		+	\|-- media sample video files
		+	\|-- scripts test scripts to launch test configurations
		+	\| `-- esg_ipdc_test test case with IPDC ESG and one TV channel
		+	\|-- src (possibly modified) source code for programs not supported by Ubuntu
		+	\| \|-- LinuxSDK driver and API of the modulator card
		+	\| \|-- OpenCaster DVB-T utilities, note that it only works with Python 2.4
		+	\| \|-- enc_proto an early IPE prototype used to evaluate our algorithms (based on fatcaps)
		+	\| \|-- fatcaps_v0.5 IP Encapsulator
		+	\| \|-- fec-3.0.1 FEC library used by fatcaps
		+	\| \|-- flute mad flute code, we only use its simple sender
		+	\| `-- log4c-1.2.1 logging library for C programs
		+	\|-- tar (unmodified) source code from other projects
		+	`-- web web user interface
		+	`-- configs
		+	</pre></tt>
		+
		+
		+
	== Presetup: ==		== Presetup: ==
	login with proper account, know the bandwidth and frequency of DVB-H network, start PCI card with the following command		login with proper account, know the bandwidth and frequency of DVB-H network, start PCI card with the following command