How to Modify the UCHe Configuration File

Page Contents:

File Location

The UCH configuration file is located at: [Apache_HOME]/cgi-bin/uch.config.

In case of UCHe installation with Apache, the location is /usr/local/[ApacheFolder]/cgi-bin/uch.config.

Basic Settings

1. Set the debug level to a number between 0 and 3:

   <debug>0</debug>

   Available debug levels:

   • 3 - information + warning + error
   • 2 - warning + error
   • 1 - error
   • 0 - no log file (recommended)

2. Specify the IP address of the server, as in the following example:

   <ipAddress>192.168.1.1</ipAddress>

   Note: Replace "192.168.1.1" in the above example with the IP address of your server.

Add and configure TDM

Set the properties for each TDM in <tdmList>, for example:

    <tdmList>
        <tdm>
    	<prop>
	     <name>tdmDLL</name>
	     <value>/usr/local/armapache/cgi-bin/libUpnpTDM.so</value>
	    </prop>
	    <prop>
	     <name>http://myurc.org/ns/res#type</name>
	     <value>http://myurc.org/restypes#tdm</value>
	    </prop>
	    <prop>
	     <name>http://purl.org/dc/elements/1.1/title</name>
	     <value>UPnP-TDM</value>
	    </prop>
	    <prop>
	     <name>http://purl.org/dc/terms/modified</name>
	     <value>2008-06-01T12:30:00Z</value>
	    </prop>
            <prop>
             <name>http://purl.org/dc/terms/conformsTo</name>
             <value>http://myurc.org/TR/uch-20080611/</value>
            </prop>
        </tdm>
    </tdmList>
    

Multiple TDMs can be added under <tdmList> for disovering devices of different networking platforms.

Add and configure TA

Set the properties for each TA in <taList>, for example:

    <taList>
	<ta>
	    <prop>
	     <name>taDLL</name>
	     <value>/usr/local/armapache/cgi-bin/libUpnpSatelliteBoxAdapter.so</value>
	    </prop>
            <prop>
	     <name>http://myurc.org/ns/res#type</name>
	     <value>http://myurc.org/restypes#ta</value>
	    </prop>
            <prop>
             <name>http://purl.org/dc/terms/conformsTo</name>
             <value>http://myurc.org/TR/uch-20080611/</value>
            </prop>
	    <prop>
	     <name>http://myurc.org/ns/res#deviceType</name>
	     <value>urn:schemas-upnp-org:device:satellitebox:1</value>
	    </prop>
	    <prop>
	     <name>http://myurc.org/ns/res#devicePlatform</name>
	     <value>UPnP</value>
	    </prop>
            <prop>
	     <name>http://purl.org/dc/terms/modified</name>
	     <value>2008-06-01T12:30:00Z</value>
	    </prop>
	</ta>
    </taList>

Multiple TAs can be added under <taList> for controlling different devices in the Network.

Add and configure UIPM

Set the properties of each UIPM in <uipmList>, for example:

    <uipmList>
	<uipm>
	    <prop>
	     <name>uipmDLL</name>
	     <value>/usr/local/armapache/cgi-bin/libUrcHttpUIPM.so</value>
	    </prop>
            <prop>
	     <name>http://myurc.org/ns/res#type</name>
	     <value>http://myurc.org/restypes#uipm</value>
	    </prop>
            <prop>
             <name>http://purl.org/dc/terms/conformsTo</name>
             <value>http://myurc.org/TR/uch-20080611/</value>
            </prop>
            <prop>
	     <name>http://purl.org/dc/terms/modified</name>
	     <value>2008-06-01T12:30:00Z</value>
	    </prop>
	    <prop>
	     <name>http://purl.org/dc/elements/1.1/title</name>
	     <value>URC-HTTP UIPM</value>
	    </prop>
	    <prop>
	     <name>http://myurc.org/ns/res#forTargetName</name>
	     <value>*</value>
	    </prop>
	    <prop>
	     <name>http://myurc.org/ns/res#urlBasePath</name>
	     <value>/urchttp</value>
	    </prop>
	    <prop>
	     <name>http://myurc.org/ns/res#urlPortNo</name>
	     <value>8888</value>
	    </prop>
	    <prop>
	     <name>http://myurc.org/ns/res#protocolShortName</name>
	     <value>URC-HTTP</value>
	    </prop>
	    <prop>
	     <name>http://myurc.org/ns/res#forSocketName</name>
	     <value>*</value>
	    </prop>
	</uipm>
    </uipmList>

Multiple UIPMs can be added under <uipmList> for implementing different protocols for remote control clients (controllers).