oLCDSE Object

Main Index

Object List

Description
Operation
Property Options
Properties
Methods

Examples
Related
Version History & Bug list

Description:

A Hardware Object that outputs characters to a Scott Edwards LCD Module.

The following table lists the size and availability of the oLCDSE Object.

Object	Size	Description	A1	A2	B1	B2	C1
oLCDSE	5 Bytes	Controls a Scott Edwards Serial LCD Display.			x	x	x
oLCDSET	5 Bytes	Controls a Scott Edwards Serial LCD Display.			x	x	x

Operation:

When the oLCDSE Object's Value property is set to the ASCII value of a character, that character is sent out the I/O Lines specified by the IOLine property in such a way that a Scott Edwards LCD module will display the character.

Setting the VString property to a string of characters will sequentially send each character in the string to the LCD module. (see examples)

Invoking the Locate method will cause the LCD's cursor to be positioned on the LCD's screen at the specified X-Y coordinates.

Invoking the Clear method will cause the LCD module to clear its screen of any characters.

NOTICE: The Clear and the Locate methods will ONLY work with the Scott Edwards LCD. The command signals for other LCDs are different.

When created, the oLCDSE Object also creates an instance of the oSerialL object which it uses to control the display. The properties of the instance of the oSerialL Object are configured to transmit data at 2400 baud with an inverted serial signal. While different baud rates can be selected, modifying any other properties of the oSerialL instance will affect the oLCDSE Object's operation in ways that could make the it unable to control the display. See the oSerialL Help for more detail on how the serial port communicates with devices such as the Scott Edwards LCD module.

Property Options:

The oLCDSE Object has 1 property option: T.

T specifies that a LCD with a Terminal command set is being used.

LCD Command Set		Terminal Command Set
	oLCDSE		oLCDSET

Properties:

The following table lists the properties of the oLCDSE Object:

Property
Description

Value

A value that is sent to the Display.

Object Class: oValue Value Range: 0 - 255

Data Type: Numeric Default Value: 0

The value property accepts the ASCII value of the character to write to the LCD.

VString

A string version of the Value property.

Object Class: oProperty

Data Type: Numeric

IOLine

A value that specifies which I/O Line is used to communicate with the LCD.

Object Class: oIOLine Value Range: 0 - 31

Data Type: Numeric Default Value: 0

Some I/O Lines have special purposes. Be sure to see oIOLine help file for details.

Serial

The I/O function object used to control the LCD.

Object Class: oSerialL Value Range: 0 - 255

Data Type: Numeric Default Value: 0

When the oLCDSE object is created, it configures its oSerialL Object for 2400 baud with the following assignment:

Serial.Baud = cv2400

Attributes of the LCD's operation can be adjusted by directly manipulating the oSerialL object, but note that doing so may change the way the LCD behaves to something different than the way described in this document.

Address

Returns a pointer to the address of the oCounter Object instance.

Object Class: oAddress Value Range: 0 - 127

Data Type: Pointer (Read Only) Default Value: Address of Object

Methods:

Methods	Description
Clear	Clears the LCD screen.
Locate	Sets the cursor to the specified location. The Locate command uses two arguments; Row & Column, both of which are 0 based. Example: X.Locate(0,1) ' will locate cursor at 1st row, 2nd column. Example: X.Locate(1,9) ' will locate cursor at 2nd row, 10th column.

Examples:

In the following example, the oLCDSE Object is used.

Visual Basic Syntax

C and Java Syntax

'This program prints "Testing"
'to a Scott Edwards serial LCD

Dim A As New oLCDSE 

Sub Main()
  A.IOLine = 8
  A.Clear
  A.Locate(1,4)
  A.VString = "Testing" 
End Sub

// This program prints "Testing"
// to a Scott Edwards serial LCD

oLCDSE A = New oLCDSE;

Void Main(Void){
  A.IOLine = 8;
  A.Clear;
  A.Locate(1,4);
  A.VString = "Testing";
}

Basic Syntax

'This program prints "Testing"
'to a Scott Edwards serial LCD

A As oLCDSE(8)

A.Clear
A.Locate(1,4)
A.VString = "Testing"

In the following example, the oLCDSE Object is used with a baud rate of 9600.

Visual Basic Syntax

C and Java Syntax

' This program prints "Testing"
' to a Scott Edwards serial LCD
' set to 9600 baud.

Dim A As New oLCDSE 

Sub Main()
  A.IOLine = 8
  A.Serial.Baud = cv9600
  A.Clear
  A.VString = "Testing" 
End Sub

// This program prints "Testing"
// to a Scott Edwards serial LCD
// set to 9600 baud.

oLCDSE A = New oLCDSE;

Void Main(Void){
  A.IOLine = 8;
  A.Serial.Baud = cv9600;
  A.Clear;
  A.VString = "Testing";
}

Basic Syntax

' This program prints "Testing"
' to a Scott Edwards serial LCD
' set to 9600 baud.

A As oLCDSE(8)

A.Serial.Baud = cv9600
A.Clear
A.VString = "Testing"

Connections:

The oLCDSE uses one I/O line. This I/O line is connected to the data line of the Scott Edwards LCD Module.