Shineblink接入机智云APP功能教程

Kara

Shineblink接入机智云APP功能教程

本教程可用于C2 DevKit开发板套件全功能展示，用于对shineblink 的C2 DevKit开发套件全面学习使用，shineblink&及机智云技术交流群（234976524）。开发板相关的进阶教程及DIY应用将在后续持续更新。

        教程主要包含以下内容：

        1.LED1（黄灯开关）开关控制

        2.LED2（绿灯开关）开关控制

        3.人体检测（有人1，无人0）

        4.按键检测（BTN1控制黄灯开关，BTN2控制绿灯开关。）

        5. LED_PWM（红灯亮度）调光控制（蜂鸣器,3610电机, LED_PWM三个功能需要切换跳冒，控制一个功能的时候另外2个现象会随之改变，控制的时候要切换D0跳冒到对应的接口才有效果）

        6.蜂鸣器开关（蜂鸣器,3610电机, LED_PWM三个功能需要切换跳冒，控制一个功能的时候另外2个现象会随之改变，控制的时候要切换D0跳冒到对应的接口才有效果）

        7.3610电机调速蜂（鸣器,3610电机, LED_PWM三个功能需要切换跳冒，控制一个功能的时候另外2个现象会随之改变，控制的时候要切换D0跳冒到对应的接口才有效果）

        8.继电器开关

        9.OLED屏幕（为了展示，此处仅展示部分显示效果）

        10.温湿度采集

        11.可调电阻电压显示

        12.光敏电阻电压显示（开发者可以转换成光照强度）

        一、云端部署

        1.进入机智云开发者中心：https://developer.gizwits.com/menu/dashboard，没有账号的可以申请注册账号。

2.创建产品

注册账号之后点击左上角创建

根据自己需求选择对应的分类

输入产品名称和选择通讯方式后点击创建，新建一个产品。

3.数据点导入（数据点模板可在附件进行下载ShineBlink.xlsx）

创建产品后在产品的产品信息页面里，在标准数据点里面点击导入，选择ShineBlink.xlsx文件。

修改显示名称，为本项目需要用到的数据点进行命名，方便后续的区分。例如黄灯，如图操作之后确定即可更改。

修改完所有参数过后如图所示（如果不想自己修改，那么在标准数据点里面点击导入附件中的ShineBlink_c2_data.xlsx）

3.APP快速生成

回到开发者中心首页，点击右上角创建，选择移动应用，输入应用包名和应用名称后，根据自己需求选择关联或者不关联用户之后选择确认，创建一个移动应用。

在用户关联里面选择我们创建好数据点的产品

关联我们之前创建好数据点的shineblink产品（其他自定义更改可参考APP开发的相关文档https://devdocs.gizwits.com/zh-cn/AppDev/APP/AddApp/CreatApp.html）。

APP页面编辑，回到我们创建数据点的产品，点击控制页面，配置智能场景，可用于定时，延时等智能化规则操作。

进入控制页面，选择通用模板，在功能里面勾选我们用到的数据点，如果勾选全部数据点，会导致APP多出无用的数据点，在功能里面对我们的显示进行排序和大小图标调整。配置后记得需要保存。

构建应用，进入应用后点击顶部有构建应用，等待构建完成后，扫描二维码即可下载APP。

APP部分页面如图所示

到此云端部署完成。

二、程序开发

1.基础参数配置

将开发板连接至电脑，或者电脑创建main.lua文件，选用自己熟悉的编辑器打开main.lua(比如notapad++)。

添加机智云参数初始化程序。

代码如下（尽量别再网页复制代码，有时候编码不一致会导致程序不通过）：

--机智云平台为每个产品类别分配的唯一PK和PS，一定要改成您自己的PK和PS

PK = "bf4e8824edbb4ada934c6ca4c8d30eb1"

PS = "f32f10d34fcd4a4784a8de13dc2ee01b"

--初始化4G模块

LIB_Giz4GConfig(PK,PS,6000,0,"UART0","D5","HIGH","D6","HIGH")

2.添加继电器开关程序，根据电路图可知，继电器为高电平使能。

代码如下：

--初始化继电器GPIO

LIB_GpioOutputConfig("D4","STANDARD")

--默认继电器为关闭状态

LIB_GpioWrite("D4",0)

        --查询机智云是否下发了写"Sw3"开关量数据点的动作

        flag,recv_data = LIB_RecvFromGizCloud("Sw3")

        if flag == 1 then

                if recv_data == 1 then -- 云下发了1

                        LIB_GpioWrite("D4",1)--继电器打开

                else -- 云下发了0

                        LIB_GpioWrite("D4",0)--继电器关闭

                end

        end

3.人体感应，根据电路图可知，红外采用数字探头NS312，当探头感应到人体时输出高电平2S，否则输出低电平2s，该输出端口接到开发板的D7引脚。

代码如下：

--人体感应初始化

LIB_GpioInputConfig("D7","NOPULL")

        --读取人体感应输入引脚的电平值

    Alarm = LIB_GpioRead("D7")

    --根据传感器状态上报云端

    if Alarm == 1 then

        --上传云端感应到人体

        LIB_SendToGizCloud("In1", Alarm)

    elseif Alarm == 0 then

        --上传云端未感应到人体

        LIB_SendToGizCloud("In1", Alarm)

End

4.温湿度采集，OLED显示，根据开发板电路图可知温湿度传感器SHT30在开发板的接口为IIC0(SCL0,SDA0)，Oled屏幕在开发板的接口为IIC1(SCL1,SDA1)

代码如下：

--设置sht3x传感器占用SCL0和SDA0引脚，并启动传感器以每秒出10个数据的频率工作，repeatability="HIGH"时精度最高

LIB_Sht3xConfig("IIC0","10","HIGH")

--设置0.96寸oled模块占用SCL1和SDA1引脚

LIB_0_96_OledConfig("IIC1")

        --查询sht3x传感器是否出数

    sht3x_flag,sht3x_temp,sht3x_humi = LIB_Sht3xGetResult()

    --如果传感器有新的温湿度数据产生

    if sht3x_flag == 1 then

        --在oled的第一行和第二行分别显示温度（摄氏度）和湿度（百分比）

        LIB_0_96_OledPuts("1","1",string.format("temprature: %.2f", sht3x_temp))

        LIB_0_96_OledPuts("2","1",string.format("humidity: %.2f", sht3x_humi))

                --向机智云发送温度和湿度数据

        LIB_SendToGizCloud("Rf3", sht3x_temp)

        LIB_SendToGizCloud("Rf4", sht3x_humi)

    end

5.按键；黄灯，绿灯开关控制，本教程将展示APP控制黄灯，绿灯，按键控制黄灯，绿灯，并同步状态。根据电路图可知，按键按下低电平，LED低电平点亮。

代码如下：

--初始化D8引脚，黄灯

LIB_GpioOutputConfig("D8","STANDARD")

--初始化D9引脚，绿灯

LIB_GpioOutputConfig("D9","STANDARD")

--设置按键"BTN1"(占用D10口)以低电平有效的方式检测按键动作

LIB_ButtonConfig("BTN1","D10","L")

--设置按键"BTN1"(占用D11口)以低电平有效的方式检测按键动作

LIB_ButtonConfig("BTN2","D11","L")

led1_value = 0        --黄灯状态

led2_value = 0        --绿灯状态

        --查询机智云是否下发了写"Sw1"开关量数据点的动作

        flag,recv_data = LIB_RecvFromGizCloud("Sw1")

                if recv_data == 1 then -- 云下发了1        

                        led1_value=1

                else -- 云下发了0

                        led1_value=0

                end

        --查询机智云是否下发了写"Sw2"开关量数据点的动作

        flag,recv_data = LIB_RecvFromGizCloud("Sw2")

                if recv_data == 1 then -- 云下发了1

                        led2_value=1

                else -- 云下发了0

                        led2_value=0

                end        

        --轮询按键事件

    key_value = LIB_ButtonQuery("BTN1")

    --如果按键1短按过,切换LED1状态

    if key_value == 1 then

                if led1_value ==1 then

                        led1_value=0

                        LIB_SendToGizCloud("Sw1", led1_value)--同步状态

                else

                        led1_value=1

                        LIB_SendToGizCloud("Sw1", led1_value)--同步状态

                end

    end

    key_value = LIB_ButtonQuery("BTN2")

    --如果按键2短按过,切换LED2状态

    if key_value == 1 then

        if led2_value ==1 then

                        led2_value=0

                        LIB_SendToGizCloud("Sw2", led2_value)--同步状态

                else

                        led2_value=1

                        LIB_SendToGizCloud("Sw2", led2_value)--同步状态

                end

    end

        if led1_value==1 then

                LIB_GpioWrite("D8",0)--黄灯打开

        else

                LIB_GpioWrite("D8",1)--黄灯关闭

        end

        if led2_value==1 then

                LIB_GpioWrite("D9",0)--绿灯打开

        else

                LIB_GpioWrite("D9",1)--绿灯关闭

        end

6. 可调电阻电压显示和光敏电阻电压显示。根据手册及电路图可知，模拟旋钮电压采集其工作原理为电阻分压的方式，通过A0端口采集可变电阻的电压。光敏感应的原理为当光照越强，LS06的电阻越小，实际上仍然是电阻分压的原理，采用A1端口采集电压。

OLED显示代码及上传云端代码如下：

--配置A0-A3这四个通道同时开始工作，当每个通道采集满50个点时缓存满，每个点的采集时间间隔为10ms

LIB_ADConfig(50,10000)

AD0=0.0

AD1=0.0

    A0_full_flag, A0_tab = LIB_ADCheckBufFull("A0")

    --每当A0通道的缓存满以后，计算缓存内的50个元素的平均值，并换算成电压值

    if A0_full_flag == 1 then

        SUM = 0

        for i = 1, #A0_tab do --此处#A0_tab的值是50，表示A0_tab表内的元素个数

            SUM = SUM + A0_tab

        end

        AVER = SUM / #A0_tab

        AD0=AVER*3.6/4096.0

        --将A0通道的AD值转换成实际电压显示出来，注意这里是保留小数点后一位

        LIB_0_96_OledPuts("3","1",string.format("AD0:%.1f", AD0))

                LIB_SendToGizCloud("Rf1", AD0)

    end

        --每当A1通道的缓存满以后，计算缓存内的50个元素的平均值，并换算成电压值

    A1_full_flag, A1_tab = LIB_ADCheckBufFull("A1")

    if A1_full_flag == 1 then

        SUM = 0

        for i = 1, #A1_tab do --此处#A1_tab的值是50，表示A0_tab表内的元素个数

            SUM = SUM + A1_tab

        end

        AVER = SUM / #A1_tab

        AD1=AVER*3.6/4096.0

        --将A1通道的AD值转换成实际电压显示出来，注意这里是保留小数点后一位

        LIB_0_96_OledPuts("4","1",string.format("AD1:%.1f", AD1))

                LIB_SendToGizCloud("Rf2", AD1)

end

7.蜂鸣器，此教程效果需要将D0跳冒接到最左侧的BUZ上才能实现效果。此无源蜂鸣器工作电压为2~5V，其工作频率为2700HZ，高电平使能。根据其参数，需将PWM周期配置为1/2700=370us。高电平的占空比将决定其音量大小，此次实验为开关动作，音量固定。。

实现代码如下：

--配置D0口为PWM功能，参数370表示PWM的周期为370us，参数1表示高电平有效

LIB_PwmConfig1(370,1)

--更新D0口的PWM输出占空比为0

LIB_PwmUpdate1(0)

cnt = 0

--查询机智云是否下发了写"Sw4"开关量数据点的动作

        flag,recv_data = LIB_RecvFromGizCloud("Sw4")

        if flag == 1 then

                if recv_data == 1 then -- 云下发了1

                        cnt = 185

                        --蜂鸣器打开

                else -- 云下发了0

                        cnt = 0

                        --蜂鸣器关闭

                end

                LIB_PwmUpdate1(cnt)

        end

8.红灯亮度调节，红灯亮度调节主要用到D0口PWM功能，效果演示需要将D0跳冒插到中间的LED上，此实验演示LED的100个不同亮度。

代码如下：

--查询机智云是否下发了写"Ws2"开关量数据点的动作

        flag,recv_data = LIB_RecvFromGizCloud("Ws2")

        if flag == 1 then

                if Ws2==0 then

                        cnt=370

                else

                        cnt =300 - Ws2 *3

                end

                LIB_PwmUpdate1(cnt)

        end

9. 3610电机调速，主要用到D0口PWM功能，效果演示需要将D0跳冒插到中间的MOT上，此实验演示电机的100个不同速度。

代码如下：

        --查询机智云是否下发了写"Ws2"开关量数据点的动作

        flag,recv_data = LIB_RecvFromGizCloud("Ws3")

        if flag == 1 then

                if Ws2==0 then

                        cnt=0

                else

                        cnt = Ws2 *3

                end

                --红灯亮度调节

                LIB_PwmUpdate1(cnt)

        end        

点击附件下载程序，数据点