simple generic level server demo¶

示例说明¶

示例功能简介
- 参考: 示例功能简介
如何运行示例代码
- 参考: 示例运行概要
如何设置 ble mesh 角色
- 参考: ble mesh 角色设置
如何处理 ble mesh 协议栈和应用协议栈的信息交互
- 参考: ble mesh 协议栈和应用协议栈的信息交互

示例功能简介¶

本示例功能主要实现 SIG 标准的 generic level server model，可以用于灯等设备模型。本示例实例化了两个 element，每个 element 包括一个 level server model，初始化部分可以参考examples 目录下 mesh_app.c 文件里面的 mesh_app_init_user函数说明，开发者可以非常容易添加更多的model。每个model初始化需要开发者初始化相关的控制接口，在例子程序中user_level_0_evt_cb，user_level_1_evt_cb分别作为两个开发者接口，通过控制灯的亮灭来进行示例。例子程序中的 generic_transition_server_0 和 generic_transition_server_1 两个 model 是设置 default transtion time,当发送的 ;level 命令中不带有 transition time 和 delay时。系统也会将关键事件通知到开发者，开发者完成自己的关键事件处理函数即可，参考user_config_server_evt_cb 函数的实现，并在初始化进行注册。另外，为了对系统进行控制，在element0 里面也初始化了SIG 的 config server model以便进行入网等相关的系统控制操作。

该示例主要体现的功能点如下：¶

设备支持mesh proxy，可以通过手机，经gatt连接快速配置入网。
节点上有两个generic level server，可以通过手机单独控制任一 server。
节点支持分组，可以分组控制。
节点支持relay可控，可以手动打开或关闭relay，便于部署。
节点支持proxy server beacon 可控，可以手动打开或关闭该beacon，便于部署。

示例运行概要¶

硬件环境¶

该示例运行在 BLE Dongle 开发板上（开发板的详细信息，参考硬件支持包），用到硬件外设如下：¶

按键

botton 3 button 4 同时按下，心跳灯会快闪，直到绿灯闪一下，设备重启并重新初始化，该操作会丢弃所有之前配置，设备变成unprovision 状态
PIN

PIN 7 8 短路： relay 功能打开，LED2 蓝灯亮

PIN 10 11短路：延迟一分钟后关闭proxy server beacon 功能打开，LED1红灯亮
指示灯
- led1 :
  - 绿灯
    
    熄灭，设备proxy server beacon 功能打开；
    
    常亮，设备proxy server beacon 功能关闭；
  - 蓝灯
    
    熄灭:
    
    generic level server 1 设置亮度的 level 值设置为0x8000；
    
    不同亮度:
    
    generic level server 1 设置亮度的 level 的值不同；
  - 红灯
    
    熄灭，保留；
    
    常亮，保留；
- led2 :
  - 绿灯
    
    闪烁，设备正常工作；
    
    常亮/长灭，设备异常；
  - 蓝灯
    
    熄灭， relay 功能关闭；
    
    常亮， relay 功能打开；
  - 红灯
    
    熄灭:
    
    generic level server **2* 设置亮度的 level 值设置为0x8000；
    
    不同亮度:
    
    generic level server **2* 设置亮度的 level 的值不同；

软件环境¶

设备端运行 ble mesh sdk 的 examples 目录下 simple_generic_level_server示例。
手机端运行任意厂商符合mesh标准的app。

软件运行流程¶

1. 用户自己函数入口

在 mesh_user_main.c 中， mesh_user_main_init()初始化自己数据。（需要注意：不能阻塞）

2. 开启mesh协议栈调度

在用户函数执行完后，系统自动开启ble协议栈调度。

3. 示例代码

void mesh_user_main_init(void)
{
    ///user data init
    simple_generic_level_server_init();

    LOG(LOG_LVL_INFO,"mesh_user_main_init\n");
}

例程初始状态¶

设备正常上电后：

led1 :
- 绿灯
  
  熄灭，设备proxy server beacon 功能默认打开；
- 蓝灯
  
  常亮， generic level server 1 默认设置打开亮度 level 为 50%,此时 level 的值为0；
- 红灯
  
  熄灭，保留；
led2 :
- 绿灯
  
  闪烁，设备正常工作；
- 蓝灯
  
  熄灭， relay 功能默认关闭；
- 红灯
  
  常亮， generic level server 2 默认设置打开亮度 level 为 50%,此时 level 的值为0；

ble mesh 角色设置¶

设置流程¶

static void user_role_init(void)
{
    //1.role init
    provision_init(MESH_ROLE_UNPROV_DEVICE,mesh_unprov_evt_cb);
    //2. data init
    unprov_data_init();
}

1. 定义协议栈内部事件通知回调函数

/* unprovision device event callback function */
static void mesh_unprov_evt_cb(mesh_prov_evt_type_t type , mesh_prov_evt_param_t param)
{
    LOG(LOG_LVL_INFO,"mesh_unprov_evt_cb type : %d\n",type);

    switch(type)
    {
        case  UNPROV_EVT_INVITE_MAKE_ATTENTION : //(NO ACTION)
        {

        }
        break;
        case  UNPROV_EVT_EXPOSE_PUBLIC_KEY :  //(NO ACTION)
        {

        }
        break;
        case  UNPROV_EVT_AUTH_INPUT_NUMBER : //alert input dialog
        {

        }
        break;
        case  UNPROV_EVT_AUTH_DISPLAY_NUMBER : //unprov_device expose random number //(NO ACTION)
        {

        }
        break;
        case  UNPROV_EVT_PROVISION_DONE :  //(NO ACTION)
        {

        }
        break;
        default:break;
    }
}

2. 设置角色，注册事件回调

provision_init(MESH_ROLE_UNPROV_DEVICE,mesh_unprov_evt_cb);

3. 初始化角色相关的数据

static void unprov_data_init(void)
{
    volatile mesh_prov_evt_param_t evt_param;

    uint8_t  bd_addr[GAP_BD_ADDR_LEN];

    //get bd_addr
    mesh_core_params_t core_param;
    core_param.mac_address = bd_addr;
    mesh_core_params_get(MESH_CORE_PARAM_MAC_ADDRESS,&core_param);

    //1. Method of configuring network access
    evt_param.unprov.method = PROVISION_BY_GATT;
    provision_config(UNPROV_SET_PROVISION_METHOD,evt_param);
    //2. private key
    memcpy(m_unprov_user.unprov_private_key,bd_addr,GAP_BD_ADDR_LEN);
    evt_param.unprov.p_unprov_private_key = m_unprov_user.unprov_private_key;
    provision_config(UNPROV_SET_PRIVATE_KEY,evt_param);
    //3.static auth value
    evt_param.unprov.p_static_val = m_unprov_user.static_value;
    provision_config(UNPROV_SET_AUTH_STATIC,evt_param);
    //4.dev_capabilities
    evt_param.unprov.p_dev_capabilities = &m_unprov_user.dev_capabilities;
    provision_config(UNPROV_SET_OOB_CAPS,evt_param);
    //5.adv beacon
    memcpy(m_unprov_user.beacon.dev_uuid,bd_addr,GAP_BD_ADDR_LEN);
    evt_param.unprov.p_beacon = &m_unprov_user.beacon;
    provision_config(UNPROV_SET_BEACON,evt_param);
}

4. 协议栈开始完整运行

监听协议栈事件。。。。

ble mesh 协议栈和应用协议栈的信息交互¶

实现消息交互的处理函数¶

/* unprovision device event callback function */
static void mesh_unprov_evt_cb(mesh_prov_evt_type_t type , mesh_prov_evt_param_t param)
{
    LOG(LOG_LVL_INFO,"mesh_unprov_evt_cb type : %d\n",type);

    switch(type)
    {
        case  UNPROV_EVT_INVITE_MAKE_ATTENTION : //(NO ACTION)
        {

        }
        break;
        case  UNPROV_EVT_EXPOSE_PUBLIC_KEY :  //(NO ACTION)
        {

        }
        break;
        case  UNPROV_EVT_AUTH_INPUT_NUMBER : //alert input dialog
        {

        }
        break;
        case  UNPROV_EVT_AUTH_DISPLAY_NUMBER : //unprov_device expose random number //(NO ACTION)
        {

        }
        break;
        case  UNPROV_EVT_PROVISION_DONE :  //(NO ACTION)
        {

        }
        break;
        default:break;
    }
}

根据收到的事件，做相应处理或回复¶

//协议->用户
typedef enum
{
    /*******PROVISIONER*******/
    PROV_EVT_BEACON,
    PROV_EVT_CAPABILITIES,
    PROV_EVT_READ_PEER_PUBLIC_KEY_OOB,
    PROV_EVT_AUTH_DISPLAY_NUMBER,//provisioner expose random number (NO ACTION)
    PROV_EVT_AUTH_INPUT_NUMBER,   //alert input dialog
    PROV_EVT_PROVISION_DONE,    //(NO ACTION)

    /*******UNPROV DEVICE*******/
    UNPROV_EVT_INVITE_MAKE_ATTENTION,//(NO ACTION)
    UNPROV_EVT_EXPOSE_PUBLIC_KEY, //(NO ACTION)
    UNPROV_EVT_AUTH_INPUT_NUMBER,//alert input dialog
    UNPROV_EVT_AUTH_DISPLAY_NUMBER,//unprov_device expose random number //(NO ACTION)
    UNPROV_EVT_PROVISION_DONE, //(NO ACTION)
} mesh_prov_evt_type_t;

//用户->协议栈（回复）
typedef enum
{
    /*******PROVISIONER*******/
    //PROV_EVT_AUTH_INPUT_NUMBER
    PROV_ACTION_AUTH_INPUT_NUMBER_DONE,//input random number done
    //PROV_EVT_READ_PEER_PUBLIC_KEY_OOB
    PROV_ACTION_READ_PEER_PUBLIC_KEY_OOB_DONE,
    //PROV_EVT_BEACON
    PROV_ACTION_SET_LINK_OPEN,
    //PROV_EVT_CAPABILITIES
    PROV_ACTION_SEND_START_PDU,

    /*******UNPROV DEVICE*******/
    //UNPROV_EVT_AUTH_INPUT_NUMBER
    UNPROV_ACTION_AUTH_INPUT_NUMBER_DONE,//input random number done
} mesh_prov_action_type_t;

void provision_action_send (mesh_prov_action_type_t type , mesh_prov_evt_param_t param);