Need Help Set up Serial Provider (xtapi.inf)

[someidunknown1234]

I have been trying to set up xTAPI for a serial provider but am unable to fill out the xtapi.inf file in a manner that enables xtapi to work. This is because, in following the document "Setting up XTAPI," I have discovered that my modem's inf file does not match up to what that help document describes. All my questions on this, and the areas of confusion are below. (I am also more than happy to put everything I learn here into a user's guide for the XTAPI Sourceforge site, assuming I get it to work ;) )

NOTE: I have included pretty much every key just to be sure I'm interpreting it properly.

NAME
-------------

I believe this chould be (in my case), "COM3". However, I only find "COM3" in one spot in my modem's file:
    [Winacpci_AddReg]
    HKLM,SYSTEM\CurrentControlSet\Services\Winacpci,SymbolicLink,,"COM3"

I'm pretty sure that means it's on COM3, but just wanted to be sure because that's a regedit command and there's nothing else to mention it.

ADDRESSES
-------------

What exactly do I put here? It's not clear in the help document what this refers to. This is the only modem on this computer, and I'm only going to accept one phone call at a time for right now - does that mean I put 0? In other words, this "key" has no relevance to my computer's inf file (called WinInf in the help document)?

CODEC
-------------

OK, here's where I get a HUGE divergence and confusion sets in. There are SIX entries in my WinInf for "VoiceDialNumberSetup." Which one do I use? The six:

  HKR, VoiceDialNumberSetup, 1, "at+fclass=8<cr>"
  HKR, VoiceDialNumberSetup, 2, "at+vls=0<cr>"
  HKR, VoiceDialNumberSetup, 3, "at+vrn=0<cr>"
  HKR, VoiceDialNumberSetup, 4, "at+vtd=10<cr>"
  HKR, VoiceDialNumberSetup, 5, "at+vsm=130,8000,0,0<cr>"
  HKR, VoiceDialNumberSetup, 6, "at+vit=6<cr>"

Also, do I include the "<cr>"? I assume that's "carriage-return"? Does XTAPI/JTAPI need "\n" instead?

INIT
-------------

Again, there are multiple Init strings, 2 to be exact. Which do I use?
  HKR, Init, 1,, "AT<cr>"
  HKR, Init, 1,, "AT&FE0V1S0=0C1&D2+MR=2;+DR=1;+ER=1;W0<cr>"

VOICESETUP,VOICESTART,ANSWER,ANALOGSOURCE,ANALOGDESTINATION
------------------------------------------------------------

The user's guide says to look under "VoiceAnswer" for all of these, but is not clear how to decide which entry fits which. I have 5 entries, which is VoiceSetup, which VoiceStart, etc?

  HKR, VoiceAnswer, 1, "at+fclass=8<cr>"
  HKR, VoiceAnswer, 2, "at+vtd=10<cr>"
  HKR, VoiceAnswer, 3, "at+vsm=130,8000,0,0<cr>"
  HKR, VoiceAnswer, 4, "at+vit=6<cr>"
  HKR, VoiceAnswer, 5, "at+vls=1<cr>"

DIAL
-------------

What should this be? All my WinInf file has is "DialPrefix" which it says is "D". I'm assuming this is just whatever you dial to get out of the building, plus "1"?

ONHOOK
-------------

Mine has: Hangup, 1,, "ATH<cr>", I'm assuming that's it, right?

DIGITDURATION
----------------

I can't find this anywhere. I'm just guessing, but is the line (see above) in "VoiceDialNumberSetup" which mentions "vtd" the right one here?

  HKR, VoiceDialNumberSetup, 4, "at+vtd=10<cr>"

So that would make my DigitDuration 100ms, right?

ENCODING
-----------------

This is nowhere to be found in my WinInf file. I can't even find any of the algorithms (X_G721, X_IMA, X_PCM_U8, etc) - nothing. What would I look for to find out which encoding it uses? Is there some other (numerical/hexidecimal?) representation of this?

GENERAL
-----------------
One last general question: I see the user guide only lists "name," "addresses" and "codec" as required. Does this mean it should work (for the basic example) if that's all I filled out? Is XTAPI more likely to work if I fill in all the settings?

Thanks again for any help canyone can give!

[Anonymous]

I would suggest trying to lookup your AT commands for you modem.. (google "at voice commands <modem name>").

then I would get a program such as minicom (hyper terminal doesn't work that well)  and enter the modem commands by hand just to get a sense to what is going on.
eg. 
ATZ (init)
AT&cls=8  or AT+fclass=8 (set to voice mode)
atdt 5555555  (call number)
ath0 (hangup)
etc...

I can add what I know about the serial provider... if I'm incorrect in any of my comments someone can correct them...

NAME
if you need to find your com port you can simply go into your modem configuration in the control panel to find out what port it is installed on...  I think It's called "phone and modem" in the control panel.

ADDRESSES
For modem dialing this isn't that important... You can probably just enter 0 for this one.  I believe when you enter "0" for the address "in the program" it ignores the address line anyway.

CODEC
ok for the codec you want
at+vsm=130,8000,0,0

in minicom type at+vsm=? for other voice codec options (you'll probably need to be in voice mode first at+fclass=8)

INIT
I would probably use this one
AT&FE0V1S0=0C1&D2+MR=2;+DR=1;+ER=1;W0

VOICESETUP
at+fclass=8  (this sets it to voice mode)

DIAL
should be ATDT

ONHOOK
ATH0 is on hook ATH1 is off hook

DIGITDURATION
I'm not sure about this one you'd have to look it up

ENCODING
what you need to do for encoding is type
at+vsm=? this should give you a list of codecs and the available encoding for those codecs...

PCM_U8, and G721 work for most modems but you'll have to confirm with your documentation (or that at+vsm=?)

ANALOGSOURCE,ANALOGDESTINATION
depends on the mode you want (you'll have to look up the documentation)
likely at+vls=0, may need to be at+vls=6 for dtmf detection (I can't remember)

voiceStart
if needed will likely be  AT+VTX

ANSWER
should be ata

I hope this gives you a start at least... make sure you check your logs after you run your program to find out which one of the at commands are failing... and why...

[madanSingh]

Hi Friend,

Can u plz help me As I am new to XTAPi.

Plz where I have o put xtapi.inf file and how to
configure.

I want to run sample program Outcall.java
I amble to compile but when I run program it shows
following error:
Can't get Provider:
javax.telephony.JtapiPeerUnavailableException:
JtapiPeer: ne
t.xtapi.XJtapiPeer could not be instantiated.

Plz reply as early as Possible

Thanks take care

Madan Singh

[Francisco Ramirez]

The jar files need to be specified in the CLASSPATH and
You need to put the xtapi.dll in your working directory

   /classes/xtapi.dll
   /classes/Outcall.class

   $ cd /classes
   $ java -classpath .:%classpath% Outcall