2013-01-22 11:41:06 +01:00
|
|
|
/*
|
|
|
|
* osal.h
|
|
|
|
*
|
|
|
|
* Created on: Jan 18, 2013
|
|
|
|
* Author: hathach
|
|
|
|
*/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Software License Agreement (BSD License)
|
2013-01-27 07:50:40 +01:00
|
|
|
* Copyright (c) 2013, hathach (tinyusb.net)
|
2013-01-22 11:41:06 +01:00
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* 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. The name of the author may not be used to endorse or promote products
|
|
|
|
* derived from this software without specific prior written permission.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.
|
|
|
|
*
|
|
|
|
* This file is part of the tiny usb stack.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/** \file
|
|
|
|
* \brief TBD
|
|
|
|
*
|
|
|
|
* \note TBD
|
|
|
|
*/
|
|
|
|
|
|
|
|
/** \ingroup TBD
|
|
|
|
* \defgroup TBD
|
|
|
|
* \brief TBD
|
|
|
|
*
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef _TUSB_OSAL_H_
|
|
|
|
#define _TUSB_OSAL_H_
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2013-01-30 05:35:37 +01:00
|
|
|
#include "tusb_option.h"
|
2013-01-22 11:41:06 +01:00
|
|
|
|
|
|
|
#define TUSB_OS_NONE 1
|
|
|
|
#define TUSB_OS_CMSIS 2
|
|
|
|
#define TUSB_OS_FREERTOS 3
|
|
|
|
#define TUSB_OS_UCOS 4
|
|
|
|
|
2013-01-30 06:55:44 +01:00
|
|
|
#ifndef _TEST_
|
|
|
|
|
2013-01-22 12:09:58 +01:00
|
|
|
#if TUSB_CFG_OS == TUSB_OS_NONE
|
|
|
|
#include "osal_none.h"
|
|
|
|
#else
|
|
|
|
#error TUSB_CFG_OS is not defined or OS is not supported yet
|
|
|
|
#endif
|
|
|
|
|
2013-01-30 06:55:44 +01:00
|
|
|
#else // OSAL API for cmock
|
|
|
|
|
|
|
|
#include "osal_common.h"
|
2013-01-22 11:41:06 +01:00
|
|
|
|
2013-02-01 04:33:43 +01:00
|
|
|
//------------- Tick -------------//
|
|
|
|
uint32_t osal_tick_get(void);
|
|
|
|
|
2013-02-26 11:28:05 +01:00
|
|
|
//--------------------------------------------------------------------+
|
|
|
|
// TASK API
|
|
|
|
//--------------------------------------------------------------------+
|
2013-01-31 07:11:50 +01:00
|
|
|
typedef uint32_t osal_task_t;
|
2013-02-26 11:28:05 +01:00
|
|
|
tusb_error_t osal_task_create(osal_task_t *task);
|
|
|
|
|
2013-01-31 07:11:50 +01:00
|
|
|
#define OSAL_TASK_DEF(name, code, stack_depth, prio) \
|
|
|
|
osal_task_t name
|
|
|
|
|
2013-02-26 11:28:05 +01:00
|
|
|
#define OSAL_TASK_DECLARE(task_name) \
|
|
|
|
void task_name(void)
|
|
|
|
|
2013-01-31 05:05:33 +01:00
|
|
|
#define OSAL_TASK_LOOP_BEGIN
|
|
|
|
#define OSAL_TASK_LOOP_END
|
2013-02-03 18:03:08 +01:00
|
|
|
|
2013-02-26 11:28:05 +01:00
|
|
|
//------------- Sub Task -------------//
|
|
|
|
#define OSAL_SUBTASK_INVOKED_AND_WAIT(subtask) TASK_ASSERT_STATUS(subtask)
|
2013-02-06 06:03:01 +01:00
|
|
|
|
2013-02-26 11:28:05 +01:00
|
|
|
#define TASK_RESTART
|
|
|
|
|
|
|
|
#define OSAL_SUBTASK_BEGIN
|
|
|
|
#define OSAL_SUBTASK_END \
|
|
|
|
return TUSB_ERROR_NONE;
|
|
|
|
|
|
|
|
//------------- Task Assert -------------//
|
|
|
|
#define _TASK_ASSERT_ERROR_HANDLER(error, func_call)\
|
|
|
|
func_call; TASK_RESTART; return error
|
2013-02-03 18:03:08 +01:00
|
|
|
|
2013-02-02 09:36:20 +01:00
|
|
|
#define TASK_ASSERT_STATUS(sts) \
|
2013-02-26 11:28:05 +01:00
|
|
|
ASSERT_DEFINE_WITH_HANDLER(_TASK_ASSERT_ERROR_HANDLER, , tusb_error_t status = (tusb_error_t)(sts),\
|
|
|
|
TUSB_ERROR_NONE == status, (void) 0, "%s", TUSB_ErrorStr[status])
|
|
|
|
|
|
|
|
#define TASK_ASSERT_STATUS_WITH_HANDLER(sts, func_call) \
|
|
|
|
ASSERT_DEFINE_WITH_HANDLER(_TASK_ASSERT_ERROR_HANDLER, func_call, tusb_error_t status = (tusb_error_t)(sts),\
|
|
|
|
TUSB_ERROR_NONE == status, (void) 0, "%s", TUSB_ErrorStr[status])
|
2013-02-06 06:03:01 +01:00
|
|
|
|
2013-02-26 11:28:05 +01:00
|
|
|
#define TASK_ASSERT(condition) \
|
|
|
|
ASSERT_DEFINE_WITH_HANDLER(_TASK_ASSERT_ERROR_HANDLER, , ,\
|
2013-02-06 12:12:26 +01:00
|
|
|
condition, (void) 0, "%s", "evaluated to false")
|
|
|
|
|
2013-02-26 11:28:05 +01:00
|
|
|
#define TASK_ASSERT_WITH_HANDLER(condition, func_call) \
|
|
|
|
ASSERT_DEFINE_WITH_HANDLER(_TASK_ASSERT_ERROR_HANDLER, func_call, ,\
|
|
|
|
condition, (void) 0, "%s", "evaluated to false")
|
|
|
|
|
|
|
|
//------------- Sub Task Assert (like Task but return error) -------------//
|
|
|
|
#define _SUBTASK_ASSERT_ERROR_HANDLER(error, func_call)\
|
|
|
|
func_call; return error
|
|
|
|
|
|
|
|
#define SUBTASK_ASSERT_STATUS(sts) ASSERT_STATUS(sts)
|
|
|
|
|
|
|
|
#define SUBTASK_ASSERT_STATUS_WITH_HANDLER(sts, func_call) \
|
|
|
|
ASSERT_DEFINE_WITH_HANDLER(_SUBTASK_ASSERT_ERROR_HANDLER, func_call, tusb_error_t status = (tusb_error_t)(sts),\
|
|
|
|
TUSB_ERROR_NONE == status, status, "%s", TUSB_ErrorStr[status])
|
|
|
|
|
|
|
|
#define SUBTASK_ASSERT(condition) ASSERT(condition, TUSB_ERROR_OSAL_TASK_FAILED)
|
|
|
|
|
|
|
|
#define SUBTASK_ASSERT_WITH_HANDLER(condition, func_call) \
|
|
|
|
ASSERT_DEFINE_WITH_HANDLER(_SUBTASK_ASSERT_ERROR_HANDLER, func_call, ,\
|
|
|
|
condition, TUSB_ERROR_OSAL_TASK_FAILED, "%s", "evaluated to false")
|
2013-01-31 05:05:33 +01:00
|
|
|
|
|
|
|
|
2013-02-26 11:28:05 +01:00
|
|
|
//--------------------------------------------------------------------+
|
|
|
|
// Semaphore API
|
|
|
|
//--------------------------------------------------------------------+
|
2013-02-04 10:07:42 +01:00
|
|
|
typedef volatile uint32_t osal_semaphore_t;
|
2013-01-30 06:55:44 +01:00
|
|
|
typedef void* osal_semaphore_handle_t;
|
2013-02-04 10:07:42 +01:00
|
|
|
|
|
|
|
#define OSAL_SEM_DEF(name)\
|
|
|
|
osal_semaphore_t name
|
|
|
|
|
2013-01-30 06:55:44 +01:00
|
|
|
osal_semaphore_handle_t osal_semaphore_create(osal_semaphore_t * const sem);
|
2013-02-01 06:00:34 +01:00
|
|
|
void osal_semaphore_wait(osal_semaphore_handle_t const sem_hdl, uint32_t msec, tusb_error_t *p_error);
|
2013-01-30 06:55:44 +01:00
|
|
|
tusb_error_t osal_semaphore_post(osal_semaphore_handle_t const sem_hdl);
|
2013-01-30 05:35:37 +01:00
|
|
|
|
2013-02-26 11:28:05 +01:00
|
|
|
//--------------------------------------------------------------------+
|
|
|
|
// QUEUE API
|
|
|
|
//--------------------------------------------------------------------+
|
2013-01-30 06:55:44 +01:00
|
|
|
typedef uint32_t osal_queue_t;
|
|
|
|
typedef void* osal_queue_handle_t;
|
2013-01-31 07:11:50 +01:00
|
|
|
|
2013-02-04 10:07:42 +01:00
|
|
|
#define OSAL_QUEUE_DEF(name, queue_depth, type) \
|
2013-01-31 07:11:50 +01:00
|
|
|
osal_queue_t name
|
|
|
|
|
2013-02-01 04:33:43 +01:00
|
|
|
osal_queue_handle_t osal_queue_create (osal_queue_t *p_queue);
|
2013-02-01 06:00:34 +01:00
|
|
|
void osal_queue_receive (osal_queue_handle_t const queue_hdl, uint32_t *p_data, uint32_t msec, tusb_error_t *p_error);
|
2013-02-01 04:33:43 +01:00
|
|
|
tusb_error_t osal_queue_send (osal_queue_handle_t const queue_hdl, uint32_t data);
|
2013-01-30 05:35:37 +01:00
|
|
|
|
2013-02-27 14:58:11 +01:00
|
|
|
//--------------------------------------------------------------------+
|
|
|
|
// TICK API
|
|
|
|
//--------------------------------------------------------------------+
|
|
|
|
uint32_t osal_tick_get(void);
|
2013-01-30 06:55:44 +01:00
|
|
|
#endif
|
2013-01-22 11:41:06 +01:00
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif /* _TUSB_OSAL_H_ */
|
|
|
|
|
|
|
|
/** @} */
|