aboutsummaryrefslogtreecommitdiffstats
path: root/doc/realtimetext.txt
blob: 1f706fe900e585ada422b7f2514d605cd2392152 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
Real-time text in Asterisk 
--------------------------
The SIP channel has support for real-time text conversation calls in Asterisk (T.140).
This is a way to perform text based conversations in combination with other media,
most often video. The text is sent character by character as a media stream.

The supported real-time text codec is t.140.
Real-time text redundancy support is now available in Asterisk.

ITU-T T.140 
-----------
You can find more information about T.140 at www.itu.int. RTP is used for the transport T.140,
as specified in RFC 4103.

How to enable T.140
-------------------
In order to enable real-time text with redundancy in Asterisk, modify sip.conf to add: 

	[general]
	disallow=all
	allow=ulaw
	allow = alaw
	allow=t140
	textsupport=yes
	videosupport=yes ; needed for proper SDP handling even if only text and voice calls are handled
	allow=h263 ; at least one video codec as H.261, H.263 or H.263+ is needed. 

The codec settings may change, depending on your phones. The important settings here are to allow
t140 to enable text support.

General information about real-time text support in Asterisk 
------------------------------------------------------------
With the configuration above, calls will be supported with any combination of real-time text, 
audio and video. 

Text (t140) is handled on channel and application level in Asterisk conveyed in
text frames, with the subtype "t140". Text conveyed in such frames usually only contains one or
a few characters from the real-time text flow. The packetization interval is 300 ms, handled on lower
RTP level, and transmission redundancy level is 2, causing one original and two redundant transmissions
of all text so that it is reliable even in high packet loss situations. 

Clients known to support text, audio/text or audio/video/text calls with Asterisk: 
----------------------------------------------------------------------------------

- Omnitor Allan eC - SIP audio/video/text softphone 
- AuPix APS-50 - audio/video/text softphone.
- France Telecom eConf –audio/video/text softphone.
- SIPcon1 - open source SIP audio/text softphone available in Sourceforge. 


Limitations
-----------

A known general problem with Asterisk is that when a client which uses audio/video/T.140 calls to 
an Asterisk with T.140 media offered but video support not specified. In this case Asterisk handles
the sdp media description (m=) incorrectly, and the sdp response is not created correctly. 
To solve this problem, turn on video support in Asterisk. 

Modify sip.conf to add
	[general] 
	videosupport=yes 
	allow=h263 ; at least one video codec as H.261, H.263 or H.263+ is needed.

The problem with sdp is a bug and is reported to Asterisk bugtracker, it has id 0012434. 

Credits
-------
 - Asterisk real-time text support is developed by AuPix
 - Asterisk real-time text redundancy support (in trunk) is developed by Omnitor

The work with Asterisk real-time text redundancy was supported with funding from the National Institute
on Disability and Rehabilitation Research (NIDRR), U.S. Department of Education, under grant number 
H133E040013 as part of a co-operation between the Telecommunication Access Rehabilitation Engineering
Research Center of the University of Wisconsin – Trace Center joint with Gallaudet University, and Omnitor.
Olle E. Johansson, Edvina AB, has been a liason between the Asterisk project and this project.