xlxd/ambed

//

//  readme

//  ambed

//

//  Created by Jean-Luc Deltombe (LX3JL) on 09/07/2017.

//  Copyright © 2017-2019 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/>.

// ----------------------------------------------------------------------------



VERSION: 1.3.4



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

- DVMEGA AMBE3000 device

- DVMEGA AMBE3003 device



Available transcoding channels per device:



device			DMR->DSTAR		DSTAR->DMR		Nb Of concurrent channels

-------------------------------------------------------------------------

3000(pair)		1				1				2

3003			1				1				2

3003(pair)		3				3				4

3003-3000(pair)	2				2				4

3006			3				3				6

3012			6				6				12



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 /xlxd/run-ambed



edit following line to match your IP:



sudo /xlxd/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.



6) OPTIONAL for Linux - Using a systemd service script to start/stop ambed



From the top of the xlxd source tree, copy scripts/ambed.service 

to /lib/systemd/system/ambed.service. Then edit

/lib/systemd/system/ambed.service and change the location of the

ambed executable or the IP address as necessary. Save the file

and then issue the following commands:



# systemd daemon-reload

# systemd restart ambed

# journalctl -xe



You should see something like:



-- A start job for unit ambed.service has finished successfully.

--

-- The job identifier is 1853.

Jan 25 14:48:24 xcoder ambed[10187]: Starting AMBEd 1.3.4

Jan 25 14:48:24 xcoder ambed[10187]: Initializing vocodecs:

Jan 25 14:48:24 xcoder ambed[10187]: Detected 1 USB-FTDI devices

Jan 25 14:48:24 xcoder ambed[10187]: Description : DVstick-33         Serial : DO3KFHPI

Jan 25 14:48:24 xcoder ambed[10187]: Opening DVstick-33:DO3KFHPI device

Jan 25 14:48:24 xcoder ambed[10187]: Trying DF2ET-3003 soft reset

Jan 25 14:48:24 xcoder ambed[10187]: DF2ET-3003 soft reset succeeded

Jan 25 14:48:24 xcoder ambed[10187]: ReadDeviceVersion : 0AMBE3003F

Jan 25 14:48:24 xcoder ambed[10187]: 1V120.E100.XXXX.C106.G514.R008.A0030608.C0020208

Jan 25 14:48:24 xcoder ambed[10187]: [2B blob data]

Jan 25 14:48:24 xcoder ambed[10187]: Codec interfaces initialized successfully : 2 channels available

Jan 25 14:48:24 xcoder ambed[10187]: Initializing controller

Jan 25 14:48:24 xcoder ambed[10187]: AMBEd started and listening on 127.0.0.1