Thread: [Redbutton-devel] SF.net SVN: redbutton: [35] www/index.html

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Revision: 35
Author:   skilvington
Date:     2006-04-03 03:53:33 -0700 (Mon, 03 Apr 2006)
ViewCVS:  http://svn.sourceforge.net/redbutton/?rev=35&view=rev

Log Message:
-----------
add remote backend description to web page

Modified Paths:
--------------
    www/index.html
Modified: www/index.html
===================================================================

--- www/index.html	2006-04-03 10:52:06 UTC (rev 34)
+++ www/index.html	2006-04-03 10:53:33 UTC (rev 35)
@@ -8,14 +8,17 @@
 RedButton allows you to use the interactive MHEG applications broadcast with DVB digital TV services.
 MHEG replaces the text only services available with analogue TV.
 <P>
-RedButton consists of two parts. The first, rb-download, allows MHEG data to be downloaded from a DVB service. The second, rb-browser, allows the downloaded MHEG applications to be displayed.
+RedButton consists of two parts. The first, rb-download, allows MHEG data to be downloaded from a DVB service.
+The second, rb-browser, allows the downloaded MHEG applications to be displayed.
+Both rb-download and rb-browser can be run on the same host,
+or rb-download can be run on a host with a DVB card and rb-browser can be run on a remote frontend without a DVB card.
 <P>
 The source for both is released under the GPL and can be
 <A HREF="http://sourceforge.net/project/showfiles.php?group_id=158629">downloaded here.</A>
 <P>
 Just un-tar them and type 'make'.
 <P>
-You can browser the latest version of the source
+You can browse the latest version of the source
 <A HREF="http://svn.sourceforge.net/redbutton/">here.</A>
 You can download the latest source code with the following Subversion command:
 <PRE>
@@ -27,18 +30,31 @@
 <H2>rb-download</H2>
 Usage:
 <PRE>
-rb-download [-d &lt;demux_device&gt;] [-b &lt;base_dir&gt;] [-t &lt;timeout&gt;] [-c &lt;carousel_id&gt;] [&lt;service_id&gt;]
+rb-download [-a &lt;adapter&gt;] [-b &lt;base_dir&gt;] [-t &lt;timeout&gt;] [-l[&lt;listen_addr&gt;]] [-c &lt;carousel_id&gt;] [&lt;service_id&gt;]
 </PRE>
 Download the DVB Object Carousel for the given channel onto the local hard disc.
 <P>
-The default demux device is /dev/dvb/adapter0/demux0.
-<P>
 If no directory is given with -b, files will be stored under the current directory.
 Note that &lt;base_dir&gt; must already exist and be writeable.
 <P>
 The default timeout is 10 seconds.
 If no DSM-CC data is found after this time, it is assumed none is being broadcast.
 <P>
+The DVB devices used will be:
+<ul>
+<li>/dev/dvb/adapter0/demux0</li>
+<li>/dev/dvb/adapter0/dvr0</li>
+</ul>
+use the -a option to change the adapter number (eg "-a 1" will use /dev/dvb/adapter1/demux0 etc).
+<P>
+If -l is given, rb-download listens on the network for commands from a remote rb-browser.
+The default IP to listen on is 0.0.0.0 (ie all interfaces), the default TCP port is 10101.
+The &lt;listen_addr&gt; should be given in the form "host:port", where host defaults to 0.0.0.0 and port defaults to 10101.
+Eg, to listen on a different port, do "-l8080",
+to only listen on the loop back, do "-l127.0.0.1" or on a different port too, do "-l127.0.0.1:8080".
+NOTE: because -l may or may not take an argument, you must not put a space between the -l and the value
+(otherwise, "rb-download -l 1234", is ambiguous - listen on port 1234 or use service_id 1234?).
+<P>
 The &lt;carousel_id&gt; will normally be read from the PMT, but you can use the -c option to explicitly choose a carousel.
 <P>
 If no &lt;service_id&gt; is given, a list of possible channels (and their &lt;service_id&gt;) is printed.
@@ -69,13 +85,29 @@
 <H2>rb-browser</H2>
 Usage:
 <PRE>
-rb-browser [-v] [-f] [-k &lt;keymap_config_file&gt] [-t &lt;timeout&gt;] &lt;service_gateway_dir&gt;
+rb-browser [-v] [-f] [-k &lt;keymap_config_file&gt] [-t &lt;timeout&gt;] [-r] &lt;service_gateway&gt;
 </PRE>
 Display the MHEG apps downloaded with rb-download.
-The &lt;service_gateway_dir&gt; should be one of the entries in the services directory, eg
+<P>
+The -r option means use a remote backend (rb-download running on another host).
+If -r is specified, then &lt;service_gateway&gt; should be the host[:port] that "rb-download -l" is running on.
+If -r is not specified, rb-download is running on the same machine
+and &lt;service_gateway&gt; should be an entry in the services directory.
+Eg, on a single host, do this:
 <PRE>
+rb-download 4165 > /dev/null &amp;
 rb-browser services/4165
 </PRE>
+To run the frontend on a different host, do this on the backend:
+<PRE>
+rb-download -l 4165 > /dev/null &amp;
+</PRE>
+and run this on the frontend:
+<PRE>
+rb-browser -r 10.0.0.1
+</PRE>
+where 10.0.0.1 is the IP or hostname of the backend.
+<P>
 It will display the app in a window, use -f for full screen mode.
 <P>
 The -v flag enables verbose/debug mode.
@@ -109,8 +141,7 @@
 <P>
 To run it you need an X server that supports the Xrender extension and you need to have libpng, libmpeg2 and freetype2 installed.
 <H2>Notes</H2>
-It's not finished yet!
-It'll only draw text, rectangles and PNG bitmaps at the moment and some of the ElementaryActions are not yet implemented.
+It'll only draw text, rectangles and bitmaps at the moment and some of the ElementaryActions are not yet implemented.
 However, it is enough to be usable.
 The main things missing are video and audio streams, at the moment it'll just draw a green box where any video should be.
 <P>


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.





Thread: [Redbutton-devel] SF.net SVN: redbutton: [35] www/index.html

redbutton-devel