Skip to content

Time Manager

androidemu.core.state.time_manager.TimeManager

Manages virtual system time and uptime. Replaces real-world blocking delays with deterministic virtual time increments. Integrates with Scheduler and SyscallsHandler to provide instant 'sleep' execution without hanging the host process.

Source code in androidemu/core/state/time_manager.py
class TimeManager:
    """
    Manages virtual system time and uptime. 
    Replaces real-world blocking delays with deterministic virtual time increments.
    Integrates with Scheduler and SyscallsHandler to provide instant 'sleep' 
    execution without hanging the host process.
    """
    def __init__(self, start_timestamp=None):
        self.virtual_us = (start_timestamp) * 1000000
        self.uptime_us = random.randint(7200, 36000) * 1000000

    def set_time(self, timestamp: float) -> None:
        self.virtual_us = int(timestamp * 1000000)

    def advance_time(self, microseconds: int) -> None:
        self.virtual_us += microseconds
        self.uptime_us += microseconds

    def jump_to_time(self, target_us: int) -> None:
        diff = target_us - self.virtual_us
        if diff > 0:
            self.advance_time(diff)

    def get_timeofday(self) -> tuple:
        self.advance_time(random.randint(15, 45))
        sec = self.virtual_us // 1000000
        usec = self.virtual_us % 1000000
        return sec, usec

    def get_clock_monotonic(self) -> tuple:
        self.advance_time(random.randint(10, 30))
        sec = self.uptime_us // 1000000
        nsec = (self.uptime_us % 1000000) * 1000
        return sec, nsec

    def get_current_time_us(self) -> int:
        return self.virtual_us

advance_time(microseconds: int) -> None

Source code in androidemu/core/state/time_manager.py
def advance_time(self, microseconds: int) -> None:
    self.virtual_us += microseconds
    self.uptime_us += microseconds

get_clock_monotonic() -> tuple

Source code in androidemu/core/state/time_manager.py
def get_clock_monotonic(self) -> tuple:
    self.advance_time(random.randint(10, 30))
    sec = self.uptime_us // 1000000
    nsec = (self.uptime_us % 1000000) * 1000
    return sec, nsec

get_current_time_us() -> int

Source code in androidemu/core/state/time_manager.py
def get_current_time_us(self) -> int:
    return self.virtual_us

get_timeofday() -> tuple

Source code in androidemu/core/state/time_manager.py
def get_timeofday(self) -> tuple:
    self.advance_time(random.randint(15, 45))
    sec = self.virtual_us // 1000000
    usec = self.virtual_us % 1000000
    return sec, usec

jump_to_time(target_us: int) -> None

Source code in androidemu/core/state/time_manager.py
def jump_to_time(self, target_us: int) -> None:
    diff = target_us - self.virtual_us
    if diff > 0:
        self.advance_time(diff)

set_time(timestamp: float) -> None

Source code in androidemu/core/state/time_manager.py
def set_time(self, timestamp: float) -> None:
    self.virtual_us = int(timestamp * 1000000)