CPKSoft Engineering

XMODEM.tlk Driver Reference

Hayes Compatible Modem Dialer Driver

This driver requires that you have TAS-HMITalk 8.04 installed.

Driver Overview

The XMODEM driver allows you establish a communication through a

telephone line by using a modem connected to a serial COM port

in your PC.

 

The driver can dial a phone number and then release the COM port

so it can be used by another TAS-HMITalk object that needs to

communicate with a remote device.

 

The driver provides also a command to hang-up the modem after

the phone line is no longer used.

 

IMPORTANT NOTE:

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

 

Most modems require the XMODEM driver to have the following

properties set to True:

 

- CommHoldRTSWhileTransmitting

- CommHoldRTSWhileReceiving

 

Any TAS-HMITalk object accessing the same port while a call is

active should have the same settings for these properties.

 

A minimum of 5000 ms in the CommTimeout property is recomended

for the XMODEM driver.

Supported Equipment Type

Modems

Supported Devices List

HAYES Compatible Modem

Supported Commands List

Dial Phone Number

Hang Up

Dial Phone Number

COMMAND DESCRIPTION:

Dials a specified phone number using tones or pulses.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.CommHoldRTSWhileTransmitting = True

HMITalk1.CommHoldRTSWhileReceiving = True

HMITalk1.DriverDataType = Digital Output

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = 0

HMITalk1.DriverP4 = 0 for tones, 1 for pulses.

HMITalk1.DriverP5 = Dialing timeout in seconds

(60 seconds is assumed if left empty).

HMITalk1.DriverP6 = Phone number (can include ',' to

indicate extra inter-digit delays).

HMITalk1.DriverP7 = Optional initialization string to be

sent before the dialing command.

(AT[initializationstring]DT phonenumber)

If left empty, defaults to 'V1', thus sending

the following command: 'ATV1DT phonenumber'.

 

RETURNS:

- OnSuccessfullySent event if the call succeded, leaving the call

connection established.

- OnErrorSending event if the call was not established, leaving

the error reason in the DriverStatus property.

Hang Up

COMMAND DESCRIPTION:

Hang ups an open communication.

 

PROPERTY SETTINGS REQUIRED:

HMITalk1.CommHoldRTSWhileTransmitting = True

HMITalk1.CommHoldRTSWhileReceiving = True

HMITalk1.DriverDataType = Digital Output

HMITalk1.DriverNumPoints = 1

HMITalk1.DriverP0 = 1

 

RETURNS:

- OnSuccessfullySent event if the call was hanged up successfully.

- OnErrorSending event if the call was not hanged up or if there wasn't

a call active, leaving the error reason in the DriverStatus property.

Returned Errors List

[1005] DRIVER (Internal): Invalid driver stage

[1300] PROTOCOL (Timeout): No answer

[2000] CONFIG (DataType): Analog inputs are not supported by this driver

[2001] CONFIG (DataType): Analog outputs are not supported by this driver

[2002] CONFIG (DataType): Digital inputs are not supported by this driver

[3002] CONFIG (P0): Invalid command (0 or 1 only)

[5007] CONFIG (P4): Invalid dialing mode (0 or 1)

[5503] CONFIG (P5): Invalid dialing timeout (1-180)

[6004] CONFIG (P6): Dial number not specified

About the XMODEM.tlk driver

This driver requires that you have TAS-HMITalk 8.04 installed.

Driver Source Code Last Update: 01/26/2006 13:11:45

Driver Reference Last Update: 10/30/2008 17:42:32

© 1990-2008, CPKSoft Engineering. All rights reserved.

http://www.cpksoft.com - support@cpksoft.com

http://www.cpksoft.com.ar - soporte@cpksoft.com.ar>