oTimer Object

The PIC's Timer1 Hardware Module provides a 16-bit high speed counter with optional Crystal controlled frequency and input scaling.

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

	Object	Size	Description	A1	A2	B1	B2	C1
	oTimer	1 Byte	Counts the number of high-speed cycles on an input.	x	x	x	x	x

The Count property directly reads and writes the Timer1 Module's 16-Bit value which consists of the TMR1L and TMR1H registers.

The ExtClock property specifies if the Timer1 Module is to count the cycles of an internal 5Mhz clock or the cycles present on a external clock supplied on I/O line 16. This property directly reads and writes the Timer1 Module TMR1CS bit.

The ExtXtal property specifies if I/O Line 16 is used in conjunction with I/O Line 17 for a crystal to be connected. This property directly reads and writes the Timer1 Module T1OSCEN bit.

The PreScale property specifies if and how the Timer1 Module divides the clock source cycles before they are counted. This property directly reads and writes the Timer1 Module T1CKPS bits.

The Operate property specifies if the Timer1 Module increments each time the clock source cycles. This property directly reads and writes the Timer1 Module TMR1ON bit.

Note that all instances of the oTimer object will use the PIC's Timer1 Hardware Module.  Therefore, all instances of the oTimer object will have the same 16-Bit count.  This includes instances of objects that use the oTimer object.

The following table lists the properties of the oTimer Object:

Property	Description
Count	The current 16-Bit cycle count value. Object Class:  oWord   Value Range:  0 - 65535 Data Type:  Numeric   Default Value:  0
ExtClock	A value that selects if the Timer1 Hardware uses I/O Lines or an internal clock for its clock source. Object Class:  oSelect0to1   Value Range:  0 - 1 Data Type:  Numeric   Default Value:  0 ExtClock Constant Description 0 cvOff 5Mhz internal clock is used as the input frequency to the Timer1 Module. 1 cvOn I/O Lines 16 & 17 are used for the source of the input frequency to the Timer1 Module.
ExtXtal	A value that selects if the external crystal driver is enabled on the I/O Lines. Object Class:  oSelect0to1   Value Range:  0 - 1 Data Type:  Numeric   Default Value:  0 ExtXtal Constant Description 0 cvOff The external crystal drive circuitry is disabled. The Timer1 Module uses only I/O line 16. 1 cvOn The external crystal drive circuitry is enabled. The Timer1 Module uses both I/O Lines 16 & 17.
PreScale	A value that selects which divisor is used to divide the clock input of the Timer1 Hardware. Object Class:  oSelect0to3   Value Range:  0 - 3 Data Type:  Numeric   Default Value:  0 PreScale Description 0 1:1 - The input clock is not changed. 1 1:2 - The input clock is divided by 2. 2 1:4 - The input clock is divided by 4. 3 1:8 - The input clock is divided by 8.
Operate	A value that selects whether or not the Timer1 Hardware is enabled and counts the cycles of the clock source. Object Class:  oOperate   Value Range:  0 - 1 Data Type:  Numeric   Default Value:  0 Operate Constant Description 0 cvOff The Timer1 Hardware is not enabled. 1 cvOn The Timer1 Hardware is enabled.
IOLineC	I/O Line 16 used as an external clock source. Object Class:  oIOLine   Value Range:  16 Data Type:  Numeric (Read-Only)   Default Value:  16
IOLineX	I/O Line 17 used to drive the external crystal. Object Class:  oIOLine   Value Range:  17 Data Type:  Numeric (Read-Only)   Default Value:  17
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

' Copy the oTimer's ' Value to an oDio16. Dim T As New oTimer Dim D As New oDIO16 Sub Main() D.Direction = cvOutput T.Operate = 1 T.PreScale = 3 T.Operate = cvTrue Do D.State = T.Count Loop End Sub

Bugs: No known bugs.