#ifndef VTK_FRAME_H
#define VTK_FRAME_H

#include "publicdata/public_define.h"

#if (POS_VTK_EN)

#ifdef __cplusplus
extern "C" {
#endif

#include "main.h"

/* VTK 基础协议号（串口模式） */
#define VTK_PD_VMC_TO_POS   ((U16_T)0x96FB)  /* CCU(VMC) → POS */
#define VTK_PD_POS_TO_VMC   ((U16_T)0x97FB)  /* POS → CCU(VMC) */

/* 串口帧相关常量 */
#define VTK_FRAME_START_BYTE    ((U8_T)0x1F)
#define VTK_MAX_APP_LEN         ((U16_T)512)
#define VTK_MAX_FRAME_LEN       ((U16_T)(1 + 2 + 2 + VTK_MAX_APP_LEN + 2)) /* Start + Len + PD + App + CRC */

typedef struct
{
    U16_T protoDisc;       /* 协议号：VTK_PD_VMC_TO_POS / VTK_PD_POS_TO_VMC */
    const U8_T *pApp;      /* 指向应用层 TLV 数据起始地址 */
    U16_T appLen;          /* 应用层 TLV 数据长度 */
} VTK_FRAME_INFO_T;

/* 串口帧打包：把 TLV 应用数据封装为完整 VTK 串口帧
 * @param[in]  pApp      应用层 TLV 数据指针
 * @param[in]  appLen    应用层 TLV 数据长度
 * @param[in]  protoDisc 协议号（通常为 VTK_PD_VMC_TO_POS）
 * @param[out] pOut      输出缓冲区
 * @param[in]  outMax    输出缓冲区大小
 * @return     U16_T     串口帧总长度；0 表示失败（缓冲区不足等）
 */
U16_T vtk_build_frame(const U8_T *pApp, U16_T appLen, U16_T protoDisc,
                      U8_T *pOut, U16_T outMax);

/* 串口帧解析：对一整帧（含 0x1F 起始和 CRC）做合法性校验，并给出应用层 TLV 区段
 * @param[in]  pFrame    输入帧缓冲区
 * @param[in]  frameLen  输入帧长度
 * @param[out] pInfo     输出解析结果（协议号、应用层指针与长度）
 * @return     U8_T      1=解析成功且 CRC 正确，0=失败
 */
U8_T vtk_parse_frame(const U8_T *pFrame, U16_T frameLen, VTK_FRAME_INFO_T *pInfo);

/* 流式解析器：用于从串口逐字节接收数据并拼出完整 VTK 帧 */
typedef enum
{
    VTK_PARSE_WAIT_START = 0,
    VTK_PARSE_LEN_H,
    VTK_PARSE_LEN_L,
    VTK_PARSE_BODY,
    VTK_PARSE_CRC_H,
    VTK_PARSE_CRC_L
} VTK_PARSE_STATE_E;

typedef struct
{
    VTK_PARSE_STATE_E state;
    U16_T lengthField;                 /* Length 字段值（Protocol Disc + App 长度） */
    U16_T index;                       /* 当前已接收字节数 */
    U16_T totalLen;                    /* 预期整帧长度（含起始和 CRC） */
    U8_T  buf[VTK_MAX_FRAME_LEN];      /* 内部缓冲区 */
} VTK_FRAME_PARSER_T;

/* 初始化帧解析器 */
void vtk_frame_parser_init(VTK_FRAME_PARSER_T *parser);

/* 向帧解析器输入 1 字节
 * @param[in,out] parser   解析器状态
 * @param[in]     byte     串口接收到的 1 字节
 * @param[out]    ppFrame  当返回 1 时，指向完整帧起始地址（内部缓冲区）
 * @param[out]    pLen     当返回 1 时，给出完整帧长度
 * @return        U8_T     1=拼出完整合法帧；0=尚未完成或校验失败
 */
U8_T vtk_frame_parser_input(VTK_FRAME_PARSER_T *parser, U8_T byte,
                            const U8_T **ppFrame, U16_T *pLen);

/* 使用示例（发送 + 接收）：
 *
 *  // 发送侧：构造一帧带 TLV 的 VTK 串口报文并通过 UART 发送
 *  U8_T  tlvBuf[VTK_MAX_APP_LEN];
 *  U16_T tlvLen = 0;
 *  U8_T  frameBuf[VTK_MAX_FRAME_LEN];
 *  U16_T frameLen;
 *
 *  // 追加 TLV 参数，例如 MessageName(Tag=0x01)="CDP"
 *  vtk_tlv_append_ascii(0x01, "CDP", tlvBuf, sizeof(tlvBuf), &tlvLen);
 *  // 追加 OperationNo(Tag=0x03)="12345"
 *  vtk_tlv_append_ascii_uint(0x03, 12345, 1, tlvBuf, sizeof(tlvBuf), &tlvLen);
 *  // 追加 Amount(Tag=0x04)="5000"
 *  vtk_tlv_append_ascii_uint(0x04, 5000, 1, tlvBuf, sizeof(tlvBuf), &tlvLen);
 *
 *  // 封装为串口帧并发送
 *  frameLen = vtk_build_frame(tlvBuf, tlvLen, VTK_PD_VMC_TO_POS,
 *                             frameBuf, sizeof(frameBuf));
 *  if (frameLen > 0U)
 *  {
 *      POS_VTK_UART_SEND(frameBuf, frameLen);  // 由上层实现的串口发送函数
 *  }
 *
 *  // 接收侧：在 UART 接收中断/任务中逐字节喂入解析器
 *  static VTK_FRAME_PARSER_T s_parser;
 *  static U8_T parserInited = 0;
 *
 *  if (!parserInited)
 *  {
 *      vtk_frame_parser_init(&s_parser);
 *      parserInited = 1;
 *  }
 *
 *  void UART_Rx_Handler_Byte(U8_T rxByte)
 *  {
 *      const U8_T *pFrame;
 *      U16_T frameLen;
 *
 *      if (vtk_frame_parser_input(&s_parser, rxByte, &pFrame, &frameLen))
 *      {
 *          // 这里获得了一整帧 VTK 报文，可继续调用 vtk_parse_frame / vtk_parse_payment_response 解析
 *      }
 *  }
 */

#ifdef __cplusplus
}
#endif

#endif /* POS_VTK_EN */

#endif /* VTK_FRAME_H */