Modem Manager
 

 < Home   < Developers   < Development Support   < Documentation

61 Modem Manager


 Table of Contents  |  < Previous  |  Next >  |  Index
   
   

Title -
Palm OS® Programmer's API Reference

Part III: Communications

61 Modem Manager

Modem Manager Functions

MdmDial

MdmHangUp

       

This chapter provides reference material for the modem manager API. The header file ModemMgr.h declares the modem manager API.

Modem Manager Functions

MdmDial

Purpose

Initialize the modem, dial the phone number and wait for result.

Prototype

Err MdmDial (MdmInfoPtr modemP, Char *okDialP, Char *userInitP, Char *phoneNumP)

Parameters

modemPPointer to modem info structure (filled in by caller)
okDialP(NOT IMPLEMENTED) Pointer to string of chars allowed in dial string
userInitPPointer to modem setup string without the AT prefix.
phoneNumPPointer to phone number string

Result

0 if successful; otherwise mdmErrNoTone, mdmErrNoDCD, mdmErrBusy, mdmErrUserCan, mdmErrCmdError

Comments

When executing this function, the system performs these steps:

Switch to the requested initial baud rate.

If HW hand-shake is requested, enable CTS/RTS hand-shaking; otherwise, disable it.

Reset the modem.

Execute the setup string (if any).

Configure the modem with required settings.

Dial the phone number.

Wait for CONNECT XXXXX or other response.

If auto-baud is requested, switch to the connected baud rate.

MdmHangUp

Purpose

Hang up the modem.

Prototype

Err MdmHangUp (MdmInfoPtr modemP)

Parameters

modemP Pointer to modem info structure (filled in by caller)

Result

0 if successful.


WARNING! This function alters configuration of the serial port (without restoring it).