Decent 浓缩咖啡

Decent 薄款蓝牙秤web应用介绍

Decent 薄款蓝牙秤web应用

本合集展示了三款使用纯 JavaScript、HTML 和 CSS 构建的 Web 应用。它们演示了通过 Web 蓝牙低功耗（Web BLE）、Wi-Fi 和 Web USB 可用的各种功能。这些应用将为您打开与您的Decent 薄款蓝牙秤交互的全新方式，为您提供强大的质量控制、精确称重及简化定量工具，所有操作直接在您的网络浏览器中完成。

体验应用：在线演示

即刻上手体验我们的网络工具。目前可通过台式/笔记本电脑浏览器及安卓、iOS 设备连接秤的 Wi-Fi 使用。

称重并保存：这是您日常称重任务的首选应用。可在设定时间内精确测量物品，并轻松导出结果用于分析或记录。

质量控制助手：非常适合确保一致性。该应用允许您反复称重相同物品，简化数据追踪和质量检查。

定量助手：通过直观的界面简化您的定量操作，旨在实现准确且可重复的测量。

鸡尾酒制作助手：这款互动应用将引导您完成著名《PDT 鸡尾酒手册》中经典鸡尾酒的全部制作步骤。

入门指南：如何连接与使用

将您的Decent 薄款蓝牙秤与我们的web应用连接非常简单。请遵循以下步骤：

1. 检查浏览器：

务必使用最新版本的 Google Chrome（136 或更新版本）或 Microsoft Edge（136 或更新版本）。

2. 打开应用：

访问上方提供的任一应用链接。

3. 启用配对模式：

将您的 Decent 薄款蓝牙秤置于蓝牙配对模式。

4. 通过应用连接：
  • 点击网页应用中的“连接”按钮。
  • 将弹出一个窗口，列出可用的蓝牙设备。
  • 从列表中选择“Decent Scale”。
    • 5. 确认连接：

    连接成功后，“连接”按钮将变为红色，文字变为“断开连接”。您还会在屏幕上看到来自秤的实时重量更新。

    6. 开始操作：

    点击“开始”按钮，然后根据您所使用的应用，按照屏幕上的指示进行操作。

    使用 USB-C 连接：

    我们的应用也支持直接 USB-C 连接。如果您选择此方式：

  • 首先，通过 USB-C 线缆将您的设备连接到f Decent 蓝牙秤。
  • 然后，在您的设备上安装 CH34X 串口驱动。
  • 从下拉菜单中选择 USB 连接，点击“连接”，然后从弹出列表中选择“USB 串口”。
  • 连接后，实时重量更新将显示在屏幕上。

    • 使用 Wi-Fi 连接(固件版本 3.0.0 及以上)：

    Decent 薄款蓝牙秤现已支持 WiFi，提供更多功能和连接方式。

  • 要启用 WiFi 模式，请进入 HDS 设置菜单，找到“WiFi 设置”选项。

    • 您可以在那里启用或禁用 WiFi，并查看当前的 WiFi 详情。

  • 如果您切换 WiFi 开/关，必须重启秤才能使新设置生效。

    • HDS 将开启自己的 WiFi，名称为“Decent Scale”。该网络受密码保护，密码为 '12345678'。

  • 连接到此 WiFi 后，在浏览器中访问 hds.local 或 192.168.1.1 以更改 WiFi 设置。

    • 通过访问 hds.local 页面并输入您的 WiFi 名称和密码，将 HDS 连接到您的家庭 WiFi（2.4 GHz）。

    重启秤以应用新设置。请正确保存您的 WiFi 设置，并确保 HDS 处于信号范围内。否则，它会恢复至自己的 WiFi（Decent Scale），这样您就可以在需要时重新更改设置。

    目的与受众

    这些web应用服务于两个主要目标：

  • 针对秤用户：我们的 Decent蓝牙秤工具实用且易于使用。它们增强了秤在日常任务中的功能。
  • 针对开发者：通过实际演示 Web 蓝牙和 Web USB 的功能，鼓励对这些技术的探索与创新。

    • 这些应用非常适合：

  • Decent Espresso 咖啡机和/或 Decent 薄款蓝牙秤的用户：优化您的日常称重和咖啡制作流程。
  • 质量控制专业人员：简化称重流程，提高一致性，简化数据收集。
  • 开发者与技术爱好者：探索 Web BLE 和 Web USB 在物联网环境中的实际应用。

    • 面向开发者：技术深度解析
  • 这些web应用的代码可在 openscale 仓库的 web_apps 目录中获取：openscale 仓库。
  • 技术基础： 使用标准 HTML、CSS 和 JavaScript 构建。
  • 样式： Tailwind CSS 采用以实用为先的样式方法，确保界面响应式且现代。注意：Tailwind 是一个 CSS 框架，但其核心逻辑使用纯 JavaScript，避免了繁重的 JS 框架。
  • 连接方式：
  • Web 蓝牙 API (Web BLE)：实现与 Decent 薄款蓝牙秤的无线通信。
  • Web USB API：提供备用的有线连接方式。
  • 浏览器兼容性： 使用 Google Chrome（136 或更新版本）或 Microsoft Edge（136 或更新版本），以及通过秤的 Wi-Fi 连接的 iOS 和 Safari 浏览器。
  • WiFi (WebSocket)：将 Decent 薄款蓝牙秤升级至固件 3.0.0 版本，然后按照上述说明开启该功能。HDS 将通过 WebSocket 端点广播重量数据并接收去皮指令。示例代码请参考此处。
  • 数据存储： 读数、预设等数据将本地存储于浏览器的本地存储中。用户可以将数据下载为 JSON 或 CSV 文件。

    • 代码结构与关键模块

    代码库设计为易于理解和修改。“称重并保存”和“定量助手”功能采用模块化结构，而“质量控制助手”采用单体结构，可能提供更简洁的功能交互概览。

    关键 JavaScript 模块及其作用：

  • scale.js：处理 BLE 协议、与 Half Decent 秤（HDS）的通信以及核心定量模式功能。
  • constants.js：存储用于 HDS 通信的预编程 10 字节消息及各种阈值。
  • state-machine.js：使用有限状态机模型实现“定量助手”和“质量控制助手”的核心逻辑。
  • export.js：管理重量读数和评估数据导出为 CSV 或 JSON 文件的功能。
  • presets.js：允许用户在“定量助手”和“质量控制助手”中将目标重量保存为预设，并由浏览器缓存于本地。
  • ui-controller.js：管理 HTML 界面的更新与变更。
  • modules/connection：包含 BLE 和 USB 连接方式的具体实现。
  • modules/reconnecting-websocket.js/：一个简单的模块，帮助您自动重连 WebSocket，建议在 WiFi 信号强度不足时使用。

    • 请参阅 Decent 蓝牙秤编程指南 以获取关于秤通信协议的详细信息。

    开发环境搭建

    按照以下简单步骤获取本地副本并运行：

    1. 下载 web_apps 目录： GitHub 不支持直接下载子目录。请使用专门工具完成此操作。以下提供几个选项：
  • 使用在线工具如 DownGit 或 github1s。
  • 访问该工具的网站。
  • 粘贴 GitHub 上 web_apps 目录的 URL：https://github.com/decentespresso/openscale/tree/main/web_apps
  • 按照工具说明将目录下载为 ZIP 文件。
  • 解压下载的 ZIP 文件。这将生成一个 web_apps 文件夹。
    • 2. 进入项目目录：

    cd web_apps/dosing_assistant

    3. 使用本地 HTTP 服务器提供文件服务：

    由于这些是使用 Web BLE 的 Web 应用，需要通过 https:// 或 http://localhost 提供服务。

    您可以使用简单的 NPX HTTP 服务器或您偏好的任何其他本地服务器。

  • 使用 NPX 的 http.server：

    • npx http-server -p 8000

    然后，打开您的 Chrome 浏览器并访问以下任意地址：


    http://localhost:8000/weigh_save.html


    http://localhost:8000/dosing_assistant.html

    本项目采用开源模式，我们强烈鼓励开发者探索、学习并为代码库做出贡献。

    Half Decent 秤手册：目录

    #app #opensource #javascript #webweigh #halfdecentscale #bluetooth #usb #decentscale #weighing #WIFI



  • 这是以下内容的翻译： Introducing Half Decent Scale web apps


    jwang created 2025/05/29, updated 2026/07/27