TIMER Config - Timer Configuration Block

dsPIC30F dsPIC33F dsPIC33E dsPIC33C dsPIC33A PIC32

☀️ Light

TIMER Config - Timer Configuration Block Timer Block Icon The MCHP_TIMER_Config block provides a high-level interface for configuring hardware timers on Microchip microcontrollers. This block creates and manages named timer resources that can be shared across multiple peripherals in the model, providing automatic timer allocation and optimal prescaler selection. Unlike direct timer register access, this block manages the complete timer lifecycle including resource allocation, conflict resolution, and automatic prescaler calculation based on desired resolution and period requirements.

When to use:

• Timer-based peripherals — Configure timebase for Input Capture, Output Compare, PWM blocks
• Named timer resources — Create shared timer for multiple peripherals (e.g., “TimerPWM”)
• Automatic allocation — Let blockset choose optimal timer from available resources
• Prescaler calculation — Automatic selection for desired resolution and period
• Timer sharing — Multiple blocks read same timer for synchronized operation

When NOT to use:

• No timer peripherals — If no blocks need timers, don’t add Timer Config
• Simple delay — Use Simulink Delay block (not hardware timer)
• Already configured — PWM/IC/OC blocks create timers automatically if not specified
• QEI/QDEC/PDEC — Encoder blocks don’t use Timer Config (have own time bases)
• External clock — If peripheral uses external clock source, may not need Timer Config

Block Dialog

Ports

Inputs: None (configuration block only)

Outputs: None (configuration block only)

This is a configuration block that sets up hardware timer resources. It does not have signal ports—other blocks (Input Capture, Output Compare, etc.) reference the timer by name.

Parameters

Timer Identification

Timer Resource Selection

Timer Resolution and Period

Timer Sharing Configuration

Timing Considerations

Resolution vs. Range Trade-off

Timer resolution and maximum period are inversely related through the prescaler:

Period Calculation Accuracy

• Period register is integer only (0-65535)
• Actual period may differ slightly from requested value
• Block automatically rounds to nearest achievable period
• Check model compilation output for actual achieved period

Clock Source Dependencies

• dsPIC/PIC24: Uses instruction cycle clock (Fcy = Fosc/2)
• PIC32: Uses peripheral bus clock (PBCLK)
• SAMx: Uses master clock (MCK) or GCLK
• Ensure clock configuration in Master Block matches hardware setup

Device Support

Examples

Example 1: Timer for Periodic Interrupt

% Configure 1ms periodic timer
Timer Name: TimerA
Timer Resource: No constraints [Preferred]
Timer Period: 0.001  % 1ms
Use Maximum Period: OFF
Share Timer: OFF (exclusive use)

Result: Automatically selects optimal prescaler and timer peripheral for 1ms period, exclusive ownership.

Example 2: Shared Timer for Multiple Peripherals

% High-resolution timer shared between PWM and OC
Timer Name: TimerPWM
Timer Resource: Timer 2  % Force use of Timer2
Use Maximum Period: ON  % PR = 65535
Share Timer: ON
Timer Use: Read only  % Allow other blocks to read

Result: Timer2 configured at maximum resolution, other blocks can reference “TimerPWM” for synchronization.

Example 3: Custom C Code Timer Reservation

% Reserve Timer3 for manual configuration
Timer Name: CustomTimer
Timer Resource: Timer 3
Do Not Setup This Timer: ON  % Reserve only

Result: Timer3 reserved but not initialized. User can configure in custom C code using the reserved resource.

Example 4: Variable Period Control

% MATLAB workspace variable control
samplingPeriod = 0.0001;  % 100µs base period

Timer Name: TimerControl
Timer Period: samplingPeriod
Share Timer: ON
Timer Use: Read / Write / Start-Stop / Period update

Result: Timer configured for 100µs, can be modified at runtime by other blocks.

Programmatic Setup

% Add block to model
add_block('MCHP_Blockset/Timers/TIMER Configuration', [mdl '/Timer']);

% Configure key parameters
set_param([mdl '/Timer'], 'TIMER_Name', 'TimerA');
set_param([mdl '/Timer'], 'TIMER_Use', 'Read only');

Troubleshooting

Common Issues and Solutions

Error: “Timer Name already defined”

Cause: Duplicate timer names in model.

Solution: Use unique names (TimerA, TimerB, etc.) or custom names. Block automatically suggests alternative names.

Warning: “Cannot achieve exact period”

Cause: Requested period not achievable with integer PR value.

Solution:

• Accept nearest achievable period (shown in compilation output)
• Try different prescaler setting
• Adjust requested period to align with clock frequency

Timer Conflict with Other Peripherals

Cause: Multiple peripherals requesting same timer with incompatible settings.

Solution:

• Use “Share Timer: ON” with compatible Timer Use settings
• Use “No constraints” to allow automatic timer selection
• Manually assign different timers to each peripheral

No Available Timers

Cause: All timers allocated to exclusive-use blocks.

Solution:

• Enable timer sharing where possible
• Reduce number of Timer Config blocks
• Use single shared timer for multiple peripherals

Implementation Details

Register Configuration

The block configures the following timer registers based on device family:

dsPIC/PIC24/PIC32A (TxCON register)

• TON - Timer ON bit (controlled by startup mode)
• TCKPS - Timer Input Clock Prescale Select (1:1, 1:8, 1:64, 1:256)
• TCS - Timer Clock Source (internal peripheral clock)
• TGATE - Timer Gated Time Accumulation Enable (disabled)
• PRx - Period register (calculated from desired period)

PIC32 MIPS (TxCON register)

• ON - Timer Enable bit
• TCKPS - Clock Prescale (3 bits: 1:1 to 1:256)
• TCS - Clock Source (PBCLK)
• PRx - Period register

SAMx (ARM) - TC Module

• TCCLKSx - Clock Selection (MCK/8, MCK/32, MCK/128)
• WAVE - Waveform mode (enabled for timer operation)
• RC - Register C (period value)
• CMR - Channel Mode Register configuration

Timer Type Classification

The block manages timers using an internal type system:

Automatic Timer Allocation

The block uses the MCHP_Fun.TimerConfig() function for intelligent timer assignment:

• Conflict Detection - Scans all Timer Config blocks for duplicate names
• Resource Pooling - Builds available timer list based on constraints
• Optimal Selection - Chooses timer that best matches requirements
• Prescaler Calculation - Automatically selects prescaler for desired resolution
• Period Register - Calculates PR value to achieve target period

Related Blocks

• MCHP_IC - Input Capture - Uses configured timers for event timestamping

• MCHP_OC_HW - Output Compare (Hardware) - Requires timer timebase

• MCHP_OC_SW - Output Compare (Software) - Uses timer for software compare

• MCHP_TIMER_PIL_Profiling - Uses timers for code execution profiling

• MCHP Interrupt Blocks - Timer interrupts for periodic tasks

• MCHP_PWM Blocks - PWM blocks use timers for frequency control

• Getting Started: Timer Configuration

• User Guide: Resource Management

• Timer Configuration Examples