mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
108 lines
3.7 KiB
C
108 lines
3.7 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2015-2021 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
|
|
/*****************************************************************************
|
|
*
|
|
* Filename: btc/btc_sm.h
|
|
*
|
|
* Description: Generic BTC state machine API
|
|
*
|
|
*****************************************************************************/
|
|
|
|
#ifndef __BTC_SM_H__
|
|
#define __BTC_SM_H__
|
|
|
|
/*****************************************************************************
|
|
** Constants & Macros
|
|
******************************************************************************/
|
|
|
|
/* Generic Enter/Exit state machine events */
|
|
#define BTC_SM_ENTER_EVT 0xFFFF
|
|
#define BTC_SM_EXIT_EVT 0xFFFE
|
|
|
|
|
|
/*****************************************************************************
|
|
** Type definitions and return values
|
|
******************************************************************************/
|
|
typedef UINT32 btc_sm_state_t;
|
|
typedef UINT32 btc_sm_event_t;
|
|
typedef void *btc_sm_handle_t;
|
|
typedef BOOLEAN (* btc_sm_handler_t)(btc_sm_event_t event, void *data);
|
|
|
|
|
|
/*****************************************************************************
|
|
** Functions
|
|
**
|
|
** NOTE: THESE APIs SHOULD BE INVOKED ONLY IN THE BTC CONTEXT
|
|
**
|
|
******************************************************************************/
|
|
|
|
/*****************************************************************************
|
|
**
|
|
** Function btc_sm_init
|
|
**
|
|
** Description Initializes the state machine with the state handlers
|
|
** The caller should ensure that the table and the corresponding
|
|
** states match. The location that 'p_handlers' points to shall
|
|
** be available until the btc_sm_shutdown API is invoked.
|
|
**
|
|
** Returns Returns a pointer to the initialized state machine handle.
|
|
**
|
|
******************************************************************************/
|
|
btc_sm_handle_t btc_sm_init(const btc_sm_handler_t *p_handlers,
|
|
btc_sm_state_t initial_state);
|
|
|
|
/*****************************************************************************
|
|
**
|
|
** Function btc_sm_shutdown
|
|
**
|
|
** Description Tears down the state machine
|
|
**
|
|
** Returns None
|
|
**
|
|
******************************************************************************/
|
|
void btc_sm_shutdown(btc_sm_handle_t handle);
|
|
|
|
/*****************************************************************************
|
|
**
|
|
** Function btc_sm_get_state
|
|
**
|
|
** Description Fetches the current state of the state machine
|
|
**
|
|
** Returns Current state
|
|
**
|
|
******************************************************************************/
|
|
btc_sm_state_t btc_sm_get_state(btc_sm_handle_t handle);
|
|
|
|
/*****************************************************************************
|
|
**
|
|
** Function btc_sm_dispatch
|
|
**
|
|
** Description Dispatches the 'event' along with 'data' to the current state handler
|
|
**
|
|
** Returns Returns BT_STATUS_OK on success, BT_STATUS_FAIL otherwise
|
|
**
|
|
******************************************************************************/
|
|
bt_status_t btc_sm_dispatch(btc_sm_handle_t handle, btc_sm_event_t event,
|
|
void *data);
|
|
|
|
/*****************************************************************************
|
|
**
|
|
** Function btc_sm_change_state
|
|
**
|
|
** Description Make a transition to the new 'state'. The 'BTC_SM_EXIT_EVT'
|
|
** shall be invoked before exiting the current state. The
|
|
** 'BTC_SM_ENTER_EVT' shall be invoked before entering the new state
|
|
**
|
|
**
|
|
** Returns Returns BT_STATUS_OK on success, BT_STATUS_FAIL otherwise
|
|
**
|
|
******************************************************************************/
|
|
bt_status_t btc_sm_change_state(btc_sm_handle_t handle, btc_sm_state_t state);
|
|
|
|
#endif /* __BTC_SM_H__ */
|