SceSystimer: Difference between revisions

From Vita Development Wiki
Jump to navigation Jump to search
No edit summary
m (→‎SceSystimerForDriver_0450933B: Update based on official description)
 
(3 intermediate revisions by the same user not shown)
Line 23: Line 23:
== Types ==
== Types ==
<source lang="C">
<source lang="C">
#define SYSTIMER_TYPE_LONG 1
#define SYSTIMER_TYPE_LONG 1     //<! 64-bit timer
#define SYSTIMER_TYPE_WORD 2
#define SYSTIMER_TYPE_WORD 2     //<! 32-bit timer
typedef SceInt32 SceSystimerType;
typedef SceInt32 SceSystimerType;
#define SYSTIMER_CLKSRC_SYS  0  //<! The clock controlled by scePowerSetSysClockFrequency
#define SYSTIMER_CLKSRC_48MHZ 3  //<! A clock running at a fixed frequency of 48MHz
typedef SceUInt32 SceSystimerClkSrc;


typedef SceInt32 SceSystimerId;
typedef SceInt32 SceSystimerId;
Line 52: Line 56:
|}
|}


Edit some bits (mask 0xFFF00700) of the timer's config register. Timer must not be counting.
Sets the timer's clock source. Timer must not be counting.


<source lang="C">
<source lang="C">
//
// Timer frequency = (clock source frequency) / (prescaleFactor + 1)
//
// if (a2 < 0x10), written to bits 0x00F00000
// if (a2 < 0x10), written to bits 0x00F00000
// else (a2 & 0x7) written to bits 0x00000700 and 0x2 written to bits 0x00F00000
// else (a2 & 0x7) written to bits 0x00000700 and 0x2 written to bits 0x00F00000
// a3 written to bits 0xFF000000
// a3 written to bits 0xFF000000
SceInt32 SceSystimerForDriver_0450933B(SceSystimerId timer, SceUInt32 a2, SceUInt32 a3);
SceInt32 SceSystimerForDriver_0450933B(SceSystimerId timer, SceSystimerClkSrc src, SceUInt32 prescaleFactor);
</source>
</source>


Line 69: Line 76:
|}
|}


Sets the timer's current counter value?
Sets the timer's counter value and increments the accumulating counter by <code>counter</code>.


<source lang="C">SceInt32 SceSystimerForDriver_1B14DFD6(SceSystimerId timer, SceKernelSysClock a2);</source>
<source lang="C">SceInt32 SceSystimerForDriver_1B14DFD6(SceSystimerId timer, SceKernelSysClock counter);</source>


=== SceSystimerForDriver_59EBD22D ===
=== SceSystimerForDriver_59EBD22D ===
Line 81: Line 88:
|}
|}


Start timer.
Starts the timer.


<source lang="C">SceInt32 SceSystimerForDriver_59EBD22D(SceSystimerId timer);</source>
<source lang="C">SceInt32 SceSystimerForDriver_59EBD22D(SceSystimerId timer);</source>
Line 93: Line 100:
|}
|}


Reset timer? Sets current counter and accumulated counter to 0.
Resets the timer's count. Sets current and accumulated counter to 0.


<source lang="C">SceInt32 SceSystimerForDriver_7DEBA6A5(SceSystimerId timer);</source>
<source lang="C">SceInt32 SceSystimerForDriver_7DEBA6A5(SceSystimerId timer);</source>
Line 105: Line 112:
|}
|}


<code>sceKernelSysTimerFree</code>? Stops timer if necessary.
Stops the timer if active, and frees the timer. (<code>sceKernelSysTimerFree</code>)


<source lang="C">SceInt32 SceSystimerForDriver_8358611F(SceSystimerId timer);</source>
<source lang="C">SceInt32 SceSystimerForDriver_8358611F(SceSystimerId timer);</source>
Line 117: Line 124:
|}
|}


Get timer accumulated time (i.e. <code>*a2 = timer->currentCounter + (sum of counter of each time interrupt was triggered)</code>)
Obtains the timer's accumulated count (i.e. <code>*a2 = timer->currentCounter + (sum of counter of each time interrupt was triggered)</code>)


<source lang="C">SceInt32 SceSystimerForDriver_85AAE0DD(SceSystimerId timer, SceKernelSysClock* a2);</source>
<source lang="C">SceInt32 SceSystimerForDriver_85AAE0DD(SceSystimerId timer, SceKernelSysClock* a2);</source>
Line 146: Line 153:
|}
|}


Get timer counter (i.e. <code>*a2 = timer->currentCount</code>).
Obtains the current value of the timer's counter (i.e. <code>*a2 = timer->currentCount</code>).


<source lang="C">SceInt32 SceSystimerForDriver_963F7C0D(SceSystimerId timer, SceKernelSysClock* a2);</source>
<source lang="C">SceInt32 SceSystimerForDriver_963F7C0D(SceSystimerId timer, SceKernelSysClock* a2);</source>
Line 158: Line 165:
|}
|}


Set timer threshold? Timer must not be counting.
Sets the timer's interval (cycles count). Timer must not be counting.


<source lang="C">SceInt32 SceSystimerForDriver_A73351C1(SceSystimerId timer, SceKernelSysClock a2);</source>
<source lang="C">SceInt32 SceSystimerForDriver_A73351C1(SceSystimerId timer, SceKernelSysClock interval);</source>


=== SceSystimerForDriver_BF8D42B0 ===
=== SceSystimerForDriver_BF8D42B0 ===
Line 170: Line 177:
|}
|}


Stop timer.
Stops the timer.


<source lang="C">SceInt32 SceSystimerForDriver_BF8D42B0(SceSystimerId timer);</source>
<source lang="C">SceInt32 SceSystimerForDriver_BF8D42B0(SceSystimerId timer);</source>
Line 198: Line 205:
|}
|}


Set behaviour on interrupt.
(Un)registers an interrupt handler for the timer.


<source lang="C">
<source lang="C">
/*
/*
  * cb will be invoked whenever the timer is interrupted - timer and pUserData arguments will be the same as provided to this function
  * cb will be invoked whenever the timer generates an interrupt (that is, when the counter reaches the threshold set via SceSystimerForDriver_A73351C1())
* timer and pUserData arguments will be the same as provided to this function
  * cb will only be called if SceSystimerForDriver_A73351C1() has been called with non-zero argument (e.g. timer has a threshold)
  * cb will only be called if SceSystimerForDriver_A73351C1() has been called with non-zero argument (e.g. timer has a threshold)
  * cb can be NULL, in which case targetCPU will not be set
  * cb can be NULL, in which case targetCPU will not be set
Line 219: Line 227:
|}
|}


Read some ?counter? from the timer.
Reads some ?counter? from the timer.


<source lang="C">SceInt32 SceSystimerForDriver_FD5F1742(SceSystimerId timer, SceKernelSysClock* a2);</source>
<source lang="C">SceInt32 SceSystimerForDriver_FD5F1742(SceSystimerId timer, SceKernelSysClock* a2);</source>

Latest revision as of 19:37, 27 October 2024

Manages the system timers. This module wraps the Hardware Timers and add some functionalities, along with providing a consistent interface.

Module

Version World Privilege
0.931-3.65 Non-secure Kernel

Libraries

Known NIDs

Version Name World Visibility NID
0.931-3.65 SceSystimerForDriver Non-secure Kernel 0xA47EB09A

Types

#define SYSTIMER_TYPE_LONG 1      //<! 64-bit timer
#define SYSTIMER_TYPE_WORD 2      //<! 32-bit timer
typedef SceInt32 SceSystimerType;

#define SYSTIMER_CLKSRC_SYS   0   //<! The clock controlled by scePowerSetSysClockFrequency
#define SYSTIMER_CLKSRC_48MHZ 3   //<! A clock running at a fixed frequency of 48MHz
typedef SceUInt32 SceSystimerClkSrc;

typedef SceInt32 SceSystimerId;

typedef void (*SceSystimerCallback)(SceSystimerId timer, void* pUserData);

SceSystimerForDriver

sceKernelSysTimerAllocForDriver

Version NID
0.990-3.60 0xE2B9D8E9 
SceSystimerId sceKernelSysTimerAllocForDriver(SceSystimerType type);

SceSystimerForDriver_0450933B

Version NID
3.65 0x0450933B

Sets the timer's clock source. Timer must not be counting. 

//
// Timer frequency = (clock source frequency) / (prescaleFactor + 1)
//
// if (a2 < 0x10), written to bits 0x00F00000
// else (a2 & 0x7) written to bits 0x00000700 and 0x2 written to bits 0x00F00000
// a3 written to bits 0xFF000000
SceInt32 SceSystimerForDriver_0450933B(SceSystimerId timer, SceSystimerClkSrc src, SceUInt32 prescaleFactor);

SceSystimerForDriver_1B14DFD6

Version NID
3.65 0x1B14DFD6

Sets the timer's counter value and increments the accumulating counter by counter. 

SceInt32 SceSystimerForDriver_1B14DFD6(SceSystimerId timer, SceKernelSysClock counter);

SceSystimerForDriver_59EBD22D

Version NID
3.65 0x59EBD22D

Starts the timer. 

SceInt32 SceSystimerForDriver_59EBD22D(SceSystimerId timer);

SceSystimerForDriver_7DEBA6A5

Version NID
3.65 0x7DEBA6A5

Resets the timer's count. Sets current and accumulated counter to 0. 

SceInt32 SceSystimerForDriver_7DEBA6A5(SceSystimerId timer);

SceSystimerForDriver_8358611F

Version NID
3.65 0x8358611F

Stops the timer if active, and frees the timer. (sceKernelSysTimerFree) 

SceInt32 SceSystimerForDriver_8358611F(SceSystimerId timer);

SceSystimerForDriver_85AAE0DD

Version NID
3.65 0x85AAE0DD

Obtains the timer's accumulated count (i.e. *a2 = timer->currentCounter + (sum of counter of each time interrupt was triggered)) 

SceInt32 SceSystimerForDriver_85AAE0DD(SceSystimerId timer, SceKernelSysClock* a2);

SceSystimerForDriver_904DF737

Version NID
3.65 0x904DF737

Edits some bits (mask 0x000F0080) of the timer's config register. Timer must not be counting. 

// a2 written to bits 0x000F0000
// a3 written to bit  0x00000080
// additionaly, config register is also |= 0x40
SceInt32 SceSystimerForDriver_904DF737(SceSystimerId timer, SceUInt32 a2, SceBool a3);

SceSystimerForDriver_963F7C0D

Version NID
3.65 0x963F7C0D

Obtains the current value of the timer's counter (i.e. *a2 = timer->currentCount). 

SceInt32 SceSystimerForDriver_963F7C0D(SceSystimerId timer, SceKernelSysClock* a2);

SceSystimerForDriver_A73351C1

Version NID
3.65 0xA73351C1

Sets the timer's interval (cycles count). Timer must not be counting. 

SceInt32 SceSystimerForDriver_A73351C1(SceSystimerId timer, SceKernelSysClock interval);

SceSystimerForDriver_BF8D42B0

Version NID
3.65 0xBF8D42B0

Stops the timer. 

SceInt32 SceSystimerForDriver_BF8D42B0(SceSystimerId timer);

SceSystimerForDriver_C34D7940

Version NID
3.65 0xC34D7940

Edits some bits (mask 0x0000F000) of the timer's config register. Timer must not be counting. 

// a2 written to bits 0x0000F000
// additionaly, config register is also |= 0x20
SceInt32 SceSystimerForDriver_C34D7940(SceSystimerId timer, SceUInt32 a2);

SceSystimerForDriver_CCCD1EE3

Version NID
3.65 0xCCCD1EE3

(Un)registers an interrupt handler for the timer. 

/*
 * cb will be invoked whenever the timer generates an interrupt (that is, when the counter reaches the threshold set via SceSystimerForDriver_A73351C1())
 * timer and pUserData arguments will be the same as provided to this function
 * cb will only be called if SceSystimerForDriver_A73351C1() has been called with non-zero argument (e.g. timer has a threshold)
 * cb can be NULL, in which case targetCPU will not be set
 *
 * targetCPU follows the same rules as sceKernelSetIntrTarget() - see SceKernelIntrMgr for more info
 */
SceInt32 SceSystimerForDriver_CCCD1EE3(SceSystimerId timer, SceSystimerCallback cb, SceUInt32 targetCPU, void* pUserData);

SceSystimerForDriver_FD5F1742

Version NID
3.65 0xFD5F1742

Reads some ?counter? from the timer. 

SceInt32 SceSystimerForDriver_FD5F1742(SceSystimerId timer, SceKernelSysClock* a2);
Retrieved from "http://wiki.henkaku.xyz/index.php?title=SceSystimer&oldid=21415"