PModem Class Reference

#include <modem.h>

Inheritance diagram for PModem:

List of all members.

Public Types
enum	Status {   Unopened, Uninitialised, Initialising, Initialised,   InitialiseFailed, Dialling, DialFailed, AwaitingResponse,   LineBusy, NoCarrier, Connected, HangingUp,   HangUpFailed, Deinitialising, DeinitialiseFailed, SendingUserCommand,   NumStatuses }
Public Member Functions
	PModem ()
	PModem (const PString &port, DWORD speed=0, BYTE data=0, Parity parity=DefaultParity, BYTE stop=0, FlowControl inputFlow=DefaultFlowControl, FlowControl outputFlow=DefaultFlowControl)
	PModem (PConfig &cfg)
virtual BOOL	Close ()
virtual BOOL	Open (const PString &port, DWORD speed=0, BYTE data=0, Parity parity=DefaultParity, BYTE stop=0, FlowControl inputFlow=DefaultFlowControl, FlowControl outputFlow=DefaultFlowControl)
virtual BOOL	Open (PConfig &cfg)
virtual void	SaveSettings (PConfig &cfg)
void	SetInitString (const PString &str)
PString	GetInitString () const
BOOL	CanInitialise () const
BOOL	Initialise ()
void	SetDeinitString (const PString &str)
PString	GetDeinitString () const
BOOL	CanDeinitialise () const
BOOL	Deinitialise ()
void	SetPreDialString (const PString &str)
PString	GetPreDialString () const
void	SetPostDialString (const PString &str)
PString	GetPostDialString () const
void	SetBusyString (const PString &str)
PString	GetBusyString () const
void	SetNoCarrierString (const PString &str)
PString	GetNoCarrierString () const
void	SetConnectString (const PString &str)
PString	GetConnectString () const
BOOL	CanDial () const
BOOL	Dial (const PString &number)
void	SetHangUpString (const PString &str)
PString	GetHangUpString () const
BOOL	CanHangUp () const
BOOL	HangUp ()
BOOL	CanSendUser () const
BOOL	SendUser (const PString &str)
void	Abort ()
BOOL	CanRead () const
Status	GetStatus () const
Protected Attributes
PString	initCmd
PString	deinitCmd
PString	preDialCmd
PString	postDialCmd
PString	busyReply
PString	noCarrierReply
PString	connectReply
PString	hangUpCmd
Status	status

---

Detailed Description

A class representing a modem attached to a serial port. This adds the usual modem operations to the basic serial port.

A modem object is always in a particular state. This state determines what operations are allowed which then move the object to other states. The operations are the exchange of strings in "chat" script.

The following defaults are used for command strings: initialise ATZ deinitialise +++ pre-dial ATDT post-dial busy reply BUSY no carrier reply NO CARRIER connect reply CONNECT hang up +++

---

Member Enumeration Documentation

enum PModem::Status

Enumerator:

Unopened	Has not been opened yet.
Uninitialised	Is open but has not yet been initialised.
Initialising	Is currently initialising the modem.
Initialised	Has been initialised but is not connected.
InitialiseFailed	Initialisation sequence failed.
Dialling	Is currently dialling.
DialFailed	Dial failed.
AwaitingResponse	Dialling in progress, awaiting connection.
LineBusy	Dial failed due to line busy.
NoCarrier	Dial failed due to no carrier.
Connected	Dial was successful and modem has connected.
HangingUp	Is currently hanging up the modem.
HangUpFailed	The hang up failed.
Deinitialising	is currently de-initialising the modem
DeinitialiseFailed	The de-initialisation failed.
SendingUserCommand	Is currently sending a user command.
NumStatuses

---

Constructor & Destructor Documentation

PModem::PModem

(

)

Create a modem object on the serial port specified. If no port was specified do not open it. It does not initially have a valid port name.

See the PSerialChannel class for more information on the parameters.

PModem::PModem	(	const PString &	port,
		DWORD	speed = 0,
		BYTE	data = 0,
		Parity	parity = DefaultParity,
		BYTE	stop = 0,
		FlowControl	inputFlow = DefaultFlowControl,
		FlowControl	outputFlow = DefaultFlowControl
	)

Parameters:

port	Serial port name to open.
speed	Speed of serial port.
data	Number of data bits for serial port.
parity	Parity for serial port.
stop	Number of stop bits for serial port.
inputFlow	Input flow control.
outputFlow	Output flow control.

PModem::PModem

(

PConfig &

cfg

)

Open the modem serial channel obtaining the parameters from standard variables in the configuration file. Note that it assumed that the correct configuration file section is already set.

Parameters:

cfg	Configuration file to read parameters from.

---

Member Function Documentation

virtual BOOL PModem::Close

(

)

[virtual]

Close the channel, shutting down the link to the data source.

Returns:

TRUE if the channel successfully closed.

Reimplemented from PSerialChannel.

virtual BOOL PModem::Open	(	const PString &	port,
		DWORD	speed = 0,
		BYTE	data = 0,
		Parity	parity = DefaultParity,
		BYTE	stop = 0,
		FlowControl	inputFlow = DefaultFlowControl,
		FlowControl	outputFlow = DefaultFlowControl
	)			[virtual]

Open the modem serial channel on the specified port.

See the PSerialChannel class for more information on the parameters.

Returns:

TRUE if the modem serial port was successfully opened.

Parameters:

port	Serial port name to open.
speed	Speed of serial port.
data	Number of data bits for serial port.
parity	Parity for serial port.
stop	Number of stop bits for serial port.
inputFlow	Input flow control.
outputFlow	Output flow control.

Reimplemented from PSerialChannel.

virtual BOOL PModem::Open

(

PConfig &

cfg

)

[virtual]

Open the modem serial port obtaining the parameters from standard variables in the configuration file. Note that it assumed that the correct configuration file section is already set.

Returns:

TRUE if the modem serial port was successfully opened.

Parameters:

cfg	Configuration file to read parameters from.

Reimplemented from PSerialChannel.

virtual void PModem::SaveSettings

(

PConfig &

cfg

)

[virtual]

Save the current port settings into the configuration file. Note that it assumed that the correct configuration file section is already set.

Parameters:

cfg	Configuration file to write parameters to.

Reimplemented from PSerialChannel.

void PModem::SetInitString

(

const PString &

str

)

Set the modem initialisation meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Note there is an implied before the string.

Parameters:

str	New initialisation command string.

PString PModem::GetInitString

(

)

const

Get the modem initialisation meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Returns:

string for initialisation command.

BOOL PModem::CanInitialise

(

)

const

The modem is in a state that allows the initialise to start.

Returns:

TRUE if the Initialise() function may proceeed.

BOOL PModem::Initialise

(

)

Send the initialisation meta-command string to the modem. The return value indicates that the conditions for the operation to start were met, ie the serial port was open etc and the command was successfully sent with all replies met.

Returns:

TRUE if command string sent successfully and the objects state has changed.

void PModem::SetDeinitString

(

const PString &

str

)

Set the modem de-initialisation meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Note there is an implied before the string.

Parameters:

str	New de-initialisation command string.

PString PModem::GetDeinitString

(

)

const

Get the modem de-initialisation meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Returns:

string for de-initialisation command.

BOOL PModem::CanDeinitialise

(

)

const

The modem is in a state that allows the de-initialise to start.

Returns:

TRUE if the Deinitialise() function may proceeed.

BOOL PModem::Deinitialise

(

)

Send the de-initialisation meta-command string to the modem. The return value indicates that the conditions for the operation to start were met, ie the serial port was open etc and the command was successfully sent with all replies met.

Returns:

TRUE if command string sent successfully and the objects state has changed.

void PModem::SetPreDialString

(

const PString &

str

)

Set the modem pre-dial meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Note there is an implied before the string.

Parameters:

str	New pre-dial command string.

PString PModem::GetPreDialString

(

)

const

Get the modem pre-dial meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Returns:

string for pre-dial command.

void PModem::SetPostDialString

(

const PString &

str

)

Set the modem post-dial meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Note there is not an implied before the string, unlike the pre-dial string.

Parameters:

str	New post-dial command string.

PString PModem::GetPostDialString

(

)

const

Get the modem post-dial meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Returns:

string for post-dial command.

void PModem::SetBusyString

(

const PString &

str

)

Set the modem busy response meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Note there is an implied before the string. Also the and commands do not operate and will simply terminate the string match.

Parameters:

str	New busy response command string.

PString PModem::GetBusyString

(

)

const

Get the modem busy response meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Returns:

string for busy response command.

void PModem::SetNoCarrierString

(

const PString &

str

)

Set the modem no carrier response meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Note there is an implied before the string. Also the and commands do not operate and will simply terminate the string match.

Parameters:

str	New no carrier response command string.

PString PModem::GetNoCarrierString

(

)

const

Get the modem no carrier response meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Returns:

string for no carrier response command.

void PModem::SetConnectString

(

const PString &

str

)

Set the modem connect response meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Note there is an implied before the string. Also the and commands do not operate and will simply terminate the string match.

Parameters:

str	New connect response command string.

PString PModem::GetConnectString

(

)

const

Get the modem connect response meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Returns:

string for connect response command.

BOOL PModem::CanDial

(

)

const

The modem is in a state that allows the dial to start.

Returns:

TRUE if the Dial() function may proceeed.

BOOL PModem::Dial

(

const PString &

number

)

Send the dial meta-command strings to the modem. The return value indicates that the conditions for the operation to start were met, ie the serial port was open etc and the command was successfully sent with all replies met.

The string sent to the modem is the concatenation of the pre-dial string, a , the number parameter and the post-dial string.

Returns:

TRUE if command string sent successfully and the objects state has changed.

void PModem::SetHangUpString

(

const PString &

str

)

Set the modem hang up meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Note there is an implied before the string.

Parameters:

str	New hang up command string.

PString PModem::GetHangUpString

(

)

const

Get the modem hang up meta-command string.

See the PChannel::SendCommandString() function for more information on the format of the command string.

Returns:

string for hang up command.

BOOL PModem::CanHangUp

(

)

const

The modem is in a state that allows the hang up to start.

Returns:

TRUE if the HangUp() function may proceeed.

BOOL PModem::HangUp

(

)

Send the hang up meta-command string to the modem. The return value indicates that the conditions for the operation to start were met, ie the serial port was open etc and the command was successfully sent with all replies met.

Returns:

TRUE if command string sent successfully and the objects state has changed.

BOOL PModem::CanSendUser

(

)

const

The modem is in a state that allows the user command to start.

Returns:

TRUE if the SendUser() function may proceeed.

BOOL PModem::SendUser

(

const PString &

str

)

Send an arbitrary user meta-command string to the modem. The return value indicates that the conditions for the operation to start were met, ie the serial port was open etc and the command was successfully sent with all replies met.

Returns:

TRUE if command string sent successfully.

Parameters:

str	User command string to send.

void PModem::Abort

(

)

BOOL PModem::CanRead

(

)

const

The modem is in a state that allows the user application to read from the channel. Reading while this is TRUE can interfere with the operation of the meta-string processing. This function is only usefull when multi-threading is used.

Returns:

TRUE if Read() operations are "safe".

Status PModem::GetStatus

(

)

const

Get the modem objects current state.

Returns:

modem status.

---

Member Data Documentation

PString PModem::initCmd [protected]

PString PModem::deinitCmd [protected]

PString PModem::preDialCmd [protected]

PString PModem::postDialCmd [protected]

PString PModem::busyReply [protected]

PString PModem::noCarrierReply [protected]

PString PModem::connectReply [protected]

PString PModem::hangUpCmd [protected]

Status PModem::status [protected]

---

The documentation for this class was generated from the following file:

• modem.h

---