Timer¶
A simple timer that operates only in one-shot mode. It has a
clock_in input pin, a timer_int_out output pin to the Interrupt
Controller, and
communicates with the core over the shared address/data bus through a
single control register, accessed with word load/stores only. See
Peripheral Devices for the connection diagram
and the full address map.
Control register¶
| Bits | Field | Description |
|---|---|---|
[0] |
Timer_en |
Enable bit. Writing 1 starts the timer, writing 0 disables it. |
[31:1] |
Timer_max_count |
The number of ticks to count, set on the same write that enables the timer. |
A read of the Control register returns it as last written. The live count is not readable. Byte stores update only the bytes they select.
Behavior¶
Software writes a maximum count into the control register and sets
the enable bit in the same write. From that point, the timer counts
clock_in edges, starting from 0. When the count reaches the maximum,
the timer asserts its interrupt output (IRL 10, see Peripheral
Devices) and stops counting. A
maximum count of 0 or 1 both fire on the first edge. The interrupt
output stays asserted until software explicitly disables the timer.
In the simulator, one clock_in edge is one core cycle by default. A
divider makes it every n cycles instead (--timer-tick-divider <n>,
or the timerTickDivider setting, see Model Configuration
Settings). In hardware the timer may
run off a different clock than the core, so timer counts here are
model ticks, not hardware time.
TIMER_DISABLED
The reset state. The interrupt output is 0. A write ofTimer_en=1clears the count, capturesTimer_max_count, and moves toTIMER_ENABLED.TIMER_ENABLED
Counts up. The interrupt output is 0. When the count reachesTimer_max_count, the interrupt output is asserted, and the timer moves toTIMER_INTERRUPTING. A further write ofTimer_en=1does not restart it.TIMER_INTERRUPTING
The timer stops counting. The interrupt output stays asserted until the CPU writesTimer_en=0, which clears it and returns the timer toTIMER_DISABLED.
A write of Timer_en=0 from any state immediately clears the count
and the interrupt output, and moves to TIMER_DISABLED.
Note¶
A free running 64-bit counter across ASR[31] and ASR[30], running at the processor clock and read-only, is documented separately from this Timer. It is unrelated to it, a CPU-internal cycle counter rather than a memory-mapped, software-configured timer. Our Sitar model does not yet implement this counter.