La Marzocco圆形控制器用户使用说明

首次 AP 配网

第一次使用时，控制器会创建自己的设置热点。手机连上热点后，即可扫描家庭 Wi-Fi、保存密码并进入完整配置页面。

1

连接热点

在手机 Wi-Fi 中选择 LM-CTRL-XXXX，密码以控制器屏幕显示为准。

2

打开配置页

等待系统自动弹窗，或手动访问 http://192.168.4.1/。

3

保存家庭 Wi-Fi

选择语言，扫描附近网络，输入家庭 Wi-Fi 密码并保存。

4

切回家庭网络

控制器连接成功后，手机切回同一个家庭 Wi-Fi。

5

访问 Portal

使用屏幕 IP 或 http://lama.local/ 打开完整设置页面。

6

选择安全方式

首次从家庭网络访问时，可设置 LAN 管理密码，或明确保持局域网开放。

初始 AP 配网页支持 English / 中文切换；完整 Portal 的 Controller 分区可选择 English / Deutsch / 中文。

AP 打开期间，shotStopper 蓝牙定量路径会暂停。配网完成并关闭 AP 后会恢复扫描和连接。

设备端页面

主界面按页面管理机器状态和萃取参数。左右滑动换页，下滑进入配方，上滑进入设置。

机器状态

开机或待机。唤醒后加热显示会重新进入预热状态。

冲煮锅炉

设置萃取水温，范围约 80.0-103.0 C。

蒸汽锅炉

Off / 1 / 2 / 3 四档蒸汽强度。

预浸泡

开关预浸泡，并在开启后显示打开和关闭时间。

shotStopper

默认显示定量萃取和目标克重，用于蓝牙称重路径。

原生 BBW

需要在 Portal 中启用，且机器云端报告支持后才显示。

配方

在设备上加载或保存当前参数到本地配方。

Guide

显示 ishangcoffee.com 的帮助二维码和地址。

shotStopper 定量套件

了解 shotStopper 的购买、安装和使用方式，访问专页 ishangcoffee.com/stopper.html。

打开 shotStopper 页面

手势或按键	作用
左右滑动	切换主页面。
点击 + / -	调整当前页面数值或开关。
主界面下滑	进入配方页。
主界面上滑	进入设置页并启动 Web Portal。
BOOT 键	锁屏；在设置页可进入恢复流程。

连接咖啡机 BLE

先在 Portal 的 Cloud 分区设置 La Marzocco 账户并选择当前咖啡机。控制器会把机器序列号和通信密钥保存在本地，然后自动连接咖啡机 BLE。

1

设置账户

进入 Portal -> Cloud，保存 La Marzocco 账户并加载机器列表。

2

选择机器

选择当前咖啡机并保存，控制器会在本地保存机器序列号和通信密钥。

3

确认连接

返回控制器主界面，蓝牙标记高亮即表示咖啡机 BLE 已连接成功。

如果蓝牙连接有问题，建议将咖啡机关机，把萃取拨杆打到左边，等待 3 秒后拨到右边，然后重新开机并等待控制器自动连接。

Web Portal

Portal 是控制器的本地管理中心。它既服务首次配置，也负责云账户、机器选择、配方、高级开关和 OTA。

Overview

查看当前连接摘要、局域网 IP、稳定地址、云端状态、顶部 Logo 状态和固件版本。

Controller

设置 hostname 和语言，上传自定义 SVG Logo，或恢复固件内置 La Marzocco 顶部 Logo。

Network

扫描附近 Wi-Fi，选择 SSID，保存家庭网络密码并立即重连。

Cloud

保存 La Marzocco 云账户，加载机器列表，选择当前机器。预浸泡、云端状态、机器原生 BBW 等能力依赖此处完成。

Recipes

编辑当前启用配方的名称、温度、预浸泡时间，以及可用时的 BBW 参数。保存配方不会立即发送到机器。

Advanced

设置配方数量、温度步进、时间步进、加热显示、原生 BBW、锁屏 PIN、远程截图、LAN 管理密码、OTA 和系统重启/重置。

Diagnostics

查看只读诊断状态：Wi-Fi、云端 WebSocket、BLE、shotStopper、加载字段和同步队列。

出厂默认状态

这些默认值会影响用户第一次看到的页面，也决定 shotStopper 和原生 BBW 的优先级。

加热显示默认开启远程截图默认关闭锁屏 PIN 默认不要求机器原生 BBW 默认禁用内置 La Marzocco 顶部 Logo 设备语言默认 English

为什么默认禁用原生 BBW

这样可以让 shotStopper 蓝牙定量路径保持可用。只有明确要使用机器自己的云端 BBW 时，才在 Advanced 中取消禁用。

为什么锁屏 PIN 默认关闭

日常使用更快。需要保护误触时，到 Advanced -> Lock Screen PIN 启用；首次启用后建议修改出厂 PIN。

固件更新

完成首次完整串口烧录后，后续可以在家庭网络 Portal 中进行 OTA。开放的 AP 设置热点不能安装固件。

更新方式	说明
上传 .bin	在 Advanced -> Firmware Update 选择 `build/round_controller_2.bin` 或版本化固件。
网络固件	刷新 Network Firmware 列表，选择服务器上的固件安装。
升级要求	保持供电、Wi-Fi 和页面稳定，等待控制器写入 OTA 分区并重启。

不要在不确认来源和适配型号的情况下安装固件。错误的 .bin、升级中断或断电可能导致设备无法正常启动。

恢复和安全

设备端恢复流程用于忘记密码或重新配置；Portal 的系统操作用于重启、重置网络或恢复出厂设置。

LAN 管理密码

保护家庭网络内的 Portal。忘记后可在控制器设置页的恢复流程中清除。

锁屏 PIN

默认关闭。启用后，锁屏时需要输入 4 位 PIN；出厂 PIN 为 0000，建议启用后修改。

重置网络

清除 Wi-Fi、云账户和机器选择，重启 AP 配网流程。

恢复出厂

擦除本地配置和配方，控制器重启进入初始设置模式。

常见问题

把常见售后问题提前写清楚，用户自己也能判断是网络、云端、BLE 还是配置项导致。

手机没有弹出配网页

确认已连接 LM-CTRL-XXXX，然后手动打开 http://192.168.4.1/。

家庭网络下打不开 Portal

确认手机和控制器在同一网络，尝试屏幕上的 IP 或 http://lama.local/。

云账户登录失败

使用可直接邮箱密码登录的 La Marzocco 账户。仅通过 Apple 或 Google 登录的账户可能无法完成当前流程。

咖啡机 BLE 不连接

确认已在 Portal 的 Cloud 分区设置 La Marzocco 账户并选择机器。仍不连接时，将机器关机，萃取拨杆打到左边等 3 秒后拨到右边，再开机等待蓝牙标记高亮。

看不到机器原生 BBW

需要机器云端报告支持，并在 Advanced 中关闭“Disable machine-native BBW”。

shotStopper 不连接

如果 AP 正在开启，先等待 AP 关闭。仍异常时查看 Diagnostics 中的 shotStopper 状态。

OTA 被拒绝

开放 AP 模式不能 OTA，请在家庭网络完整 Portal 中操作。

从第一次开机，到日常使用和固件更新。