Particle CLI 使用教程

Particle CLI 使用教程

particle-cliCommand Line Interface for Particle Cloud and devices项目地址:https://gitcode.com/gh_mirrors/pa/particle-cli

1. 项目介绍

Particle CLI（Command Line Interface）是一个强大的工具，用于与Particle设备和Particle设备云进行交互。它基于Node.js开发，支持Windows、Mac OS（OS X）和Linux操作系统。Particle CLI是开源的，用户可以自由修改和扩展，甚至可以通过提交Pull Request来贡献代码。

2. 项目快速启动

安装

在Mac OS或Linux上安装

打开终端并输入以下命令：

bash <( curl -sL https://particle.io/install-cli )

该命令会将particle命令下载到你的主目录下的~/bin文件夹中。

在Windows上安装

下载Windows CLI安装程序并运行它以安装Particle CLI。Windows CLI安装程序是自包含的，可以在没有互联网访问的计算机上运行，但与Particle云交互的CLI命令需要互联网访问。CLI安装在%LOCALAPPDATA%\particle目录下（对于英文Windows系统，路径为C:\Users\username\AppData\Local\particle）。

升级到最新版本

如果你通过安装程序安装了Particle CLI，它会定期自动更新到最新版本。要强制更新，可以再次运行安装脚本或输入以下命令：

$ particle update-cli

基本命令

列出设备

要查看你的设备及其在线状态、可用函数和变量，可以使用以下命令：

$ particle list

调用设备函数

使用particle call命令可以调用设备上的函数。首先使用particle list查看设备ID和可用函数，然后调用函数：

$ particle call 0123456789abcdef78901234 digitalWrite "D7,HIGH"

3. 应用案例和最佳实践

使用InternetButton库

如果你想使用InternetButton库，可以通过以下命令将其复制到你的项目中：

$ particle library copy internetbutton

然后在你的源代码中添加以下行以使用该库：

#include "InternetButton.h"

创建自定义库

你可以使用particle library create命令创建自己的库：

$ mkdir mylib
$ cd mylib
$ particle library create

上传自定义库

修改或创建库后，可以使用以下命令将其上传到Particle云：

$ particle library upload

4. 典型生态项目

Particle Device Cloud

Particle Device Cloud是Particle生态系统的核心，提供设备管理、固件更新、数据存储和分析等功能。通过Particle CLI，你可以轻松与Device Cloud进行交互，管理你的设备和数据。

Particle Workbench

Particle Workbench是一个基于VS Code的集成开发环境，专门用于Particle设备的开发。它集成了Particle CLI，提供了更直观的开发体验和更强大的调试功能。

Particle Web IDE

Particle Web IDE是一个在线开发环境，允许你在浏览器中编写、编译和上传代码到Particle设备。它也支持与Particle CLI的集成，方便你在本地和云端之间切换开发环境。

通过这些工具和服务的结合，Particle CLI为用户提供了一个完整的开发和部署解决方案，适用于从初学者到专业开发者的各种需求。

particle-cliCommand Line Interface for Particle Cloud and devices项目地址:https://gitcode.com/gh_mirrors/pa/particle-cli