thd.h

浏览该文件的文档.

 
#ifndef __xwos_osal_thd_h__
#define __xwos_osal_thd_h__
 
#include <xwos/standard.h>
#include <xwos/osal/jack/thd.h>
#include <xwos/osal/time.h>
#include <xwos/osal/skd.h>
 
struct xwos_thd {
        struct xwosdl_thd osthd;
};
 
typedef xwer_t (* xwos_thd_f)(void *);
 
typedef struct {
        struct xwos_thd * thd; 
        xwsq_t tik; 
} xwos_thd_d;
 
#define XWOS_THD_NILD ((xwos_thd_d){NULL, 0,})
 
struct xwos_thd_attr {
        const char * name; 
        xwstk_t * stack; 
        xwsz_t stack_size; 
        xwsz_t stack_guard_size; 
        xwpr_t priority; 
        bool detached; 
        bool privileged; 
};
 
struct xwos_thd_stack_info {
        xwstk_t * sp; 
        xwstk_t * tls; 
        xwstk_t * base; 
        xwsz_t size; 
        xwstk_t * guard_base; 
        xwsz_t guard_size; 
        xwstk_t * line; 
        xwsz_t usage; 
};
 
#define __xwos_thd_stack __xwcc_alignl1cache
 
#define XWOS_STACK_SIZE_DEFAULT         XWMMCFG_STACK_SIZE_DEFAULT
 
#define XWOS_STACK_SIZE_MIN             XWMMCFG_STACK_SIZE_MIN
 
#define XWOS_STACK_GUARD_SIZE_DEFAULT   XWMMCFG_STACK_GUARD_SIZE_DEFAULT
 
#define XWOS_THD_LOCAL_DATA_NUM         XWOSDL_THD_LOCAL_DATA_NUM
 
struct xwos_thd_desc {
        struct xwos_thd_attr attr; 
        xwos_thd_f func; 
        void * arg; 
};
 
static __xwos_inline_api
void xwos_thd_attr_init(struct xwos_thd_attr * attr)
{
        xwosdl_thd_attr_init((struct xwosdl_thd_attr *)attr);
}
 
static __xwos_inline_api
xwer_t xwos_thd_init(struct xwos_thd * thd, xwos_thd_d * thdd,
                     const struct xwos_thd_attr * attr,
                     xwos_thd_f thdfunc, void * arg)
{
        return xwosdl_thd_init(&thd->osthd, (xwosdl_thd_d *)thdd,
                               (const struct xwosdl_thd_attr *)attr,
                               // cppcheck-suppress [misra-c2012-11.1]
                               (xwosdl_thd_f)thdfunc, arg);
}
 
static __xwos_inline_api
xwer_t xwos_thd_grab(xwos_thd_d thdd)
{
        return xwosdl_thd_grab(&thdd.thd->osthd);
}
 
static __xwos_inline_api
xwer_t xwos_thd_put(xwos_thd_d thdd)
{
        return xwosdl_thd_put(&thdd.thd->osthd);
}
 
static __xwos_inline_api
xwer_t xwos_thd_create(xwos_thd_d * thdd,
                       const struct xwos_thd_attr * attr,
                       xwos_thd_f thdfunc, void * arg)
{
        return xwosdl_thd_create((xwosdl_thd_d *)thdd,
                                 (const struct xwosdl_thd_attr *)attr,
                                 // cppcheck-suppress [misra-c2012-11.1]
                                 (xwosdl_thd_f)thdfunc, arg);
}
 
static __xwos_inline_api
xwer_t xwos_thd_acquire(xwos_thd_d thdd)
{
        return xwosdl_thd_acquire(&thdd.thd->osthd, thdd.tik);
}
 
static __xwos_inline_api
xwer_t xwos_thd_release(xwos_thd_d thdd)
{
        return xwosdl_thd_release(&thdd.thd->osthd, thdd.tik);
}
 
static __xwos_inline_api
xwer_t xwos_thd_launch(xwos_thd_d thdd, xwos_thd_f thdfunc, void * arg)
{
        return xwosdl_thd_launch(&thdd.thd->osthd, thdd.tik,
                                 // cppcheck-suppress [misra-c2012-11.1]
                                 (xwosdl_thd_f)thdfunc, arg);
}
 
 
static __xwos_inline_api
xwer_t xwos_thd_get_attr(xwos_thd_d thdd, struct xwos_thd_attr * attr)
{
        return xwosdl_thd_get_attr(&thdd.thd->osthd, thdd.tik,
                                   (struct xwosdl_thd_attr *)attr);
}
 
static __xwos_inline_api
xwer_t xwos_thd_get_stack_info(xwos_thd_d thdd, struct xwos_thd_stack_info * stack)
{
        xwer_t rc;
        struct xwosdl_thd_stack_info info;
 
        rc = xwosdl_thd_get_stack_info(&thdd.thd->osthd, thdd.tik, &info);
        if ((XWOK == rc) && (stack)) {
                stack->sp = info.sp;
                stack->tls = (xwstk_t *)info.tls;
                stack->base = info.base;
                stack->size = info.size;
                stack->guard_base = info.guard_base;
                stack->guard_size = info.guard_size;
                stack->line = info.line;
                stack->usage = info.usage;
        }
        return rc;
}
 
static __xwos_inline_api
xwer_t xwos_thd_get_stack_usage(xwos_thd_d thdd, xwsz_t * usage)
{
        return xwosdl_thd_get_stack_usage(&thdd.thd->osthd, thdd.tik, usage);
}
 
static __xwos_inline_api
xwer_t xwos_thd_intr(xwos_thd_d thdd)
{
        return xwosdl_thd_intr(&thdd.thd->osthd, thdd.tik);
}
 
static __xwos_inline_api
xwer_t xwos_thd_quit(xwos_thd_d thdd)
{
        return xwosdl_thd_quit(&thdd.thd->osthd, thdd.tik);
}
 
static __xwos_inline_api
xwer_t xwos_thd_join(xwos_thd_d thdd, xwer_t * trc)
{
        return xwosdl_thd_join(&thdd.thd->osthd, thdd.tik, trc);
}
 
static __xwos_inline_api
xwer_t xwos_thd_stop(xwos_thd_d thdd, xwer_t * trc)
{
        return xwosdl_thd_stop(&thdd.thd->osthd, thdd.tik, trc);
}
 
static __xwos_inline_api
xwer_t xwos_thd_detach(xwos_thd_d thdd)
{
        return xwosdl_thd_detach(&thdd.thd->osthd, thdd.tik);
}
 
static __xwos_inline_api
xwer_t xwos_thd_migrate(xwos_thd_d thdd, xwid_t dstcpu)
{
        return xwosdl_thd_migrate(&thdd.thd->osthd, thdd.tik, dstcpu);
}
 
static __xwos_inline_api
xwos_thd_d xwos_cthd_self(void)
{
        xwosdl_thd_d thdd;
 
        thdd = xwosdl_cthd_self();
        return (xwos_thd_d){(struct xwos_thd *)thdd.thd, thdd.tik};
}
 
static __xwos_inline_api
void xwos_cthd_get_attr(struct xwos_thd_attr * attr)
{
        // cppcheck-suppress [misra-c2012-17.7]
        xwos_thd_get_attr(xwos_cthd_self(), attr);
}
 
static __xwos_inline_api
void xwos_cthd_get_stack_info(struct xwos_thd_stack_info * stack)
{
        // cppcheck-suppress [misra-c2012-17.7]
        xwos_thd_get_stack_info(xwos_cthd_self(), stack);
}
 
static __xwos_inline_api
xwsz_t xwos_cthd_get_stack_usage(void)
{
        xwsz_t usage;
 
        // cppcheck-suppress [misra-c2012-17.7]
        xwos_thd_get_stack_usage(xwos_cthd_self(), &usage);
        return usage;
}
 
static __xwos_inline_api
void xwos_cthd_yield(void)
{
        xwosdl_cthd_yield();
}
 
static __xwos_inline_api
void xwos_cthd_exit(xwer_t rc)
{
        xwosdl_cthd_exit(rc);
}
 
static __xwos_inline_api
bool xwos_cthd_shld_frz(void)
{
        return xwosdl_cthd_shld_frz();
}
 
static __xwos_inline_api
bool xwos_cthd_shld_stop(void)
{
        return xwosdl_cthd_shld_stop();
}
 
static __xwos_inline_api
bool xwos_cthd_frz_shld_stop(bool * frozen)
{
        return xwosdl_cthd_frz_shld_stop(frozen);
}
 
static __xwos_inline_api
xwer_t xwos_cthd_sleep(xwtm_t dur)
{
        return xwosdl_cthd_sleep_to(xwtm_ft(dur));
}
 
static __xwos_inline_api
xwer_t xwos_cthd_sleep_to(xwtm_t to)
{
        return xwosdl_cthd_sleep_to(to);
}
 
static __xwos_inline_api
xwer_t xwos_cthd_sleep_from(xwtm_t * from, xwtm_t dur)
{
        return xwosdl_cthd_sleep_from(from, dur);
}
 
static __xwos_inline_api
xwer_t xwos_cthd_freeze(void)
{
        return xwosdl_cthd_freeze();
}
 
#if (XWOS_THD_LOCAL_DATA_NUM > 0U)
static __xwos_inline_api
xwer_t xwos_thd_set_data(xwos_thd_d thdd, xwsq_t pos, void * data)
{
        return xwosdl_thd_set_data(&thdd.thd->osthd, thdd.tik, pos, data);
}
 
static __xwos_inline_api
xwer_t xwos_thd_get_data(xwos_thd_d thdd, xwsq_t pos, void ** databuf)
{
        return xwosdl_thd_get_data(&thdd.thd->osthd, thdd.tik, pos, databuf);
}
 
static __xwos_inline_api
xwer_t xwos_cthd_set_data(xwsq_t pos, void * data)
{
        return xwosdl_cthd_set_data(pos, data);
}
 
static __xwos_inline_api
xwer_t xwos_cthd_get_data(xwsq_t pos, void ** databuf)
{
        return xwosdl_cthd_get_data(pos, databuf);
 
}
#endif
 
#endif /* xwos/osal/thd.h */