oDivider Object

Description
Operation
Properties

Examples
Related
Version History & Bug list

A Processing Object that takes a clock input, divides it by a specified divisor and provides a clock output with the newly calculated clock rate.

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

	Object	Size	Description	A1	A2	B1	B2	C1
	oDivider	5 Bytes	Provides a clock divider.	x	x	x	x	x

Operation:

The oDivider Object monitors the oLogic Object that the Input property points to. Each time the monitored value transitions from 0 to 1 or from 1 to 0, a half-tick is counted. The number of half-ticks is then compared to the number specified by the Rate property. When the half-tick count is equal to the Rate property, the Result property is inverted. This process results in the Result property equaling the Input frequency divided by the Rate property. For example, if the Input property is linked to a 60hz input and the Rate property is set to 1, then the Result property will also cycle at 60hz. But if the Rate property is set to 3, then the Result will cycle at 20hz.

If the Rate property is set to 0, then the Input clock is divided by 256.

The default value of the Rate property is 1.

Properties:

The following table lists the properties of the oDivider Object:

Property
Description

Operate

A value that selects whether or not the Input clock is divided.

Object Class: oOperate Value Range: 0 - 1

Data Type: Numeric Default Value: 0

Operate Constant Description

0 cvOff The data is not updated.

1 cvOn The data is updated.

Input

A pointer to an oLogic Object whose value is used as an input to the divider function.

Object Class: oLogicPtrI Value Range: Any oLogic Object

Data Type: Pointer Default Value: Null

InvertIn

A value that selects in the incoming clock signal is to be inverted.

Object Class: oSelect0to1L Value Range: 0 - 1

Data Type: Numeric Default Value: 0

The following table lists the values of the InvertIn Property:

InvertIn Constant Description

0 cvFalse A transition from 0 to 1 is considered the end of the input clock's cycle.

1 cvTrue A transition from 1 to 0 is considered the end of the input clock's cycle

Output

A pointer to an oLogic Object whose value is updated with the value of the Result property.

Object Class: oLogicPtrO Value Range: Any oLogic Object

Data Type: Pointer Default Value: Null

InvertOut

A value that selects if the value of the Result property is inverted before it is copied to the oLogic Object pointed to by the Output property.

Object Class: oSelect0to1L Value Range: 0 - 1

Data Type: Numeric Default Value: 0

InvertOut Constant Description

0 cvFalse The value Result property is not inverted.

1 cvTrue The value of the Result property is inverted before it is copied.

Rate

A value that specifies the number of times that Input clock is to be divided.

Object Class: oVar7 Value Range: 0 - 127

Data Type: Numeric Default Value: 1

Rate Description

0 Divide by 256

1 Output clock = Input Clock

2 to 255 Divide by the number specified.

Result

The result of the divided Input clock.

Object Class: oLogic Value Range: 0 - 1

Data Type: Numeric Default Value: 0

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

Example:

The following examples use the oDivider Object.

Visual Basic Syntax

C and Java Syntax

' This program generates a 3Hz Clock
' by using an oDivider to divide the
' ooPIC.Hz60 property by 20.

Dim A As New oDivider
Dim B As New oDIO1 

Sub Main()
  A.ClockIn.Link(ooPIC.Hz60)
  A.Rate = 20
  A.Output.Link(B)
  A.Operate = 1
  B.IOLine = 8
  B.Direction = cvOutput
  B.Value = 1
End Sub

// This program generates a 3Hz Clock
// by using an oDivider to divide the
// ooPIC.Hz60 property by 20.

oDivider A = New oDivider;
oDIO1 B = New oDIO1;

Void Main(Void){
  A.ClockIn.Link(ooPIC.Hz60);
  A.Rate = 20;
  A.Output.Link(B);
  A.Operate = 1;
  B.IOLine = 8;
  B.Direction = cvOutput;
  B.Value = 1;
}

Basic Syntax

' This program generates a 3Hz Clock
' by using an oDivider to divide the
' ooPIC.Hz60 property by 20.

A As oDivider(ooPIC.Hz60,,B,,20,cvOn)
B As oDIO1(8,cvOutput,1)