Bartendro 饮料调配机器人技术文档

1. 安装指南

1.1 硬件安装

Bartendro 饮料调配机器人的硬件部分包括多个电路板和机械组件。硬件设计文件位于 hardware 目录下，包含电路原理图和布局图。用户可以根据这些文件进行硬件的组装和调试。

1.2 软件安装

Bartendro 的软件部分包括固件、脚本和用户界面。用户可以通过以下步骤进行软件安装：

1. 下载 SD 卡镜像：在 2021 年，SD 卡镜像已更新，用户可以从指定链接下载最新的镜像文件。
2. 烧录镜像：使用工具（如 Etcher）将下载的镜像文件烧录到 SD 卡中。
3. 插入 SD 卡：将烧录好的 SD 卡插入 Bartendro 的主控板中。

2. 项目的使用说明

2.1 启动系统

1. 连接电源：将 Bartendro 连接到电源，并确保所有硬件组件正常工作。
2. 启动主控板：插入 SD 卡后，主控板将自动启动并加载固件。
3. 访问 Web 界面：通过浏览器访问 Bartendro 的 Web 界面，界面代码位于 ui 目录下，使用 Python 编写。

2.2 调配饮料

1. 选择饮料：在 Web 界面中选择您想要调配的饮料。
2. 确认调配：点击“调配”按钮，Bartendro 将自动调配所选饮料。
3. 取用饮料：调配完成后，从机器中取出饮料。

3. 项目 API 使用文档

3.1 API 概述

Bartendro 提供了丰富的 API 接口，用户可以通过这些接口控制机器人的各种功能。API 接口主要通过 Web 界面进行调用。

3.2 API 接口示例

以下是一些常用的 API 接口示例：

• 获取饮料列表：

  GET /api/drinks
  

  返回所有可调配的饮料列表。

• 调配饮料：

  POST /api/make_drink
  {
    "drink_id": 1,
    "quantity": 200
  }
  

  根据指定的饮料 ID 和数量进行调配。

• 获取机器状态：

  GET /api/status
  

  返回当前机器的状态信息，包括各泵的工作状态和剩余液体量。

4. 项目安装方式

4.1 从源码安装

用户可以从 GitHub 仓库中获取 Bartendro 的源码，并自行编译和安装。以下是安装步骤：

1. 克隆仓库：

   git clone https://github.com/partyrobotics/bartendro.git
   

2. 进入项目目录：

   cd bartendro
   

3. 编译固件：

   cd firmware
   make
   

4. 安装脚本：

   cd ../scripts
   ./install.sh
   

5. 启动 Web 界面：

   cd ../ui
   python app.py
   

4.2 使用预编译镜像

用户也可以直接下载预编译的 SD 卡镜像，并将其烧录到 SD 卡中，从而快速启动 Bartendro 系统。

通过以上步骤，用户可以顺利完成 Bartendro 饮料调配机器人的安装和使用。希望本文档能帮助您更好地理解和使用该项目。