首页
/ RESTduino 技术文档

RESTduino 技术文档

2024-12-24 21:53:17作者:钟日瑜

1. 安装指南

系统要求

  • Git:下载地址
  • Arduino 开发工具:下载地址
  • 可以运行上述软件的计算机
  • Arduino 硬件(Arduino 主板、网络接口等)
  • USB 数据线
  • 测试用 LED 灯

安装步骤

  1. 如果尚未安装,先安装 Arduino 软件,并测试“Blink”示例程序以确保一切正常。
  2. 克隆 RESTduino 代码库:
    git clone https://github.com/jjg/RESTduino.git
    
  3. 在 Arduino 软件中选择“Sketch” -> “Import Library” -> “Add Library”,然后选择 RESTduino 目录中的 EthernetBonjour 目录。
  4. 打开 RESTduino 目录中的 RESTduino.ino 文件。
  5. 选择“Sketch” -> “Verify/Compile”编译代码。
  6. 编译成功后,连接 Arduino 主板并选择正确的板型和串行端口。
  7. 选择“File” -> “Upload”将 RESTduino 程序上传到 Arduino 主板。

2. 项目使用说明

网络连接

上传程序后,将 Arduino 主板连接到网络。如果使用以太网,直接连接到网络交换机即可;如果使用 WiFi,可能需要进行特定配置。

测试连接

使用以下命令测试网络连接:

ping restduino.local

如果能够成功 ping 通,表示网络连接正常。

控制引脚

使用 HTTP GET 请求控制引脚,例如:

  • 设置数字引脚 9 为高电平:
    curl http://restduino.local/D9/HIGH
    
  • 设置数字引脚 9 为低电平:
    curl http://restduino.local/D9/LOW
    
  • 使用 PWM 设置数字引脚 9 的亮度(0-255):
    curl http://restduino.local/D9/128
    

读取引脚

读取引脚值,例如:

  • 读取数字引脚 9 的值:
    curl http://restduino.local/D9
    
  • 读取模拟引脚 0 的值:
    curl http://restduino.local/A0
    

3. 项目 API 使用文档

RESTduino 使用 HTTP GET 请求进行操作,以下是支持的 API:

  • http://restduino.local/Dx/HIGH:将数字引脚 x 设置为高电平。
  • http://restduino.local/Dx/LOW:将数字引脚 x 设置为低电平。
  • http://restduino.local/Dx/VALUE:将数字引脚 x 设置为特定值(仅限支持 PWM 的引脚)。
  • http://restduino.local/Dx:读取数字引脚 x 的值。
  • http://restduino.local/Ax:读取模拟引脚 x 的值。

返回值均为 JSON 格式,例如:

{"D9":"HIGH"}

4. 项目安装方式

请参考“安装指南”部分的内容进行安装。简而言之,您需要安装 Git 和 Arduino 开发工具,克隆 RESTduino 代码库,配置 Arduino 软件,编译并上传程序到 Arduino 主板。

登录后查看全文
热门项目推荐