inittimer7

InitTimer7

Syntax:

InitTimer7 source, prescaler

Command Availability:

Available on Microchip microcontrollers with a Timer 7 module.

Explanation:

InitTimer7 will set up timer 7.

Parameters are required as detailed in the table below:

Parameter	Description
source	The clock source for this specific timer. Can be either Osc, Ext or ExtOsc where: Osc is an internal oscillator. Ext is an external oscillator. Osc - Selects the clock source in use, as set by the microcontroller specific configuration (fuses or #config).  This could be an internal clock or an external clock source ( external clock sources are typically attached to the XTAL pins). Ext - Selects the clock source attached to a specific exernal interrupt input port.  This allows a different clock frequency than the main clock to be used, such as 32.768 kHz crystals commonly used for real time circuits. ExtOsc is an external oscillator and only available on a Microchip PIC microcontroller. Enhanced Microchip PIC microcontrollers with a dedicated TMRxCLK register support additional clock sources. This includes, but limited to, the following devices: 16F153xx, 16F16xx, 16F188xx and 18FxxK40 Microchip PIC microcontroller series. On these devices the clock source can be one of the following: Osc is an internal oscillator which is the same source as FOSC4. Ext is an external oscillator which is the same source as TxXKIPPS. ExtOsc is an external oscillator which is the same source as SOSC. FOSC is an internal oscillator which is the Frequency of the OSCillator. FOSC4 is an internal oscillator which is the Frequency of the OSCillator divided by 4. SOSC is an external oscillator which is the same source as SOSC. MFINTOSC is an internal 500KHz internal clock oscillator. LFINTOSC is an internal 31Khz internal clock oscillator. HFINTOSC is an oscillator as specified within the datasheet for each specific microcontroller. TxCKIPPS is an oscillator input on TxCKIPPS Pin.
prescaler	The value of the prescaler for this specific timer. See the tables below for permitted vales for Microchip PIC or the Atmel AVR microcontrollers.

When the timer overflows an interrupt event will be generated. This interrupt event can be used in conjunction with On Interrupt to run a section of code when the interrupt event occurs.

Microchip PIC microcontrollers:

On Microchip PIC microcontrollers prescaler must be one of the following constants:

Prescaler Value	Primary GCB Constant	Constant Equates to value
1:1	PS7_1	0
1:2	PS7_2	16
1:4	PS7_4	32
1:8	PS7_8	48

These correspond to a prescaler of between 1:2 and 1:8 of the oscillator (FOSC/4) speed. The prescaler will apply to either the oscillator or the external clock input.

Supported in <TIMER.H>