/*******************************************************************************
* @file rsi_os_none.c
* @brief
*******************************************************************************
* # License
* <b>Copyright 2020 Silicon Laboratories Inc. www.silabs.com</b>
*******************************************************************************
*
* The licensor of this software is Silicon Laboratories Inc. Your use of this
* software is governed by the terms of Silicon Labs Master Software License
* Agreement (MSLA) available at
* www.silabs.com/about-us/legal/master-software-license-agreement. This
* software is distributed to you in Source Code format and is governed by the
* sections of the MSLA applicable to Source Code.
*
******************************************************************************/
#include <rsi_driver.h>
#ifndef RSI_WITH_OS
/*
Include files
*/
/*==============================================*/
rsi_reg_flags_t rsi_critical_section_entry(void)
{
rsi_reg_flags_t xflags;
// hold interrupt status before entering critical section
// disable interrupts
#ifdef RSI_M4_INTERFACE
xflags = NVIC_GetIRQEnable((IRQn_Type)M4_ISR_IRQ);
NVIC_DisableIRQ((IRQn_Type)M4_ISR_IRQ);
#else
xflags = rsi_hal_critical_section_entry();
#endif
// return stored interrupt status
return (xflags);
}
/*==============================================*/
void rsi_critical_section_exit(rsi_reg_flags_t xflags)
{
// restore interrupts while exiting critical section
if (xflags != 0) {
#ifdef RSI_M4_INTERFACE
// restore interrupts while exiting critical section
NVIC_EnableIRQ((IRQn_Type)M4_ISR_IRQ);
#else
rsi_hal_critical_section_exit();
#endif
}
}
/*==============================================*/
void *rsi_virtual_to_physical_address(void *virtual_address)
{
return (virtual_address);
}
/*==============================================*/
void *rsi_physical_to_virtual_address(void *physical_address)
{
return (physical_address);
}
/*==============================================*/
rsi_error_t rsi_mutex_create(rsi_mutex_handle_t *mutex)
{
/* Create dummy mutxe pointer because OS not present */
RSI_NO_OS_ATOMIC_MUTEX_SET(*mutex, RSI_NO_OS_MUTEX_UNLOCKED);
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_mutex_lock(volatile rsi_mutex_handle_t *mutex)
{
while (RSI_NO_OS_ATOMIC_MUTEX_CHECK(*mutex, RSI_NO_OS_MUTEX_LOCKED))
;
RSI_NO_OS_ATOMIC_MUTEX_SET(*mutex, RSI_NO_OS_MUTEX_LOCKED);
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_mutex_unlock(volatile rsi_mutex_handle_t *mutex)
{
RSI_NO_OS_ATOMIC_MUTEX_SET(*mutex, RSI_NO_OS_MUTEX_UNLOCKED);
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_mutex_destroy(rsi_mutex_handle_t *mutex)
{
UNUSED_PARAMETER(mutex); //This statement is added only to resolve compilation warning, value is unchanged
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_semaphore_create(rsi_semaphore_handle_t *semaphore, uint32_t count)
{
*semaphore = count;
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_semaphore_destroy(rsi_semaphore_handle_t *semaphore)
{
*semaphore = 0;
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_semaphore_check_and_destroy(rsi_semaphore_handle_t *semaphore)
{
if (rsi_semaphore_destroy(semaphore) != RSI_ERROR_NONE) {
return RSI_ERROR_SEMAPHORE_DESTROY_FAILED;
}
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_semaphore_wait(rsi_semaphore_handle_t *semaphore, uint32_t timeout_ms)
{
volatile uint32_t *event;
rsi_timer_instance_t timer_instance;
rsi_driver_cb_t *rsi_driver_cb = global_cb_p->rsi_driver_cb;
event = (uint32_t *)semaphore;
if (0UL != *event) {
RSI_ATOMIC_DECREMENT(*event);
return (RSI_ERROR_NONE);
}
if (0UL == timeout_ms) {
while (0UL == *event) {
// if any events pending
// call rsi schedular
rsi_scheduler(&rsi_driver_cb->scheduler_cb);
}
RSI_ATOMIC_DECREMENT(*event);
return (RSI_ERROR_NONE);
}
rsi_init_timer(&timer_instance, timeout_ms);
while ((0UL != timeout_ms) && (0UL == *event)) {
// if any events pending
// call rsi schedular
rsi_scheduler(&rsi_driver_cb->scheduler_cb);
if (rsi_timer_expired(&timer_instance)) {
break;
}
}
if (0UL == *event || (0UL == timeout_ms)) {
return (RSI_ERROR_TIMEOUT);
} else {
RSI_ATOMIC_DECREMENT(*event);
}
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_semaphore_post_from_isr(rsi_semaphore_handle_t *semaphore)
{
volatile uint32_t *event;
event = (uint32_t *)semaphore;
RSI_ATOMIC_INCREMENT(*event);
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_semaphore_post(rsi_semaphore_handle_t *semaphore)
{
volatile uint32_t *event;
event = (uint32_t *)semaphore;
RSI_ATOMIC_INCREMENT(*event);
return (RSI_ERROR_NONE);
}
/*==============================================*/
rsi_error_t rsi_semaphore_reset(rsi_semaphore_handle_t *semaphore)
{
volatile uint32_t *event;
event = (uint32_t *)semaphore;
*event = 0;
return (RSI_ERROR_NONE);
}
#endif
Functions#
rsi_reg_flags_t
void
rsi_critical_section_exit(rsi_reg_flags_t xflags)
void *
rsi_virtual_to_physical_address(void *virtual_address)
Map virtual address to physical address.
void *
rsi_physical_to_virtual_address(void *physical_address)
Map physical address to virtual address.
rsi_error_t
rsi_mutex_create(rsi_mutex_handle_t *mutex)
rsi_error_t
rsi_mutex_lock(volatile rsi_mutex_handle_t *mutex)
rsi_error_t
rsi_mutex_unlock(volatile rsi_mutex_handle_t *mutex)
rsi_error_t
rsi_mutex_destroy(rsi_mutex_handle_t *mutex)
rsi_error_t
rsi_semaphore_create(rsi_semaphore_handle_t *semaphore, uint32_t count)
rsi_error_t
rsi_semaphore_destroy(rsi_semaphore_handle_t *semaphore)
rsi_error_t
rsi_semaphore_check_and_destroy(rsi_semaphore_handle_t *semaphore)
Checks whether the semaphore is created and destroys the semaphore instance, if its created.
rsi_error_t
rsi_semaphore_wait(rsi_semaphore_handle_t *semaphore, uint32_t timeout_ms)
rsi_error_t
rsi_semaphore_post_from_isr(rsi_semaphore_handle_t *semaphore)
rsi_error_t
rsi_semaphore_post(rsi_semaphore_handle_t *semaphore)
rsi_error_t
rsi_semaphore_reset(rsi_semaphore_handle_t *semaphore)
Function Documentation#
rsi_critical_section_entry#
rsi_reg_flags_t rsi_critical_section_entry (void )
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| void | N/A |
rsi_critical_section_exit#
void rsi_critical_section_exit (rsi_reg_flags_t xflags)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_reg_flags_t | N/A | xflags |
rsi_virtual_to_physical_address#
void * rsi_virtual_to_physical_address (void * virtual_address)
Map virtual address to physical address.
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| void * | [in] | virtual_address | - pointer to virtual address |
Returns
void
rsi_physical_to_virtual_address#
void * rsi_physical_to_virtual_address (void * physical_address)
Map physical address to virtual address.
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| void * | [in] | physical_address | - pointer to physical_address |
Returns
void
rsi_mutex_create#
rsi_error_t rsi_mutex_create (rsi_mutex_handle_t * mutex)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_mutex_handle_t * | N/A | mutex |
Referenced by rsi_common_cb_init , and rsi_wlan_cb_init
rsi_mutex_lock#
rsi_error_t rsi_mutex_lock (volatile rsi_mutex_handle_t * mutex)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| volatile rsi_mutex_handle_t * | N/A | mutex |
Referenced by rsi_rx_event_handler , and rsi_tx_event_handler
rsi_mutex_unlock#
rsi_error_t rsi_mutex_unlock (volatile rsi_mutex_handle_t * mutex)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| volatile rsi_mutex_handle_t * | N/A | mutex |
Referenced by rsi_rx_event_handler , and rsi_tx_event_handler
rsi_mutex_destroy#
rsi_error_t rsi_mutex_destroy (rsi_mutex_handle_t * mutex)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_mutex_handle_t * | N/A | mutex |
rsi_semaphore_create#
rsi_error_t rsi_semaphore_create (rsi_semaphore_handle_t * semaphore, uint32_t count)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_semaphore_handle_t * | N/A | semaphore | |
| uint32_t | N/A | count |
Referenced by rsi_common_cb_init , and rsi_wlan_cb_init
rsi_semaphore_destroy#
rsi_error_t rsi_semaphore_destroy (rsi_semaphore_handle_t * semaphore)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_semaphore_handle_t * | N/A | semaphore |
Referenced by rsi_driver_deinit , and rsi_semaphore_check_and_destroy
rsi_semaphore_check_and_destroy#
rsi_error_t rsi_semaphore_check_and_destroy (rsi_semaphore_handle_t * semaphore)
Checks whether the semaphore is created and destroys the semaphore instance, if its created.
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_semaphore_handle_t * | [in] | semaphore | - Semaphore handle pointer |
Returns
0 - Success
Negative Value - Failure
rsi_semaphore_wait#
rsi_error_t rsi_semaphore_wait (rsi_semaphore_handle_t * semaphore, uint32_t timeout_ms)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_semaphore_handle_t * | N/A | semaphore | |
| uint32_t | N/A | timeout_ms |
References global_cb_s::rsi_driver_cb , rsi_init_timer , rsi_scheduler , rsi_timer_expired , and rsi_driver_cb_s::scheduler_cb
Referenced by rsi_req_wakeup , rsi_wait4wakeup , rsi_wait_on_common_semaphore , and rsi_wait_on_wlan_semaphore
rsi_semaphore_post_from_isr#
rsi_error_t rsi_semaphore_post_from_isr (rsi_semaphore_handle_t * semaphore)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_semaphore_handle_t * | N/A | semaphore |
rsi_semaphore_post#
rsi_error_t rsi_semaphore_post (rsi_semaphore_handle_t * semaphore)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_semaphore_handle_t * | N/A | semaphore |
Referenced by rsi_check_and_update_cmd_state , rsi_check_common_buffer_full , rsi_check_wlan_buffer_full , rsi_common_cb_init , rsi_driver_process_common_recv_cmd , rsi_driver_process_wlan_recv_cmd , rsi_handle_slp_wkp , rsi_post_waiting_bt_semaphore , rsi_post_waiting_common_semaphore , rsi_post_waiting_semaphore , rsi_post_waiting_wlan_semaphore , rsi_release_waiting_semaphore , rsi_wlan_cb_init , and rsi_wlan_packet_transfer_done
rsi_semaphore_reset#
rsi_error_t rsi_semaphore_reset (rsi_semaphore_handle_t * semaphore)
Parameters
| Type | Direction | Argument Name | Description |
|---|---|---|---|
| rsi_semaphore_handle_t * | N/A | semaphore |