【花雕学编程】Arduino HTTP 之通过豆包 API 控制设备

最新推荐文章于 2025-03-17 17:58:34 发布

驴友花雕

最新推荐文章于 2025-03-17 17:58:34 发布

阅读量1.3k

点赞数 36

分类专栏：开源硬件文章标签：网络协议网络嵌入式硬件单片机 c++ 通过豆包 API 控制设备 Arduino HTTP

本文链接：https://blog.csdn.net/weixin_41659040/article/details/144976392

版权

开源硬件专栏收录该内容

1633 篇文章

订阅专栏

在这里插入图片描述

Arduino是一个开放源码的电子原型平台，它可以让你用简单的硬件和软件来创建各种互动的项目。Arduino的核心是一个微控制器板，它可以通过一系列的引脚来连接各种传感器、执行器、显示器等外部设备。Arduino的编程是基于C/C++语言的，你可以使用Arduino IDE（集成开发环境）来编写、编译和上传代码到Arduino板上。Arduino还有一个丰富的库和社区，你可以利用它们来扩展Arduino的功能和学习Arduino的知识。

Arduino的特点是：
1、开放源码：Arduino的硬件和软件都是开放源码的，你可以自由地修改、复制和分享它们。
2、易用：Arduino的硬件和软件都是为初学者和非专业人士设计的，你可以轻松地上手和使用它们。
3、便宜：Arduino的硬件和软件都是非常经济的，你可以用很低的成本来实现你的想法。
4、多样：Arduino有多种型号和版本，你可以根据你的需要和喜好来选择合适的Arduino板。
5、创新：Arduino可以让你用电子的方式来表达你的创意和想象，你可以用Arduino来制作各种有趣和有用的项目，如机器人、智能家居、艺术装置等。

在这里插入图片描述
Arduino
Arduino 是一个开源电子原型平台，由硬件和软件两部分组成。硬件方面，Arduino 电路板可以读取输入——例如来自传感器的数据、按钮按下的信号、或是社交媒体消息——并将其转换为输出，如启动电机、点亮 LED、或发送通知。软件方面，用户可以使用 Arduino 编程语言（基于 Wiring）和 Arduino 软件（IDE）进行编程。以下是一些关键概念：
1、微控制器 (Microcontroller): 一种集成在电路板上的小型计算机，用于控制其他电子组件。Arduino 板常使用 ATmega328P 微控制器。
2、引脚 (Pins): 电路板上的物理连接点，用于连接传感器、执行器等外围设备。分为数字引脚和模拟引脚。
3、板载LED (Onboard LED): Arduino 板上自带的 LED（通常连接到引脚 13），便于测试和调试代码。
4、电源端口 (Power Port): 用于供电的接口，可以通过 USB 端口、电池或电源适配器供电。

HTTP (HyperText Transfer Protocol)
HTTP 是互联网的基础协议之一，用于在网络上交换信息，特别是用于客户端（如浏览器）与服务器之间的数据通信。以下是一些关键概念：
1、请求 (Request): 由客户端发送到服务器的消息，包含请求行、请求头和请求体。常见的请求方法包括 GET（请求资源）、POST（提交数据）、PUT（更新资源）和 DELETE（删除资源）。
2、响应 (Response): 服务器返回给客户端的消息，包含状态行、响应头和响应体。状态码如 200（OK）、404（Not Found）等用于表示请求的处理结果。
3、URI (Uniform Resource Identifier): 用于唯一标识网络资源的字符串，可以是 URL（Uniform Resource Locator）或 URN（Uniform Resource Name）。
4、无状态 (Stateless): HTTP 是一种无状态协议，每个请求都是独立的，不保留前后的状态信息。因此，服务器在处理请求时不需要了解之前的请求信息。

Arduino 与 HTTP 的结合
在 Arduino 项目中，HTTP 可以用于实现设备与网络服务的通信，典型应用场景包括：
1、发送传感器数据到服务器: Arduino 可以通过 HTTP POST 请求将传感器数据上传到云服务器，进行数据存储和分析。
2、从服务器获取数据: Arduino 可以通过 HTTP GET 请求从服务器获取信息，例如天气预报或实时监控数据。
3、控制设备: 通过 HTTP 请求，Arduino 可以接收远程指令，控制物理设备的开关状态，如远程点亮 LED 或启动电机。

在这里插入图片描述
一、主要特点
（一）功能扩展与智能化
利用外部智能资源
通过接入豆包 API，Arduino 设备能够借助豆包强大的语言处理能力和知识资源来扩展自身功能。例如，Arduino 设备可以利用豆包 API 进行文本翻译、知识问答、文本生成等功能，从而使设备不再局限于简单的硬件控制，变得更加智能化。
实时知识获取。设备可以实时获取豆包的最新知识和信息，这对于需要及时更新数据或获取最新知识解答的应用场景非常有用。比如，在一个智能问答系统中，Arduino 设备能够立即查询豆包 API 获取问题的答案，而不需要预先存储大量的知识内容。
（二）便捷的交互方式
简单的 HTTP 请求通信
与豆包 API 的交互主要通过 HTTP 请求实现，通常是 HTTP GET 或 POST 请求。这种通信方式在 Arduino 开发中相对容易实现。例如，通过简单的网络库，Arduino 可以构建符合要求的 HTTP 请求，将参数发送给豆包 API，并接收返回的结果。
统一的接口标准。豆包 API 提供了统一的接口标准，使得 Arduino 设备的开发者可以按照文档说明轻松地进行调用。无论是查询知识、获取文本处理结果还是其他功能，都有明确的接口参数和返回值格式，方便开发者进行集成和应用。
（三）灵活的应用集成
与多种设备和系统融合
可以将豆包 API 控制的功能集成到各种 Arduino 设备中，无论是智能家居设备、工业物联网设备还是教育实验设备等。例如，在智能家居系统中，智能音箱（由 Arduino 控制）可以使用豆包 API 来回答用户的各种知识问题；在工业设备的监控系统中，利用豆包 API 进行故障诊断知识查询。
定制化功能开发。开发者可以根据具体的需求定制设备的功能。通过调用豆包 API 的不同功能模块，结合 Arduino 的硬件控制能力，如传感器数据采集、执行器动作控制等，创造出独特的应用场景。例如，开发一个带有知识讲解功能的智能导游机器人，通过 Arduino 控制机器人的移动和语音输出，同时利用豆包 API 获取景点介绍等知识内容。

二、应用场景
（一）智能家居领域
智能语音助手与问答系统
在智能家居环境中，Arduino 可以作为智能语音助手的核心控制器。通过连接麦克风和扬声器，利用豆包 API 进行语音识别后的文本处理，实现用户提问的回答。例如，用户可以问 “如何保养木地板？”，语音助手将问题发送给豆包 API，然后将返回的答案以语音形式播放给用户。
设备操作引导。当用户购买新的智能家居设备时，智能语音助手可以利用豆包 API 获取设备的操作指南和使用技巧，并为用户提供语音指导。例如，对于新安装的智能灯具，语音助手可以回答用户关于如何调节灯光颜色、亮度等问题。
（二）教育与培训设备
智能学习工具与实验辅助
在教育领域，Arduino 设备结合豆包 API 可以制作智能学习工具。例如，一个电子词典设备，通过 Arduino 实现输入和显示功能，利用豆包 API 进行单词查询、例句展示等功能。在实验教学中，Arduino 设备可以利用豆包 API 获取实验原理讲解、实验步骤提示等内容，辅助学生进行实验操作。
互动式教学机器人。可以开发互动式教学机器人，通过 Arduino 控制机器人的动作和表情，利用豆包 API 回答学生的学习问题、讲解知识点，增加教学的趣味性和互动性。
（三）工业物联网（IIoT）
智能监控与故障诊断辅助
在工业设备的监控系统中，Arduino 设备可以利用豆包 API 查询设备故障的可能原因和解决方案。例如，当监测到工业电机的温度异常升高时，Arduino 设备可以向豆包 API 发送关于电机温度过高的问题，获取相关的故障诊断知识，如可能是散热不良、过载等原因，并为维修人员提供相应的建议。
工业知识更新与培训。利用豆包 API，工业物联网设备可以为员工提供最新的工业技术知识、操作规程更新等内容。例如，在新的生产工艺引入后，员工可以通过与 Arduino 设备交互，查询豆包 API 获取新工艺流程的详细介绍和操作要点。

三、需要注意的事项
（一）API 使用权限与配额
遵守 API 使用条款
在使用豆包 API 控制设备时，必须遵守豆包的 API 使用条款和相关的服务协议。这包括对 API 的合法使用范围、数据使用权限等方面的规定。例如，不能将 API 用于非法或侵权的目的，如恶意攻击、侵犯知识产权等。
注意配额限制。豆包 API 可能会对使用频率、请求数量等有一定的配额限制。开发者需要了解这些限制，并合理安排设备的请求，避免超出配额导致服务中断。例如，如果一个设备频繁地向豆包 API 发送请求，超过了规定的每秒请求次数，可能会被暂时限制访问。
（二）网络连接与稳定性
可靠的网络环境要求
由于设备与豆包 API 之间是通过网络进行通信的，所以需要一个可靠的网络连接环境。在网络不稳定或者中断的情况下，可能会导致设备无法正常获取豆包 API 的服务。例如，在智能家居系统中，如果 Wi - Fi 网络出现故障，智能语音助手就无法查询豆包 API 回答用户的问题。
网络安全考虑。在网络连接过程中，要注意网络安全问题。特别是当设备传输用户数据或者涉及敏感信息（如设备认证信息）时，要确保网络通信的安全性，如采用加密协议（如 HTTPS）来防止数据泄露。
（三）数据处理与隐私保护
API 返回数据的处理
豆包 API 返回的数据可能包含各种内容，需要在 Arduino 设备上进行合理的处理。例如，对于文本内容，要考虑字符编码、文本长度限制等因素，确保设备能够正确地显示或使用返回的数据。同时，要对返回的数据进行错误检查，防止因数据格式错误等问题导致设备出现异常。
隐私保护措施。在使用豆包 API 的过程中，要注意保护用户的隐私。如果设备收集了用户的个人信息并发送给豆包 API 进行处理，需要确保这些信息的使用符合隐私政策。例如，不能将用户的隐私信息用于未经授权的第三方服务或广告目的。

在这里插入图片描述
1、打开设备

#include <WiFi.h>
#include <HTTPClient.h>

const char* ssid = "YOUR_SSID";           // WiFi SSID
const char* password = "YOUR_PASSWORD";     // WiFi 密码
const char* serverName = "http://api.doubao.io/device/open"; // 豆包 API 地址

void setup() {
    Serial.begin(115200);
    WiFi.begin(ssid, password);

    // 等待连接
    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }
    Serial.println("Connected to WiFi");
}

void loop() {
    if (WiFi.status() == WL_CONNECTED) {
        HTTPClient http;
        http.begin(serverName); // 指定服务器地址
        http.addHeader("Content-Type", "application/json"); // 设置请求头

        // 创建 JSON 数据
        String jsonData = "{\"device_id\":\"YOUR_DEVICE_ID\"}";

        int httpResponseCode = http.POST(jsonData); // 发送 POST 请求

        if (httpResponseCode > 0) {
            String response = http.getString(); // 获取响应内容
            Serial.println(httpResponseCode); // 打印响应代码
            Serial.println(response); // 打印响应内容
        } else {
            Serial.print("Error on sending POST: ");
            Serial.println(httpResponseCode);
        }
        http.end(); // 结束请求
    }

    delay(10000); // 每10秒发送一次请求
}

2、关闭设备

#include <WiFi.h>
#include <HTTPClient.h>

const char* ssid = "YOUR_SSID";           // WiFi SSID
const char* password = "YOUR_PASSWORD";     // WiFi 密码
const char* serverName = "http://api.doubao.io/device/close"; // 豆包 API 地址

void setup() {
    Serial.begin(115200);
    WiFi.begin(ssid, password);

    // 等待连接
    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }
    Serial.println("Connected to WiFi");
}

void loop() {
    if (WiFi.status() == WL_CONNECTED) {
        HTTPClient http;
        http.begin(serverName); // 指定服务器地址
        http.addHeader("Content-Type", "application/json"); // 设置请求头

        // 创建 JSON 数据
        String jsonData = "{\"device_id\":\"YOUR_DEVICE_ID\"}";

        int httpResponseCode = http.POST(jsonData); // 发送 POST 请求

        if (httpResponseCode > 0) {
            String response = http.getString(); // 获取响应内容
            Serial.println(httpResponseCode); // 打印响应代码
            Serial.println(response); // 打印响应内容
        } else {
            Serial.print("Error on sending POST: ");
            Serial.println(httpResponseCode);
        }
        http.end(); // 结束请求
    }

    delay(10000); // 每10秒发送一次请求
}

3、获取设备状态

#include <WiFi.h>
#include <HTTPClient.h>

const char* ssid = "YOUR_SSID";           // WiFi SSID
const char* password = "YOUR_PASSWORD";     // WiFi 密码
const char* serverName = "http://api.doubao.io/device/status"; // 豆包 API 地址

void setup() {
    Serial.begin(115200);
    WiFi.begin(ssid, password);

    // 等待连接
    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }
    Serial.println("Connected to WiFi");
}

void loop() {
    if (WiFi.status() == WL_CONNECTED) {
        HTTPClient http;
        http.begin(serverName); // 指定服务器地址
        http.addHeader("Content-Type", "application/json"); // 设置请求头

        // 创建 JSON 数据
        String jsonData = "{\"device_id\":\"YOUR_DEVICE_ID\"}";

        int httpResponseCode = http.POST(jsonData); // 发送 POST 请求

        if (httpResponseCode > 0) {
            String response = http.getString(); // 获取响应内容
            Serial.println(httpResponseCode); // 打印响应代码
            Serial.println(response); // 打印响应内容
        } else {
            Serial.print("Error on sending POST: ");
            Serial.println(httpResponseCode);
        }
        http.end(); // 结束请求
    }

    delay(10000); // 每10秒发送一次请求
}

要点解读
WiFi 连接：
每个示例首先通过 WiFi.begin() 建立 WiFi 连接，确保 Arduino 可以连接到互联网，并通过 WiFi.status() 检查连接状态。
HTTPClient 库：
使用 HTTPClient 库简化 HTTP POST 请求的发送。通过 http.begin() 指定 API 的 URL，并使用 http.POST() 发送数据。
请求头设置：
示例中通过 http.addHeader(“Content-Type”, “application/json”) 设置请求头，以指明发送的数据格式为 JSON。这是与豆包 API 进行通信时的必要步骤。
设备控制：
示例 1 和示例 2 分别演示了如何打开和关闭设备，示例 3 则演示了如何获取设备的状态。这些请求通过发送 JSON 数据（包含设备 ID）来控制设备。
错误处理：
每个示例都检查 HTTP 响应代码，以确保请求成功。如果请求失败，程序会打印错误代码，便于调试和问题识别。这在实际应用中帮助开发者快速定位问题。

在这里插入图片描述
4、通过豆包API控制设备的开关

#include <WiFi.h>
#include <HTTPClient.h>

const char* ssid = "your_SSID"; // WiFi名称
const char* password = "your_PASSWORD"; // WiFi密码
const char* apiUrl = "http://api.doubler.io/v1/device/control"; // 豆包API URL
const char* deviceId = "your_device_id"; // 设备ID

void setup() {
    Serial.begin(115200);
    WiFi.begin(ssid, password);

    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }

    Serial.println("Connected to WiFi");
}

void loop() {
    if (WiFi.status() == WL_CONNECTED) {
        HTTPClient http;

        http.begin(apiUrl);
        http.addHeader("Content-Type", "application/json");

        // 控制设备开关
        String jsonData = String("{\"device_id\": \"") + deviceId + String("\", \"status\": \"on\"}");
        int httpResponseCode = http.POST(jsonData);

        if (httpResponseCode > 0) {
            String response = http.getString();
            Serial.println(httpResponseCode);
            Serial.println(response);
        } else {
            Serial.print("Error on sending POST: ");
            Serial.println(httpResponseCode);
        }
        
        http.end();
    }

    delay(10000); // 每10秒控制一次
}

要点解读
WiFi连接：在setup()中连接到指定的WiFi，以确保可以访问豆包API。
HTTPClient库：使用HTTPClient库简化HTTP请求的发送与响应处理。
设备控制：通过POST请求发送设备ID和控制状态（如开或关），实现远程控制。
JSON数据格式：使用JSON格式进行数据传输，便于服务器解析和处理。
错误处理：检查HTTP响应代码，确保请求成功并处理失败情况，便于调试和维护。

5、通过豆包API读取设备状态

#include <WiFi.h>
#include <HTTPClient.h>

const char* ssid = "your_SSID";
const char* password = "your_PASSWORD";
const char* apiUrl = "http://api.doubler.io/v1/device/status"; // 豆包API URL
const char* deviceId = "your_device_id";

void setup() {
    Serial.begin(115200);
    WiFi.begin(ssid, password);

    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }

    Serial.println("Connected to WiFi");
}

void loop() {
    if (WiFi.status() == WL_CONNECTED) {
        HTTPClient http;

        String urlWithId = String(apiUrl) + "?device_id=" + deviceId;
        http.begin(urlWithId);

        int httpResponseCode = http.GET();

        if (httpResponseCode > 0) {
            String response = http.getString();
            Serial.println(httpResponseCode);
            Serial.println(response);
        } else {
            Serial.print("Error on sending GET: ");
            Serial.println(httpResponseCode);
        }
        
        http.end();
    }

    delay(10000); // 每10秒读取一次状态
}

要点解读
状态读取：通过GET请求从豆包API读取设备的当前状态，适合监控应用。
动态URL构建：通过在URL中添加设备ID，构建完整的请求地址。
实时数据反馈：通过定时读取设备状态，可以实时监控设备的工作状态。
HTTPClient库的应用：继续使用HTTPClient库，简化HTTP请求的处理。
错误处理：确保请求成功与失败都能被妥善处理，便于后续调试。

6、通过豆包API发送传感器数据

#include <WiFi.h>
#include <HTTPClient.h>

const char* ssid = "your_SSID";
const char* password = "your_PASSWORD";
const char* apiUrl = "http://api.doubler.io/v1/device/data"; // 豆包API URL
const char* deviceId = "your_device_id";

void setup() {
    Serial.begin(115200);
    WiFi.begin(ssid, password);

    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }

    Serial.println("Connected to WiFi");
}

void loop() {
    if (WiFi.status() == WL_CONNECTED) {
        HTTPClient http;

        http.begin(apiUrl);
        http.addHeader("Content-Type", "application/json");

        // 模拟传感器数据
        float temperature = random(20, 30); // 随机温度
        float humidity = random(40, 60);    // 随机湿度

        String jsonData = String("{\"device_id\": \"") + deviceId + String("\", \"temperature\": ") + temperature + String(", \"humidity\": ") + humidity + String("}");
        int httpResponseCode = http.POST(jsonData);

        if (httpResponseCode > 0) {
            String response = http.getString();
            Serial.println(httpResponseCode);
            Serial.println(response);
        } else {
            Serial.print("Error on sending POST: ");
            Serial.println(httpResponseCode);
        }
        
        http.end();
    }

    delay(10000); // 每10秒发送一次传感器数据
}

要点解读
传感器数据上传：模拟传感器数据（如温度和湿度），通过POST请求发送到豆包API。
随机数据生成：使用random()函数模拟传感器数据，可以根据实际传感器的读数进行替换。
JSON格式：利用JSON格式发送数据，确保数据易于服务器解析。
定时上传：在loop()中定时上传数据，适合实时监控的需求。
错误处理：确保请求的成功与失败都有反馈，方便后续调试和维护。

总结
以上几个案例展示了如何通过豆包API控制设备。通过这些示例，用户可以学习到：
WiFi连接：如何连接到WiFi网络，以便进行Internet通信。
HTTPClient库的使用：简化HTTP请求的发送与响应处理。
设备控制与状态读取：通过POST和GET请求实现对设备的控制和状态读取。
JSON数据格式：在物联网应用中，如何使用JSON格式发送和接收数据。
错误处理与调试：如何检查HTTP响应代码，处理请求的成功与失败。

注意，以上案例只是为了拓展思路，仅供参考。它们可能有错误、不适用或者无法编译。您的硬件平台、使用场景和Arduino版本可能影响使用方法的选择。实际编程时，您要根据自己的硬件配置、使用场景和具体需求进行调整，并多次实际测试。您还要正确连接硬件，了解所用传感器和设备的规范和特性。涉及硬件操作的代码，您要在使用前确认引脚和电平等参数的正确性和安全性。

在这里插入图片描述