觀察筆記

开始使用 LinkIt 7688(Duo) (Python)

在本教程中，您将了解有关使用 LinkIt 7688 (Duo)（运行 OpenWRT）的基本知识。之后，您还会了解如何使用 QIoT Suite Lite 将您的设备无缝连接到 QNAP NAS。

请确保您的 LinkIt 7688 (duo) 与 NAS 在同一 LAN 中。

1.配置您的设备

1.1 开始使用

• 所需内容
  
  
  
  1. LinkIt 7688 (Duo)
  
  
  2. 电源：
     
     
     
     • LinkIt 7688 由至少为 1A、5V 的 USB Micro 电源供电。
     
     
     
     
  
  
  3. Wi-Fi 接入点
  
  
  
  


• 为 LinkIt 7688(Duo) 接通电源
  电源 (PWR) 连接器位于 MPU 重置按钮附近，注意不是 USB 主设备 (HOST) 连接器。绿色 ON LED（开机）将亮起，然后橙色 Wi-Fi LED 闪烁（启动加程序初始化）。大约 5 秒后，设备开始启动，橙色 LED 将持续亮起约 30 秒。
  

1.2 将 LinkIt 7688(Duo) 连接到网络

• 开启接入点模式
  
  
  
  • 启动后，Wi-Fi LED 会熄灭。这表示系统已准备好接受 Wi-Fi 连接。
  
  
  • 否则，请按住“Wi-Fi Reset”（Wi-Fi 重置）按钮至少 5 秒再松开，开启接入点模式。
    
  
  
  
  


• Wi-Fi LED 状态和系统状态见下图。（图片来源：Media Tek Lab）
  


• 转到 Wi-Fi 设置并选择“LinkIt_Smart_7688_XXXXXXX”。（其中“XXXXXXX”是您的 LinkIt 7688 (Duo) 的 MAC 地址。）
  


• 加入 LinkIt Smart Network 后，在 Web 浏览器中打开“http://mylinkit.local”或“http://192.168.100.1”
  
  
  
  • 在登录页面，设置一个密码（或输入之前设置的密码）。
  
  
  • 默认用户名是 root。
    
  
  
  
  


• 登录后，转到“Network”（网络）选项卡，然后选择“Station Mode”（工作站模式），设置您将连接的 Wi-Fi 接入点。您的 PC 与 LinkIt 必须位于同一网络中。单击“CONFIGURE & RESTART”（配置与重新启动）。
  


• 将 PC 网络更改为 LinkIt 网络。

有关设置 LinkIt 7688(Duo) 的详细信息，请访问：https://docs.labs.mediatek.com/resource/linkit-smart-7688/en/get-started

2.在 QIoT Suite Lite 中创建设备

2.1 安装 QIoT Suite Lite

• 您可以从 App Center 安装 QIoT Suite Lite。
  


• 启动 QIoT Suite Lite 并登录。默认用户名和密码均为“admin”。
  

2.2 创建新 IoT 应用程序

IoT 应用程序由多个 IoT 设备、规则和仪表板构成。建议您先在 IoT 应用程序中创建“IoT 设备”。使用此 IoT 应用程序可以记录连接到 NAS 的所有设备。

使用规则可以构建 IoT 应用程序，从而对已连接设备所生成的数据进行收集、处理、分析和操作。规则可以应用到一个或多个设备所生成的数据，并且可以并行执行一个或多个操作。

仪表板可以将您的数据转换为分析和报告，让您掌握实时信息。

所有这些元素共同为用户提供了一个完整的 IoT 应用程序环境。

• 单击“IoT Applications”（IoT 应用程序）。
  


• 单击“Add IoT Application”（添加 IoT 应用程序）。
  


• 在“Create a New IoT application”（创建新 IoT 应用程序）中：
  
  
  
  • 输入 IoT 应用程序名称（例如：“myApp”）。
  
  
  • “Rule Name”（规则名称）和“Dashboard Name”（仪表板名称）将根据 IoT 应用程序名称自动生成。
  
  
  • 单击“Create”（创建）。
    
  
  
  
  


• 单击“+ Add Thing”（+ 添加 IoT 设备）以添加此应用程序的设备。
  


• 单击“Add Thing”（添加 IoT 设备）后，在“Add Thing”（添加 IoT 设备）中完成以下操作：
  
  
  
  • 输入设备名称（例如：“linkIt”）在“Add”（添加）属性中输入设备信息（例如，序列号和制造商）。
  
  
  • 如果您的设备以受 QIoT 支持（Arduino Yun、Raspberry Pi、Edison 和 LinkIt 7688 (Duo)），选择一种预定义的“Thing Type”（IoT 设备类型）。
  
  
  • 单击“Add”（添加）。
    
  
  
  
  


• 单击“Thing Resource”（IoT 设备资源）：
  


• 在“Thing Resources”（IoT 设备资源）中，单击“Add Resource”（添加资源）。
  


• 在“Add Thing Resource”（添加 IoT 设备资源）中：
  
  
  
  • 在“资源名称”（Resource Name）和“资源 ID”（Resource ID）中，输入传感器的名称和 ID。请注意，此资源 ID 将用于在 QIoT 代理中创建主题。此 ID 应该对设备唯一，不允许对同一设备使用重复的 ID。
    
  
  
  
  


• 如果需要添加更多资源，请重复上述步骤。完成后单击“Close”（关闭）。
  


• 转到“Dashboard”（仪表板）选项卡，此时将创建一个示例仪表板
  


• 转到“Rule”（规则）选项卡，以定义流或者有关如何处理设备发送的数据以及如何在仪表板上呈现数据的规则。
  

3.使用 MQTTS 将设备连接到 QIoT Suite Lite

3.1 在 QIoT Suite 内生成资源信息

• 单击“Connect a Device”（连接设备）：
  


• 选择 MQTTS 并单击“Generate a Device Certificate”（生成设备证书）：
  


• 在“Download the files to connect”（下载文件以连接）中，单击链接，将“Device Certificate”（设备证书）、“CA Certificate”（CA 证书）和“Private Key”（私钥）下载到您的 PC。不要重命名这些文件。单击“OK”（确定）。
  


• 单击“Download JSON file”（下载 JSON 文件）。
  

3.2 下载示例代码

• 从 QNAP QIoT Suite Lite GitHub 下载示例代码。
  
  
  
  • URL：https://github.com/qnap-dev/qnap-qiot-sdks
  
  
  • 路径：python/device/mtk-linkit-7688-duo/examples
  
  
  
  


• 按下图所示设置数据结构。
  
  
  
  • “resource.json”文件必须保存在“res”文件夹中，设备证书、CA 证书和私钥必须保存在“ssl”证书中。
    
  
  
  
  


• 在 PC 上打开终端应用程序（例如 WinSCP）并登录到您的设备。
  
  
  
  • LinkIt 7688 仅支持 SCP 协议。可以使用“openssh-sftp-server”安装 SFTP。
    
  
  
  
  


• 在 PC 上打开一个终端应用程序（例如 PuTTY）。使用 SSH 连接到您的设备，然后输入存储示例代码的文件夹（例如：/home/root/bundle）。
  


• 要安装示例代码需要的程序，输入以下命令：
  


• 运行示例代码
  


• 设备会向“temp”（临时）主题（或您定义的主题）发送消息。
  

3.3 使用其他协议

• 单击“Connect a Device”（连接设备）。
  


• 您可以选择其他协议。
  


• 使用 SSH 连接到您的设备，并输入以下命令：
  

4.集成 Power BI

4.1 获取第一个 Power BI 帐户

• 在以下网址注册一个免费的 PowerBI 帐户：https://powerbi.microsoft.com/en-us/ 


• 注册后会转到以下页面。单击“My workspace”（我的工作区），然后单击“Skip for now”（现在跳过）。
  

4.2 设置流数据集 API

• 创建“Datasets”（数据集）
  
  
  
  • 单击右上角的“Create”（创建）
  
  
  • 单击“Streaming dataset”（流数据集）
    
  
  
  
  


• 选择“API”作为数据源，然后单击“Next”（下一步）。
  


• 定义流中的值（例如 temp、max、min），文本框中将显示 JSON 结果。我们使用此 JSON 代码来将数据推送到 QIoT Suite Lite 应用程序。单击“Create”（创建）完成操作。
  


• 创建了数据流后，您将获得一个 REST API URL，IoT 应用程序可以使用 POST 请求来调用此 URL，以将您的实时数据推送到您所创建的流数据数据集中。
  

4.3 在 IoT 应用程序中配置 Node-RED 节点

• 在 QIoT Suite 中创建一个 IoT 应用程序。


•  下图是您的第一个 Node-RED 流，因此，您可以开始创建自己的 IoT 流。有关 Node-RED 的更多信息，请访问 https://nodered.org/
  


• 在开始将实时数据推送到 Power BI 之前，我们需要一个“function”（函数）节点来将 IoT 数据转换为流数据数据集。您可以将 msg.payload 替换为您自己的 JSON 数据集。
  


• 输入以下所示的代码：
  


• 我们需要一个“http request”（http 请求）节点来帮助将实时数据推送到 Power BI。拖放“http request”（http 请求）节点将其连接到“function”（函数）节点后。
  


• 复制并粘贴从 Power BI 控制台获取的 REST API URL，并将 http 方法设置为 POST。单击“Deploy”（部署）。
  


• 您的 Node-RED 流将如下所示。
  

4.4 添加磁贴以显示实时数据

• 创建“Dashboard”（仪表板）。
  
  
  
  • 单击右上角的“Create”（创建）
  
  
  • 单击“Dashboard”（仪表板）
  
  
  • 输入仪表板的名称，然后单击“Create（创建）。
    
  
  
  
  


• 单击右上角的“Add tile”（添加磁贴）
  


• 选择“CUSTOM STREAMING DATA”（自定义流数据），然后单击“Next”（下一步）。
  


• 选择数据集，然后单击“Next”（下一步）。
  


• 选择一种可视化类型，并设置最小值和最大值。
  


• 现在，您将获得一个可供使用的流数据集，以及如下所示的实时仪表。
  

• 请访问 QNAP github 查阅 QIoT Suite Lite 示例代码：
  “https://github.com/qnap-dev/qnap-qiot-sdks”


• 有关 QIoT Suite Lite 的更多信息，请访问
  https://www.qnap.com/en/how-to/tutorial/qiot-suite-lite