小米IoT平台BLE Mesh SDK开发指南:搭建软件环境和进行基础开发

目录

  • 前提条件
  • SDK 下载
  • 基础开发
  • 固件编译
  • 前提条件

  • 注册小米账号:在小米 IoT 平台 注册账号 且 登录 完成
  • 注册企业:在小米 IoT 平台注册企业且被审核通过,关于如何注册企业请参考 注册企业
  • 成为开发者:在企业开发组下添加开发者,参考 企业管理
  • 产品已创建:如未创建,请参考 新建产品
  • 已完成功能定义;如未完成请参考 如何进行功能定义
  • 已在平台侧进行固件设置和资源(SDK)申请:如未进行,请参考 固件开发如何进行平台侧设置及申请 SDK
  • 已搭建硬件环境:如未搭建请参考 如何搭建硬件环境
  • SDK 下载

  • 使用模组 MHCB05P-B(IB)、MHCB06P-B(IB)和 MHCB07P,开发 BLE 产品的固件时,开发者需在 keil 官网上下载并安装 Keil,自行搜索解决
  • SDK 下载:Windows 环境下通过 git bash 下载 SDK,网页直接下载 zip 包会导致工程文件不全,git bash 自行下载安装
    1. 新建一个文件夹,文件夹右击点击 Open Git Bash here

    2. 使用git clone --recursive -b realtek [url]命令下载(url 在申请 SDK 通过后可以获取到)

      如果出现这个问题,就将你电脑的公钥添加到 GitLab 中,将下图所示文件中的内容复制(这个怎么生成自行解决)

      GitLab 中搜索 SSH Keys

      将复制的公钥添加到这里

      添加成功,会有邮件提醒

      重新下载,进入下载过程

    3. 下载好后,进入*\mijia_ble_mesh\Bee2_SDK_Mesh\board\evb\mesh_xiaomi_switch目录下,双击用 Keil 打开

    基础开发

    1. 配置产品基础信息,在 custom_mi_config.h 中,包含以下宏定义: #define DEVELOPER_VERSION 0001
    2. 查看自己产品的 model 和 pid ,在 product_info.h 中进行更改,包含以下宏定义:

    注意:

  • 模组需要在配网绑定前先修改成正在开发中的 PRODUCT_ID 和 MODEL_NAME,否则模组通过默认的 PRODUCT_ID 绑定后不能再更换成其它值了,此时绑定会失败,只能更换一个全新模组来绑定更改后的 PRODUCT_ID;
  • 另外,开发时需要正确选择模板宏定义,如示例中需要选择开启单键开关模板宏定义
    MI_MESH_TEMPLATE_ONE_KEY_SWITCH,因为不同的选择对协议栈的初始化会不一样,选错了可能会导致控制或者设备上报数据异常;
  • 没有找到对应模板名称的,如窗帘电机产品,统一选择开启 MI_MESH_TEMPLATE_CLOUD。
    1. 更改 Log 打印级别,通过 mible_log.h 中 MI_LOG_LEVEL 宏配置开启应用层日志打印级别

    2. 在平台上定义好设备功能定义后,开发者也可以根据需要(非必须),使用代码自动生成工具生成 Spec 操作相关代码,减少代码开发,操作步骤如下


    3. 将其解压后,用其替换*\mijia_ble_mesh\Bee2_SDK_Mesh\src\app\mesh\xiaomi_switch下的miot_spec文件夹

    4. 将生成的代码源文件加入到工程对应的目录下:把原先有的全部都删掉,然后点击add files,打开刚才的替换的目录,选择你要添加的文件(直接全选),点击Add

    固件编译

    点击编译,在*\mijia_ble_mesh\Bee2_SDK_Mesh\board\evb\mesh_xiaomi_switch\bin下有生成的bin文件

    物联沃分享整理
    物联沃-IOTWORD物联网 » 小米IoT平台BLE Mesh SDK开发指南:搭建软件环境和进行基础开发

    发表评论