some mods in the text
This commit is contained in:
Volker Fischer
parent
c94413e086
commit
4834c79d07
1 changed files with 59 additions and 53 deletions
112
README
112
README
|
|
@ -1,5 +1,5 @@
|
||||||
/******************************************************************************\
|
/******************************************************************************\
|
||||||
* Copyright (c) 2004-2006
|
* Copyright (c) 2004-2008
|
||||||
*
|
*
|
||||||
* Author(s):
|
* Author(s):
|
||||||
* Volker Fischer
|
* Volker Fischer
|
||||||
|
|
@ -8,16 +8,16 @@
|
||||||
*
|
*
|
||||||
* This program is free software; you can redistribute it and/or modify it under
|
* This program is free software; you can redistribute it and/or modify it under
|
||||||
* the terms of the GNU General Public License as published by the Free Software
|
* the terms of the GNU General Public License as published by the Free Software
|
||||||
* Foundation; either version 2 of the License, or (at your option) any later
|
* Foundation; either version 2 of the License, or (at your option) any later
|
||||||
* version.
|
* version.
|
||||||
*
|
*
|
||||||
* This program is distributed in the hope that it will be useful, but WITHOUT
|
* This program is distributed in the hope that it will be useful, but WITHOUT
|
||||||
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
||||||
* FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
|
* FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
|
||||||
* details.
|
* details.
|
||||||
*
|
*
|
||||||
* You should have received a copy of the GNU General Public License along with
|
* You should have received a copy of the GNU General Public License along with
|
||||||
* this program; if not, write to the Free Software Foundation, Inc.,
|
* this program; if not, write to the Free Software Foundation, Inc.,
|
||||||
* 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
* 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||||
*
|
*
|
||||||
\******************************************************************************/
|
\******************************************************************************/
|
||||||
|
|
@ -25,51 +25,57 @@
|
||||||
llcon
|
llcon
|
||||||
-----
|
-----
|
||||||
|
|
||||||
Low-Latency Connection / client and server
|
Low-Latency Connection / client and server (http://llcon.sourceforge.net)
|
||||||
|
|
||||||
|
|
||||||
OBJECTIVES:
|
INTRODUCTION:
|
||||||
The task is to build a client/server software to enable musicians to play together
|
The llcon software enables musicians to play together over the internet. The
|
||||||
over the internet. Target internet connection is DSL with 256 kbps upstream and
|
way it works is that there must be one server which collects the audio data
|
||||||
1 Mbit downstream. The server software must be located at a server with a very
|
from each client, mixes all together and sends the mix back to each client.
|
||||||
fast internet connection (at least 1 Mbps for up- and downstream).
|
The minimum internet connection speed at each client must be 256 kbps upstream
|
||||||
|
and 1 Mbit downstream. The server software must be located at a server with a
|
||||||
To get sufficient results, a sample rate of 24 kHz (mono channel) was chosen. An
|
very fast internet connection (at least 1 Mbps for up- and downstream) and a
|
||||||
audio compression algorithm with very low delay is IMA-ADPCM (delay is just one
|
very low ping time. To get satisfactory results, the ping time from the client
|
||||||
sample). This gives a raw compressed audio data rate of 96 kbps.
|
computer to the server should not exceed 30 ms average and the network jitter
|
||||||
|
should be as low as 2-5 ms (To get a low ping time on DSL connections, an
|
||||||
Target hardware setup at the client is stereo audio input signal with one channel
|
extra option "DSL fast path" should be enabled by your internet provider).
|
||||||
is the instrument and the other channel is a microphone signal. On the microphne
|
|
||||||
channel a reverberation effect can be applied (maybe at a later time other audio
|
Technical details
|
||||||
effects are added).
|
To get sufficient results, a sample rate of 24 kHz (mono channel) was chosen.
|
||||||
|
The audio compression algorithm IMA-ADPCM with very low delay is used which
|
||||||
|
results in a raw compressed audio data rate of 96 kbps. First tests showed
|
||||||
MANUAL:
|
that an upstream of 128 kbps is too slow for using the llcon software. At
|
||||||
For starting server type ./llcon -s
|
least 256 kbps upstream bandwidth is required.
|
||||||
|
|
||||||
Start the llcon server on a remote computer with fast internet access. Start the
|
The llcon software package includes both, the server and the client
|
||||||
llcon client on your local computer and connect your sound card with your
|
functionality which can be selected by using command line arguments.
|
||||||
instrument/microphone and headphone and type in the IP address of the server.
|
|
||||||
There are levelers for adjusting the sound card (in/out) and network buffer sizes.
|
|
||||||
It seems that 2 blocks for network buffer is optimal choice. For the sound card
|
MANUAL:
|
||||||
buffer, try to make them as short as possible by watching the LEDs below the
|
For starting server type ./llcon -s
|
||||||
levelers (they should stay green) and the timing standard deviation (should be
|
|
||||||
as low as approx. 0.5 ms).
|
Start the llcon server on a remote computer with fast internet access. Start the
|
||||||
|
llcon client on your local computer and connect your sound card with your
|
||||||
For test purpose it is possible to run server and client on the same computer. For
|
instrument/microphone and headphone and type in the IP address of the server.
|
||||||
this setup firstly start server and then the client. Type in 127.0.0.1 for the
|
There are levelers for adjusting the sound card (in/out) and network buffer sizes.
|
||||||
IP address in the client.
|
It seems that 2 blocks for network buffer is an optimal choice. For the sound card
|
||||||
|
buffer, try to make them as short as possible by watching the LEDs below the
|
||||||
|
levelers (they should stay green).
|
||||||
EXTERNAL CODE:
|
|
||||||
This code contains open source code from different sources. The developer(s) want
|
For test purpose it is possible to run server and client on the same computer. For
|
||||||
to thank the developer of this code for making their efforts available under open
|
this setup first start the server and then the client. Type in 127.0.0.1 for the
|
||||||
source:
|
IP address in the client software.
|
||||||
|
|
||||||
- audio reverberation code: by Perry R. Cook and Gary P. Scavone, 1995 - 2004
|
|
||||||
(taken from "The Synthesis ToolKit in C++ (STK)")
|
EXTERNAL CODE:
|
||||||
|
This code contains open source code from different sources. The developer(s) want
|
||||||
- IMA-ADPCM: by Erik de Castro Lopo
|
to thank the developer of this code for making their efforts available under open
|
||||||
|
source:
|
||||||
- some parts are taken from the project "Dream: a PC-based Digital Radio Mondiale
|
|
||||||
(DRM) receiver" written by one of the llcon authors, Volker Fischer
|
- audio reverberation code: by Perry R. Cook and Gary P. Scavone, 1995 - 2004
|
||||||
|
(taken from "The Synthesis ToolKit in C++ (STK)")
|
||||||
|
|
||||||
|
- IMA-ADPCM: by Erik de Castro Lopo
|
||||||
|
|
||||||
|
- some parts are taken from the project "Dream: a PC-based Digital Radio Mondiale
|
||||||
|
(DRM) receiver" written by one of the llcon authors, Volker Fischer
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue