C SDK esp8266 集成指南

适用版本

jiot-c-sdk支持乐鑫 ESP8266 Wi-Fi 模块(基于ESP8266_RTOS_SDK release/v3.2版本,freeRTOS操作系统)

压缩包说明

解压文件,以jiot-sdk-v1.0.7-source.zip为例。

unzip jiot-sdk-v1.0.7-source.zip

解压后目录结构如下。

jiot-c-sdk/
├── build
│   ├── armv7
│   ├── esp8266
│   ├── m5311
│   ├── rt-thread
│   └── x86
├── common
├── examples
│   ├── esp8266
│   ├── linux
│   ├── m5311
│   └── rt-thread
├── include
├── platform
├── public
└── src

配置参数

修改“jiot-c-sdk/examples/esp8266/main/user_main.c”文件。

      /*
      configs for demo:
      */

      #define WIFI_SSID              "yourSSID"
      #define WIFI_PASSWORD          "yourPASSWORD"
      #define JIOT_PRODUCTKEY        "yourPRODUCTKEY"
      #define JIOT_DEVICENAME        "yourDEVICENAME"
      #define JIOT_DEVICESECRET      "yourDEVICESECRET"

配置参数分别为: * yourSSID: WIFI标识(名称)。 * yourPASSWORD: WIFI密码。 * yourPRODUCTKEY:在极光 IoT portal 上创建产品得到的对应的产品标识。 * yourDEVICENAME:在 portal 上创建设备时输入的设备名。 * yourDEVICESECRET:在 portal 上创建设备成功后得到的产品密钥,可以通过设备详情页面查看。

安装ESP8266 SDK

请参考乐鑫官方ESP8266_RTOS_SDK安装文档。注意jiot-c-sdk基于ESP8266_RTOS_SDK release/v3.2版本开发,需要下载该版本的SDK,可参考下面命令。

git clone -b release/v3.2 https://github.com/espressif/ESP8266_RTOS_SDK.git

安装后确保以下变量指向乐鑫SDK和编译工具,样例如下。

export PATH=/home/szz/Embedded/esp8266/xtensa-lx106-elf/bin:$PATH
export IDF_PATH=/home/szz/Embedded/esp8266/ESP8266_RTOS_SDK

编译 jiot-c-sdk

 cd jiot-c-sdk/build/esp8266/
 make
 make flash   #烧录到开发板
 make monitor #运行demo并监视日志

运行看到下面日志说明设备和JIOT云端已经连接成功。

    start demo! 
    ...
    Jclient connected 

开发集成SDK

参考ESP8266 Build System的Example Project结构,“jiot-c-sdk”相当于“components”中的一个“component”。

- myProject/
             - Makefile
             - sdkconfig
             - components/ - component1/ - component.mk
                                         - Kconfig
                                         - src1.c
                           - component2/ - component.mk
                                         - Kconfig
                                         - src1.c
                                         - include/ - component2.h
             - main/       - src1.c
                           - src2.c
                           - component.mk

             - build/

以下以“ESP8266_RTOS_SDK/examples/get-started/project_template”为例,介绍如何集成jiot-c-sdk。 解压jiot-sdk-v1.0.7-source.zip和拷贝乐鑫project_template后得到如下两包源文件。

jiot-c-sdk
project_template

编辑jiot-c-sdk/component.mk修改“SDK_SRC_DIRS”变量如下,并保存。

cp jiot-c-sdk/build/esp8266/components/jiot-c-sdk/component.mk jiot-c-sdk/
SDK_SRC_DIRS := ./

将jiot-c-sdk拷贝到project_template/components/目录下。

rm -rf project_template/components/* #清理components中其他文件,否则不符合上图架构
cp -r jiot-c-sdk/ project_template/components/

这里使用jiot-c-sdk中example中文件模拟调用sdk。

cp jiot-c-sdk/examples/esp8266/main/* project_template/main/
cp jiot-c-sdk/build/esp8266/sdkconfig project_template/sdkconfig #拷贝example配置
cd project_template
make

如果继续运行,可参考“配置参数”等步骤配置wifi等信息,然后编译、烧了和运行即可。

以上步骤完成jiot-c-sdk集成。


Copyright 2011-2019, jiguang.cn, All Rights Reserved.
粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

Documentation built with MkDocs.