版本历史

7.00 — 2026 年 9 月 4 日

重大更新。主要变化：

新增“奶酪制作”（«Сыроварение»）模式：加热、保温、冷却，用 pH 传感器控制酸度（PH-4502C 接在 LUA_PIN 输入上，在“pH 校准”（«Калибровка pH»）页面校准），搅拌器，4 号继电器上的盐水排放阀，以及专用的程序行类型。设置位于“奶酪”（«Сыр»）选项卡。
精馏模式下的杂质穿透检测器：带气压修正地分析温度趋势，根据塔的噪声自行选择阈值，温度上升时可降低取酒速度，温度严重上升时暂停取酒并自行恢复；在酒头阶段只做观察，等待原因显示在界面中。
啤酒、BK 和 NBK 模式重大更新：All-in-one、HERMS 和 RIMS 酿造方案，改进的 BeerXML 导入，重写的 NBK 算法（预热、调整、优化、运行）；啤酒和奶酪程序中新增 L 行——由 Lua 控制的阶段。
除 NBK 外的所有程序都支持 L 行（Lua 阶段）：精馏、蒸馏、BK、啤酒、奶酪制作。脚本文件、以秒为单位的超时时间和参数（脚本中的 arg 表）在程序编辑器的“Lua 阶段”（«Lua-этап»）窗口中设置；通过编辑器上传新版本文件后，正在运行的脚本会重新读取。在 BK 中，“下一个程序”（«Следующая программа»）按钮现在可以使用。
新的网页界面：深色“铜”主题，带实时读数的工艺流程图（啤酒模式下按酿造方案显示，精馏模式下显示分凝器以及已启用的第二台泵），当前程序行，图表，各模式页面，“外部泵”（«Внешний насос»）页面和“I2CStepper”页面；页面以压缩形式传输，初始数据通过一次请求获取。
通过 TLS 连接 samovar-tool.ru 服务器，取代 MQTT：读数、命令、过程日志和消息都经由此通道传输；网站上的日志页面、网站上的控制页面以及带报警推送通知的 Android 和 iOS 手机应用都基于此通道。向自建 MQTT 代理发送数据作为可选的编译设置保留。
I2CStepper 板，协议第 2 版：两块板（搅拌器和泵），灌泵，按设定容量加注，“每毫升步数”校准，四个继电器，一个外部传感器。可从“I2CStepper”页面、程序、Lua、应用和网站进行控制。I2C 泵可用作巴氏杀菌段上方的酒头取酒泵。
Lua：单次运行时间限制（20 秒），反复出错后循环停止，新函数 setPumpPwm 和 setCapacity，I2CStepper 板函数，Lua 模式成为独立的运行模式。
状态快照：紧急重启后，如果在 30 分钟内重新启动过程，固件会恢复程序并继续同一个日志会话。
适用于 Windows、macOS 和 Linux 的配置工具：编译，通过 USB 或 Wi-Fi 烧录，设备文件编辑器，配置报告。支持 ESP32-S3。
重写了精馏和蒸馏程序的计算、程序和过程状态的保存以及设备错误处理。

6.27 — 2026 年 5 月 11 日

修复了计时器、网络超时、用万能按钮启动接入点、蒸馏结束、啤酒模式下的 UART 调压器控制、功率显示、PID 自整定以及冷却泵读数。

6.26 — 2026 年 1 月 1 日

更新了库，提高了稳定性，降低了内存占用。新增无需重启即可切换模式。更新到此版本前，建议通过“设置”（«Настройки»）→“其他”（«Прочие»）→“保存设置”（«Сохранить настройки»）保存设置。

6.25

加入了用户建议，更新了库，另有一些小改进。
修正了分区文件。同时修正了向 Telegram 发送消息的函数。

6.24.

修复了之前发现的错误。
NBK 模式也已可以使用。
改进了网络处理。

6.23.

修正了网页界面。
修复了错误。
修正了啤酒程序中泵的工作。

6.22.

主要变化——更新了库。
在啤酒模式下，搅拌器运行时间现在以秒而不是分钟为单位设置。
此外，蒸馏模式下会显示预计完成时间。

6.20

修复了错误。
实现了 NBK 模式，基于以下用户的研究：dranek
修改了酿造啤酒时加热器和麦汁转移泵的工作方式。
由于 Blynk 中的通知已停止工作，新增了 Telegram 通知。

6.19.

新增 NBK 模式。已实现安全组的主要功能和冷却泵的手动控制。自动化目前计划通过 Lua 实现。
Lua 中新增用于处理当前时间的数值变量。

YY、MM、DD、HH、MI、SS——分别为年、月、日、时、分、秒。

调用示例：

setLuaStatus(getNumVariable("HH"))

6.18.

新增 Lua 变量。
更新了 6.16 和 6.17 版本啤酒模式的界面——PID 自整定模式恢复了。
现在可以在界面中选择，在糖化程序中关闭搅拌器。
代码小幅优化

下次 Samovar 启动时界面会自动更新。

6.17.

更新了文件编辑器版本（在设置中).
更新了屏幕菜单库。
Samovar 和 I2CStepper 草图（sketch）做了小幅优化。
压缩包中现已包含最新版本的 Meter 以及来自以下用户的电路图：dranek，还有 SEM(Stab)_AVR 调压器外壳的 3D 模型
借助 Lua 脚本（目前阶段），啤酒模式可以实现任何酿造方案，完全自动化，并可使用 beerxml 或 BrewMate 格式的配方。对配方的支持仅限于构建糖化程序所需的最低程度。也就是说，配方中可能不会显示制备糖化醪所需的全部原料
功能更新之一——在温度设置中新增了刷新温度传感器的按钮。可以逐个连接传感器并保存到设置中。接上一个传感器，选择它所属的位置，点击保存，回到设置，接上另一个传感器，选择它所属的位置，点击保存，依此类推。
运行逻辑没有任何变化。

6.16.

现在可以启用取酒泵的平滑加速。不过它停止时也会平滑减速，在从一个程序行切换到另一个程序行时，这可能不利于过程的稳定。

要启用步进电机的加速/减速，请在 Samovar_ini.h 文件中将以下内容

//#define USE_STEPPER_ACCELERATION //использовать плавный старт и торможение шагового двигателя

替换为

#define USE_STEPPER_ACCELERATION //использовать плавный старт и торможение шагового двигателя

新增了无需导线将调压器连接到 Samovar 的说明。该说明也可在以下位置查看：网站.
更新了步进电机库，改进了与 I2CStepper 的交互。

发布了 I2CStepper 0.3 版，修复了错误。如果需要速度精确，请降低驱动器上的细分倍数（不超过 1/2）；要更精确，请设为 1。草图中细分默认设为 1/2。可在 I2CStepper.h 文件第 22 行调整，那里指定了分频值。

更新了界面。在“啤酒”模式下，程序行中的搅拌器参数在单独的窗口中编辑。

注意！ Samovar 和 I2CStepper 所用的库必须取自 Samovar 附带的库。

6.15

初始设置文件 tools/Samovar_default_settings.txt 中新增了默认值。编译后首次启动 Samovar 时，必须加载默认值。选项已经很多，很难一次全部设置正确，而默认值能让 Samovar 正常工作。之后可以按自己的需要进行调整。
修复了啤酒模式下用于投放啤酒花的步进电机的错误。
Samovar_ini.h 文件中新增了一个选项，用于从网页界面控制是否使用回流传感器（默认启用）

#define IGNORE_HEAD_LEVEL_SENSOR_SETTING //如果使用回流传感器，则忽略网页界面中关闭该传感器的命令（详见此处).

6.14

如果在 Samovar 通电前按住按钮（通电 2 秒后松开），Samovar 将以接入点模式启动。网络：Samovar，密码：SamApp123
新增对 Blynk 终端的支持——可以运行一小段 Lua 代码（几行；不建议用这种方式运行大型脚本）。如何在 Blynk 中添加终端——见此处
在 Samovar 中配置了 Lua 后，也可以在网页界面中运行几行 Lua——在所有模式的“附加”（«Дополнительно»）选项卡上可用
Lua 现在可以控制水泵的 PID 系数——分别为 pmpKp、pmpKi、pmpKd。要设置系数，可以运行以下 Lua 代码

setNumVariable("pmpKp", 6)

当前值可以这样获取：

setLuaStatus("pmpKp="..getNumVariable("pmpKp")

啤酒模式下新增用于自动投放啤酒花的步进电机控制。有待测试。
通过互联网更新网页界面的问题应该已经解决。
还修复了一些小错误。

6.12

新增对三种压力传感器的支持：
- XGZP6897D（通过 I2C 连接），
- MPX5010D（模拟量，接 ESP32 的 34 号引脚）
- 通过 1Wire。通过 1Wire 连接的传感器地址固定为 {0x22, 0x22, 0x22, 0x22, 0x22, 0x22, 0x22, 0x22}。使用哪种传感器（或不用）在 Samovar_ini.h 中选择：
//定义所用压力传感器的类型。只能使用一种类型。如果取消注释了三个或两个传感器，则只使用 MPX5010D

//#define USE_PRESSURE_XGZ 32 //использовать датчик давления XGZP6897D (или аналогичный). Какое использовать значение - смотреть параметр К в таблице: https://github.com/fanfanlatulipe26/XGZP6897D

//#define USE_PRESSURE_1WIRE {0x22, 0x22, 0x22, 0x22, 0x22, 0x22, 0x22, 0x22} //использовать датчик давления по 1Wire

//#define USE_PRESSURE_MPX //использовать датчик давления MPX5010D

界面中还没有相关逻辑和显示，但可以在 Lua 脚本中使用：把数值输出到 Lua 状态，并在那里实现达到某些数值时 Samovar 应有的行为。此外，在 Samovar 设置中可以设置压力上限，达到该值时 Samovar 将转入紧急模式。如果设置中的压力值为 0，Samovar 将忽略压力传感器的读数。

将压力输出到 Lua 状态的示例：

pressure_value = getNumVariable("pressure_value") + 0

setLuaStatus("Давление = "..pressure_value)

为了查看压力传感器信息，新增了向 Blynk 的输出。可以自行将其添加到 Blynk 界面中，使用虚拟引脚 22。
新增通过 1Wire 扩展板连接 1Wire 压力传感器的支持，并可在 Blynk 中查看。
Samovar 显示屏上现在显示全部 5 个温度传感器的读数。

6.11

啤酒模式。
- 除供水阀门外，还会开启冷却泵。
- 新增冷却泵转速控制。
- 新增对“搅拌器”（«Мешалка»）字段格式是否正确的检查。如果格式不正确，会改为 0^0.00^0^0
精馏模式。在“设置”（«Настройки»）>“基本”（«Основные»）中新增选项：是否使用回流液位传感器。
蒸馏模式。在“设置”（«Настройки»）>“基本”（«Основные»）中新增选项：以分钟为单位的时间，若蒸馏釜传感器数值在此时间内不变，则停止蒸馏。为 0 时不考虑该时间。
当前加热管功率的字体加大了。

6.10

在啤酒模式下，程序行中新增选择用哪个温度传感器控制加热（用于实现各种酿造方案）。可在 5 个传感器中选择。
自检模式下泵的运行时间延长了
在啤酒和蒸馏模式下，程序和当前程序执行状态现在会保存到文本文件中，与精馏模式的做法相同。
Lua 现在可以调节水泵的输出。新增函数 setPumpPwm(p)，p=0——泵关闭，p=1023——最大输出。
现在可以在设置中关闭水流传感器监测。
设置中新增选项——啤酒模式下煮沸时不降低功率。

注意！ 可以使用 SDK 2.0.13。如果遇到稳定性问题，请回退到 2.0.9

6.9

扩展了通过 LUA 脚本控制步进电机的功能。

如果未连接 Arduino Nano 上的 I2CStepper 扩展板，调用 Lua 函数 set_stepper_target 将控制内置步进电机；否则通过扩展板控制。

控制内置步进电机时只考虑一个参数——spd，即每秒步数表示的速度；调用函数时仍需传入全部三个参数。

--set_stepper_target(spd, direction, target) //spd——速度，每秒步数；direction——正向或反向；target——步数

set_stepper_target(950, 0, 0)

spd = 0 时步进电机停止。

注意！更新到此版本时必须使用 SDK 2.09 版

6.8

通过界面按钮停止 Lua 脚本的方式改变了。
新增 SetScriptOff 变量。在按钮脚本 btn_button2.lua 中它被置为 1，之后还会再执行一个 Lua 脚本运行周期。
这样做是为了能够捕获脚本停止事件，并执行必要的操作，使脚本正确结束。

6.7

错误修复和小改进。
值得注意的是——6.6 版在蒸馏模式下无法检测沸腾开始。已修复。

6.6

在蒸馏模式下新增了切换到下一个程序的按钮。修复了与检测沸腾开始以及蒸馏模式下程序运行相关的错误。

6.5

草图现在可以改变取酒蠕动泵步进电机的旋转方向。为此，请在 Samovar_ini.h 中取消注释以下行：

//#define STEPPER_REVERSE //изменить направление вращения шагового двигателя
还修复了过早检测到沸腾开始的问题。

6.4

修复了蒸馏釜中酒精度的计算
同时修复了取酒酒精度的计算。
新增向云端上传酒精度；在网站日志中查看蒸馏和精馏图表时会显示酒精度。
安装更新时，请将 SDK 更新到最新版本。

6.3

改动涉及蒸馏模式——新增了蒸馏程序。它的作用是按温度或酒精度更换取酒容器，除此之外不做任何事。蒸馏的启动和结束算法没有改变，所以如果你不打算分容器接取，有没有程序对你来说都一样。我还加入了蒸汽中酒精含量的计算（对蒸馏来说相当于取酒中的酒精含量）。我只从数学上验证了计算，实际条件下可能与酒精计读数有出入。两个数值都显示在界面中。
程序中既可以使用蒸馏釜中的酒精度，也可以使用取酒的酒精度；由取酒行的类型决定。
如果不需要分容器接取，就不必连接舵机。此时无论蒸馏程序里写了什么，都只是普通蒸馏。

6.2

修复的错误：

在 SDK 2.0.5 上，Samovar 在精馏模式下可能会重启。
在精馏模式下，取酒程序写入 prg.csv 文件时不正确。代码优化。

6.1

改进——在确定沸腾温度和蒸馏釜初始酒精含量时加入延时。
关于蒸馏釜内容物酒度的数据将出现在消息和界面中，并发送到 Blynk。

6.0

主要改进：

以前很不方便：Samovar 的存储总是被覆盖，每次都得恢复自己的成果（如果有的话）——精馏程序、Lua 脚本。现在，在有互联网连接时，Samovar 草图版本变化后界面会自动更新，而不会覆盖 Samovar 存储中的其他文件，这样就可以在 Samovar 存储中保存每种模式的设置，并在切换模式时加载。如果是配置一块新的 ESP32，会下载 data 文件夹中的全部文件。手动安装（不通过互联网）的方式仍然保留，但所用的文件系统变了，所以手动上传时必须使用的不是 ~~ESP32 Sketch Data Upload~~ ，而是 ESP32 LittleFS Data Upload。更换文件系统是为了优化 Samovar 的运行速度。
界面会针对具体的草图版本自动下载（从 6.0 开始），也就是说，如果需要回退到旧版草图，界面也会回退到相应版本。
（即更新或回退时，网页界面会自行更新。草图和库需要手动更新）
改进了与 Lua 脚本的交互。脚本示例和 Lua 文档放在单独的文件夹（Lua_script）中。
使用脚本语言可以利用 Samovar 的全部功能，并针对你的具体任务进行扩展。例如——按 Gabriel 法蒸馏或控制 NBK。
取酒程序的改动。引入了“蒸汽温度”（«Температура пара»）数值（在后续版本中已停用）。
泵加大冷却时的 TCA 温度值移到了“温度”（«Температура»）选项卡。
修复了发现的错误。

5.27

改动涉及啤酒模式下搅拌器和泵的工作。啤酒模式程序中新增了一个参数——搅拌器工作模板。
在啤酒模式下，开启搅拌器时，Samovar 会接通 2 号继电器和 SSD 继电器；如果连接了 Arduino Nano 上的扩展板（用于控制步进电机），还会向其发送命令，开启步进电机和另一个继电器。
在搅拌器工作模板中可以设置搅拌器的运行时间、旋转方向（仅限步进电机）和暂停。例如：搅拌 2 分钟，等待 1 分钟，然后反方向搅拌 2 分钟，等待 1 分钟。

5.27b（测试版）

用于测试 Lua 脚本的版本。详情见论坛帖子.

5.26

1. 在精馏过程中，新增保存精馏状态和取酒程序。取酒程序保存到 prg.csv 文件，状态保存到 state.csv 文件。这些文件可以通过设置中的编辑器查看（默认登录名和密码均为 admin），也可以在以下地址下载：YOUR_IP/prg.csv 和 YOUR_IP/state.csv。
在 Samovar_ini.h 中新增了一个参数，用于设置调压器输出电压的延时，从接触器动作后开始计算。
此外还做了一些小改进、优化，并修复了发现的错误。

5.25

新增对 I2CStepper 的支持功能。
精馏模式下程序界面的改动——编写程序时，现在会显示每一行的时间以及整个程序的总时间。

5.24
界面改动.

5.23

在精馏和啤酒模式下，状态中新增了正在执行的程序行的类型。
还修复了发现的错误。

实现了以下格式啤酒配方的加载：

1. BeerXML（在西方非常流行），主要的配方库在这里，但下载需要付费，还有这里以及许多其他地方。

2. Brewmate（在前苏联国家很流行）。

配方示例可通过链接查看。可以从网站下载配方，加载到 Samovar 中，它会根据这些配方构建糖化程序。这些网站上不仅有配方，还有配方计算器。任何配方都可以改编后加载到 Samovar 中。

这两种格式都非常灵活，很可能并未考虑到它们的所有特性。如果在使用配方时遇到问题，请通过电子邮件发送配方 info@samovar-tool.ru

5.22.

主要变化之一——预液泛（«Предзахлеб»）和酒心（«Тело»）程序中自动修正酒心 T 的功能默认关闭. 另外还做了一些与编写 Samovar 功能文档相关的小改动。

5.21

浏览器中新增了 Samovar 消息队列。现在很难错过消息：它们会一直显示在页面上，直到点击消息本身或“清除”（«очистить»）按钮明确清除为止。

浏览器中新增了关键事件的声音提醒——收到关键消息时，浏览器会一直发出声音，直到消息被清除。可在设置中开启/关闭。现代浏览器出于对用户的考虑，默认阻止自动播放声音。有两种办法：点击页面上的任意元素，或者在浏览器设置中把 Samovar 的地址加入例外。

还实现了以下功能：

如果当前程序行是“预液泛”（«Предзахлеб»），且其后还有一行酒心取酒，则会自动修正酒心 T。手动修正仍然可用。

延长了自检期间冷却水泵的运行时间。

修复的错误：

从 Samovar 下载日志并不总能成功。已修复。

在自检模式下，取酒泵的步进电机可能不会开启。已修复。

5.20

修复了发现的错误。

5.19.
修复了发现的错误。

5.18.

修复了 Samovar 在预液泛模式下运行的一个错误。该错误从 5.11 版起就存在。如果你使用 5.11-5.17 版并使用预液泛模式，必须更新。

5.17.

优化了通过 UART 协议与调压器的协作，并修改了液泛传感器触发与水温超限同时发生时的电压复位逻辑。

5.16.

支持 BeerXML 格式。（该格式非常灵活，可能没有考虑到格式的所有变体）

5.15.

改进了自检。新增加载 BeerXML 格式的功能（目前仅能查看）。更改 Samovar 运行模式并保存设置后，Samovar 会重启以切换到所设模式。在蒸馏模式下，取酒一直进行到设置中指定的温度，或者直到蒸馏釜温度 10 分钟内不再变化。此外还有一些小的系统改进。

5.14.

改进了对以下调压器的控制：kvic，优化了对以下调压器的控制：SEM_AVR.

“设置”（«Настройка»）页面新增了一个按钮——“自检”（«Самотестирование»）：供水泵会开启 5 秒和/或水阀打开，取酒蠕动泵启动，舵机依次转过前 5 个位置后返回。

5.13.

啤酒模式新增一种程序类型——“发酵”（«Брожение»）。它用于把蒸馏釜中的温度保持在设定值的允许范围内。如果蒸馏釜温度低于设定温度减去设定偏差，加热器和辅助加热继电器开启；当蒸馏釜 T 达到设定值减去设定偏差时，加热关闭（与其他啤酒模式一样由 PID 控制器工作）。如果蒸馏釜 T 高于设定温度加上设定偏差，会触发一个继电器。根据你的设备配置，可以在它上面连接供水阀门、泵或其他执行机构。当蒸馏釜 T 降到设定值加上设定偏差时，继电器关闭。附加逻辑可以在 Lua 脚本中实现，必要时可使用端口扩展板来控制任何执行机构或传感器。

还修复了错误并更新了库。SDK 必须更新到 2.0.5 版。

在某些情况下 Samovar 不保存 WiFi 设置；通过更新库和更新 SDK 解决了这个问题。

控制 kvic 调压器（旧固件）时存在一些错误。这个问题也已解决。

新固件的 kvic 调压器暂时无法与 Samovar 配合工作。

如果有人使用“用中国模块制作的简易加热管功率稳定器”（«Простой стабилизатор мощности ТЭНа из китайских модулей»），要与新版 Samovar 正确配合，必须使用 Samovar 附带的 Stab-avr 文件夹中的草图对其进行更新。

5.12. 小改动。代码优化。

5.10.

更换了水果、谷物和糖原料的取酒程序（相应文件位于 tools 文件夹中，更新界面时也会加载到 Samovar 存储中）。此外，在取酒程序计算界面中现在可以选择原料类型（水果、谷物、糖），所需的取酒程序会立即加载。