diff --git a/en/device-dev/kernel/kernel-basic-mini-time.md b/en/device-dev/kernel/kernel-basic-mini-time.md index eb5fd111c455696972aa0d9b9dea3dfc2f6cbf2a..586349d0c4683c5b782b61ea2cd0b714e7b1b4b1 100644 --- a/en/device-dev/kernel/kernel-basic-mini-time.md +++ b/en/device-dev/kernel/kernel-basic-mini-time.md @@ -1,13 +1,5 @@ # Time Management -- [Basic Concepts](#section36251149131120) -- [Time Unit](#section97172532397) -- [Available APIs](#section158501652121514) -- [How to Develop](#section783435801510) -- [Development Example](#section460018317164) - - [Example Description](#section127752801718) - - [Sample Code](#section321653551711) - - [Verification](#section4366193318167) ## Basic Concepts @@ -37,56 +29,18 @@ The following table describes APIs available for the OpenHarmony LiteOS-M time m **Table 1** APIs of the time management module - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

-

API

-

Description

-

Time conversion

-

LOS_MS2Tick

-

Converts milliseconds into ticks.

-

LOS_Tick2MS

-

Converts ticks into milliseconds.

-

OsCpuTick2MS

-

Converts cycles into milliseconds. Two UINT32 values indicate the high-order and low-order 32 bits of the result value, respectively.

-

OsCpuTick2US

-

Converts cycles into microseconds. Two UINT32 values indicate the high-order and low-order 32 bits of the result value, respectively.

-

Time statistics

-

LOS_SysClockGet

-

Obtains the system clock.

-

LOS_TickCountGet

-

Obtains the number of ticks since the system starts.

-

LOS_CyclePerTickGet

-

Obtains the number of cycles for each tick.

-
+| Category| API| Description| +| -------- | -------- | -------- | +| Time conversion| LOS_MS2Tick | Converts milliseconds into ticks.| +| | LOS_Tick2MS | Converts ticks into milliseconds.| +| | OsCpuTick2MS | Converts cycles into milliseconds. Two UINT32 values indicate the high-order and low-order 32 bits of the result value, respectively.| +| | OsCpuTick2US | Converts cycles into microseconds. Two UINT32 values indicate the high-order and low-order 32 bits of the result value, respectively.| +| Time statistics| LOS_SysClockGet | Obtains the system clock.| +| | LOS_TickCountGet | Obtains the number of ticks since the system starts.| +| | LOS_CyclePerTickGet | Obtains the number of cycles for each tick.| +| | LOS_CurrNanosec |Obtains the number of nanoseconds since the system starts.| +| Delay management| LOS_UDelay |Performs busy waiting in μs, which can be preempted by a task with a higher priority.| +| | LOS_MDelay |Performs busy waiting in ms, which can be preempted by a task with a higher priority.| ## How to Develop @@ -95,7 +49,8 @@ The typical development process of time management is as follows: 1. Complete board configuration and adaptation as required, and configure the system clock frequency \(**OS\_SYS\_CLOCK** in Hz and **LOSCFG\_BASE\_CORE\_TICK\_PER\_SECOND**\). The default value of **OS\_SYS\_CLOCK** varies with the hardware platform. 2. Call the clock conversion and statistics APIs. ->![](../public_sys-resources/icon-note.gif) **NOTE:** +>![](../public_sys-resources/icon-note.gif) **NOTE** +> >- The time management module depends on **OS\_SYS\_CLOCK** and **LOSCFG\_BASE\_CORE\_TICK\_PER\_SECOND**. >- The number of system ticks is not counted when the interrupt feature is disabled. Therefore, the number of ticks cannot be used as the accurate time. >- The configuration options are maintained in the **target\_config.h** file of the development board project. @@ -106,8 +61,8 @@ The typical development process of time management is as follows: The following example describes basic time management methods, including: -1. Time conversion: convert milliseconds to ticks or convert ticks to milliseconds. -2. Time statistics: obtain the number of cycles per tick, number of ticks since system startup, and number of delayed ticks. +- Time conversion: convert milliseconds to ticks or convert ticks to milliseconds. +- Time statistics: obtain the number of cycles per tick, number of ticks since system startup, and number of delayed ticks. ### Sample Code @@ -175,4 +130,3 @@ LOS_CyclePerTickGet = 495000 LOS_TickCountGet = 1 LOS_TickCountGet after delay = 201 ``` - diff --git a/en/device-dev/kernel/kernel-mini-appx-lib-cmsis.md b/en/device-dev/kernel/kernel-mini-appx-lib-cmsis.md index faae4988fa77df6a72cbea38a208d9693eeca100..e159dee8effd98a834fcdb6d23704fcd8541ce38 100644 --- a/en/device-dev/kernel/kernel-mini-appx-lib-cmsis.md +++ b/en/device-dev/kernel/kernel-mini-appx-lib-cmsis.md @@ -19,437 +19,88 @@ The following table describes CMSIS-RTOS v2 APIs. For more details about the API **Table 1** CMSIS-RTOS v2 APIs - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

-

API

-

Description

-

Kernel information and control

-

osKernelGetInfo

-

Obtains RTOS kernel information.

-

osKernelGetState

-

Obtains the current RTOS kernel status.

-

osKernelGetSysTimerCount

-

Obtains the RTOS kernel system timer count.

-

osKernelGetSysTimerFreq

-

Obtains the RTOS kernel system timer frequency.

-

osKernelInitialize

-

Initializes the RTOS kernel.

-

osKernelLock

-

Locks the RTOS kernel scheduler.

-

osKernelUnlock

-

Unlocks the RTOS kernel scheduler.

-

osKernelRestoreLock

-

Restores the RTOS kernel scheduler to the locked state.

-

osKernelResume

-

Restores the RTOS kernel scheduler. (not implemented yet)

-

osKernelStart

-

Starts the RTOS kernel scheduler.

-

osKernelSuspend

-

Suspends the RTOS kernel scheduler. (not implemented yet)

-

osKernelGetTickCount

-

Obtains the RTOS kernel tick count.

-

osKernelGetTickFreq

-

Obtains the RTOS kernel tick frequency.

-

Thread management

-

osThreadDetach

-

Detaches a thread (thread storage can be reclaimed when the thread terminates). (not implemented yet)

-

osThreadEnumerate

-

Enumerates active threads. (not implemented yet)

-

osThreadExit

-

Terminates execution of the thread that is currently running.

-

osThreadGetCount

-

Obtains the number of active threads.

-

osThreadGetId

-

Returns the ID of the thread that is running.

-

osThreadGetName

-

Obtains the name of a thread.

-

osThreadGetPriority

-

Obtains the current priority of a thread.

-

osThreadGetStackSize

-

Obtains the stack size of a thread.

-

osThreadGetStackSpace

-

Obtains the available stack space of a thread based on the stack waterline record during execution.

-

osThreadGetState

-

Obtains the current status of a thread.

-

osThreadJoin

-

Waits for the specified thread to terminate. (not implemented yet)

-

osThreadNew

-

Creates a thread and add it to active threads.

-

osThreadResume

-

Resumes the execution of a thread.

-

osThreadSetPriority

-

Changes the priority of a thread.

-

osThreadSuspend

-

Suspends the execution of a thread.

-

osThreadTerminate

-

Terminates the execution of a thread.

-

osThreadYield

-

Passes control to the next thread in the ready state.

-

Thread flag

-

osThreadFlagsSet

-

Sets the specified thread flags for a thread. (not implemented yet)

-

osThreadFlagsClear

-

Clears the specified thread flags of the thread that is running. (not implemented yet)

-

osThreadFlagsGet

-

Obtains the current thread flags of the thread that is running. (not implemented yet)

-

osThreadFlagsWait

-

Waits for one or more thread flags of the currently running thread to emit a signal. (not implemented yet)

-

Event flag

-

osEventFlagsGetName

-

Obtains the name of an event flag object. (not implemented yet)

-

osEventFlagsNew

-

Creates and initializes an event flag object.

-

osEventFlagsDelete

-

Deletes an event flag object.

-

osEventFlagsSet

-

Sets the specified event flag.

-

osEventFlagsClear

-

Clears the specified event flag.

-

osEventFlagsGet

-

Obtains the current event flag.

-

osEventFlagsWait

-

Waits for one or more event flags to be signaled.

-

General wait function

-

osDelay

-

Waits for timeout (time delay).

-

osDelayUntil

-

Waits until the specified time.

-

Timer management

-

osTimerDelete

-

Deletes a timer.

-

osTimerGetName

-

Obtains the name of a timer. (not implemented yet)

-

osTimerIsRunning

-

Checks whether a timer is running.

-

osTimerNew

-

Creates and initializes a timer.

-

osTimerStart

-

Starts or restarts a timer.

-

osTimerStop

-

Stops a timer.

-

Mutex management

-

osMutexAcquire

-

Acquires a mutex or waits for timeout (if locked).

-

osMutexDelete

-

Deletes a mutex object.

-

osMutexGetName

-

Obtains the name of a mutex object. (not implemented yet)

-

osMutexGetOwner

-

Obtains the thread that has a mutex object.

-

osMutexNew

-

Creates and initializes a mutex object.

-

osMutexRelease

-

Releases the mutex obtained by calling osMutexAcquire.

-

Semaphore

-

osSemaphoreAcquire

-

Obtains a semaphore token or waits for timeout if no token is available.

-

osSemaphoreDelete

-

Deletes a semaphore object.

-

osSemaphoreGetCount

-

Obtains the number of tokens of the current semaphore.

-

osSemaphoreGetName

-

Obtains the name of a semaphore object. (not implemented yet)

-

osSemaphoreNew

-

Creates and initializes a semaphore object.

-

osSemaphoreRelease

-

Releases a semaphore token till the initial maximum count.

-

Memory pool

-

osMemoryPoolAlloc

-

Allocates a memory block from the memory pool.

-

osMemoryPoolDelete

-

Deletes a memory pool object.

-

osMemoryPoolFree

-

Releases the allocated memory block to the memory pool.

-

osMemoryPoolGetBlockSize

-

Obtains the memory block size in the memory pool.

-

osMemoryPoolGetCapacity

-

Obtains the maximum number of memory blocks in the memory pool.

-

osMemoryPoolGetCount

-

Obtains the number of memory blocks used in the memory pool.

-

osMemoryPoolGetName

-

Obtains the name of a memory pool object.

-

osMemoryPoolGetSpace

-

Obtains the number of available memory blocks in the memory pool.

-

osMemoryPoolNew

-

Creates and initializes a memory pool object.

-

Message queue

-

osMessageQueueDelete

-

Deletes a message queue object.

-

osMessageQueueGet

-

Obtains a message from the queue or waits for timeout if the queue is empty.

-

osMessageQueueGetCapacity

-

Obtains the maximum number of messages in a message queue.

-

osMessageQueueGetCount

-

Obtains the number of queued messages in a message queue.

-

osMessageQueueGetMsgSize

-

Obtains the maximum size of the message in the memory pool.

-

osMessageQueueGetName

-

Obtains the name of a message queue object. (not implemented yet)

-

osMessageQueueGetSpace

-

Obtains the number of available slots for messages in a message queue.

-

osMessageQueueNew

-

Creates and initializes a message queue object.

-

osMessageQueuePut

-

Puts the message into the queue or waits till timeout if the queue is full.

-

osMessageQueueReset

-

Resets the message queue to its initial empty state. (not implemented yet)

-
+| Category| API| Description| +| -------- | -------- | -------- | +| Kernel information and control| osKernelGetInfo | Obtains RTOS kernel information.| +| | osKernelGetState | Obtains the current RTOS kernel status.| +| | osKernelGetSysTimerCount | Obtains the RTOS kernel system timer count.| +| | osKernelGetSysTimerFreq | Obtains the RTOS kernel system timer frequency.| +| | osKernelInitialize | Initializes the RTOS kernel.| +| | osKernelLock | Locks the RTOS kernel scheduler.| +| | osKernelUnlock | Unlocks the RTOS kernel scheduler.| +| | osKernelRestoreLock | Restores the RTOS kernel scheduler to the locked state.| +| | osKernelResume | Restores the RTOS kernel scheduler (not implemented yet).| +| | osKernelStart | Starts the RTOS kernel scheduler.| +| | osKernelSuspend | Suspends the RTOS kernel scheduler (not implemented yet).| +| | osKernelGetTickCount | Obtains the RTOS kernel tick count.| +| | osKernelGetTickFreq | Obtains the RTOS kernel tick frequency.| +| Thread management| osThreadDetach | Detaches a thread (to reclaim the thread storage when the thread terminates).| +| | osThreadEnumerate | Enumerates active threads (not been implemented yet).| +| | osThreadExit | Terminates a running thread.| +| | osThreadGetCount | Obtains the number of active threads.| +| | osThreadGetId | Obtains the ID of the running thread.| +| | osThreadGetName | Obtains the thread name.| +| | osThreadGetPriority | Obtains the current thread priority.| +| | osThreadGetStackSize | Obtains the thread stack size.| +| | osThreadGetStackSpace | Obtains the available stack space for a thread based on the stack waterline record during execution.| +| | osThreadGetState | Obtains the current thread status.| +| | osThreadJoin | Waits for the specified thread to terminate.| +| | osThreadNew | Creates a thread and adds it to active threads.| +| | osThreadResume | Resumes the execution of a thread.| +| | osThreadSetPriority | Changes the priority of a thread.| +| | osThreadSuspend | Suspends a thread.| +| | osThreadTerminate | Terminates a thread.| +| | osThreadYield | Passes control to the next thread in the ready state.| +| Thread flag| osThreadFlagsSet | Sets flags for a thread.| +| | osThreadFlagsClear | Clears the specified flags for the running thread.| +| | osThreadFlagsGet | Obtains the current flags of the running thread.| +| | osThreadFlagsWait | Waits for one or more thread flags of the running thread to signal.| +| Event flag| osEventFlagsGetName | Obtains the names of the event flags (not implemented yet).| +| | osEventFlagsNew | Creates and initializes event flags.| +| | osEventFlagsDelete | Deletes event flags.| +| | osEventFlagsSet | Sets event flags.| +| | osEventFlagsClear | Clears event flags.| +| | osEventFlagsGet | Obtains the current event flags.| +| | osEventFlagsWait | Waits for one or more event flags to be signaled.| +| General waiting functions| osDelay | Waits for timeout (time delay).| +| | osDelayUntil | Waits until the specified time.| +| Timer management| osTimerDelete | Deletes a timer.| +| | osTimerGetName | Obtains the timer name (not implemented yet).| +| | osTimerIsRunning | Checks whether a timer is running.| +| | osTimerNew | Creates and initializes a timer.| +| | osTimerStart | Starts or restarts a timer.| +| | osTimerStop | Stops a timer.| +| Mutex management| osMutexAcquire | Acquires a mutex or times out (if locked).| +| | osMutexDelete | Deletes a mutex.| +| | osMutexGetName | Obtains the mutex name (not implemented yet).| +| | osMutexGetOwner | Obtains the thread that acquires the mutex.| +| | osMutexNew | Creates and initializes a mutex.| +| | osMutexRelease | Releases the mutex obtained using **osMutexAcquire**.| +| Semaphore| osSemaphoreAcquire | Obtains the semaphore token or times out if no token is available.| +| | osSemaphoreDelete | Deletes a semaphore.| +| | osSemaphoreGetCount | Obtains the token count of the current semaphore.| +| | osSemaphoreGetName | Obtains the name of a semaphore (not implemented yet).| +| | osSemaphoreNew | Creates and initializes a semaphore.| +| | osSemaphoreRelease | Releases semaphore tokens till the initial maximum count.| +| Memory pool| osMemoryPoolAlloc | Allocates a memory block from the memory pool.| +| | osMemoryPoolDelete | Deletes a memory pool object.| +| | osMemoryPoolFree | Releases the allocated memory block to the memory pool.| +| | osMemoryPoolGetBlockSize | Obtains the memory block size in the memory pool.| +| | osMemoryPoolGetCapacity | Obtains the maximum number of memory blocks in the memory pool.| +| | osMemoryPoolGetCount | Obtains the number of used memory blocks in the memory pool.| +| | osMemoryPoolGetName | Obtains the memory pool name.| +| | osMemoryPoolGetSpace | Obtains the number of available memory blocks in the memory pool.| +| | osMemoryPoolNew | Creates and initializes a memory pool.| +| Message queue| osMessageQueueDelete | Deletes a message queue.| +| | osMessageQueueGet | Obtain a message from the queue or times out if the queue is empty.| +| | osMessageQueueGetCapacity | Obtains the maximum number of messages in the message queue.| +| | osMessageQueueGetCount | Obtains the number of queued messages in the message queue.| +| | osMessageQueueGetMsgSize | Obtains the maximum message size in the memory pool.| +| | osMessageQueueGetName | Obtains the message queue name (not implemented yet).| +| | osMessageQueueGetSpace | Obtains the number of slots available for messages in the message queue.| +| | osMessageQueueNew | Creates and initializes a message queue.| +| | osMessageQueuePut | Puts the message into the queue or times out if the queue is full.| +| | osMessageQueueReset | Initialized the message queue to the empty state (not implemented yet).| ### How to Develop @@ -484,4 +135,3 @@ int main (void) { for (;;) {} } ``` - diff --git a/en/device-dev/kernel/kernel-mini-basic-interrupt.md b/en/device-dev/kernel/kernel-mini-basic-interrupt.md index 6429771d8231598ddd039a6a6bee3bcbe0783d74..892ff1dd410e531baf4f0622144a3302058b1499 100644 --- a/en/device-dev/kernel/kernel-mini-basic-interrupt.md +++ b/en/device-dev/kernel/kernel-mini-basic-interrupt.md @@ -49,52 +49,24 @@ The following table describes APIs available for the OpenHarmony LiteOS-M interr **Table 1** APIs of the interrupt module - - - - - - - - - - - - - - - - - - - - - - - - -

Function

-

API

-

Description

-

Creating or deleting interrupts

-

HalHwiCreate

-

Creates an interrupt and registers the interrupt ID, interrupt triggering mode, interrupt priority, and interrupt handler. When an interrupt is triggered, the interrupt handler will be called.

-

HalHwiDelete

-

Deletes an interrupt based on the specified interrupt ID.

-

Enabling or disabling interrupts

-

LOS_IntUnLock

-

Enables the CPU to respond to all interrupt requests.

-

LOS_IntLock

-

Disables the CPU from responding to interrupt requests.

-

LOS_IntRestore

-

Restores the interrupt status before the LOS_IntLock and LOS_IntUnLock operations are performed.

-
+| Category| API| Description| +| -------- | -------- | -------- | +| Creating or deleting an interrupt| LOS_HwiCreate | Creates an interrupt and registers the interrupt ID, triggering mode, priority, and interrupt handler. When an interrupt is triggered, the interrupt handler will be called.| +| | LOS_HwiDelete | Deletes an interrupt based on the specified interrupt ID.| +| Locking or unlocking interrupts| LOS_IntUnLock | Enables the CPU to respond to all interrupt requests.| +| | LOS_IntLock | Disables the CPU from responding to interrupt requests.| +| | LOS_IntRestore | Restores the interrupt status before the **LOS_IntLock** and **LOS_IntUnLock** operations are performed.| +| Enabling or disabling an interrupt| LOS_HwiDisable | Disables the CPU from responding to the specified interrupt by setting the register.| +| | LOS_HwiEnable | Enables the CPU to respond to the specified interrupt by setting the register.| +| Setting the interrupt priority| LOS_HwiSetPriority | Sets the interrupt priority.| +| Triggering an interrupt| LOS_HwiTrigger | Triggers an interrupt (simulate an external interrupt by writing the related register of the interrupt controller).| +| Clearing interrupt register status| LOS_HwiClear | Clears the status bit of the interrupt register corresponding to the interrupt ID. The implementation of this API depends on the interrupt controller version. It is optional.| ## How to Develop -1. Create an interrupt by calling **HalHwiCreate**. -2. Call **TestHwiTrigger** to trigger the specified interrupt. \(This API is defined in the test suite. It simulates an external interrupt by writing the related register of the interrupt controller. Skip this step for common peripheral devices.\) -3. Call **HalHwiDelete** to delete the specified interrupt. Use this API based on actual requirements. +1. Call **LOS_HwiCreate** to create an interrupt. +2. Call **LOS_HwiTrigger** to trigger the interrupt. +3. Call **LOS_HwiDelete** to delete the specified interrupt. Use this API based on actual requirements. >![](../public_sys-resources/icon-note.gif) **NOTE:** >- Configure the maximum number of interrupts supported and the number of configurable interrupt priorities based on the specific hardware. @@ -131,9 +103,9 @@ static UINT32 Example_Interrupt(VOID) HwiIrqParam irqParam; (void)memset_s(&irqParam, sizeof(HwiIrqParam), 0, sizeof(HwiIrqParam)); irqParam.pDevId = 0; - + /* Create an interrupt. */ - ret = LOS_HwiCreate(HWI_NUM_TEST, hwiPrio, mode, (HWI_PROC_FUNC)HwiUsrIrq, &irqParam); + ret = LOS_HwiCreate(HWI_NUM_TEST, hwiPrio, mode, (HWI_PROC_FUNC)HwiUsrIrq, &irqParam); if(ret == LOS_OK){ printf("Hwi create success!\n"); } else { @@ -141,11 +113,17 @@ static UINT32 Example_Interrupt(VOID) return LOS_NOK; } - /* Delay 50 ticks. When a hardware interrupt occurs, the HwiUsrIrq function will be called. */ - LOS_TaskDelay(50); + /* Trigger the interrupt. */ + ret = LOS_HwiTrigger(HWI_NUM_TEST); + if(ret == LOS_OK){ + printf("Hwi trigger success!\n"); + } else { + printf("Hwi trigger failed!\n"); + return LOS_NOK; + } - /* Delete an interrupt. */ - ret = HalHwiDelete(HWI_NUM_TEST); + /* Delete the interrupt. */ + ret = LOS_HwiDelete(HWI_NUM_TEST); if(ret == LOS_OK){ printf("Hwi delete success!\n"); } else { @@ -164,4 +142,3 @@ The development is successful if the return result is as follows: Hwi create success! Hwi delete success! ``` - diff --git a/en/device-dev/kernel/kernel-mini-basic-task.md b/en/device-dev/kernel/kernel-mini-basic-task.md index 3087fd0aaa3aed09956d2993cdd24b995d7ea280..b2a566704c827488e88242ec321b5e26f54efd99 100644 --- a/en/device-dev/kernel/kernel-mini-basic-task.md +++ b/en/device-dev/kernel/kernel-mini-basic-task.md @@ -109,149 +109,35 @@ The following table describes APIs available for the OpenHarmony LiteOS-M task m **Table 1** APIs of the task management module - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Function

-

API

-

Description

-

Creating or deleting a task

-

LOS_TaskCreateOnly

-

Creates a task and suspends the task to disable scheduling of the task. To enable scheduling of the task, call LOS_TaskResume to make the task enter the Ready state.

-

LOS_TaskCreate

-

Creates a task and places the task in the Ready state. If there is no task with a higher priority in the Ready queue, the task will be executed.

-

LOS_TaskDelete

-

Deletes the specified task.

-

Controlling task status

-

LOS_TaskResume

-

Resumes a suspended task to place the task in the Ready state.

-

LOS_TaskSuspend

-

Suspends the specified task and performs task switching.

-

LOS_TaskJoin

-

Suspends this task till the specified task is complete and the task control block resources are reclaimed.

-

LOS_TaskDelay

-

Makes a task wait for a period of time (in ticks) and releases CPU resources. When the delay time expires, the task enters the Ready state again. The input parameter is the number of ticks.

-

LOS_Msleep

-

Converts the input parameter number of milliseconds into number of ticks, and use the result to call LOS_TaskDelay.

-

LOS_TaskYield

-

Sets the time slice of the current task to 0 to release CPU resources and schedule the task with the highest priority in the Ready queue to run.

-

Control task scheduling

-

LOS_TaskLock

-

Locks task scheduling. However, tasks can still be interrupted.

-

LOS_TaskUnlock

-

Unlocks task scheduling.

-

LOS_Schedule

-

Triggers task scheduling

-

Controlling task priority

-

LOS_CurTaskPriSet

-

Sets the priority for the current task.

-

LOS_TaskPriSet

-

Sets the priority for a specified task.

-

LOS_TaskPriGet

-

Obtains the priority of a specified task.

-

Obtaining task information

-

LOS_CurTaskIDGet

-

Obtains the ID of the current task.

-

LOS_NextTaskIDGet

-

Obtains the ID of the task with the highest priority in the Ready queue.

-

LOS_NewTaskIDGet

-

Same as LOS_NextTaskIDGet.

-

LOS_CurTaskNameGet

-

Obtains the name of the current task.

-

LOS_TaskNameGet

-

Obtains the name of a specified task.

-

LOS_TaskStatusGet

-

Obtains the state of a specified task.

-

LOS_TaskInfoGet

-

Obtains information about a specified task, including the task state, priority, stack size, stack pointer (SP), task entry function, and used stack space.

-

LOS_TaskIsRunning

-

Checks whether the task module has started scheduling.

-

Maintaining and testing task information

-

LOS_TaskSwitchInfoGet

-

Obtains task switching information. The macro LOSCFG_BASE_CORE_EXC_TSK_SWITCH must be enabled.

-
+| Category| API| Description| +| -------- | -------- | -------- | +| Creating or deleting a task| LOS_TaskCreateOnly | Creates a task and suspends the task to disable scheduling of the task. To enable scheduling of the task, call **LOS_TaskResume** to make the task enter the Ready state.| +| | LOS_TaskCreate | Creates a task and places the task in the Ready state. If there is no task with a higher priority in the Ready queue, the task will be executed.| +| | LOS_TaskDelete | Deletes a task.| +| Controlling task status| LOS_TaskResume | Resumes a suspended task to place it in the Ready state.| +| | LOS_TaskSuspend | Suspends the specified task and performs task switching.| +| | LOS_TaskJoin | Suspends this task till the specified task is complete and the task control block resources are reclaimed.| +| | LOS_TaskDetach | Changes the task attribute from **joinable** to **detach**. After the task of the **detach** attribute is complete, the task control block resources will be automatically reclaimed.| +| | LOS_TaskDelay | Makes a task wait for a period of time (in ticks) and releases CPU resources. When the delay time expires, the task enters the Ready state again. The input parameter is the number of ticks.| +| | LOS_Msleep | Converts the input number of milliseconds into number of ticks, and use the result to call **LOS_TaskDelay**.| +| | LOS_TaskYield | Sets the time slice of the current task to **0** to release CPU resources and schedule the task with the highest priority in the Ready queue to run.| +| Controlling task scheduling| LOS_TaskLock | Locks task scheduling. However, tasks can still be interrupted.| +| | LOS_TaskUnlock | Unlocks task scheduling.| +| | LOS_Schedule | Triggers task scheduling| +| Controlling task priority| LOS_CurTaskPriSet | Sets the priority for the current task.| +| | LOS_TaskPriSet | Sets the priority for a specified task.| +| | LOS_TaskPriGet | Obtains the priority of a specified task.| +| Obtaining Job information| LOS_CurTaskIDGet | Obtains the ID of the current task.| +| | LOS_NextTaskIDGet | Obtains the ID of the task with the highest priority in the Ready queue.| +| | LOS_NewTaskIDGet | Same as **LOS_NextTaskIDGet**.| +| | LOS_CurTaskNameGet | Obtains the name of the current task.| +| | LOS_TaskNameGet | Obtains the name of a specified task.| +| | LOS_TaskStatusGet | Obtains the state of a specified task.| +| | LOS_TaskInfoGet | Obtains information about a specified task, including the task state, priority, stack size, stack pointer (SP), task entry function, and used stack space.| +| | LOS_TaskIsRunning | Checks whether the task module has started scheduling.| +| Updating task information| LOS_TaskSwitchInfoGet | Obtains task switching information. The macro **LOSCFG_BASE_CORE_EXC_TSK_SWITCH** must be enabled.| +| Reclaiming task stack resources| LOS_TaskResRecycle | Reclaims all task stack resources.| + ## How to Develop @@ -410,4 +296,3 @@ TaskHi LOS_TaskSuspend Success. TaskHi LOS_TaskResume Success. Join Example_TaskHi Success! ``` -