Onnowpurbo: /* Referensi */

2014-07-11T09:03:34Z

Referensi

← Older revision		Revision as of 09:03, 11 July 2014
Line 354:		Line 354:

	* https://allstarlink.org/usbradio.html		* https://allstarlink.org/usbradio.html


			==Pranala Menarik==

			* [[Radio]]
			* [[Radio Internet]]
			* [[Radio amatir]]
			* [[Ethernet]]
			* [[Radio over Internet Protocol]]
			* [[XIPAR]]
			* [[RoIP: Mic Connector]]
			* [[RoIP: Instalasi]]
			* [[RoIP: URI pin]]
			* [[RoIP: Membuat URI dari USB sound card]]
			* [[RoIP: Compile Asterisk app_rpt]] '''NOT RECOMMENDED'''
			* [[RoIP: Registrasi ke allstarlink.org untuk Amatir Radio]]

			* [[Asterisk RoIP: usbradio.conf]]
			* [[Asterisk RoIP: app rpt]]
			* [[Asterisk RoIP: rpt.conf]]

Onnowpurbo: New page: Sumber: https://allstarlink.org/usbradio.html ==USB Device Configuration And Provisioning== USB Device Setup And Tuning USB Device Configuration And Provisioning Each USB device require...

2014-06-02T02:04:41Z

New page: Sumber: https://allstarlink.org/usbradio.html ==USB Device Configuration And Provisioning== USB Device Setup And Tuning USB Device Configuration And Provisioning Each USB device require...

New page

Sumber: https://allstarlink.org/usbradio.html

==USB Device Configuration And Provisioning==

USB Device Setup And Tuning
USB Device Configuration And Provisioning

Each USB device requires specification of operating mode parameters, which is done by setting various parameters in the /etc/asterisk/usbradio.conf file. This may either be done for you by this Portal, if you choose the Portal to create your configuration, or by manually editing the file. There are many different potential configruations of radio hardware and associated connection with the USB Radio device, and the various parameters are an attempt at addressing these differences.

Associating Physical USB Devices With Their Device Designations (USB Device Naming)

Every Physical USB Radio device, such as a URI or a USB fob is assigned a device name, either by the Portal (in the case of Portal-Based configuration, or by you when configured manually. When configured manualy, it is not neceaary to follow any particular standard, but calling it usb<Node-Name> (like for example, usb1999 would be associated with node 1999) might be a good idea. Click here for more details.

At this point, it is assumed that a configuration for all of the desired USB Radio devices has been generated (by whatever means), and has been placed in the configuration file /etc/asterisk/usbradio.conf, and the system is running with this configuration. If this is to be done manually, see below for details of how to do so. The USB configuration (and a number of others) must be done previous to starting the Asterisk system.

If your system has only one single USB Radio device, the association of the device and its name is quite easy and obvious (since there only is one of them). For systems with multiple USB Radio devices, it gets much more complicated. The problem is seriously compounded by the fact that all USB Radio devices (based on the CMedia CM108, CM119, etc) all look alike to the computer, and there is no way to tell them apart, other then by what actual USB connector (interface) that they are attached to.

There are several methods to associate and determine what USB devices go with what deivce names (designations). The most practical one (which we call the "flashing and swapping method") is described here:

1. Plug in all of your USB radio devices. This may be done with the system in operation, as both the system hardware
and the software are prefectly capable of handling plugging and un-plugging of these USB devices while in
operation, even while in use (the application software won't even know its happening).

2. The system will seemingly rather arbitrarily associate all your USB Radio devices with the names specified
in the configuration file. There is a small but finite chance that it did it the way you wanted it. If not,
it is possible to set things up in a desired manner.

3. Run the radio-tune-menu program.

4. Use menu item (1) to select the a USB device, and use the (F) option which will make the associated USB device
cause its attached transmitter to transmit a 1000Hz tone on and off a couple of times (and make the red light
on the interface flash on and off, if so equiped) in order to identify which USB device is associated with
the selected USB interface designator.

5. If the association is with the wrong one, use the (S) option to swap the USB device with ahother one and
repeat step 4 and this step until you have found the correct one.

6. Repeat steps 4 and 5 until all the devices are associated with the correct designators.

7. Going through all the devices, one at a time, uee item (1) to select the device, then use item (W) to
save the device parameters permanently. The USB device to designator associaion is one of the parameters
that gets saved when you do this. If you happen to un-plug a USB device, be sure to plug it back into the
same connector (USB interface) that it came out of, otherwise you may have to repeat this whole procedure
again.

==USB Radio Configuration File (/etc/asterisk/usbradio.conf)==

The USB Radio Configuration file /etc/asterisk/usbradio.conf consistes of stanzas that each contain the configuration parameters for a USB Radio device, named with the devices name, such as [usb] or [usb1999]. Here is an example of such a file, containing one stanza (which happens to be the default configuration file):

;
; chan_usbradio.c configuration file
;
[general] ; this has to be here and is RFU

[usb] ; USB Channel Name e.g. usb or usb1, usb2, ...
; this starts the definition block for a device

; General Device Parameters

hwtype=0 ; USB Sound Adapter Hardware Type
; Set to 0 for DMK Eng. URI, or USB sound adapaters
; modified using the instructions from usbfob.pdf.
; Set to 1 for DingTel/W9SH modified usb adapters.

duplex=0 ; Connected Radio Device Duplex Capability
; 0 = Simplex (PTT / Release to Listen)
; 1 = Duplex (simultaneous Tx and Rx)

eeprom=0 ; 1 = Indicates that an EEPROM internal to the radio
; adapter and cable is expected.
; 0 = no warning message if no EEPROM found.

; Receiver-Related Parameters

rxboost=0 ; Rx Audio Boost
; 0 = 20db attenuator inserted,
; 1= 20db attenuator removed
; Set to 1 for additonal gain if using a low-level
; receiver output.

rxctcssrelax=1 ; Rx CTCSS Decoder Criteria Relax
; reduce CTCSS talkoff from radios w/o CTCSS Tx HPF
; Set to 1 for Amateur and FRS radios.

carrierfrom=dsp ; Carrier Detect Source
; Options - no,usb,usbinvert,dsp,vox
; no - no carrier detection at all
; usb - via USB radio adapter COR connection
; usbinvert - same as above but inverted polarity.
; dsp - from RX noise using dsp methods
; vox - voice activated via RX audio

ctcssfrom=dsp ; CTCSS Decoder Source
; Options = no,usb,dsp
; no - CTCSS decoding, system will be carrier squelch
; usb - CTCSS decoding using input from USB adapter
; usbinvert - same as above but inverted polarity.
; dsp - CTCSS decoding using RX audio in DSP.
; rxdemod option must be set to flat for this to work.

rxdemod=flat ; Rx Audio Source Type from Radio
; Options = no, flat, speaker
; no - RX audio input not used
; flat - source is un-filtered discriminator signal
; speaker - source is filtered, de-emphasized audio

; Transmitter-Related Parameters

txboost=1 ;Set to 1 to fix the 6db down audio bug in "voice" mode

txprelim=yes ; Tx Audio PreEmphasis and Limiting in software
; no - Audio is not pre-emphasized and limited.
; for application to radio microphone input
; yes - Audio is pre-emphasized, limited and filtered
; for direct connection to an FM modulator

txtoctype=notone ; Transmit Tone Turn Off Code method:
; Options = no,phase,notone
; no - CTCSS tone encodes up to tx carrier drop
; phase - encode reverse phase before tx carrier drop
; AKA ("reverse burst") before unkeying TX
; notone - drop tone, wait and then drop carrier
; AKA ("chicken burst")

txmixa=composite ; Tx Mix Output Channel A (Left) Output Type
; Options = no,voice,tone,composite,auxvoice
; no - Do not output anything
; voice - output voice only
; tone - CTCSS tone only
; composite - voice and tone
; auxvoice - voice output for monitoring

txmixb=no ; Tx Mix Output Channel B (Right) Output Type
; See txmixa above.

invertptt=0 ; Invert PTT
; 0 = ground to transmit, 1 = open to transmit
; This is the collector lead of the 2N4401 transistor
; on the modified usb sound adapter.

; CTCSS-Related Parameters
; These will be ignored and my be omitted if CTCSS is not in use

txctcssdefault=88.5 ; Tx CTCSS Default Encode
; Encodes this tone if no other tone in use.

rxctcssfreqs=88.5 ; rx ctcss frequency. this must be in the tone table.
txctcssfreqs=88.5 ; tx ctcss frequency. any frequency is permitted.

; end of file

Receiver with audio coming directly from the output of the discriminator:

carrierfrom=dsp
ctcssfrom=dsp
rxdemod=flat

Receiver with audio coming from de-dmpahsized low level audio, or the speaker output:

carrierfrom=usb ; or usbinvert
ctcssfrom=usb ; or usbinvert, or no if CTCSS not in use
rxdemod=speaker
;Note, this requires connection to the receivers COR (carrier presence detector) signal.

Trasnsmitter with audio going directly to the frequency modulator:

txprelim=yes
txtoctype=notone ; This may be whatever is appropriate
txmixa=composite ; Tx Mix Output Channel A (Left) Output of Composite Audio
txmixb=no ; No output on B
invertptt=0 ; Invert PTT , set a appropriate (alsmostly always 0)

Trasnsmitter with audio going low level input or microphone input:

txprelim=no
txmixa=voice ; Tx Mix Output Channel A (Left) Output of Audio
txmixb=no ; No output on B
invertptt=0 ; Invert PTT , set a appropriate (alsmostly always 0)

If you are using CTCSS (processed by the USB device, as opposed to the radio itself), be sure to set the CTCSS parameters appropriately.

Be sure also, to set 'duplex' and 'eeprom' to appropreiate values.

All of these configuration options apply to both manual configuration and configuration through use of the Portal.

==USB Device Setup And Tuning==

Once your system is configured and running, your USB Radio devices still need to be 'tuned' (which means setting various audio levels, etc). The easiest way to perform this is to log in into your Linux system, either on the physical console, or via SSH from a remote system. There is a program called

radio-tune-menu

which provides a menu of items appropriate for performing these 'tuning' functions. NOTE, this requires all of the Asterisk system to be running from the SVN sources as of 6/7/2010. To get instructions on upgrading your Asterisk system, Click Here.

This program generates a menu which looks something like this:

Active (command) USB Radio device is [usb1999]
1) Select USB device
2) Auto-Detect Rx Noise Level Value (with no carrier)
3) Set Rx Voice Level (using display)
4) Auto-Detect Rx CTCSS Level Value (with carrier + CTCSS)
5) Set Rx Squelch Level
6) Set Transmit Voice Level
7) Set Transmit Aux Voice Level
8) Set Transmit CTCSS Level
9) Auto-Detect Rx Voice Level Value (with carrier + 1KHz @ 3KHz Dev)
E) Toggle Echo Mode (currently Disabled)
F) Flash (Toggle PTT and Tone output several times)
P) Print Current Parameter Values
S) Swap Current USB device with another USB device
T) Toggle Transmit Test Tone/Keying (currently Disabled)
W) Write (Save) Current Parameter Values
0) Exit Menu

Please enter your selection now:

Note: If your USB device is on a node configured as a remote base, then you must first make a node connection to the remote base from an external node, becuase the USB device is not actually opened until an external node is connected. This does not apply to all other node configurations.

Sceanarios And Environments

The best (optimum) method

The optimum case, and the only way to truly perform precision calibration of your audio levels is with the use of either a Service Monitor, or some sort of precision FM signal generator and Deviation meter.

If you are fortunate enough to have access to such a device, please perform the following 8 steps:

1. If the desired USB device is not currently seleected, use menu item
(1) to select the desired USB device.

2. Without any signal on the input of the receiver, use menu item (2) to
automatically calibrate the base received signal level. If the device
requires adjust of a squelch control in order to make it output noise
(standard lack of signal static noise), please do so. Please return
the squelch control to its normal position after performing this step.

3. Apply a hard-limiting full-quieting signal on the input of the reciever,
with modulation of 1000Hz at 3Khz deviation. It should not be necessary
to encode CTCSS at this time. If you do, please make sure that there is
3 KHz of deviation at 1000Hz, plus the deviation of the CTCSS
(nominally 650Hz). Then, use menu item (9) to automatically set the receive
voice level.

4. If your receive source for this device is flat (discriminator) audio,
remove the 1000Hz modulation from the signal, and encode appropriate
CTCSS tone at 650Hz Deviation. Then, use menu item (4) to automatically
set the receive CTCSS level. If your receive source is not flat audio
(or you do not use CTCSS), skip this step.

5. If menu item (T) does not show that Transmit Tone/Keying is enabled,
use menu item (T) to enable it.

6. Remove the signal from the Receiver. Make sure the transmitter is
connected to a proper load. Use menu iten (6) to manually adjust
to audio output to 3KHz deviation with the 1000Hz test tone genrated
and the transmitter is keyed by the USB driver.

7. If your transmit source for this device is configured to generate CTCSS,
use menu item (8) to manually adjust the transmitted CTCSS level to
output 650Hz of deviation, while the USB driver generates the CTCSS
tone and keys the transmitter.

8. Be sure to save the parameters that you just changed, by using the (W)
(Write Parameters) menu item. This writes the parameters to a file
and optionally the EEPROM connected to the USB device (if so configured).

The "kind of acceptible" method

This method relies on generated DTMF tones from a users's transmitter, and a "good" ear. It involves mostly manual adjustment of audio levels.

To accomplish this, please perform the follwing 8 steps:

1. If the desired USB device is not currently seleected, use menu item
(1) to select the desired USB device.

2. If your receive source for this device is flat (discriminator) audio,
then without any signal on the input of the receiver, use menu item (2) to
automatically calibrate the base received signal level. If your receive
source is not flat audio, skip this step.

3. Using a users transmitter (preferably within feet of the receiver being
adjusted, or at least having a hard-limiting full-quieting signal on the
input of the reciever), transmit DTMF tones to the receiver while using
menu item (3) to display the perceived audio level, and make adjustments
to it so that the DTMF tones are roughly at a perceived 3KHz deviation.
It is probably a good idea to try different DTMF tones, and perhaps try
several different users radios to get the best consensus of the desired
setting.

4. If your receive source for this device is flat (discriminator) audio,
transmit an unmodulated signal from the users radio to the receiver
(encoding the appropriate CTCSS tone). Then, use menu item (4) to
automatically set the receive CTCSS level. If your receive source is
not flat audio (or you do not use CTCSS), skip this step.

5. If menu item (T) shows that Transmit Tone/Keying is enabled,
use menu item (T) to disable it.

6. Here's the tricky part. You need to have a source of "known correct"
level audio to adjust the transmitter audio level. If this is a
full duplex repeater, then you can use a signal on the input of
the system (the receiver), since we just calibrated it and we know
the level is correct. If it is not a full-duplex system, then you
need some other source of audio. The use of "echo mode" (menu
item (E)) is a good way of doing this. It records a received
transmission (20 secs max), then after the transmission is over, it
re-transmits it back out exactly as received. You can also bring up
a link to a system with users talking at a known-good level. If you
enable "echo mode", be sure to disable it when done testing. Regardless
of how you accomplish this, the botom line is to use another user's
receiver to an A/B comparison of the audio levels of a live, direct
signal (received directly from the user's transmitter that is providing
the signal to the receiver connected to the USB device being adjusted)
and the signal being transmitted from the transmitter connected to the
USB device that is being adjusted. The object is to get the two
compared signals to be at the same audio level.

7. If your transmit source for this device is configured to generate CTCSS,
you can use menu item (8) to manually adjust the transmitted CTCSS level
if necessary. If it seems to work, leave it alone (it defaults to
a set value of 200). If its not enough to reliably be decoded by
user's radios, raise it. If its so loud it can be heard, lower it
considerably. Without proper equiment, this is a difficult one to
even come close to truly getting right.

8. Be sure to save the parameters that you just changed, by using the (W)
(Write Parameters) menu item. This writes the parameters to a file
and optionally the EEPROM connected to the USB device (if so configured).

The "if this is the best you can do" method

This method relies on speech levels from a users's transmitter, and a "good" ear. It should be avoided if at all posible. It's basically identical to the "kind of acceptible" mothod (see above) with step 3 different, as follows:

3. Using a users transmitter (preferably within feet of the receiver being
adjusted, or at least having a hard-limiting full-quieting signal on the
input of the reciever), Speak in a normal voice into the transmitter,
and transmit to the receiver while using menu item (3) to display the
perceived audio level, and make adjustments to it so that the speech
level peaks roughly just below a perceived 5KHz deviation. It is probably
a good idea to try different people speaking, and perhaps try several
different users radios to get the best consensus of the desired setting.

Auxillary Audio Output

If your USB device has one of its outputs configured as an "auxillary" output, you can use menu item (7) to manually set this level.

==Referensi==

* https://allstarlink.org/usbradio.html

Asterisk RoIP: usbradio.conf - Revision history

Onnowpurbo: /* Referensi */

Onnowpurbo: New page: Sumber: https://allstarlink.org/usbradio.html ==USB Device Configuration And Provisioning== USB Device Setup And Tuning USB Device Configuration And Provisioning Each USB device require...