本教程可用于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.进入机智云开发者中心：机智云 开发者中心，没有账号的可以申请注册账号。 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