User's Manual

Engineering Test Software Operation

Rev 28_A Sept 2005

VIA Telecom, Inc. Proprietary

Retrieves all of the strings in the response queue in the form of a list of strings. If there are no

responses in the response queue an empty string is returned.

GetResponses as boolean

Enables and disables the response queue. When set to false the queue is emptied and

disabled.

GetError() as string

Retrieves a string from the error queue in the same format as in the log window. If there is no

error in the error queue an empty string is returned.

GetErrors as boolean

Enables and disables the error queue. When set to false the queue is emptied and disabled.

SendCommand(Cmd as String)

Sends the command string provided. The format is identical to the log window entry that gets

made when the command is manually sent.

The received raw hex display of a message can be provided as a command string. These are

lines that start with "Raw Rx:".

SetRspQSize(Size as Long)

Sets the size of the response queue. By default the queue size is set to 100 messages. By

setting this value to a larger number, bursts of messages can be handled in a delayed manner.

5.5.4 Received Message Flow

Two methods are provided to support receiving messages from ETSMain. One involves waiting for a specific

message. The other uses message events.

5.5.4.1 Asynchronous Message Flow Functions

WaitResponse( Seconds as integer ) as string.

Waits until either the next response message is received or the number of seconds specified has elapsed. An

empty string is returned under the timeout condition.

FindResponse( Seconds as integer, Pattern as string ) as string.

Waits until a message is received that matches the specific response in Pattern or the timeout occurs. If a

timeout occurs an empty string is returned. The Pattern is a string that matches the leading characters of the

message string.

CancelFlag as boolean

This flag is used to prematurely abort a WaitResponse or FindResponse call. When set to true

WaitResponse or FindResponse will complete immediately.

5.5.4.2 Message Event Functions

The message events are used to process messages with less latency than the other methods. Events can be

used for Commands, Responses, and Errors. In addition the responses which generate events can be filtered.

The ETSIF ActiveX control has a Timer that it uses to poll ETSMain for messages during event generation. This

means that the event threads are not part of ETSMain.

Members

EvFilterAdd( Message as string)