116 lines
2.8 KiB
C
116 lines
2.8 KiB
C
/**
|
||
******************************************************************************
|
||
* @file rf433_tx_app.h
|
||
* @brief RF433 TX应用层接口
|
||
******************************************************************************
|
||
*/
|
||
|
||
#ifndef __RF433_TX_APP_H__
|
||
#define __RF433_TX_APP_H__
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#include "rf433.h"
|
||
#include <stdint.h>
|
||
#include <stdbool.h>
|
||
|
||
/* ============================================================================
|
||
* 数据类型定义
|
||
* ============================================================================ */
|
||
|
||
/**
|
||
* @brief TX状态机状态
|
||
*/
|
||
typedef enum {
|
||
TX_STATE_INIT = 0, /**< 初始化状态 */
|
||
TX_STATE_SENDING, /**< 发送中状态 */
|
||
TX_STATE_WAITING, /**< 等待状态 */
|
||
TX_STATE_IDLE, /**< 空闲状态 */
|
||
} tx_state_t;
|
||
|
||
/**
|
||
* @brief TX应用结构体
|
||
*/
|
||
typedef struct {
|
||
tx_state_t state; /**< 当前状态 */
|
||
uint32_t send_count; /**< 已发送次数 */
|
||
uint32_t total_count; /**< 总发送次数 */
|
||
uint32_t send_interval_ms; /**< 发送间隔(ms) */
|
||
uint32_t last_send_time; /**< 上次发送时间 */
|
||
rf433_register_t config; /**< RF433配置 */
|
||
bool is_running; /**< 是否正在运行 */
|
||
} rf433_tx_app_t;
|
||
|
||
/* ============================================================================
|
||
* API函数声明
|
||
* ============================================================================ */
|
||
|
||
/**
|
||
* @brief 初始化TX应用层
|
||
* @param config RF433配置参数
|
||
* @retval RF433_OK 成功
|
||
* @retval RF433_ERROR 参数错误
|
||
*/
|
||
rf433_error_t rf433_tx_app_init(const rf433_register_t *config);
|
||
|
||
/**
|
||
* @brief 启动TX自动发送
|
||
* @param count 总发送次数
|
||
* @param interval_ms 发送间隔(ms)
|
||
* @retval RF433_OK 成功
|
||
* @retval RF433_ERROR 参数错误
|
||
*/
|
||
rf433_error_t rf433_tx_app_start(uint32_t count, uint32_t interval_ms);
|
||
|
||
/**
|
||
* @brief 停止TX自动发送
|
||
* @retval RF433_OK 成功
|
||
*/
|
||
rf433_error_t rf433_tx_app_stop(void);
|
||
|
||
/**
|
||
* @brief 手动发送数据
|
||
* @param data 数据指针
|
||
* @param length 数据长度
|
||
* @retval RF433_OK 成功
|
||
* @retval RF433_ERROR 参数错误
|
||
* @retval RF433_ERROR_BUSY 模块忙
|
||
*/
|
||
rf433_error_t rf433_tx_app_manual_send(uint8_t *data, uint16_t length);
|
||
|
||
/**
|
||
* @brief TX任务函数（在主循环中调用）
|
||
*/
|
||
void rf433_tx_app_task(void);
|
||
|
||
/**
|
||
* @brief 获取TX状态
|
||
* @return 当前TX状态
|
||
*/
|
||
tx_state_t rf433_tx_app_get_state(void);
|
||
|
||
/**
|
||
* @brief 获取已发送次数
|
||
* @return 已发送次数
|
||
*/
|
||
uint32_t rf433_tx_app_get_send_count(void);
|
||
|
||
/**
|
||
* @brief 获取总发送次数
|
||
* @return 总发送次数
|
||
*/
|
||
uint32_t rf433_tx_app_get_total_count(void);
|
||
|
||
/**
|
||
* @brief 重置TX计数器
|
||
*/
|
||
void rf433_tx_app_reset_count(void);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* __RF433_TX_APP_H__ */
|