# genie_mesh_light_ctl **Repository Path**: yocop/genie_mesh_light_ctl ## Basic Information - **Project Name**: genie_mesh_light_ctl - **Description**: No description available - **Primary Language**: C - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2021-01-18 - **Last Updated**: 2025-04-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## 1.概述 `genie_mesh_light_ctl` 是可连接天猫精灵音箱，同时支持天猫精灵APP控制的灯应用示例，支持灯的开关、亮度、色温及场景模式的控制，同时支持基于PWM的渐变功能控制，会用到SIG Model与阿里巴巴Vendor Model。 ​ ## 2.编译 ### 2.1 编译TG7120B上运行的程序 ```bash cd solutions/genie_mesh_light_ctl/ make clean make ``` 生成固件： 完整的烧录固件：solutions/genie_mesh_light_ctl/generated/total_image.hexf OTA固件：solutions/genie_mesh_light_ctl/generated/fota.bin ### 2.2 编译TG7121B上运行的程序 ```bash cd solutions/genie_mesh_light_ctl/ make clean make SDK=sdk_chip_TG7121B ``` 生成固件： 完整的烧录固件：solutions/genie_mesh_light_ctl/generated/total_image.hex OTA固件：solutions/genie_mesh_light_ctl/generated/fota.bin ## 3.烧录 ### 3.1 烧录TG7120B 参考boards/TG7120B_evb/README.md中的烧录方法。 ### 3.2 烧录TG7121B 参考boards/TG7121B_evb/README.md中的烧录方法。 ## 4.启动 烧录完成之后按复位键或者重新上电，启动设备 TG7120B 调试串口默认波特率为256000，连接串口工具后串口会有打印输出 TG7121B 调试串口默认波特率为115200，默认无打印输出 ## 5.说明 ### 5.1 genie service 的接口调用说明 #### 5.1.1 初始化 函数名称：int genie_service_init(genie_service_ctx_t* p_ctx) 参数说明： 结构体genie_service_ctx_t的成员参数如下： | 参数名称 | 参数类型 | 功能说明 | 备注 | | --- | --- | --- | --- | | p_mesh_elem | structbt_mesh_elem | Element的地址 | | | mesh_elem_counts | uint8_t | Element的数目 | | | event_cb | user_event_cb | SDK上传给应用的事件 | 用户事件回调，系统初始化和复位通知及接收Mesh数据通知，另外还有定时事件和用户自定义串口透传数据通知 | | prov_timeout | uint32_t | 默认10分钟，超时之后进入静默广播状态 | 静默广播可以进行设备发现，但是不能直接配网 | | lpm_conf | genie_lpm_conf_t | 低功耗相关参数配置 | 低功耗相关，由宏定义CONFIG_PM_SLEEP开关该功能 | 结构体genie_lpm_conf_t的成员参数如下： | 参数名称 | 参数类型 | 功能说明 | 备注 | | --- | --- | --- | --- | | lpm_wakeup_io | uint8_t | 是否支持GPIO唤醒，0：不支持，>0：支持 | | | lpm_wakeup_io_config | genie_lpm_wakeup_io_t | 配置多个唤醒GPIO | 多键开关可以使用 | | lpm_wakeup_msg | uint8_t | 是否支持通过激活包属性唤醒，0：不支持，1：支持 | | | is_auto_enable | uint8_t | 上电之后是否自动进入低功耗状态 | 大于0自动进入低功耗 | | delay_sleep_time | uint32_t | 上电多久之后进入低功耗状态，默认是10秒 | | | sleep_ms | uint16_t | 低功耗睡眠时长 | GLP模式的时候1100ms | | wakeup_ms | uint16_t | 低功耗唤醒时长 | GLP模式的时候60ms | | genie_lpm_cb | genie_lpm_cb_t | 睡眠和唤醒状态通知用户的回调函数 | | #### 5.1.2 发送Mesh数据 SDK为Vendor Model的数据发送提供了两个API接口，一个需要element参数，另外一个不需要element参数，会直接使用primary element，两个函数的参数介绍如下： 函数名称：int genie_transport_send_model(genie_transport_model_param_t* p_vendor_msg) 参数说明： 结构体genie_transport_model_param_t的成员参数如下： | 参数名称 | 参数类型 | 功能说明 | 备注 | | --- | --- | --- | --- | | p_elem | struct bt_mesh_elem* | 指定发送数据的Element，主要是获取源地址 | | | p_model | struct bt_mesh_model* | 指定发送数据的model，主要是获取app key | | | result_cb | transport_result_cb | 发送结果回调给应用 | 发送超时或者发送成功（D3和CF消息不会执行回调） | | retry | uint8_t | 没有收到应答执行重发的次数，默认重发两次 | 如果是GLP设备默认重发五次 | | opid | uint8_t | opcode id，例如：0xD4 | 取3字节opcode的第一个字节 | | tid | uint8_t | 传输ID，通常传入值0，为0的时候SDK会自动生成TID | Mesh设备发送数据的TID从0x80到0xBF | | dst_addr | uint16_t | 数据目的地址 | | | retry_period | uint16_t | 重传的时间间隔 | | | len | uint16_t | 发送数据的长度 | | | data | uint8_t* | 发送数据的起始地址 | | 函数名称：int genie_transport_send_payload(genie_transport_payload_param_t* payload_param) 结构体genie_transport_payload_param_t的成员参数如下： | 参数名称 | 参数类型 | 功能说明 | 备注 | | --- | --- | --- | --- | | opid | uint8_t | opcode id，例如：0xD4 | 取3字节opcode的第一个字节 | | tid | uint8_t | 传输ID，通常传入值0，为0的时候SDK会自动生成TID | Mesh设备发送数据的TID从0x80到0xBF | | retry_cnt | uint8_t | 没有收到应答执行重发的次数，默认重发两次 | 如果是GLP设备默认重发五次 | | dst_addr | uint16_t | 数据目的地址 | | | p_payload | uint8_t* | 发送数据的起始地址 | | | payload_len | uint16_t | 发送数据的长度 | | | result_cb | transport_result_cb | 发送结果回调给应用 | 发送超时或者发送成功（D3和CF消息不会执行回调） | #### 5.1.3 接收Mesh数据 应用程序接收Mesh数据是通过初始化的时候注册的用户回调函数接收的，如下两个Event分别接收SIG Model的数据和Genie的Vendor Model的数据： - 接收SIG Model的数据： ```c case GENIE_EVT_SIG_MODEL_MSG: { 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; ``` - 接收Vendor Model的数据 ```c case GENIE_EVT_VENDOR_MODEL_MSG: { 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(%02X)", p_elem_state->element_id, p_msg->tid); (void)p_elem_state; } } break; ``` ### 5.2 主要串口命令说明 | 命令名称 | 命令说明 | 使用参考（示例） | | --- | --- | --- | | set_tt | 设备蓝牙Mesh设备三元组 | set_tt 5297793 0c51b11c6ec78b52b803b3bbaae64fba 486e704a5bf6 | | get_tt | 查看蓝牙Mesh设备三元组 | 无参数 | | get_info | 查看版本和MAC等信息 | 无参数 | | reboot | 系统重启 | 无参数 | | reset | 设备复位 | 无参数 | | mesg | 通过MESH发送数据 | mesg d4 1 f000 010203 | mesg命令参数说明： - 第一个参数d4就是indication发送，其他有D3、CE及CF等； - 第二个参数是发送模式和重发次数参数 - 0表示不重发 - 1-252表示重发次数 - 253表示使用payload的第一个字节作为时间间隔参数，单位是100ms，例如：mesg d4 253 f000 030201  表示300毫秒发一次0201，mesg d4 253 f000 1e0201是3秒一次0201 - 254表示收到回复或者发送超时就再次发送 - 255表示每秒自动发送一次 - 第三个参数是接收者地址，必须是四个字符如果设置为0000会使用音箱默认组播地址F000； - 第四个参数是发送的内容，例如010203就是发送0x01，0x02，0x03因此必须是偶数个0-f之间的字符； ### 5.3 宏定义说明 #### 5.3.1 灯功能相关宏定义 | 宏定义的名称 | 功能说明 | | --- | --- | | CONFIG_MESH_MODEL_GEN_ONOFF_SRV | 支持开关控制功能 | | CONFIG_MESH_MODEL_LIGHTNESS_SRV | 支持亮度控制功能 | | CONFIG_MESH_MODEL_CTL_SRV | 支持色温控制功能 | | CONFIG_MESH_MODEL_SCENE_SRV | 支持场景模式控制功能 | | CONFIG_MESH_MODEL_TRANS | 支持渐变控制功能 | #### 5.3.2 其他通用功能相关宏定义 | 宏定义的名称 | 功能说明 | | --- | --- | | CONFIG_BT_MESH_GATT_PROXY | 支持Proxy功能 | | CONFIG_BT_MESH_PB_GATT | 支持手机配网功能 | | CONFIG_BT_MESH_RELAY | 支持中继功能 | | CONFIG_GENIE_OTA | 支持手机OTA功能 | | CONFIG_GENIE_RESET_BY_REPEAT | 支持连续上电五次进入配网状态功能 | | CONFIG_BT_MESH_CTRL_RELAY | 启用Mesh Controlled Relay特性(用于多节点场景消减网络泛洪) | | CONFIG_BT_MESH_NPS_OPT | 启用Mesh网络性能优化特性(用于多节点场景组控操作状态同步要求） | | PROJECT_SW_VERSION | 配置版本号，OTA功能使用，int32数据类型 | | CONFIG_PM_SLEEP | 支持低功耗功能 | | CONFIG_GENIE_MESH_GLP | 支持GLP模式的低功耗功能 | | CONFIG_DEBUG | 支持BT_xxx日志输出 | | CONFIG_BT_DEBUG_LOG | 支持BT_DBG日志输出 | | MESH_DEBUG_PROV | 支持配网日志输出 | | MESH_DEBUG_TX | 支持Access层发送Mesh数据日志输出 | | MESH_DEBUG_RX | 支持Access层接收Mesh数据日志输出 | ### 5.4 其他参考文档 - [蓝牙mesh智能家居产品规范](https://help.aliyun.com/document_detail/173319.html?spm=a2c4g.11186623.6.694.77dc41f0KNwhT0) - [蓝牙设备属性表](https://help.aliyun.com/document_detail/173320.html?spm=a2c4g.11186623.6.694.51385ed8bpGvnn) - [蓝牙Mesh模组软件规范](https://help.aliyun.com/document_detail/173310.html?spm=a2c4g.11174283.6.689.2d197132x9Gqoi) - [蓝牙Mesh设备扩展协议](https://help.aliyun.com/document_detail/173311.html?spm=a2c4g.11186623.6.685.6e5c59eev3fdLS) - [蓝牙mesh设备开发FAQ](https://help.aliyun.com/document_detail/173313.html?spm=a2c4g.11186623.6.686.6fdb14262iF9B3)