B_ QuRT_ User_ Guide(36)

22 System Environment

Programs can access QuRT Various properties of the system environment .
Maximum pimutex Priority specifies that a thread has priority inheritance mutex The lock on can be set to the highest priority . This value makes others unused pimutex Of threads can be higher than pimutex The highest priority thread priority runs .
The system environment supports the following operations .- qurt_sysenv_get_app_heap()

• qurt_sysenv_get_arch_version()
• qurt_sysenv_get_hw_timer()
• qurt_sysenv_get_max_hw_threads()
• qurt_sysenv_get_max_pi_prio()
• qurt_sysenv_get_process_name()
• qurt_sysenv_get_stack_profile_count()
• qurt_sysenv_get_hw_threads()
• Data Types

22.1 qurt_sysenv_get_app_heap()

22.1.1 Function document

22.1.1.1 int qurt_sysenv_get_app_heap ( qurt_sysenv_app_heap_t ∗ aheap )

Get the information of the program heap from the kernel .
Related data types
qurt_sysenv_app_heap_t
Parameters

Return value
QURT_EOK – Success.
QURT_EVAL – Invalid parameter.
Dependencies
None.

22.2 qurt_sysenv_get_arch_version()

22.2.1 Function document

22.2.1.1 int qurt_sysenv_get_arch_version ( qurt_arch_version_t ∗ vers )

Get from kernel Hexagon Processor architecture version .
Parameters

Return value
QURT_EOK – Success.
QURT_EVAL – Invalid parameter
Dependencies
None.

22.3 qurt_sysenv_get_hw_timer()

22.3.1 Function document

22.3.1.1 int qurt_sysenv_get_hw_timer ( qurt_sysenv_hw_timer_t ∗ timer )

Get the memory address of the hardware timer from the kernel .

Parameters

Return value
QURT_EOK – Success.
QURT_EVAL – Invalid parameter.

Dependencies
None.

22.4 qurt_sysenv_get_max_hw_threads()

22.4.1 Function document

22.4.1.1 int qurt_sysenv_get_max_hw_threads ( qurt_sysenv_max_hthreads_t ∗ mhwt )

obtain Hexagon The maximum number of hardware threads supported in the processor .API Including disabled hardware threads , To reflect the maximum number of hardware threads . for example , If the image is configured with four hardware threads , And in cust_config.xml in hthread_mask Set to 0x5, only HW0 and HW2 By QuRT initialization .HW1 and HW3 Not used at all . under these circumstances ,qurt_sysenv_get_max_hw_threads() Still return four .
Related data types
qurt_sysenv_max_hthreads_t
Parameters

Return value
QURT_EOK – Success.
QURT_EVAL – Invalid parameter.
Dependencies
None.

22.5 qurt_sysenv_get_max_pi_prio()

22.5.1 Function document

22.5.1.1 int qurt_sysenv_get_max_pi_prio ( qurt_sysenv_max_pi_prio_t ∗ mpip )

Get the inherited spoiler priority with the highest priority from the kernel .
Related data types
qurt_sysenv_max_pi_prio_t
Parameters

Return value
Masked 64 Bit atomic variable AND result .

Dependencies
None.

22.6 qurt_sysenv_get_process_name()

27.6.1 Function document

22.6.1.1 int qurt_sysenv_get_process_name ( qurt_sysenv_procname_t ∗ pname )

Get the information of the system environment process name from the kernel .
Related data types
qurt_sysenv_procname_t
Parameters

Return value
QURT_EOK – Success.
QURT_EVAL – Invalid parameter.
Dependencies
None.

22.7 qurt_sysenv_get_stack_profile_count()

22.7.1 Function document

22.7.1.1 int qurt_sysenv_get_stack_profile_count ( qurt_sysenv_stack_profile_count- _t∗count )

Get information about stack profile count from the kernel .
Related data types
qurt_sysenv_stack_profile_count_t
Parameters

Return value
QURT_EOK – Success.

Dependencies
None.

22.8 qurt_atomic64_xor_return()

22.8.1 Function document

22.8.1.1 int qurt_sysenv_get_hw_threads ( qurt_sysenv_hthreads_t ∗ mhwt )

obtain QuRT stay Hexagon The number of hardware threads initialized in the processor . for example , If the image is configured with four hardware threads , And in cust_config.xml in hthread_mask Set to 0x5,QuRT Initialization only HW0 and HW2.HW1 and HW3 Not used . under these circumstances ,qurt_sysenv_get_hw_threads return 2.
Related data types
qurt_sysenv_hthreads_t
Parameters

Return value
QURT_EOK – Success.
QURT_EVAL – Invalid parameter.
Dependencies
None.

22.9 Data Types

This section describes the data types of system environment services .

22.9.1 Data Structure Documentation

22.9.1.1 struct qurt_sysenv_swap_pools_t

QuRT Exchange pool information type .

22.9.1.2 struct qurt_sysenv_app_heap_t

QuRT Application heap information type .

22.9.1.3 struct qurt_arch_version_t

QuRT Schema version information type .

22.9.1.4 struct qurt_sysenv_max_hthreads_t

QuRT Maximum hardware thread information type .

22.9.1.5 struct qurt_sysenv_hthreads_t

QuRT Active hardware thread information type .

22.9.1.6 struct qurt_sysenv_max_pi_prio_t

QuRT Maximum pi Priority information type .

22.9.1.7 struct qurt_sysenv_hw_timer_t

22.9.1.8 struct qurt_sysenv_procname_t

QuRT Process name information type .

22.9.1.9 struct qurt_sysenv_stack_profile_count_t

QuRT Stack overview count information type .

22.9.1.10 struct qurt_sysevent_error_t

QuRT System error event type .

22.9.1.11 struct qurt_sysenv_swap_pools_t

QuRT Information type of page error event .