<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> <title>Internet Communications Software Update for N800: Development version</title> <style type="text/css"> body { text-align:left; background-color:white; font-family: Arial,Helvetica,sans-serif; color: black; } .heading { border-bottom:1px solid black; text-align:right; } h1.heading_main { text-align:left; margin:0 0 0 0; font-family: Arial,Helvetica,sans-serif; } span.qmenu, span.dev_note { margin:0 0 0 0; text-align:right; border:1px solid black; background:white; padding:4px 4px 4px 4px; } span.dev_note { color:silver; position:relative; bottom:-0.5em; } div.qmenu { text-align:left; position:relative; bottom:-0.5em; float:left; } span.qmenu { padding-left:10px; padding-right:10px; margin-right:10px; } a.qmenu { font-weight:bold; text-decoration:none; color: green; } .TOC { border-right:1px solid black; border-bottom:1px solid black; float:left; margin-right:20px; margin-bottom:10px; padding-left:0px; padding-top:10px; padding-bottom:10px; padding-right:10px; } .content { margin-left:auto; margin-right:auto; margin-top:10px; text-align:justify; width:800px; padding-left:5px; padding-right:30px; } .fea_tab { margin-left:10px; margin-right:10px; margin-bottom:10px; padding-right:10px; padding-left:10px; text-align:left; } #sip_fea { } #ava_fea { } h2 { clear:both; } img.screenshot { width:400px; border:1px solid black; } div.main { background: url('img/calling.png'); background-position:top right; background-repeat:no-repeat; } a.bigbutton { color: white; } div.endheading { width:100%; text-align:right; border-bottom:1px solid black; } a.gotop, a.gotop_part { position:relative; right:0em; bottom:-0.5em; background:white; padding:2px 2px 2px 2px; text-transform:capitalize; font-size:small; text-decoration:none; color:green; border-bottom:1px solid black; border-right:1px solid black; } a.gotop { border-left:1px solid black; border-top:1px solid black; } span.notsup { color:#CC3333; font-size:small; } span.pre { font-family: Courier; } </style> </head> <body> <div class="content"> <div class="heading"> <a name="top"/><h1 class="heading_main">Internet Communications Software Update 2 for N8x0 (IT OS2008)</h1> <div class="qmenu"> <span class="qmenu"><a class="qmenu" href="#install2">Install</a></span> <span class="qmenu"><a class="qmenu" href="#usage">Use</a></span> <span class="qmenu"><a class="qmenu" href="#feedback">Give feedback</a></span> </div> <span class="dev_note">Development version</span> </div> <p style="padding-top:20px"> Internet Communications Software is a subsystem in Internet tablet OS 2008, running on Nokia n8x0 devices, that handles presence, chat, voip and video call. It is based on Telepathy framework and components as explained at <a href="http://telepathy.freedesktop.org/">http://telepathy.freedesktop.org/</a> </p> <div class="main"> <h2>Added and updated features</h2> <div class="fea_tab" id="haze_fea"> <h3>Telepathy-haze</h3> <p> Now you can use nearly all of the great IM services supported by pidgin (formerly known as gaim) open-source application - all from the comfort for your native IM/Voip client in your N8x0 device. </p><p> To see the list of services/protocols supported by pidgin, visit: <a href="http://www.pidgin.im/">http://www.pidgin.im/</a>. Please note that not all protocols are enabled for now, but can be done on request :) . </p><p> To use it, simply create your IM account in the device normally and the wizard will let you select the type of service you want (you will see more services listed there). </p> </div> <div class="fea_tab" id="salut_fea"> <h3>Telepathy-salut</h3> <p> Be connected to your neighbourhood instantly. This is a link-local instant messaging that requires no external service or server. Your buddy list (roster) will automatically consist of everyone present in the local network. Extremely useful for on-the-spot social networking in parties or conferences :) . </p><p> At some point in future when we support inter-application communications via Telepaty, you will be able to use this feature for playing multiplayer games and such with nearby people. </p><p> Oh, and it is zero configuration IM. You only set your full name for others to see. To use it, simply create an account using the wizard in and select 'link-local (xmpp)' as the service. </p> </div> <div class="fea_tab"> <h3>Chat log viewer</h3> <p> If you have wished you could see your past chat messages for reference or simply to recall some important information, worry no more. With IMLogViewer application (installed in 'Extra' application menu), you will be able to see all your past chat messages exchanged with your friends. </p> </div> <div class="fea_tab"> <h3>SIP Profiles</h3> <p> There is now some pre-configured SIP profiles for some major providers. This would easy configuring SIP accounts in the device. They are: <ul> <li>Ekiga.net</li> <li>FreeWorldDialup</li> <li>Sipphone.com (same as used by gizmo)</li> </ul> </p> </div> <div class="endheading"><a class="gotop" href="#top">Top</a></div> <h2><a name="install2"></a>Installation</h2> <ol> <li>You need to enable 'red pill mode' in Application Manager. <ol> <li> Start "Settings > Application Manager".</li> <li>Go to "Tools > Application catalogue", click "New".</li> <li>Enter "matrix" into the "Web Address" field and click "Cancel".</li> <li>Choosing the red pill will activate the red pill mode, obviously, and chosing the blue one will deactivate it.</li> </ol> </li> <li>Open this webpage in your N8x0 device.</li> <li><a href="http://rtcomm.garage.maemo.org/deb/rtcomm-beta-installer-os2008_0.3_armel.deb"> Install the installer from here</a> (click on this link while on your N8x0)</li> <li>Once installed, select the menu item "Extras/RTCom update installer" and continue</li> <li>When asked, reboot</li> <li> Once rebooted, make sure to disable 'red pill mode' by repeating step (1) and selecting 'blue pill' instead. </li> </ol> </p> <div class="endheading"><a class="gotop" href="#top">Top</a></div> <h2><a name="install2"></a>Limitations</h2> <p> <ol> <li>No audio/video calls with either telepathy-haze or telepathy-salut</li> <li>No avatars support yet with telepathy-salut</li> <li>No authorization of new contacts in telepathy-haze. Adding/removing buddies won't work from it.</li> <li>telepathy-salut may crash occasionally and when it happens it keeps crashing repeatedly due to auto-reconnections. Just go offline and online again to fix it (until the next crash). This will be fixed pretty soon</li> </ol> </p> <div class="endheading"><a class="gotop" href="#top">Top</a></div> <h2><a name="install2"></a>Credits</h2> <p> Thanks to: Will Thompson (telepathy-haze guy) and Sjoerd Simons (telepathy-salut guy) for their great telepathy connection managers. Telepathy community for improving everything in general. Collabora, Maemo Rtcomm team, Desktop team and everyone else who has helped it get through. </p> <div class="endheading"><a class="gotop" href="#top">Top</a></div> <h2><a name="feedback"></a>Feedback</h2> You are welcome to give your feedback on this software to: <ul> <li><a href="mailto:maemo-developers@maemo.org">maemo-developers mailing list</a></li> <li><a href="http://bugzilla.maemo.org">Maemo bugzilla, rtcomm component</a>. See currenly open bugs <a href="https://bugs.maemo.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=rtcomm&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailqa_contact2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=">here</a>.</li> <li><a href="mailto:rtcomm@maemo.org">Our mailing address</a></li> </ul> Along with that, you are also welcome to participate in and comment to the lists/bugtrackers of the following relevant open-source projects which are part of the Internet Communications Software: <ul> <li>Telepathy, incl. Gabble: <a href="http://telepathy.freedesktop.org/">http://telepathy.freedesktop.org/</a></li> <li>Telepathy Mission Control: <a href="http://sourceforge.net/projects/mission-control/">http://sourceforge.net/projects/mission-control/</a></li> <li>Farsight: <a href="http://farsight.freedesktop.org/">http://farsight.freedesktop.org/</a></li> <li>Telepathy-SofiaSIP: <a href="http://sourceforge.net/projects/tp-sofiasip/">http://sourceforge.net/projects/tp-sofiasip/</a></li> <li>Sofia SIP stack: <a href="http://sourceforge.net/projects/sofia-sip/">http://sourceforge.net/projects/sofia-sip/</a></li> <li>Evolution Data Server for Maemo: <a href="https://garage.maemo.org/projects/eds/">https://garage.maemo.org/projects/eds/</a></li> </ul> <div class="endheading"><a class="gotop" href="#top">Top</a></div> <h2><a name="devels"></a>Information for developers</h2> <p>To write accounts setup wizard UI for new Telepathy Connection Managers in N8x0 device, see the <a href="/docs/libaccounts">API documentation</a> of Control panel accounts library.</p> <div class="endheading"><a class="gotop" href="#top">Top</a></div> <br> <br> <br> <br> <br> <br> <br> <br> <br> <br> <font color="red">Older releases</font> <div class="endheading"><a class="gotop" href="#top">Top</a></div>  <div class="heading"> <a name="top"/><h1 class="heading_main">Internet Communications Software Update for N800</h1> <div class="qmenu"> <span class="qmenu"><a class="qmenu" href="#install">Install</a></span> <span class="qmenu"><a class="qmenu" href="#usage">Use</a></span> <span class="qmenu"><a class="qmenu" href="#feedback">Give feedback</a></span> </div> <span class="dev_note">Development version</span> </div>  <p style="padding-top:20px">Internet Communications Software is a subsystem that handles presence, chat, voip and video calls. This projects intends to deliver an early access development version of the subsystem to run on <span style="color:red">Internet tablet OS 2007</span></p> <p>This software will be officially included in maemo 4.0 Chinook release.</p> <div class="main"> <h2>Added and updated features</h2> <div class="fea_tab" id="sip_fea"> <h3>SIP support</h3> <ul> <li>Basic one-to-one VoIP calls</li> <li>Messaging (using the MESSAGE method of SIMPLE).</li> <li>Video call between two N800 devices.</li> <li>NAT traversal using STUN. </li> </ul> </div> <div class="fea_tab" id="ava_fea"> <h3>XMPP support enhancements</h3> <ul> <li>Avatars support</li>  <li>Presence status message</li> <li>Google Talk relay support</li> </ul> </div> <div class="fea_tab"> <h3>User interface updates</h3> <ul> <li>Updates in the Internet call UI</li> <li>Updates in the Chat UI</li> <li>Updates in the Account configuration UI</li> <li>Updates in the Addressbook UI</li> </ul> </div> <div class="fea_tab"> <h3>New APIs</h3> <ul> <li>Telepathy</li> <li>Mission Control</li> <li>Accounts</li> <li>Telepathy-glib</li> </ul> </div> <div class="endheading"><a class="gotop" href="#top">Top</a></div> <h2><a name="install"></a>Installation</h2> <ol> <li><a href="http://rtcomm.garage.maemo.org/deb/osso-rtcom-installer_0.2_armel.deb"> Install the installer from here</a>(click on this link while on your N800)</li> <li>Once installed, select the menu item "Extras/RTCom update installer" and continue</li> <li>When asked, reboot</li> </ol> <p>Note: This is a known issue that the software update may not be installable in case some other conflicting packages have been installed by a user (i.e. "contacts" from the Pimlico suite). If you experience such a problem please remove all these third party packages and try to install the update again. </p> <h3>Staying up to date</h3> <img src="img/appman.png" alt="Check for updates in Application manager"/> <p>Our repository is <span class="pre">http://repository.maemo.org/rtcomm bora free</span></p> <div class="endheading" style="border:none"><a class="gotop_part" href="#top">Top</a></div> <h2 style="padding-bottom:1em; border-bottom:1px solid black;"><a name="usage"></a>Usage</h2> <div class="qmenu" style="position:relative; top:-2em;"> <span class="qmenu"><a class="qmenu" href="#use_sip">Create SIP account</a></span> <span class="qmenu"><a class="qmenu" href="#use_pstn">Call to phone numbers</a></span> <span class="qmenu"><a class="qmenu" href="#use_avatar">Set avatar</a></span> <span class="qmenu"><a class="qmenu" href="#use_tips">Tips</a></span> </div> <a name="use_sip"/><h3 style="clear:both">Creating SIP Account</h3> <p>Open Control Panel:</p>  <p>Select Accounts:</p>  <p>Press New, then Next</p>  <p>Select SIP</p> <img class="screenshot" src="img/acct/acct05.png" alt="Select SIP"/> <p>Enter your SIP credentials</p> <img class="screenshot" src="img/acct/acct06.png" alt="Enter your credentials"/> <p>If you need to change advanced settings, press "Advanced": (see <a href="#use_tips">Tips</a>)</p> <p> Advanced SIP settings, Connection tab</p> <img class="screenshot" src="img/acct/acct06a.png" alt="Connection Tab"/> <p><b>Transport settings</b>: Set transport for SIP signalling</p> <ul> <li>Auto - Automatically select SIP transport</li> <li>UDP - Use UDP SIP transport</li> <li>TCP - Use TCP SIP transport</li> <li>TLS - Use TLS SIP transport (<span class="notsup">Not supported yet</span>)</li> <li>TCP via HTTP proxy - Use TCP via HTTP proxy (<span class="notsup">Not supported yet</span>)</li> <li>TLS via HTTP proxy - Use TLS via HTTP proxy (<span class="notsup">Not supported yet</span>)</li> </ul> <p><b>Outgoing proxy</b>: Set outgoing SIP proxy</p> <p><b>Port</b>: Set SIP port</p> <p><b>Discover public address</b>: Discover public address for signalling</p> <p><b>Keepalive mechanism</b>: Way to keep the SIP connection alive</p> <ul> <li>Auto - Select automatically</li> <li>Register - Use REGISTER method</li> <li>Options - Use OPTIONS method</li> <li>Off - No keepalives</li> </ul> <p><b>Keepalive frequency</b>: How often to send keepalives (sec). 0:Automatically select</p> <p> Advanced SIP settings, Authentication tab</p> <img class="screenshot" src="img/acct/acct06b.png" alt="Authentication tab"/> <p><b>Authentication username/password</b> - Use these credentials for foreign domains if requested</p> <p> Advanced SIP settings, STUN tab</p> <img class="screenshot" src="img/acct/acct06c.png" alt="STUN tab"/> <p><b>Autodetect STUN</b> - Use SRV record to detect stun server</p> <p><b>STUN server/STUN port</b> - Manually specify STUN server/port</p> <div class="endheading"><a class="gotop" href="#top">Top</a></div> <a name="use_pstn"/><h3>Calling to phone numbers</h3> <p>Once SIP account is set, it is assumed that you can call to the PSTN numbers using this account. There are two ways:</p> <h4>Call from addressbook</h4> <p>Select a contact from addressbook having a Phone Number field set, press "Contact details" button (or choose Contact-Details from the menu)</p> <img class="screenshot" src="img/ab/ab3.png" alt="Contact details"/> <p>Click on the phone number. The Call UI should start and this number called</p> <img class="screenshot" src="img/call/ic1.png" alt="Calling"/> <h4>Manually dial from Call UI</h4> <p>Open Call UI, Press the Dialpad button</p> <img class="screenshot" src="img/call/01.png" alt="Call UI"/> <p>Enter the number desired, country code included (as requested by the provider)</p> <img class="screenshot" src="img/call/02.png" alt="Enter number"/> <p>Press "Dial"</p> <img class="screenshot" src="img/call/03.png" alt="Calling"/> <div class="endheading"><a class="gotop" href="#top">Top</a></div> <a name="use_avatar"/><h3>Adding avatar to Jabber/Google Talk account</h3> <p>Go to Control Panel - Accounts. Select your Jabber/Google Talk account, press Edit, Then Next</p> <img class="screenshot" src="img/acct/acct-j1.png" alt="Account setup: Details tab"/> <p>Press "Change" button to set/change an avatar</p> <p>Select an image for avatar</p> <img class="screenshot" src="img/acct/acct-j2.png" alt="Select image for avatar"/> <p>Press "Change" button to set/change an avatar</p> <p>Resize/crop an image to get the desired results. Once done press "OK".</p> <img class="screenshot" src="img/acct/acct-j3.png" alt="Manipulate"/> <p>You are done.</p> <img class="screenshot" src="img/acct/acct-j4.png" alt="Avatar set"/> <p>Now press Next and then Finish</p> <div class="endheading"><a class="gotop" href="#top">Top</a></div>  <a name="use_tips"/><h3>Tips and tricks</h3> <h4>Using sipphone.com service</h4> 1. Sipphone SIP service does not support chat. <br/> 2. When configuring an account: <br/> - enter proxy01.sipphone.com as a domain <br/> - enter stun01.sipphone.com as a stun server(advanced settings) <br/> - select UDP transport (advanced settings) <div class="endheading"><a class="gotop" href="#top">Top</a></div> <h2><a name="limitations"></a>Limitations</h2> This is work in progress, thus: <h3>UI</h3> <ul> <li>Helps are missing</li> <li>It only speaks English</li> <li>Theming is missing (only default one is supported)</li> </ul> <h3>SIP</h3> <ul> <li>Calls fail to establish media streams when the device is behind a symmetric NAT and the proxies do not deploy transparent media relaying. </li> <li>Calls forked to multiple endpoints may fail to establish media streams.</li> <li>Video is not interoperable with other implementations.</li> <li>DTMF (<a href="http://www.rfc-editor.org/rfc/rfc4733.txt">RFC4733</a>) is not reliable</li> </ul> <h2><a name="issues"></a>Known issues</h2> <ul> <li>The update may break the application "E-mail" (<a href="https://bugs.maemo.org/show_bug.cgi?id=1667">https://bugs.maemo.org/show_bug.cgi?id=1667</a>)</li> </ul> <div class="endheading"><a class="gotop" href="#top">Top</a></div> </div></div> </body> </html>