Technical Documentation

SKYPE2RTC - TECHNICAL Specifications

Authors :	Pablo Queixalos	This document describes Skype2rtc implemention and how to use it.
Created :	14/08/2005
Modified :	12/03/2006

1.Introduction

Skype2RTC is a Skype plugin which provides an interface between Skype VoIP network and a PSTN line. In other words, it permits to call all over the world by Internet, using Skype and your home/office PSTN line.

VoIP to PSTN diagram

2.Features

Future :

• 'clean sound' gateway between Skype and PSTN or SkypeOut

• Secured user logon

• Multiple line support using SkypeOut or adding sound cards and voice-modems

• User rights filtering by mask

• Skype conference hosting

• Detailled and verbosed actions logging

• Remote administration (of the Skype2RTC bot)

• Statistics and reporting

• PSTN to Skype calls using "Skype short numbers"

Currently : (alpha 0.4.3)

• Skype API supported by SkypeAPILib

• login/logout

• Local administration of the users (GUI)

• Call (PSTN)

• Call and Chat (via Skype)

3.Security

Skype provides a encoded communication protocol between clients. You will not need to configure any firewall or proxy to use Skype2RTC. But your Skype client must be connected to the network. If not, the plugin will not be able to attach to the Skype Public API.

To secure the access of this PSTN line sharing system, you must define accounts. They are defined by three values :

• Login name

• Password

• Rights mask more details in part 5

• Call Limit

The rights mask field defines what the user can do. That means in wich country and how he will be able to phone using Skype2RTC. The mask also refers to the Call limitation.

4.Implementation

This plugin's implementation is based on the Skype Public API capabilities and the use of a PSTN voice-modem. Respectively, we imply the JNI and the whole of AT commands to do that.

Current Skype2RTC API implementation	Future Skype2RTC API implementation

0. SkypeAPI use

6.HOW TO

1.Hardware requirements

• PC 400 MHz processor / 128 MB RAM

• Sound card

• Voice modem like the OLITEC SelfMemory 56k

• Double male jack-jack cable

• Internet Connection

1.Software requirements

• Windows 2000 or XP

• Skype working well

• Java Runtime Environment

  • Libraries needed :

    • javax.comm For the serial port communication (RS232)

    • bridge2java See the SkypeAPILib

2.Wire connections

3.Commands

LOGIN

Synopsis :

Allows you to log in to the Skype2RTC bot running.

Syntax :

login [userName] [userPassword]

Exemple :

login admin passwd

LOGOUT

Synopsis :

Disconnects you from the Skype2RTC service.

You need to be logged on to execute this command.

Syntax :

logout

CALL

Synopsis :

Initiates a PSTN call. The following process is attempted :

1. The bot calls you by Skype.

2. When you pick up this call, the PSTN call is instantiated by the voice-modem.

You will hear the DTMF generation and the remote ring.

3. When you hang-up the skype call, the modem closes the line.

You need to be logged on to execute this command.

Syntax :

call [phoneNumber]

Exemple :

call 0033102030404

Glossary

DTMF : Dual Tone Multi-Frequency

PSTN : Public Switched Telephone Network

RTC : The PSTN french equivalent, « Réseau de Télephonie Commuté »

Bibliography

http://www.tldp.org/HOWTO/VoIP-HOWTO.html