Arduino的各种优质项目集合-包括灯泡控制等.zip（毕设/课设/竞赛/实训/项目开发）

# blinker-library Blinker library for embedded hardware. Works with Arduino, ESP8266, ESP32. # What's Blinker [Blinker](https://blinker.app/) is a platform with iOS and Android apps to control embedded hardware like Arduino. You can easily build graphic interfaces for all your projects by simply dragging and dropping widgets. [Blinker](https://blinker.app/) 是一个运行在 IOS 和 Android 上用于控制嵌入式硬件的应用程序。你可以通过拖放控制组件，轻松地为你的项目建立图形化控制界面。 # Reference/参考 * [EN-英文](https://github.com/blinker-iot/blinker-doc/wiki/Blinker-Arduino-library-reference) * [CN-中文](https://github.com/blinker-iot/blinker-doc/wiki/Blinker-Arduino-%E5%BA%93%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C) * [CN-中文/官网](https://doc.blinker.app/?file=003-%E7%A1%AC%E4%BB%B6%E5%BC%80%E5%8F%91/02-Arduino%E6%94%AF%E6%8C%81) <!-- --- # 目前支持的硬件 * Arduino boards - Arduino Uno, Duemilanove - Arduino Nano, Mini, Pro Mini, Pro Micro, Due, Mega * 使用 [esp8266/arduino](https://github.com/esp8266/arduino) 的ESP8266 * 使用 [espressif/arduino-esp32](https://github.com/espressif/arduino-esp32) 的ESP32 # 连接类型 * Bluetooth Smart (BLE 4.0) * WiFi * MQTT # 准备工作 开始使用前你需要做好如下准备: * [Arduino IDE](https://www.arduino.cc/en/Main/Software) 1.6.12及更新版本 * 使用 Arduino IDE 的开发板管理器安装 [esp8266/arduino](https://github.com/esp8266/arduino) * 按照 [安装说明](https://github.com/espressif/arduino-esp32#installation-instructions) 安装 [espressif/arduino-esp32](https://github.com/espressif/arduino-esp32) # Blinker接口函数 ## 设备配置 ### Blinker.begin() 使用 **Blinker.begin()** 来配置 Blinker: ``` Blinker.begin(...); ``` 根据你使用的连接方式选择不同的参数用于配置Blinker BLE: ``` #define BLINKER_BLE #include <Blinker.h> void setup() { Blinker.begin(); } ``` >串口蓝牙模块: >**Blinker.begin()** 将使用默认设置配置 Serial(默认使用软串口) > >Blinker.begin();// 默认设置: 数字IO 2(RX) 3(TX), 波特率 9600 bps >Blinker.begin(4, 5);// 设置数字IO 4(RX) 5(TX), 默认波特率 9600 bps >Blinker.begin(4, 5, 115200);// 设置数字IO 4(RX) 5(TX) 及波特率 115200 bps > >若配置时Blinker.begin(0, 1); >0 1对应硬串口的RX TX, 库会默认使用硬串口与BLE模块进行通信 >Blinker.begin(15, 14);//Arduino MEGA中如15, 14对应硬串口Serial3 > >注意使用软串口时: >使用Arduino MEGA时以下IO可以设置为RX: 10, 11, 12, 13, 50, 51, 52, 53, 62, 63, 64, 65, 66, 67, 68, 69 >使用Arduino Leonardo时以下IO可以设置为RX: 8, 9, 10, 11, 14, 15, 16 WiFi: ``` #define BLINKER_WIFI #include <Blinker.h> void setup() { Blinker.begin(ssid, pswd); } ``` MQTT: ``` #define BLINKER_MQTT #include <Blinker.h> void setup() { Blinker.begin(auth, ssid, pswd); } ``` > MQTT 支持的硬件: WiFiduino, WiFiduino32, ESP8266, ESP32 **begin()** 主要完成以下配置: 1.初始化硬件设置; 2.连接网络并广播设备信息等待app连接; ## 连接管理 ### Blinker.connect() 建立 **Blinker** 设备间连接并返回连接状态, 默认超时时间为10秒 ``` bool result = Blinker.connect(); uint32_t timeout = 30000;//ms bool result = Blinker.connect(timeout); ``` ### Blinker.disconnect() 断开 **Blinker** 设备间连接 ``` Blinker.disconnect(); ``` ### Blinker.connected() 返回 **Blinker** 设备间连接状态 ``` bool result = Blinker.connected(); ``` ### Blinker.run() 此函数需要频繁调用以保持设备间连接及处理收到的数据, 建议放在 **loop()** 函数中 ``` void loop() { Blinker.run(); } ``` ## 数据管理 ### Blinker.available() 检测是否有接收到数据 ``` bool result = Blinker.available(); ``` ### Blinker.readString() 读取接收到的数据 ``` String data = Blinker.readString(); ``` `*读取数据最大为 256 字节` ### Blinker.print() 发送数据 ``` Blinker.print(data); ``` 发送一个Json数据, 如 {text1:data} ``` Blinker.print(text1, data); ``` 发送一个带单位的Json数据, eg: {"temp":"30.2 °C"} ``` Blinker.print("temp", 30.2, "°C"); ``` >发送的Json数据可以在 Blinker APP 的 TEXT 组件中显示 ``` *发送数据最大为 128 字节 *MQTT方式接入时, print需间隔1s以上 例: Blinker.print("hello"); Blinker.delay(1000); Blinker.print("world); ``` ### Blinker.beginFormat() && Blinker.endFormat() 当使用 **beginFormat** 时, **print** 发送出的数据都将以 Json 格式存入发送数据中。 这个发送数据将在使用 **endFormat** 时发送出去。 ``` Blinker.beginFormat(); Blinker.print("Hello","Blinker"); Blinker.print("start","end"); Blinker.print("number",123); Blinker.endFormat(); ``` >使用 endFormat 后, 发送的 Json 数据: {"Hello":"Blinker","start":"end","number":123} ### Blinker.notify() 使用 **notify** 时, 发送数据以感叹号开始, 将会发送消息通知到app, 否则将会发送Json数据到app 发送通知 ``` Blinker.notify("!notify"); ``` 发送Json数据, 如 {"notice":"notify"} ``` Blinker.notify("notify"); ``` ## App Widgets ### Blinker.wInit() 组件初始化, 建议在使用前初始化 **Button** 、**Slider** 、 **Toggle** 及 **RGB** ``` Blinker.wInit("ButtonName", W_BUTTON); Blinker.wInit("SliderName", W_SLIDER); Blinker.wInit("ToggleName", W_TOGGLE); Blinker.wInit("RGBName", W_RGB);//键词, 类型 ``` >类型: >W_BUTTON 按键 >W_SLIDER 滑动条 >W_TOGGLE 开关 >W_RGB RGB调色板 >以上四种组件数量限制为 16个/种 ### Blinker.button() 读取开关/按键数据, 按下(Pressed)时返回true, 松开(Released)时返回false ``` bool result = Blinker.button("Button1"); ``` ### Blinker.slider() 读取滑动条数据 ``` uint8_t result = Blinker.slider("Slider1"); ``` ### Blinker.toggle() 读取拨动开关数据, 打开(ON)时返回true, 关闭(OFF)时返回false ``` bool result = Blinker.toggle("Toggle1"); ``` ### Blinker.joystick() 读取摇杆数据 ``` uint8_t result_X = Blinker.joystick(J_Xaxis); uint8_t result_Y = Blinker.joystick(J_Yaxis); ``` ### BlinkerButton 按键组件在App中可以设置 按键/开关/自定义 三种模式, **按键** 模式下支持 点按/长按/释放(tap/pre/pup) 三个动作 **开关** 模式下支持 打开/关闭(on/off) 两个动作 **自定义** 模式下支持 自定义指令 发送 初始化, 创建对象 ``` #define BUTTON_1 "ButtonKey" BlinkerButton Button1(BUTTON_1); ``` 用于处理 **button** 收到数据的回调函数 ``` void button1_callback(const String & state) { digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN)); BLINKER_LOG2("get button state: ", state); } ``` > 在回调函数中, **state** 的值为: > **按键** : 点按(tap)/长按(pre)/释放(pup) > **开关** : 打开(on)/关闭(off) > **自定义** : 你设置的值 在 **setup()** 中注册回调函数 ``` Button1.attach(button1_callback); ``` > 也可以在初始化时注册回调函数: > BlinkerButton Button1(BUTTON_1, button1_callback); #### Button1.icon(); Button1.color("#FFFFFF"); Button1.text("Your button name or describe"); Button1.print("on"); ### BlinkerJoystick ### BlinkerRGB ### BlinkerSlider ### BlinkerNumber ### BlinkerText ### BUILTIN_SWITCH ### Blinker.ahrs() 开启手机 **AHRS** 功能 ``` Blinker.attachAhrs(); ``` 读取 **AHRS** 数据 ``` int16_t result_Yaw = Blinker.ahrs(Yaw); int16_t result_Roll = Blinker.ahrs(Roll); int16_t result_Pitch = Blinker.ahrs(Pitch); ``` 关闭手机 **AHRS** 功能 ``` Blinker.dettachAhrs(); ``` ### Blinker.gps() 刷新手机 **GPS** 功能 ``` Blinker.freshAhrs(); ``` 读取 **GPS** 数据 ``` String result_LONG = Blinker.gps(LONG); String result_LAT = Blinker.gps(LAT); ``` > LONG 经度 > LAT 维度 <!-- ### Blinke