|
|
/* ----------------------------------------------------------------------------
|
|
|
* Copyright (c) Huawei Technologies Co., Ltd. 2013-2019. All rights reserved.
|
|
|
* Description: Mutex
|
|
|
* Author: Huawei LiteOS Team
|
|
|
* Create: 2013-01-01
|
|
|
* Redistribution and use in source and binary forms, with or without modification,
|
|
|
* are permitted provided that the following conditions are met:
|
|
|
* 1. Redistributions of source code must retain the above copyright notice, this list of
|
|
|
* conditions and the following disclaimer.
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice, this list
|
|
|
* of conditions and the following disclaimer in the documentation and/or other materials
|
|
|
* provided with the distribution.
|
|
|
* 3. Neither the name of the copyright holder nor the names of its contributors may be used
|
|
|
* to endorse or promote products derived from this software without specific prior written
|
|
|
* permission.
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
|
|
|
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
|
|
|
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
|
|
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
|
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
|
|
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
* --------------------------------------------------------------------------- */
|
|
|
|
|
|
/**
|
|
|
* @defgroup los_mux Mutex
|
|
|
* @ingroup kernel
|
|
|
*/
|
|
|
|
|
|
#ifndef _LOS_MUX_H
|
|
|
#define _LOS_MUX_H
|
|
|
|
|
|
#include "los_base.h"
|
|
|
#include "los_sys.h"
|
|
|
#include "los_list.h"
|
|
|
#include "los_task.h"
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
#if __cplusplus
|
|
|
extern "C" {
|
|
|
#endif /* __cplusplus */
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: The memory request fails.
|
|
|
*
|
|
|
* Value: 0x02001d00.
|
|
|
*
|
|
|
* Solution: Decrease the number of mutexes defined by LOSCFG_BASE_IPC_MUX_LIMIT.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_NO_MEMORY LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x00)
|
|
|
/*<2A><><EFBFBD>δ<EFBFBD><CEB4>붨<EFBFBD><EBB6A8><EFBFBD><EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD>Ϊ LOS_ERRNO_MUX_NO_MEMORY <20>ĺ꣬<C4BA><EAA3AC><EFBFBD>ڱ<EFBFBD>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڴ<EFBFBD>ʧ<EFBFBD>ܵĴ<DCB5><C4B4><EFBFBD><EFBFBD>롣
|
|
|
|
|
|
LOS_ERRNO_OS_ERROR <20><>һ<EFBFBD><D2BB><EFBFBD>꣬<EFBFBD><EAA3AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɾ<EFBFBD><C9BE><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ʹ<EFBFBD><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>LOS_MOD_MUX <20><>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ǻ<EFBFBD><C7BB><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD>飬
|
|
|
0x00 <20>Ǹô<C7B8><C3B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڸ<EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>еľ<D0B5><C4BE><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>*/
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: The mutex is not usable.
|
|
|
*
|
|
|
* Value: 0x02001d01.
|
|
|
*
|
|
|
* Solution: Check whether the mutex ID and the mutex state are applicable for the current operation.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_INVALID LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x01)
|
|
|
//LOS_ERRNO_OS_ERROR <20><>һ<EFBFBD><D2BB><EFBFBD>꣬<EFBFBD><EAA3AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɾ<EFBFBD><C9BE><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ʹ<EFBFBD><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>LOS_MOD_MUX <20><>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ǻ<EFBFBD><C7BB><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD>飬0x01 <20>Ǹô<C7B8><C3B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڸ<EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>еľ<D0B5><C4BE><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: Null pointer.
|
|
|
*
|
|
|
* Value: 0x02001d02.
|
|
|
*
|
|
|
* Solution: Check whether the input parameter is usable.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_PTR_NULL LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x02)
|
|
|
//<2F><><EFBFBD>δ<EFBFBD><CEB4>붨<EFBFBD><EBB6A8><EFBFBD><EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD>Ϊ LOS_ERRNO_MUX_PTR_NULL <20>ĺ꣬<C4BA><EAA3AC><EFBFBD>ڱ<EFBFBD>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ָ<EFBFBD><D6B8>Ϊ<EFBFBD>յĴ<D5B5><C4B4><EFBFBD><EFBFBD>롣
|
|
|
//LOS_ERRNO_OS_ERROR <20><>һ<EFBFBD><D2BB><EFBFBD>꣬<EFBFBD><EAA3AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɾ<EFBFBD><C9BE><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ʹ<EFBFBD><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>LOS_MOD_MUX <20><>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ǻ<EFBFBD><C7BB><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD>飬0x02 <20>Ǹô<C7B8><C3B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڸ<EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>еľ<D0B5><C4BE><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: No mutex is available and the mutex request fails.
|
|
|
*
|
|
|
* Value: 0x02001d03.
|
|
|
*
|
|
|
* Solution: Increase the number of mutexes defined by LOSCFG_BASE_IPC_MUX_LIMIT.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_ALL_BUSY LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x03)
|
|
|
/*<2A><><EFBFBD>δ<EFBFBD><CEB4>붨<EFBFBD><EBB6A8><EFBFBD><EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD>Ϊ LOS_ERRNO_MUX_ALL_BUSY <20>ĺ꣬<C4BA><EAA3AC><EFBFBD>ڱ<EFBFBD>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ȫ<EFBFBD><C8AB><EFBFBD><EFBFBD>ռ<EFBFBD>õĴ<C3B5><C4B4><EFBFBD><EFBFBD>롣
|
|
|
|
|
|
LOS_ERRNO_OS_ERROR <20><>һ<EFBFBD><D2BB><EFBFBD>꣬<EFBFBD><EAA3AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɾ<EFBFBD><C9BE><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ʹ<EFBFBD><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>LOS_MOD_MUX <20><>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ǻ<EFBFBD><C7BB><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD>飬0x03 <20>Ǹô<C7B8><C3B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڸ<EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>еľ<D0B5><C4BE><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>*/
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: The mutex fails to be locked in non-blocking mode because it is locked by another thread.
|
|
|
*
|
|
|
* Value: 0x02001d04.
|
|
|
*
|
|
|
* Solution: Lock the mutex after it is unlocked by the thread that owns it, or set a waiting time.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_UNAVAILABLE LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x04)
|
|
|
/*<2A><><EFBFBD>δ<EFBFBD><CEB4>붨<EFBFBD><EBB6A8><EFBFBD><EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD>Ϊ LOS_ERRNO_MUX_UNAVAILABLE <20>ĺ꣬<C4BA><EAA3AC><EFBFBD>ڱ<EFBFBD>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>õĴ<C3B5><C4B4><EFBFBD><EFBFBD>롣
|
|
|
|
|
|
LOS_ERRNO_OS_ERROR <20><>һ<EFBFBD><D2BB><EFBFBD>꣬<EFBFBD><EAA3AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɾ<EFBFBD><C9BE><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ʹ<EFBFBD><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>LOS_MOD_MUX <20><>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ǻ<EFBFBD><C7BB><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD>飬0x04 <20>Ǹô<C7B8><C3B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڸ<EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>еľ<D0B5><C4BE><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>*/
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: The mutex is being locked during an interrupt.
|
|
|
*
|
|
|
* Value: 0x02001d05.
|
|
|
*
|
|
|
* Solution: Check whether the mutex is being locked during an interrupt.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_PEND_INTERR LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x05)
|
|
|
/*<2A><><EFBFBD>δ<EFBFBD><CEB4>붨<EFBFBD><EBB6A8><EFBFBD><EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD>Ϊ LOS_ERRNO_MUX_PEND_INTERR <20>ĺ꣬<C4BA><EAA3AC><EFBFBD>ڱ<EFBFBD>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ȴ<EFBFBD><C8B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD>жϴ<D0B6><CFB4><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD>롣
|
|
|
|
|
|
LOS_ERRNO_OS_ERROR <20><>һ<EFBFBD><D2BB><EFBFBD>꣬<EFBFBD><EAA3AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɾ<EFBFBD><C9BE><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ʹ<EFBFBD><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>LOS_MOD_MUX <20><>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ǻ<EFBFBD><C7BB><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD>飬0x05 <20>Ǹô<C7B8><C3B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڸ<EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>еľ<D0B5><C4BE><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>*/
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: A thread locks a mutex after waiting for the mutex to be unlocked by another thread
|
|
|
* when the task scheduling is disabled.
|
|
|
*
|
|
|
* Value: 0x02001d06.
|
|
|
*
|
|
|
* Solution: Check whether the task scheduling is disabled, or set timeout to 0, which means that the
|
|
|
* thread will not wait for the mutex to become available.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_PEND_IN_LOCK LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x06)
|
|
|
/*<2A><><EFBFBD>δ<EFBFBD><CEB4>붨<EFBFBD><EBB6A8><EFBFBD><EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD>Ϊ LOS_ERRNO_MUX_PEND_IN_LOCK <20>ĺ꣬<C4BA><EAA3AC><EFBFBD>ڱ<EFBFBD>ʾ<EFBFBD>ڻ<EFBFBD><DABB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϵȴ<CFB5>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD>롣
|
|
|
|
|
|
LOS_ERRNO_OS_ERROR <20><>һ<EFBFBD><D2BB><EFBFBD>꣬<EFBFBD><EAA3AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɾ<EFBFBD><C9BE><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ʹ<EFBFBD><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>LOS_MOD_MUX <20><>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ǻ<EFBFBD><C7BB><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD>飬0x06 <20>Ǹô<C7B8><C3B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڸ<EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>еľ<D0B5><C4BE><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>*/
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: The mutex locking times out.
|
|
|
*
|
|
|
* Value: 0x02001d07.
|
|
|
*
|
|
|
* Solution: Increase the waiting time or set the waiting time to LOS_WAIT_FOREVER (forever-blocking mode).
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_TIMEOUT LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x07)
|
|
|
//LOS_ERRNO_OS_ERROR <20><>һ<EFBFBD><D2BB><EFBFBD>꣬<EFBFBD><EAA3AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɾ<EFBFBD><C9BE><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ʹ<EFBFBD><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><C4B4><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>LOS_MOD_MUX <20><>ʾ<EFBFBD><CABE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>ǻ<EFBFBD><C7BB><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD>飬0x07 <20>Ǹô<C7B8><C3B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڸ<EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>еľ<D0B5><C4BE><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* The error code is not in use temporarily.
|
|
|
*
|
|
|
* Value: 0x02001d08
|
|
|
* @deprecated This error code is obsolete since LiteOS 5.0.0.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_OVERFLOW LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x08)
|
|
|
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: The mutex to be deleted is being locked.
|
|
|
*
|
|
|
* Value: 0x02001d09.
|
|
|
*
|
|
|
* Solution: Delete the mutex after it is unlocked.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_PENDED LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x09)
|
|
|
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* The error code is not in use temporarily.
|
|
|
*
|
|
|
* Value: 0x02001d0A
|
|
|
* @deprecated This error code is obsolete since LiteOS 5.0.0.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_GET_COUNT_ERR LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x0A)
|
|
|
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* The error code is not in use temporarily.
|
|
|
*
|
|
|
* Value: 0x02001d0B
|
|
|
* @deprecated This error code is obsolete since LiteOS 5.0.0.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_REG_ERROR LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x0B)
|
|
|
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* Mutex error code: The mutex is being locked in system-level task.
|
|
|
* old usage: The mutex is being locked in software timer task(LOS_ERRNO_MUX_PEND_IN_SWTMR_TSK).
|
|
|
*
|
|
|
* Value: 0x02001d0C.
|
|
|
*
|
|
|
* Solution: Pend the mutex in a vailid task.
|
|
|
* @deprecated This error code is obsolete since LiteOS 5.0.0.
|
|
|
*/
|
|
|
#define LOS_ERRNO_MUX_PEND_IN_SYSTEM_TASK LOS_ERRNO_OS_ERROR(LOS_MOD_MUX, 0x0C)
|
|
|
/*<2A><><EFBFBD><EFBFBD> LOS_ERRNO_OS_ERROR <20><>һ<EFBFBD><D2BB><EFBFBD>꺯<EFBFBD><EABAAF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɴ<EFBFBD><C9B4><EFBFBD><EFBFBD>롣<EFBFBD>ú꺯<C3BA><EABAAF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><C4A3><EFBFBD>źʹ<C5BA><CDB4><EFBFBD><EFBFBD>롣<EFBFBD><EBA1A3><EFBFBD><EFBFBD><EFBFBD>ģ<EFA3AC><C4A3><EFBFBD><EFBFBD>Ϊ LOS_MOD_MUX<55><58><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϊ 0x0C<30><43>
|
|
|
|
|
|
ͨ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>궨<EFBFBD>壬<EFBFBD><EFBFBD><EFBFBD>Է<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʶ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϵͳ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʹ<EFBFBD>û<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ź<EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ĵ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>*/
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* @brief Create a mutex.
|
|
|
*
|
|
|
* @par Description:
|
|
|
* This API is used to create a mutex. A mutex handle is assigned to muxHandle when the mutex is created successfully.
|
|
|
* Return #LOS_OK when creating is successful, return specific error code otherwise.
|
|
|
* @attention
|
|
|
* The total number of mutexes is pre-configured. If there are no available mutexes, the mutex creation will fail.
|
|
|
*
|
|
|
* @param muxHandle [OUT] Handle pointer of the successfully created mutex. The value of handle should be in
|
|
|
* [0, LOSCFG_BASE_IPC_MUX_LIMIT - 1].
|
|
|
*
|
|
|
* @retval #LOS_ERRNO_MUX_PTR_NULL The muxHandle pointer is NULL.
|
|
|
* @retval #LOS_ERRNO_MUX_ALL_BUSY No available mutex.
|
|
|
* @retval #LOS_OK The mutex is successfully created.
|
|
|
* @par Dependency:
|
|
|
* <ul><li>los_mux.h: the header file that contains the API declaration.</li></ul>
|
|
|
* @see LOS_MuxDelete
|
|
|
* @since Huawei LiteOS V100R001C00
|
|
|
*/
|
|
|
extern UINT32 LOS_MuxCreate(UINT32 *muxHandle);
|
|
|
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* @brief Delete a mutex.
|
|
|
*
|
|
|
* @par Description:
|
|
|
* This API is used to delete a specified mutex. Return LOS_OK if the mutex deletion is successfully,
|
|
|
* otherwise return specific error code.
|
|
|
* @attention
|
|
|
* <ul>
|
|
|
* <li>The specific mutex should be created firstly.</li>
|
|
|
* <li>The mutex can be deleted successfully only when there is no other tasks pend on it.</li>
|
|
|
* </ul>
|
|
|
*
|
|
|
* @param muxHandle [IN] The mutex handle to be deleted. The value of handle should be in
|
|
|
* [0, LOSCFG_BASE_IPC_MUX_LIMIT - 1].
|
|
|
*
|
|
|
* @retval #LOS_ERRNO_MUX_INVALID Invalid handle or mutex in use.
|
|
|
* @retval #LOS_ERRNO_MUX_PENDED Tasks pended on this mutex.
|
|
|
* @retval #LOS_OK The mutex is successfully deleted.
|
|
|
* @par Dependency:
|
|
|
* <ul><li>los_mux.h: the header file that contains the API declaration.</li></ul>
|
|
|
* @see LOS_MuxCreate
|
|
|
* @since Huawei LiteOS V100R001C00
|
|
|
*/
|
|
|
extern UINT32 LOS_MuxDelete(UINT32 muxHandle);
|
|
|
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* @brief Wait to lock a mutex.
|
|
|
*
|
|
|
* @par Description:
|
|
|
* This API is used to wait for a specified period of time to lock a mutex.
|
|
|
* @attention
|
|
|
* <ul>
|
|
|
* <li>The specific mutex should be created firstly.</li>
|
|
|
* <li>The function fails if the mutex that is waited on is already locked by another thread when the task scheduling
|
|
|
* is disabled.</li>
|
|
|
* <li>Do not wait on a mutex during an interrupt.</li>
|
|
|
* <li>The priority inheritance protocol is supported. If a higher-priority thread is waiting on a mutex, it changes
|
|
|
* the priority of the thread that owns the mutex to avoid priority inversion.</li>
|
|
|
* <li>A recursive mutex can be locked more than once by the same thread.</li>
|
|
|
* <li>Do not recommend to use this API in software timer callback. </li>
|
|
|
* </ul>
|
|
|
*
|
|
|
* @param muxHandle [IN] The mutex handle to be waited for. The value of handle should be
|
|
|
* in [0, LOSCFG_BASE_IPC_MUX_LIMIT - 1].
|
|
|
* @param timeout [IN] Waiting time. The value range is [0, LOS_WAIT_FOREVER](unit: Tick).
|
|
|
*
|
|
|
* @retval #LOS_ERRNO_MUX_INVALID The mutex state (for example, the mutex does not exist or is not in use)
|
|
|
* is not applicable for the current operation.
|
|
|
* @retval #LOS_ERRNO_MUX_UNAVAILABLE The mutex fails to be locked because it is locked by another thread and
|
|
|
* a period of time is not set for waiting for the mutex to become available.
|
|
|
* @retval #LOS_ERRNO_MUX_PEND_INTERR The mutex is being locked during an interrupt.
|
|
|
* @retval #LOS_ERRNO_MUX_PEND_IN_LOCK The mutex is waited on when the task scheduling is disabled.
|
|
|
* @retval #LOS_ERRNO_MUX_TIMEOUT The mutex waiting times out.
|
|
|
* @retval #LOS_OK The mutex is successfully locked.
|
|
|
* @par Dependency:
|
|
|
* <ul><li>los_mux.h: the header file that contains the API declaration.</li></ul>
|
|
|
* @see LOS_MuxCreate | LOS_MuxPost
|
|
|
* @since Huawei LiteOS V100R001C00
|
|
|
*/
|
|
|
extern UINT32 LOS_MuxPend(UINT32 muxHandle, UINT32 timeout);
|
|
|
/*<2A><><EFBFBD><EFBFBD>˵<EFBFBD><CBB5><EFBFBD><EFBFBD>
|
|
|
|
|
|
muxHandle<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ź<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ź<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɹ<EFBFBD><EFBFBD>ص<EFBFBD>ֵ<EFBFBD><EFBFBD>
|
|
|
timeout<EFBFBD><EFBFBD><EFBFBD>ȴ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ź<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ij<EFBFBD>ʱʱ<EFBFBD>䣬<EFBFBD><EFBFBD>λΪϵͳʱ<EFBFBD>ӽ<EFBFBD><EFBFBD>ġ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϊ0<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʾ<EFBFBD><EFBFBD><EFBFBD>õȴ<EFBFBD><EFBFBD><EFBFBD>
|
|
|
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ֵ˵<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
|
|
|
|
|
|
<EFBFBD><EFBFBD><EFBFBD><EFBFBD> LOS_OK <20><>ʾ<EFBFBD>ɹ<EFBFBD><C9B9><EFBFBD>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD>ź<EFBFBD><C5BA><EFBFBD><EFBFBD><EFBFBD>
|
|
|
<EFBFBD><EFBFBD><EFBFBD>ش<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʾ<EFBFBD><EFBFBD>ȡ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ź<EFBFBD><EFBFBD><EFBFBD>ʧ<EFBFBD>ܣ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڴ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>IJ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ч<EFBFBD><EFBFBD><EFBFBD>߳<EFBFBD>ʱ<EFBFBD><EFBFBD>ԭ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>¡<EFBFBD>*/
|
|
|
/**
|
|
|
* @ingroup los_mux
|
|
|
* @brief Release a mutex.
|
|
|
*
|
|
|
* @par Description:
|
|
|
* This API is used to release a specified mutex.
|
|
|
* @attention
|
|
|
* <ul>
|
|
|
* <li>The specific mutex should be created firstly.</li>
|
|
|
* <li>Do not release a mutex during an interrupt.</li>
|
|
|
* <li>If a recursive mutex is locked for many times, it must be unlocked for the same times to be released.</li>
|
|
|
* </ul>
|
|
|
*
|
|
|
* @param muxHandle [IN] The mutex handle to be released. The value of handle should be in
|
|
|
* [0, LOSCFG_BASE_IPC_MUX_LIMIT - 1].
|
|
|
*
|
|
|
* @retval #LOS_ERRNO_MUX_INVALID The mutex state (for example, the mutex does not exist or is not in use
|
|
|
* or owned by other thread) is not applicable for the current operation.
|
|
|
* @retval #LOS_ERRNO_MUX_PEND_INTERR The mutex is being released during an interrupt.
|
|
|
* @retval #LOS_OK The mutex is successfully released.
|
|
|
* @par Dependency:
|
|
|
* <ul><li>los_mux.h: the header file that contains the API declaration.</li></ul>
|
|
|
* @see LOS_MuxCreate | LOS_MuxPend
|
|
|
* @since Huawei LiteOS V100R001C00
|
|
|
*/
|
|
|
extern UINT32 LOS_MuxPost(UINT32 muxHandle);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
#if __cplusplus
|
|
|
}
|
|
|
#endif
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
#endif /* _LOS_MUX_H */
|
