快速上手

从一个空账号到一台能用的设备

五步,大约二十分钟,电脑上什么都不用装。下面的一切都在浏览器里完成——如果你更愿意从手机开始,也可以在手机应用里做。

你需要准备

  • 任意一块 ESP32 开发板,普通的就够
  • 一根能传数据的 USB 线,不能只供电
  • 一个浏览器:Chrome、Edge 或 Opera,它们能和 USB 端口通信
  1. 1

    注册账号

    打开 cloud.r1bbit.com,填写姓名、邮箱和密码——或者跳过这些,用 Google 或 Apple 一键登录。不用等邮件确认,也不用填银行卡。

    手机应用用的是同一个账号,所以也可以直接在手机上注册,之后打开浏览器时一切都已经就位。

    cloud.r1bbit.com 的 Sign Up 标签页
    cloud.r1bbit.com 的 Sign Up 标签页
  2. 2

    添加开发板并烧录

    把开发板插到 USB 口,在云端把它添加进来。固件由浏览器自己写入:不用装工具链,也不用找驱动。重启之后开发板会自己找到云端,出现在你的列表里。

    这是唯一需要数据线的一步,之后的一切都走空中传输。

    添加第一块开发板
    添加第一块开发板
  3. 3

    拿一个现成的例子

    打开编辑器,点 Load Template。每个模板都是一整段能跑的程序,自带 CONFIG 块,所以你从一个已经能运行的东西开始,而不是从空文件开始。选 GPIO & Peripherals 里的 ADC 例子:它读取一个模拟输入并把数值打印出来,开发板上什么都不用接。

    别找和你的开发板同名的模板,要找和你的接线方式相符的:CONFIG 块描述的是外设,不是型号。

    筛选到 GPIO 的模板库——我们取的是 ADC 例子
    筛选到 GPIO 的模板库——我们取的是 ADC 例子
  4. 4

    发送到开发板

    模板里引脚号是个占位符,把它换成你这块板子上真实的 GPIO。然后按图上标注:1 处在 Device 列表里选中你的板子并点 Connect;2 处点 Upload to Device,再点 Script Start。脚本通过加密链路几秒钟就到板子上——什么都不编译,自然也没有编译失败一说。

    写错一行只会停下脚本,并在终端里说明原因。改好再发一次,开发板全程都在线。

    1 — 选中板子并连接,2 — 发送脚本并启动
    1 — 选中板子并连接,2 — 发送脚本并启动
  5. 5

    看结果

    右边的终端开始刷屏:每秒两次,各两行,直接来自开发板。电脑上什么都没插——板子是通过云端在跟你说话,换到另一栋楼里也一样。

    打印只是最简单的输出。用 VARS_PUBLISH 发布一个数值,它还会变成面板和手机应用上的一张卡片。

    终端里开发板的实时输出
    终端里开发板的实时输出