ufm::sys::TinyKernel 類別 參考文件

類別ufm::sys::TinyKernel的繼承圖:

公開方法(Public Methods)
	TinyKernel (void(*reboot)(void))
	Construct a new object.
virtual	~TinyKernel (void) override
	Destroy the object.
virtual const char *	getThreadName (void) const override
	取得執行緒名稱
virtual ufm::sys::ThreadPriority	getPriority (void) const override
	取得執行緒優先權
virtual ufm::sys::ThreadState	getState (void) const override
	取得執行緒狀態
virtual int	getStackSize (void) const override
	取得執行緒堆疊大小
virtual bool	start (const char *name, ufm::sys::ThreadPriority priority) override
	以指定名稱和優先權啟動執行緒
virtual void	notify (void) override
	通知執行緒，喚醒等待中的執行緒
virtual bool	setPriority (ufm::sys::ThreadPriority priority) override
	設定執行緒優先權
virtual bool	initialize (void) override
	核心初始化
virtual void	start (ufm::func::Runnable *task) override
	核心啟動
virtual int	systemLock (void) override
	核心鎖定
virtual int	systemUnlock (void) override
	核心解鎖
virtual bool	systemDelay (int milliseconds) const override
	執行緒延遲
virtual bool	systemWait (int timeout) const override
	執行緒等待
virtual void	reboot (void) override
	核心重新啟動
virtual ufm::sys::Thread *	getCurrentThread (void) override
	取得當前執行緒
virtual bool	systemYield (void) override
	讓出執行時間片段
公開方法(Public Methods) 繼承自 ufm::sys::Thread
	Thread (void)
	建構執行緒物件
virtual	~Thread (void) override
	解構執行緒物件
bool	start (const char *name)
	以預設優先權啟動執行緒
bool	isActive (void)
	檢查執行緒是否處於活動狀態
公開方法(Public Methods) 繼承自 ufm::lang::Object
void *	operator new (size_t n)
	使用運算子 new 分配記憶體
void *	operator new (size_t n, void *p)
	在指定記憶體上調用運算子 new
virtual ufm::lang::Object &	getObject (void) override
	取得對應的 Object 物件
void	delay (int milliseconds) const
	延遲指定的毫秒數進行執行緒等待
bool	equals (Object *object) const
	判斷與另一物件是否為相同參照（指標型態比較）
bool	equals (Object &object) const
	判斷與另一物件是否為相同參照（參照型態比較）
void	wait (void) const
	使當前線程等待直到被通知
bool	wait (int timeout) const
	等待通知或超時
bool	yield (void) const
	讓執行緒讓渡控制權給同優先權的下一個執行緒
int	lock (void) const
	核心鎖定，鎖定期間禁止線程切換
int	unlock (void) const
	核心解鎖
ufm::sys::Thread *	currentThread (void) const
	取得當前執行緒指標
virtual int	hashcode (void) const
	返回對象的哈希碼值。支持這種方法是為了散列表，如HashMap提供的那樣。
公開方法(Public Methods) 繼承自 ufm::lang::Interface
virtual	~Interface (void)=default
	虛擬析構函式

函式成員說明文件

getCurrentThread()

virtual ufm::sys::Thread * ufm::sys::TinyKernel::getCurrentThread ( void )

overridevirtual

取得當前執行緒

獲取當前正在CPU上執行的執行緒物件。 用於執行緒需要參照自身或取得自己相關資訊時。

傳回值

Thread* 當前執行緒的指標，若在中斷或核心未啟動時可能返回null

實作 ufm::sys::Kernel.

getPriority()

virtual ufm::sys::ThreadPriority ufm::sys::TinyKernel::getPriority ( void ) const

overridevirtual

取得執行緒優先權

獲取此執行緒的當前優先權等級，影響調度器對此執行緒的處理優先性。

傳回值

ufm::sys::ThreadPriority 執行緒當前的優先權等級

實作 ufm::sys::Thread.

getStackSize()

virtual int ufm::sys::TinyKernel::getStackSize ( void ) const

overridevirtual

取得執行緒堆疊大小

獲取分配給此執行緒的堆疊記憶體大小。堆疊用於儲存區域變數、 函數調用信息以及執行緒上下文資料。

傳回值

int 執行緒堆疊的大小（位元組）

實作 ufm::sys::Thread.

getState()

virtual ufm::sys::ThreadState ufm::sys::TinyKernel::getState ( void ) const

overridevirtual

取得執行緒狀態

獲取此執行緒的當前運行狀態，如READY、RUNNING、BLOCKED等。

傳回值

ufm::sys::ThreadState 執行緒當前的運行狀態

參閱

ufm::sys::ThreadState 了解可能的狀態值

實作 ufm::sys::Thread.

getThreadName()

virtual const char * ufm::sys::TinyKernel::getThreadName ( void ) const

overridevirtual

取得執行緒名稱

獲取此執行緒的識別名稱，用於偵錯和日誌記錄。

傳回值

const char* 執行緒名稱字串，不為null

實作 ufm::sys::Thread.

initialize()

virtual bool ufm::sys::TinyKernel::initialize ( void )

overridevirtual

核心初始化

初始化作業系統核心元件和必要資源。所有核心相關方法的呼叫 必須在初始化完成後進行，否則可能導致未定義行為。

傳回值

true 初始化成功，核心準備就緒

false 初始化失敗，可能是核心已被初始化或硬體不支援

實作 ufm::sys::Kernel.

notify()

virtual void ufm::sys::TinyKernel::notify ( void )

overridevirtual

通知執行緒，喚醒等待中的執行緒

將執行緒從等待狀態喚醒，使其可以繼續執行。 若執行緒未處於等待狀態，則此操作無效。

註

此方法通常由其他執行緒調用，實現執行緒間的同步

實作 ufm::sys::Thread.

reboot()

virtual void ufm::sys::TinyKernel::reboot ( void )

overridevirtual

核心重新啟動

重新啟動整個系統，所有執行緒和資源將被終止並重新初始化。 此操作類似於硬體重置，但由軟體控制。

註

此方法呼叫後通常不會返回

實作 ufm::sys::Kernel.

setPriority()

virtual bool ufm::sys::TinyKernel::setPriority ( ufm::sys::ThreadPriority priority )

overridevirtual

設定執行緒優先權

動態調整執行緒的優先權等級，影響其在調度時的優先次序。 優先權越高，越容易獲得處理器時間。

參數

priority

要設定的新優先權

傳回值

true 優先權設定成功

false 優先權設定失敗，可能權限不足或執行緒狀態不允許

實作 ufm::sys::Thread.

start() [1/2]

virtual bool ufm::sys::TinyKernel::start ( const char * name, ufm::sys::ThreadPriority priority )

overridevirtual

以指定名稱和優先權啟動執行緒

使執行緒開始執行其關聯的Runnable任務。執行緒將被調度器管理， 根據系統負載和優先權進行調度。

參數

name	執行緒名稱，用於識別
priority	執行緒優先權，決定調度順序

傳回值

true 執行緒成功啟動

false 執行緒啟動失敗，可能已在運行或資源不足

實作 ufm::sys::Thread.

start() [2/2]

virtual void ufm::sys::TinyKernel::start ( ufm::func::Runnable * task )

overridevirtual

核心啟動

啟動作業系統核心，開始執行緒調度和系統服務。 此方法呼叫後，系統將開始正常運作。

註

通常此方法不會返回，除非系統發生重大錯誤

實作 ufm::sys::Kernel.

systemDelay()

virtual bool ufm::sys::TinyKernel::systemDelay ( int milliseconds ) const

overridevirtual

執行緒延遲

使當前執行緒暫停指定的時間，並讓出CPU資源給其他執行緒。 延遲精度取決於系統時鐘解析度和排程器負載。

參數

milliseconds

延遲時間，單位為毫秒

傳回值

true 延遲成功完成

false 延遲失敗，可能參數無效或系統不支援

實作 ufm::sys::Kernel.

systemLock()

virtual int ufm::sys::TinyKernel::systemLock ( void )

overridevirtual

核心鎖定

鎖定系統核心，暫停執行緒切換。當需要執行原子操作或訪問共享資源時， 可使用此方法避免被其他執行緒中斷。鎖定可以巢狀調用。

傳回值

int 目前鎖定層數，每次呼叫後遞增

警告

鎖定期間應儘量減少操作，避免阻塞系統過久

實作 ufm::sys::Kernel.

systemUnlock()

virtual int ufm::sys::TinyKernel::systemUnlock ( void )

overridevirtual

核心解鎖

釋放系統核心鎖。當鎖定層數降至零時，系統將恢復執行緒切換。 每次呼叫會將鎖定層數減一。

傳回值

int 剩餘鎖定層數，值為0時表示系統已完全解鎖

實作 ufm::sys::Kernel.

systemWait()

virtual bool ufm::sys::TinyKernel::systemWait ( int timeout ) const

overridevirtual

執行緒等待

使當前執行緒進入等待狀態，直到被喚醒或等待超時。 等待期間執行緒會讓出處理器資源，不消耗CPU時間。

參數

timeout

等待超時時間(毫秒)，0表示永久等待直到被notify()喚醒

傳回值

true 等待成功開始

false 等待失敗，可能在中斷處理或核心未啟動

實作 ufm::sys::Kernel.

systemYield()

virtual bool ufm::sys::TinyKernel::systemYield ( void )

overridevirtual

讓出執行時間片段

將控制權讓給相同優先權的其他就緒執行緒。如果沒有其他相同優先權 的就緒執行緒，則當前執行緒會繼續執行。

與systemDelay和systemWait不同，此方法不會使執行緒進入阻塞狀態， 僅主動讓出本輪執行時間。

傳回值

true 成功讓出執行時間或無需讓出

false 操作失敗，可能在中斷服務中調用

註

即使有較低優先權的執行緒就緒，也不會讓給它們執行

實作 ufm::sys::Kernel.

---

此類別(class) 文件是由下列檔案中產生:

• TinyKernel.h