== Timer Extension (EID #0x54494D45 "TIME")

This replaces legacy timer extension (EID #0x00). It follows the new calling
convention defined in v0.2.

=== Function: Set Timer (FID #0)

[source, C]
----
struct sbiret sbi_set_timer(uint64_t stime_value)
----

Programs the clock for next event after *stime_value* time. *stime_value*
is in absolute time.

If the supervisor wishes to clear the timer interrupt without scheduling
the next timer event, it may request a timer interrupt infinitely far
into the future (i.e., (uint64_t)-1). Alternatively, to not receive timer
interrupts, it may mask timer interrupts by clearing the `sie.STIE` CSR bit.

This function must clear the pending timer interrupt bit when
*stime_value* is set to some time in the future, regardless of whether
timer interrupts are masked or not.

This function always returns SBI_SUCCESS in `sbiret.error`.

=== Function Listing

[#table_time_function_list]
.TIME Function List
[cols="4,2,1,2", width=80%, align="center", options="header"]
|===
| Function Name | SBI Version | FID | EID
| sbi_set_timer | 0.2         | 0   | 0x54494D45
|===