sys_arch.c 文件参考

浏览源代码.

函数
	SPIN_LOCK_INIT (arch_protect_spin)
sys_thread_t	sys_thread_new (const char *name, lwip_thread_fn thread, void *arg, int stackSize, int prio)
void	sys_init (void)
u32_t	sys_now (void)
u16_t	lwip_standard_chksum (const void *dataptr, int len)
sys_prot_t	sys_arch_protect (void)
void	sys_arch_unprotect (sys_prot_t pval)
err_t	sys_mbox_new (sys_mbox_t *mbox, int size)
void	sys_mbox_post (sys_mbox_t *mbox, void *msg)
	发送消息,参数2不能为空,直到发送成功为止 更多...
err_t	sys_mbox_trypost (sys_mbox_t *mbox, void *msg)
	尝试发送消息 更多...
err_t	sys_mbox_trypost_fromisr (sys_mbox_t *mbox, void *msg)
u32_t	sys_arch_mbox_fetch (sys_mbox_t *mbox, void **msg, u32_t timeoutMs)
u32_t	sys_arch_mbox_tryfetch (sys_mbox_t *mbox, void **msg)
	尝试都消息 更多...
void	sys_mbox_free (sys_mbox_t *mbox)
	删除队列 更多...
int	sys_mbox_valid (sys_mbox_t *mbox)
	队列是否有效 更多...
void	sys_mbox_set_invalid (sys_mbox_t *mbox)
err_t	sys_sem_new (sys_sem_t *sem, u8_t count)
void	sys_sem_signal (sys_sem_t *sem)
u32_t	sys_arch_sem_wait (sys_sem_t *sem, u32_t timeoutMs)
void	sys_sem_free (sys_sem_t *sem)
int	sys_sem_valid (sys_sem_t *sem)
void	sys_sem_set_invalid (sys_sem_t *sem)
err_t	sys_mutex_new (sys_mutex_t *mutex)
void	sys_mutex_lock (sys_mutex_t *mutex)
void	sys_mutex_unlock (sys_mutex_t *mutex)
void	sys_mutex_free (sys_mutex_t *mutex)
int	sys_mutex_valid (sys_mutex_t *mutex)
void	sys_mutex_set_invalid (sys_mutex_t *mutex)

变量
static u32_t	lwprot_thread = LOS_ERRNO_TSK_ID_INVALID
static int	lwprot_count = 0

函数说明

lwip_standard_chksum()

u16_t lwip_standard_chksum	(	const void *	dataptr,
		int	len
	)

在文件 sys_arch.c 第 100 行定义.

{
    return ~(u16_t)(in_cksum(dataptr, len));
}

函数调用图:

SPIN_LOCK_INIT()

SPIN_LOCK_INIT

(

arch_protect_spin

)

   移值lwip所需的内核架构层支持.
   创建线程,互斥锁,信号量,队列的接口实现
* 

sys_arch_mbox_fetch()

u32_t sys_arch_mbox_fetch	(	sys_mbox_t *	mbox,
		void **	msg,
		u32_t	timeoutMs
	)

在文件 sys_arch.c 第 200 行定义.

{
    void *ignore = 0; /* if msg==NULL, the fetched msg should be dropped */
    UINT64 tick = ROUND_UP_DIV((UINT64)timeoutMs * LOSCFG_BASE_CORE_TICK_PER_SECOND, OS_SYS_MS_PER_SECOND);
    UINT32 ret = LOS_QueueRead(*mbox, msg ? msg : &ignore, sizeof(void *), tick ? (UINT32)tick : LOS_WAIT_FOREVER);
    switch (ret) {
        case LOS_OK:
            return ERR_OK;
        case LOS_ERRNO_QUEUE_ISEMPTY:
        case LOS_ERRNO_QUEUE_TIMEOUT:
            return SYS_ARCH_TIMEOUT;
        default:
            break;
    }
    LWIP_DEBUGF(SYS_DEBUG, ("%s: LOS_QueueRead error %u\n", __FUNCTION__, ret));
    return SYS_ARCH_TIMEOUT; /* Errors should be treated as timeout */
}

函数调用图:

sys_arch_mbox_tryfetch()

u32_t sys_arch_mbox_tryfetch	(	sys_mbox_t *	mbox,
		void **	msg
	)

尝试都消息

在文件 sys_arch.c 第 218 行定义.

{
    void *ignore = 0; /* if msg==NULL, the fetched msg should be dropped */
    UINT32 ret = LOS_QueueRead(*mbox, msg ? msg : &ignore, sizeof(void *), 0);
    switch (ret) {
        case LOS_OK:
            return ERR_OK;
        case LOS_ERRNO_QUEUE_ISEMPTY:
            return SYS_MBOX_EMPTY;
        case LOS_ERRNO_QUEUE_TIMEOUT:
            return SYS_ARCH_TIMEOUT;
        default:
            break;
    }
    LWIP_DEBUGF(SYS_DEBUG, ("%s: LOS_QueueRead error %u\n", __FUNCTION__, ret));
    return SYS_MBOX_EMPTY; /* Errors should be treated as timeout */
}

函数调用图:

sys_arch_protect()

sys_prot_t sys_arch_protect

(

void

)

Protector

在文件 sys_arch.c 第 111 行定义.

{
#ifdef LOSCFG_KERNEL_SMP
    /* Note that we are using spinlock instead of mutex for LiteOS-SMP here:
     * 1. spinlock is more effective for short critical region protection.
     * 2. this function is called only in task context, not in interrupt handler.
     *    so it's not needed to disable interrupt.
     */
    if (lwprot_thread != LOS_CurTaskIDGet()) {
        /* We are locking the spinlock where it has not been locked before
         * or is being locked by another thread */
        LOS_SpinLock(&arch_protect_spin);
        lwprot_thread = LOS_CurTaskIDGet();
        lwprot_count = 1;
    } else {
        /* It is already locked by THIS thread */
        lwprot_count++;
    }
#else
    LOS_TaskLock();
#endif /* LOSCFG_KERNEL_SMP */
    return 0; /* return value is unused */
}

函数调用图:

sys_arch_sem_wait()

u32_t sys_arch_sem_wait	(	sys_sem_t *	sem,
		u32_t	timeoutMs
	)

在文件 sys_arch.c 第 272 行定义.

{
    UINT64 tick = ROUND_UP_DIV((UINT64)timeoutMs * LOSCFG_BASE_CORE_TICK_PER_SECOND, OS_SYS_MS_PER_SECOND);
    UINT32 ret = LOS_SemPend(*sem, tick ? (UINT32)tick : LOS_WAIT_FOREVER); // timeoutMs 0 means wait forever
    switch (ret) {
        case LOS_OK:
            return ERR_OK;
        case LOS_ERRNO_SEM_TIMEOUT:
            return SYS_ARCH_TIMEOUT;
        default:
            break;
    }
    LWIP_DEBUGF(SYS_DEBUG, ("%s: LOS_SemPend error %u\n", __FUNCTION__, ret));
    return SYS_ARCH_TIMEOUT; /* Errors should be treated as timeout */
}

函数调用图:

这是这个函数的调用关系图:

sys_arch_unprotect()

void sys_arch_unprotect

(

sys_prot_t

pval

)

在文件 sys_arch.c 第 135 行定义.

{
    LWIP_UNUSED_ARG(pval);
#ifdef LOSCFG_KERNEL_SMP
    if (lwprot_thread == LOS_CurTaskIDGet()) {
        lwprot_count--;
        if (lwprot_count == 0) {
            lwprot_thread = LOS_ERRNO_TSK_ID_INVALID;
            LOS_SpinUnlock(&arch_protect_spin);
        }
    }
#else
    LOS_TaskUnlock();
#endif /* LOSCFG_KERNEL_SMP */
}

函数调用图:

sys_init()

void sys_init

(

void

)

在文件 sys_arch.c 第 84 行定义.

{
    /* set rand seed to make random sequence diff on every startup */
    UINT32 seedhsb, seedlsb;
    LOS_GetCpuCycle(&seedhsb, &seedlsb);
    srand(seedlsb);
}

函数调用图:

sys_mbox_free()

void sys_mbox_free

(

sys_mbox_t *

mbox

)

删除队列

在文件 sys_arch.c 第 236 行定义.

{
    (void)LOS_QueueDelete(*mbox);
}

函数调用图:

sys_mbox_new()

err_t sys_mbox_new	(	sys_mbox_t *	mbox,
		int	size
	)

MessageBox

在文件 sys_arch.c 第 156 行定义.

{
    CHAR qName[] = "lwIP";
    UINT32 ret = LOS_QueueCreate(qName, (UINT16)size, mbox, 0, sizeof(void *));//创建一个队列 "lwip"
    switch (ret) {
        case LOS_OK:
            return ERR_OK;
        case LOS_ERRNO_QUEUE_CB_UNAVAILABLE:
        case LOS_ERRNO_QUEUE_CREATE_NO_MEMORY:
            return ERR_MEM;
        default:
            break;
    }
    LWIP_DEBUGF(SYS_DEBUG, ("%s: LOS_QueueCreate error %u\n", __FUNCTION__, ret));
    return ERR_ARG;
}

函数调用图:

sys_mbox_post()

void sys_mbox_post	(	sys_mbox_t *	mbox,
		void *	msg
	)

发送消息,参数2不能为空,直到发送成功为止

在文件 sys_arch.c 第 173 行定义.

{
    /* Caution: the second parameter is NOT &msg */
    UINT32 ret = LOS_QueueWrite(*mbox, msg, sizeof(char *), LOS_WAIT_FOREVER);
    if (ret != LOS_OK) {
        LWIP_DEBUGF(SYS_DEBUG, ("%s: LOS_QueueWrite error %u\n", __FUNCTION__, ret));
    }
}

函数调用图:

sys_mbox_set_invalid()

void sys_mbox_set_invalid

(

sys_mbox_t *

mbox

)

在文件 sys_arch.c 第 247 行定义.

{
    *mbox = LOSCFG_BASE_IPC_QUEUE_LIMIT;
}

sys_mbox_trypost()

err_t sys_mbox_trypost	(	sys_mbox_t *	mbox,
		void *	msg
	)

尝试发送消息

在文件 sys_arch.c 第 182 行定义.

{
    /* Caution: the second parameter is NOT &msg */
    UINT32 ret = LOS_QueueWrite(*mbox, msg, sizeof(char *), 0);
    switch (ret) {
        case LOS_OK:
            return ERR_OK;
        case LOS_ERRNO_QUEUE_ISFULL:
            return ERR_MEM;
        default:
            break;
    }
    LWIP_DEBUGF(SYS_DEBUG, ("%s: LOS_QueueWrite error %u\n", __FUNCTION__, ret));
    return ERR_ARG;
}

函数调用图:

sys_mbox_trypost_fromisr()

err_t sys_mbox_trypost_fromisr	(	sys_mbox_t *	mbox,
		void *	msg
	)

sys_mbox_valid()

int sys_mbox_valid

(

sys_mbox_t *

mbox

)

队列是否有效

在文件 sys_arch.c 第 241 行定义.

{
    QUEUE_INFO_S queueInfo;
    return LOS_OK == LOS_QueueInfoGet(*mbox, &queueInfo);
}

函数调用图:

sys_mutex_free()

void sys_mutex_free

(

sys_mutex_t *

mutex

)

在文件 sys_arch.c 第 328 行定义.

{
    (void)LOS_MuxDestroy(mutex);
}

函数调用图:

sys_mutex_lock()

void sys_mutex_lock

(

sys_mutex_t *

mutex

)

在文件 sys_arch.c 第 318 行定义.

{
    (void)LOS_MuxLock(mutex, LOS_WAIT_FOREVER);
}

函数调用图:

sys_mutex_new()

err_t sys_mutex_new

(

sys_mutex_t *

mutex

)

Mutex

在文件 sys_arch.c 第 308 行定义.

{
    UINT32 ret = LOS_MuxInit(mutex, NULL);
    if (ret != LOS_OK) {
        return ERR_ARG;
    }
 
    return ERR_OK;
}

函数调用图:

sys_mutex_set_invalid()

void sys_mutex_set_invalid

(

sys_mutex_t *

mutex

)

在文件 sys_arch.c 第 338 行定义.

{
    (void)LOS_MuxDestroy(mutex);
}

函数调用图:

sys_mutex_unlock()

void sys_mutex_unlock

(

sys_mutex_t *

mutex

)

在文件 sys_arch.c 第 323 行定义.

{
    (void)LOS_MuxUnlock(mutex);
}

函数调用图:

sys_mutex_valid()

int sys_mutex_valid

(

sys_mutex_t *

mutex

)

在文件 sys_arch.c 第 333 行定义.

{
    return LOS_MuxIsValid(mutex);
}

函数调用图:

sys_now()

u32_t sys_now

(

void

)

在文件 sys_arch.c 第 92 行定义.

{
    /* Lwip docs mentioned like wraparound is not a problem in this funtion */
    return (u32_t)((LOS_TickCountGet() * OS_SYS_MS_PER_SECOND) / LOSCFG_BASE_CORE_TICK_PER_SECOND);
}

函数调用图:

这是这个函数的调用关系图:

sys_sem_free()

void sys_sem_free

(

sys_sem_t *

sem

)

在文件 sys_arch.c 第 288 行定义.

{
    (void)LOS_SemDelete(*sem);
}

函数调用图:

这是这个函数的调用关系图:

sys_sem_new()

err_t sys_sem_new	(	sys_sem_t *	sem,
		u8_t	count
	)

Semaphore

在文件 sys_arch.c 第 257 行定义.

{
    UINT32 ret = LOS_SemCreate(count, sem);
    if (ret != LOS_OK) {
        return ERR_ARG;
    }
 
    return ERR_OK;
}

函数调用图:

这是这个函数的调用关系图:

sys_sem_set_invalid()

void sys_sem_set_invalid

(

sys_sem_t *

sem

)

在文件 sys_arch.c 第 298 行定义.

{
    *sem = LOSCFG_BASE_IPC_SEM_LIMIT;
}

sys_sem_signal()

void sys_sem_signal

(

sys_sem_t *

sem

)

在文件 sys_arch.c 第 267 行定义.

{
    (void)LOS_SemPost(*sem);
}

函数调用图:

这是这个函数的调用关系图:

sys_sem_valid()

int sys_sem_valid

(

sys_sem_t *

sem

)

在文件 sys_arch.c 第 293 行定义.

{
    return *sem != LOSCFG_BASE_IPC_SEM_LIMIT;
}

sys_thread_new()

sys_thread_t sys_thread_new	(	const char *	name,
		lwip_thread_fn	thread,
		void *	arg,
		int	stackSize,
		int	prio
	)

Thread and System misc

在文件 sys_arch.c 第 62 行定义.

{
    UINT32 taskID = LOS_ERRNO_TSK_ID_INVALID;
    UINT32 ret;
    TSK_INIT_PARAM_S task = {0};
 
    /* Create host Task */
    task.pfnTaskEntry = (TSK_ENTRY_FUNC)thread;
    task.uwStackSize = stackSize;//内核栈大小
    task.pcName = (char *)name;//任务名称
    task.usTaskPrio = prio;
    task.auwArgs[0] = (UINTPTR)arg;
    task.uwResved = LOS_TASK_STATUS_DETACHED;
    ret = LOS_TaskCreate(&taskID, &task);
    if (ret != LOS_OK) {
        LWIP_DEBUGF(SYS_DEBUG, ("sys_thread_new: LOS_TaskCreate error %u\n", ret));
        return -1;
    }
 
    return taskID;
}

函数调用图:

变量说明

lwprot_count

int lwprot_count = 0

static

在文件 sys_arch.c 第 53 行定义.

lwprot_thread

u32_t lwprot_thread = LOS_ERRNO_TSK_ID_INVALID

static

在文件 sys_arch.c 第 52 行定义.