基于TG7100B的Mesh灯应用固件说明

TG7100B概述

TG7100B是天猫精灵针对蓝牙Mesh接入定制的高性价比蓝牙芯片，具有极简的电路设计，优异的射频性能，低功耗，汽车级温宽范围（-40℃~125℃）等特点。TG7100B芯片相关文档和软件工具，请参见TG7100B。

固件编译与烧录

1. 下载SDK。获取下载地址，请参见获取SDK。注意需要下载TG7100B SDK V1.3.4版本。
2. 配置开发环境。详细介绍，请参见准备开发环境。
3. 编译固件。详细介绍，请参见开发设备固件。
   说明

   • 生成烧录文件：out/bluetooth.light_ctl@tg7100b/binary/total_image.hexf
   • 生成OTA文件：out/bluetooth.light_ctl@tg7100b/binary/fota.bin
4. 烧录固件。详细介绍，请参见烧录固件。
5. 烧录设备证书。
   • 断开烧写工具TG71XX Programmer.exe，并将开发板的拨码开关置于GND，并按下开发板上的reset键。
   • 打开串口调试工具SecureCRT，选择文件 > 快速连接，并如下图所示设置开发板串口的各参数，默认波特率为512000。
     说明 其中端口号与TG71XX Programmer.exe工具自动识别的串口号一致。您也可以右击我的电脑，选择管理 > 系统工具 > 设备管理器 > 端口（COM和LPT）来查看（不同系统下打开设备管理器的操作路径略有差异，请根据您电脑的实际路径操作）。
     
   • 单击连接。
   • 输入以下命令，烧录设备证书。

     set_tt <ProductID> <Device Secret> <Device Name>

     说明 该命令中Product id、Device Secret、Device Name（即MAC），三者为添加设备中生成的设备证书。

应用模型配置

Mesh Model的详细说明请参见蓝牙Mesh灯应用Mesh Model说明 。注意蓝牙Mesh SDK中的light_ctl应用示例仅实现了开关、亮度、色温和场景模式控制，固件中默认支持的物模型与Attribute Type如下表所示。

模型配置对应的代码在app/example/bluetooth/light_ctl/light_ctl.c文件中，如下。

/* 灯产品中的SIG通用模型定义 */
static struct bt_mesh_model primary_element[] = {
    BT_MESH_MODEL_CFG_SRV(),     /* 配置 Configuration Server */
    BT_MESH_MODEL_HEALTH_SRV(),  /* Health Server */

    MESH_MODEL_GEN_ONOFF_SRV(&light_elem_stat[0]),    /* 开关 Generic OnOff Server */
    MESH_MODEL_LIGHTNESS_SRV(&light_elem_stat[0]),    /* 亮度 Lightness Server */
    MESH_MODEL_CTL_SRV(&light_elem_stat[0]),          /* 色温 Light CTL Server */
    MESH_MODEL_SCENE_SRV(&light_elem_stat[0]),        /* 场景模式 Scene Server */
};
/* 厂商自定义模型定义 */
static struct bt_mesh_model primary_vendor_element[] = {
    MESH_MODEL_VENDOR_SRV(&light_elem_stat[0]),
};

/* 灯的主Element注册SIG通用模型和厂商自定义模型，其中GENIE_ADDR_LIGHT的定义为灯品类组播地址0xC000*/
struct bt_mesh_elem light_elements[] = {
    BT_MESH_ELEM(0, primary_element, primary_vendor_element, GENIE_ADDR_LIGHT),
};

应用层事件处理

应用层事件处理对应的代码在app/example/bluetooth/light_ctl/light_ctl.c文件中，如下。

static void light_ctl_event_handler(genie_event_e event, void *p_arg)
{
    switch (event)
    {
    case GENIE_EVT_SW_RESET:                            /* 软件复位 */
    {
        light_param_reset();
        light_led_blink(3, 1);
        aos_msleep(3000);
    }
    break;
    case GENIE_EVT_MESH_READY:                          /*Mesh协议栈Ready，可以收发数据*/
    {
        //User can report data to cloud at here
        GENIE_LOG_INFO("User report data");
        light_report_poweron_state(&light_elem_stat[0]);
    }
    break;
    case GENIE_EVT_SDK_MESH_PROV_SUCCESS:               /* 配网成功 */
    {
        light_led_blink(3, 0);                          /* 配网成功闪灯提示 */
    }
    break;
#ifdef CONFIG_MESH_MODEL_TRANS
    case GENIE_EVT_USER_TRANS_CYCLE:
#endif
    case GENIE_EVT_USER_ACTION_DONE:                    /* 灯效变化结束 */
    {
        sig_model_element_state_t *p_elem = (sig_model_element_state_t *)p_arg;
        light_update(p_elem);    
        if (event == GENIE_EVT_USER_ACTION_DONE)
        {
            light_save_state(p_elem);
        }
    }
    break;
    case GENIE_EVT_SIG_MODEL_MSG:                      /* 收到下行SIG Model 消息 */
    {
        sig_model_msg *p_msg = (sig_model_msg *)p_arg;

        if (p_msg)
        {
            GENIE_LOG_INFO("SIG mesg ElemID(%d)", p_msg->element_id);
        }
    }
    break;
    case GENIE_EVT_VENDOR_MODEL_MSG:                   /* 收到下行Vendor Model 消息 */
    {
        genie_transport_model_param_t *p_msg = (genie_transport_model_param_t *)p_arg;

        if (p_msg && p_msg->p_model && p_msg->p_model->user_data)
        {
            sig_model_element_state_t *p_elem_state = (sig_model_element_state_t *)p_msg->p_model->user_data;
            GENIE_LOG_INFO("ElemID(%d) TID(%d)", p_elem_state->element_id, p_msg->tid);
        }
    }
    break;
#ifdef CONFIG_GENIE_MESH_USER_CMD                     /* 用于实现用户自定义串口协议 */
    case GENIE_EVT_DOWN_MSG:
    {
        genie_down_msg_t *p_msg = (genie_down_msg_t *)p_arg;
        //User handle this msg,such as send to MCU    /* 在此处可以按自定义串口协议将数据转发给MCU */
        if (p_msg)
        {
        }
    }
    break;
#endif
#ifdef MESH_MODEL_VENDOR_TIMER
    case GENIE_EVT_TIMEOUT:                           /* TimerOnOff本地定时超时处理入口 */
    {
        vendor_attr_data_t *pdata = (vendor_attr_data_t *)p_arg;
        //User handle vendor timeout event at here
        if (pdata)
        {
            light_ctl_handle_order_msg(pdata);        /* 此处执行灯开关操作 */
        }
    }
    break;
#endif
    default:
        break;
            

串口命令说明

以下串口命令可以用于开发调试。

固件宏定义说明