#ifndef BSP_RC_H
#define BSP_RC_H

#include "struct_typedef.h"
#include "main.h"

#define DEVICE_USART_CNT 3     // C板至多分配3个串口
#define USART_RXBUFF_LIMIT 128 // if your protocol needs bigger buff, modify here

/* application callback,which resolves specific protocol,解析协议的回调函数 */
typedef void (*usart_module_callback)();

/* usart_instance struct,each app would have one instance */
typedef struct
{
    uint8_t recv_buff[USART_RXBUFF_LIMIT]; // 预先定义的最大buff大小,如果太小请修改USART_RXBUFF_LIMIT
    uint8_t recv_buff_size;                // 模块接收一包数据的大小
    UART_HandleTypeDef *usart_handle;      // 实例对应的usart_handle
    usart_module_callback module_callback; // 解析收到的数据的回调函数
} usart_instance;

/**
 * @brief 注册一个串口实例.
 *
 * @param _instance 传入一个由module拥有的串口实例,注意在传入前进行基本信息的配置,详见usart_instance的struct定义
 */
void USARTRegister(usart_instance *_instance);

/**
 * @todo 是否需要进一步封装发送buff和size,并创建一个串口任务以一定频率自动发送?
 *       若采用此方法,则串口实例的拥有者仅需要在自己的任务中设置发送值,不需要关心发送buffer大小以及何时发送.
 *
 * @brief api for sending data through a specific serial port,indicated by the first parameter:id
 *        通过调用该函数可以发送一帧数据,需要传入一个usart实例,发送buff以及这一帧的长度
 *
 * @param id specify which usart would be used
 * @param send_size how many bytes to send
 */
void USARTSend(usart_instance *_instance, uint8_t *send_buf, uint16_t send_size);

#endif
