mirror of
https://github.com/VincentWei/MiniGUI.git
synced 2026-09-30 06:23:22 +08:00
226 lines
8.4 KiB
C
226 lines
8.4 KiB
C
///////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// IMPORTANT NOTICE
|
|
//
|
|
// The following open source license statement does not apply to any
|
|
// entity in the Exception List published by FMSoft.
|
|
//
|
|
// For more information, please visit:
|
|
//
|
|
// https://www.fmsoft.cn/exception-list
|
|
//
|
|
//////////////////////////////////////////////////////////////////////////////
|
|
/*
|
|
* This file is part of MiniGUI, a mature cross-platform windowing
|
|
* and Graphics User Interface (GUI) support system for embedded systems
|
|
* and smart IoT devices.
|
|
*
|
|
* Copyright (C) 2002~2018, Beijing FMSoft Technologies Co., Ltd.
|
|
* Copyright (C) 1998~2002, WEI Yongming
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* Or,
|
|
*
|
|
* As this program is a library, any link to this program must follow
|
|
* GNU General Public License version 3 (GPLv3). If you cannot accept
|
|
* GPLv3, you need to be licensed from FMSoft.
|
|
*
|
|
* If you have got a commercial license of this program, please use it
|
|
* under the terms and conditions of the commercial license.
|
|
*
|
|
* For more information about the commercial license, please refer to
|
|
* <http://www.minigui.com/blog/minigui-licensing-policy/>.
|
|
*/
|
|
/*
|
|
** threadx_pprivate.h: The private header for POSIX Thread implementation
|
|
** on ThreadX. This is the POSIX PThreads implementation in order to
|
|
** run MiniGUI on ThreadX.
|
|
**
|
|
** Author: Wei Yongming
|
|
**
|
|
** Create Date: 2005-01-11
|
|
**/
|
|
|
|
#ifndef TXPTH_PPRIVATE_H
|
|
#define TXPTH_PPRIVATE_H
|
|
|
|
#include <stddef.h>
|
|
#include "tx_api.h"
|
|
#include "threadx_pthread.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
#define TXPTHNUM_POSIX_PTHREAD_THREADS_MAX 64
|
|
#define TXPTHNUM_LIBC_MAIN_DEFAULT_STACK_SIZE (1024 * 4)
|
|
|
|
#define TXPTH_THREAD_MIN_PRIORITY 31
|
|
#define TXPTH_THREAD_MAX_PRIORITY 0
|
|
|
|
#define TXPTH_THREAD_DEF_PRIORITY 20
|
|
#define TXPTH_THREAD_DEF_PREEMPT_THRESHOLD 20
|
|
#define TXPTH_THREAD_DEF_TIME_SLICE 10
|
|
|
|
#define TXPTH_POSIX_MAIN_DEF_PRIORITY 21
|
|
#define TXPTH_POSIX_MAIN_DEF_PREEMPT_THRESHOLD 21
|
|
#define TXPTH_POSIX_MAIN_DEF_TIME_SLICE 10
|
|
|
|
#define TXPTH_SIZE_BYTE_POOL ((PTHREAD_STACK_DEFAULT + sizeof (pthread_info) + (1024*2)) * TXPTHNUM_POSIX_PTHREAD_THREADS_MAX)
|
|
#define TXPTH_NAME_BYTE_POOL "BytePool4PThreads"
|
|
|
|
#define TXPTH_NAME_MUTEX "Mutex4PThreads"
|
|
|
|
//=============================================================================
|
|
// Thread control data structure
|
|
|
|
// Per-thread information needed by POSIX
|
|
// This is pointed to by the tx_thread_name entry of the thread control block of a TX_THREAD.
|
|
|
|
typedef struct
|
|
{
|
|
// The following is space for the ThreadX thread object that underlies
|
|
// this POSIX thread. It is allocated like this to avoid constructing
|
|
// it on startup.
|
|
TX_THREAD thread_obj;
|
|
|
|
char name [TXPTH_LEN_NAME]; // Thread name
|
|
unsigned int state:4, // Thread state
|
|
cancelstate:2, // Cancel state of thread
|
|
canceltype:2, // Cancel type of thread
|
|
cancelpending:1, // pending cancel flag
|
|
freestack:1; // stack malloced, must be freed
|
|
|
|
int pth_errno; // the per-thread errno location
|
|
|
|
pthread_t id; // My thread ID
|
|
TX_THREAD *thread; // pointer to ThreadX thread object
|
|
pthread_attr_t attr; // Current thread attributes
|
|
void *retval; // return value
|
|
void *(*start_routine)(void *); // start routine
|
|
void *start_arg; // argument to start routine
|
|
TX_EVENT_FLAGS_GROUP *joiner; // joining threads wait here
|
|
void *stackmem; // base of stack memory area
|
|
// only valid if freestack == true
|
|
|
|
struct pthread_cleanup_buffer *cancelbuffer; // stack of cleanup buffers
|
|
|
|
// And the same for the joiner condition variable.
|
|
TX_EVENT_FLAGS_GROUP joiner_obj;
|
|
char joiner_name [TXPTH_LEN_NAME];
|
|
|
|
// Per-thread data table pointer
|
|
void **thread_data;
|
|
} pthread_info;
|
|
|
|
|
|
// Values for the state field. These are solely concerned with the
|
|
// states visible to POSIX. The thread's run state is stored in the
|
|
// ThreadX thread object.
|
|
// Note: numerical order here is important, do not rearrange.
|
|
|
|
#define PTHREAD_STATE_FREE 0 // This structure is free for reuse
|
|
#define PTHREAD_STATE_DETACHED 1 // The thread is running but detached
|
|
#define PTHREAD_STATE_RUNNING 2 // The thread is running and will wait
|
|
// to join when it exits
|
|
#define PTHREAD_STATE_JOIN 3 // The thread has exited and is waiting
|
|
// to be joined
|
|
#define PTHREAD_STATE_EXITED 4 // The thread has exited and is ready to
|
|
// be reaped
|
|
//-----------------------------------------------------------------------------
|
|
// Internal definitions
|
|
#define _REPORT_RETVAL(err)
|
|
#define _REPORT_RETURN()
|
|
|
|
#define _MACRO_START do {
|
|
#define _MACRO_END } while (0);
|
|
|
|
// Handle entry to a pthread package function.
|
|
#define PTHREAD_ENTRY()
|
|
|
|
// Handle entry to a pthread package function with no args.
|
|
#define PTHREAD_ENTRY_VOID()
|
|
|
|
// Do a pthread package defined return. This requires the error code to be
|
|
// returned as the result of the function. This also gives us a place to
|
|
// put any generic tidyup handling needed for things like signal delivery
|
|
// and cancellation.
|
|
#define PTHREAD_RETURN(err) \
|
|
_MACRO_START \
|
|
_REPORT_RETVAL (err); \
|
|
return err; \
|
|
_MACRO_END
|
|
|
|
// A void variant of the above.
|
|
#define PTHREAD_RETURN_VOID \
|
|
_MACRO_START \
|
|
_REPORT_RETURN(); \
|
|
return; \
|
|
_MACRO_END
|
|
|
|
#if 0
|
|
#define TXPTH_ASSERT(cond, info) if (!(cond)) SerialOutputString (info)
|
|
#define TXPTH_FAIL(info) SerialOutputString (info)
|
|
#else
|
|
#define TXPTH_ASSERT(cond, info)
|
|
#define TXPTH_FAIL(info)
|
|
#endif
|
|
|
|
// Check that a pointer passed in as an argument is valid and return
|
|
// EINVAL if it is not. This should be used to check pointers that are
|
|
// required to be valid. Pointers that may optionally be NULL should
|
|
// be checked within the function.
|
|
#define PTHREAD_CHECK(ptr) if( (ptr) == NULL ) PTHREAD_RETURN(EINVAL);
|
|
|
|
#define PTHREAD_TESTCANCEL() pthread_testcancel()
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Priority translation.
|
|
// ThreadX priorities run from 0 as the highest to 31 as the lowest. POSIX priorities
|
|
// run in the opposite direction. The following macros translate between the two
|
|
// priority ranges.
|
|
|
|
#define PTHREAD_TX_PRIORITY(pri) (TXPTH_THREAD_MIN_PRIORITY-(pri))
|
|
|
|
#define PTHREAD_POSIX_PRIORITY(pri) (TXPTH_THREAD_MIN_PRIORITY-(pri))
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Global data structures
|
|
|
|
// Mutex for locking access to pthread_info structures
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Functions exported by pthread.c to the other parts of the POSIX subsystem.
|
|
|
|
pthread_info *pthread_self_info (void);
|
|
|
|
pthread_info *pthread_info_id (pthread_t id);
|
|
|
|
#define NAME_TYPE_THREAD 't'
|
|
#define NAME_TYPE_MUTEX 'm'
|
|
#define NAME_TYPE_SEM 's'
|
|
#define NAME_TYPE_EVENTFLAGS 'e'
|
|
|
|
void __txpth_get_name (char *name, char type, int lock);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* !TXPTH_PPRIVATE_H */
|
|
|
|
/* End of pprivate.h */
|
|
|