xlxd/ambed

//
//  readme
//  ambed
//
//  Created by Jean-Luc Deltombe (LX3JL) on 09/07/2017.
//  Copyright © 2017 Jean-Luc Deltombe (LX3JL). All rights reserved.
//
// ----------------------------------------------------------------------------
//    This file is part of ambed.
//
//    xlxd 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 Foundation, either version 3 of the License, or
//    (at your option) any later version.
//
//    xlxd is distributed in the hope that it will be useful,
//    but WITHOUT ANY WARRANTY; without even the implied warranty of
//    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//    GNU General Public License for more details.
//
//    You should have received a copy of the GNU General Public License
//    along with Foobar.  If not, see <http://www.gnu.org/licenses/>.
// ----------------------------------------------------------------------------


Hardware compatibility.
======================
This version of ambed is compatible with:
- DF2ET's AMBE3003USB opensource device (https://github.com/phl0/AMBE3003USB)
- LX3JL's USB-3006 opensource device (https://github.com/lx3jl/usb-3006)
- DVSI's USB-3000 device
- DVSI's USB-3003 device
- DVSI's USB-3012 device
- NWDR's ThumbDV device
- NWDR's ThumbDV-3 device

Available transcoding channels per device:

device			DMR->DSTAR		DSTAR->DMR		Nb Of concurrent channels
----------------------------------------------------------------------
3000(pair)		1				1				2
3003			1				1				1
3003(pair)		3				3				not tested
3003-3000(pair)	2				2				not tested
3006			3				3				4
3012			6				6				8

Multiple devices can be used at the same time.
You need to use 3000 by pairs or paired with a 3003
Do not to use USB hubs as they have proven making
system behaviour unreliable.

Instructions:
=============

1) Installation of FTDI drivers

Download from FTDI web site the latest D2XX driver package (tested on 1.4.6).
Follow FTDI provided documentation for installation and testing of the drivers.


2) installation of g++ compiler

# apt-get install build-essential
# apt-get install g++-4.7

2) download and compile ambed

# git clone https://github.com/LX3JL/xlxd.git
# cd xlxd/ambed/
# make clean
# make
# make install

3) configuring ambed startup script

# nano /ambed/run

edit following line to match your IP:

sudo /ambed/ambed 127.0.0.1 &

if ambed is running on same machine than xlxd, use default 127.0.0.1
otherwise use the machine own IP


4) running ambed

note:
Due to specific FTDI driver implementation, ambed must be running
with root privilege, and cannot be run as a daemon.
So ambed will display the information and error messages in the
terminal it has been started from

plug at least one USB-3xxx USB device

# cd /ambed
# ./run
 
 
during initialisation phase, ambed will scan all USB port to discover
and configure ans report status of all available USB-3xxx devices


5) stoping ambed

find PID of ambed process, using for example ps

# ps ax | grep ambed

and kill the process

# kill xxxx

where xxxx is PID found previously.