/******************************************************************************
* 文件名称: msg.c
* 内容摘要: 消息处理
* 创建者の: 孔佳伟
* 个人主页: https://gitee.com/thin-wind/jump
* 修改记录: 
******************************************************************************/


#include "msg.h"
#include <string.h>
#include <stdlib.h>


/******************************************************************************
* 函数名称: MESSAGE* MessageNew(uint16_t type, 
                                uint16_t cmd, 
                                uint16_t index, 
                                uint16_t total, 
                                const uint8_t* payload,
                                uint32_t length)
* 功能说明: 创建消息对象
* 输入参数: uint16_t        type              	--类型
    　　　　uint16_t        cmd                 --指令
    　　　　uint16_t        index               --数据包序号索引
    　　　　uint16_t        total               --数据总包数
    　　　　const uint8_t*  payload             --数据区首地址
    　　　　uint32_t        length              --数据长度
* 输出参数: 无
* 函数返回: 无
* 其它说明: 无
******************************************************************************/
MESSAGE* MessageNew(uint16_t type, 
                    uint16_t cmd, 
                    uint16_t index, 
                    uint16_t total, 
                    const uint8_t* payload,
                    uint32_t length)
{
    MESSAGE* msg = malloc(sizeof(MESSAGE) + length);
    if(NULL == msg)
        return NULL;
    if(NULL == payload)
        return NULL;

    msg->type   = type;
    msg->cmd    = cmd;
    msg->index  = index;
    msg->total  = total;
    msg->length = length;
    
    // msg 是 MESSAGE 类型的，msg+1 则指向 msg->payload，注意柔性数组本身并不占用内存空间
    if(NULL != payload)
        memcpy(msg + 1, payload, length);

    return msg;
}