[ Pobierz całość w formacie PDF ]

longer function.
Source :
Prototype :void _mqx_fatal_error(_mqx_uint error);
Table 2-49. _mqx_fatal_error arguments
Name Type Direction Description
_mqx_uint error input Error code.
See also :
" _mqx_exit
Description :
The function logs an error in kernel log (if it has been created and configured to log
errors) and calls _mqx_exit.
MQX calls _mqx_fatal_error if it detects an unhandled interrupt while it is in
_int_exception_isr().
If an application calls _mqx_fatal_error when it detects a serious error, you can use this
to help you debug by setting a breakpoint in the function.
CAUTION
Terminates the application by calling _mqx_exit.
2.8.3 _mqx_get_counter
Gets a unique number.
Source :
Prototype :_mqx_uint _mqx_get_counter(void);
Returns :
Freescale MQX"! Lite RTOS, Rev. Version 1.1
Freescale Semiconductor, Inc. 59
Miscellaneous
" 16-bit number for 16-bit processors or a 32-bit number for 32-bit processors (unique
for the processor and never 0).
Description :
This function increments the counter and then returns value of the counter.
This provides a unique number for whoever requires it.
Note
The unique number will never be 0.
2.8.4 _mqx_get_cpu_type
Gets the CPU type.
Source :
Prototype :_mqx_uint _mqx_get_cpu_type(void);
Returns :
" CPU_TYPE field of kernel data.
See also :
" _mqx_set_cpu_type
Description :
CPU types begin with PSP_CPU_TYPE_ and are defined in "source\psp\
\".
2.8.5 _mqx_get_exit_handler
Gets a pointer to the MQX exit handler function called when MQX exits.
Source :
Prototype :MQX_EXIT_FPTR _mqx_get_exit_handler(void);
Returns :
" Pointer to the MQX exit handler.
See also :
" _mqx_exit
" _mqx_set_exit_handler
Freescale MQX"! Lite RTOS, Rev. Version 1.1
60 Freescale Semiconductor, Inc.
Chapter 2 MQX Lite Functions
2.8.6 _mqx_get_initialization
Gets a pointer to the MQX initialization structure for this processor.
Source :
Prototype :MQX_INITIALIZATION_STRUCT_PTR _mqx_get_initialization(void);
Returns :
" Pointer to the MQX initialization structure in kernel data.
See also :
" _mqxlite_init
2.8.7 _mqx_get_kernel_data
Gets a pointer to kernel data.
Source :
Prototype :pointer _mqx_get_kernel_data(void);
Returns :
" Pointer to kernel data.
Description :
The address of kernel data corresponds to START_OF_KERNEL_MEMORY in the
MQX initialization structure that the application used to start MQX on the processor.
2.8.8 _mqx_get_system_task_id
Gets the task ID of the System Task.
Source :
Prototype :_task_id _mqx_get_system_task_id(void);
Returns :
" TASK_ID Task ID of System Task.
Description :
System resources are owned by System Task.
Freescale MQX"! Lite RTOS, Rev. Version 1.1
Freescale Semiconductor, Inc. 61
Miscellaneous
2.8.9 _mqx_idle_task
This function is the code for the idle task.
Source :
Prototype :void _mqx_idle_task(uint_32 parameter);
Table 2-50. _mqx_idle_task arguments
Name Type Direction Description
uint_32 parameter input Parameter passed to the task when created.
Description :
Idle Task is a MQX task that runs when all application tasks are blocked.
The function implements a simple counter. Size depends on the CPU (64-bit counter for
16-bit CPUs, 128-bit counter for 32-bit CPUs).
Counter can be read from a debugger and idle CPU time can be calculated.
2.8.10 _mqx_set_cpu_type
Sets the CPU type.
Source :
Prototype :void _mqx_set_cpu_type(_mqx_uint cpu_type);
Table 2-51. _mqx_set_cpu_type arguments
Name Type Direction Description
_mqx_uint cpu_type input The value representing the kernel CPU type.
See also :
" _mqx_get_cpu_type
Description :
The function sets CPU_TYPE in kernel data. The MQX Host Tools family of products
uses CPU type. CPU types begin with PSP_CPU_TYPE_ and are defined in source\psp
\cpu_family\cpu_family.h.
Freescale MQX"! Lite RTOS, Rev. Version 1.1
62 Freescale Semiconductor, Inc.
Chapter 2 MQX Lite Functions
CAUTION
Does not verify that cpu_type is valid.
2.8.11 _mqx_set_exit_handler
Sets a pointer to the MQX exit handler function called when MQX exits.
Source :
Prototype :void _mqx_set_exit_handler(MQX_EXIT_FPTR entry);
Table 2-52. _mqx_set_exit_handler arguments
Name Type Direction Description
MQX_EXIT_FPTR entry input Pointer to the exit handler.
See also :
" _mqx_exit
" _mqx_get_exit_handler
2.8.12 _mqxlite_init
Initializes MQXLite on the processor.
Source :
Prototype :_mqx_uint _mqxlite_init(register MQXLITE_INITIALIZATION_STRUCT_PTR mqx_init);
Table 2-53. _mqxlite_init arguments
Name Type Direction Description
register mqx_init input Pointer to the MQXLITE initialization structure for the
MQXLITE_INITIALIZAT processor.
ION_STRUCT_PTR
Returns :
" MQX_OK
" If application calls _mqx_exit(), error code that it passed to _mqx_exit().
See also :
" _mqxlite
" _mqx_exit
" MQXLITE_INITIALIZATION_STRUCT
Freescale MQX"! Lite RTOS, Rev. Version 1.1
Freescale Semiconductor, Inc. 63
Mutexes
Description :
The function does the following:
- Initializes kernel data.
- Creates the interrupt stack.
- Creates the ready queues.
- Creates a lightweight semaphore for task creation/destruction.
- Initializes interrupts.
- Initializes system timer.
CAUTION
Must be called exactly once per processor.
2.9 Mutexes
2.9.1 _mutatr_destroy
Deinitializes the mutex attributes structure.
Source :
Prototype :_mqx_uint _mutatr_destroy(MUTEX_ATTR_STRUCT_PTR attr_ptr);
Table 2-54. _mutatr_destroy arguments
Name Type Direction Description [ Pobierz całość w formacie PDF ]