下载 PDF
        SAMOVAR 
×
菜单
搜索
 
   
   
   
 
  用户手册    

首次上传草图

Samovar 7.00: 首次启动时，如果还没有保存的设置，Samovar 7.00 会自行创建带默认值的配置。无需手动恢复 Samovar_default_settings.txt。
Samovar 7.00: 支持通过 Arduino IDE 进行首次安装。另一种方法是在配置工具中选择开发板和参数，点击“烧录”（«Прошить»），对于新开发板，再单独点击“上传 LittleFS”（«Загрузить LittleFS»）。
 
首次把 Samovar 草图上传到 ESP32 之前，需要准备好电脑和开发板，详见 “为上传准备 ESP32”
 
 
安装 Arduino IDE 时，程序会在“文档”中新建一个名为 Arduino 的目录。默认路径为 C:\User\Documents\Arduino
需要准备好这个目录。
安装时，Arduino IDE 可能会在 ...Documents\Arduino 中放入子目录，其中包括名为 libraries 和 tools 的目录。需要移走这些目录。
 
注意，这很重要！
要正确安装 Samovar 草图， 必须使用每个 Samovar 版本压缩包中附带的库和工具。使用 早期版本或其他来源的库，会导致 Samovar 草图上传到 ESP32 时出错。
 
下面的建议可以帮助您在开始时避免因粗心等原因出错。以后您可以形成自己的方法。
 
在 ...Documents\Arduino 中新建子目录 OLD，把 Arduino IDE 安装时创建的 libraries 和 tools 目录拖入（或剪切后粘贴到） OLD 目录。
如果操作正确，C:\User\Documents\Arduino\ 中不应再有名为 libraries 和 tools 的目录。其他任何目录名都可以。
 
现在通过这个链接下载最新固件的压缩包。

  注意！
建议从上面的链接下载压缩包。那是完成并经过测试的版本。 该资源上还 有Master 版本。这是正在开发中的未来版本。它可能工作不正常，甚至完全无法工作。
 
 
首次上传草图
1

ZIP

下载 ZIP 格式的压缩包
2

TAR

下载 TAR 格式的压缩包（RAR、GZ）
 
通常，压缩包会保存到浏览器的“下载”目录。
下载的压缩包名为： Samovar-X.XX，其中 X.XX 对应版本号（下面所有示例都使用 Samovar-7.00 版）。 
 
把下载的压缩包复制（或剪切后粘贴）到目录 C:\User\Documents\Arduino\（您的路径可能不同）
 
最终，...Documents\Arduino\ 中应形成如下目录结构：
 
 
 
现在草图已准备好上传到 ESP32。
点击箭头开始把版本上传到 Samovar
 
说明。
 
注意！
某些 ESP32 开发板的 仿制品不按 BOOT 按钮就无法把草图上传到 ESP。
使用  BOOT 按钮上传有两种方法。
- 如果在 ESP 通电前按住 BOOT 按钮，通电后继续按住 3 秒再松开，就可以烧录 ESP， 并且之前所做的所有设置都会保留，特别是 WiFi 连接设置。
- 如果直接通电并发出“上传”命令，在草图编译完成、开始上传到 ESP32 之后，Arduino IDE 控制台 在几行红色文字后会显示消息：
"Connecting ....."  之后开始出现点。
这时按下 ESP32 开发板上的 BOOT 按钮，点不再出现时松开。
按 BOOT 只是让开发板进入引导模式，本身不会清除 Wi-Fi 设置。
 
 
安装网页界面。
注意！
从 6.0 版开始，所用的文件系统改变了。 更换文件系统是为了优化 Samovar 的速度。
 
安装草图后，必须在本地安装网页界面。
 
 不要断开 ESP32 与电脑的连接，在“工具”菜单中选择：
- ESP32 LittleFS Data Upload -  用于 6.0 及更高版本
- ESP32 Sketch Data Upload -  用于低于 6.0 的版本。
 
再次点击 Arduino IDE 中的“上传”按钮，等待安装完成。在某些 ESP32 版本上，上传界面时也需要使用 BOOT 按钮（见上文）。
 
 
 
注意！重要！
最近出现了一些工作完全正常的 ESP32 开发板 仿制品，但如果在 “工具”菜单 > 开发板 > ESP32 Arduino>DOIT ESP32 DEVKIT V1 中选择，网页界面无法安装。如果选择 ESP32 Dev Module 开发板，界面可以正常上传。
 
注意！重要！
从 6.0 版开始，只要 Samovar 连接了互联网， 界面就会自动下载并安装，无需您参与。
如果需要回退到旧版本的草图（适用于 6.0 及更高版本），界面也会自行回退到对应的版本。
如果没有互联网连接，则需要为每个版本自行安装界面，也就是在本地安装。
固件会把服务器上的界面版本（web.samovar-tool.ru 上其自身版本的目录）与本地文件 version.txt 进行比较，只有不同时才下载文件。这时串口监视器会输出 WEB interface version 和 Local interface version 两行。如果 LittleFS 的剩余空间少于 64 KB，更新会被取消，并显示消息“网页界面更新已取消：磁盘空间不足”（«Обновление веб-интерфейса отменено: мало места на диске»）。如果文件系统未能挂载（新开发板、已擦除的闪存），固件会自行将其格式化，显示消息“无法连接到文件系统，正在格式化...”（«Не удалось подключиться к файловой системе, форматируем...»）。
补充。
但事实证明，情况有所变化，这并非对所有人都有效。
从 6.20 版开始，文件 Samovar_ini.h 中增加了一个参数：
//#define NOT_USE_INTERFACE_UPDATE //启动时不使用界面更新
首次上传草图时，需要 取消它的注释：
#define NOT_USE_INTERFACE_UPDATE //启动时不使用界面更新
这样界面就不会通过互联网更新，只能手动更新。 以后在设置草图时，可以把这一行恢复原样（注释掉），看看通过互联网更新是否正常。
 
提示
建议通过 USB 在本地进行界面的首次安装。 原因是，如果启用了通过互联网更新界面的选项，下载和更新界面可能需要很长时间，在此期间界面不会显示。
 
警告。
本地上传 LittleFS 支持 Arduino IDE 1.8.x（使用经典上传工具）和 Arduino IDE 2.x（使用 ESP32 LittleFS Data Upload 插件）。
补充。
在 ESP32 by Espressif Systems 开发板包 3.0.0 及更高版本中，可以用 Arduino IDE 2 的插件在本地安装界面。说明见这里。插件本身（文件 arduino-littlefs-upload-1.1.7.vsix）在 Samovar 压缩包的 tools\ESP32LittleFS_Arduino IDE 2.X 目录中：把它复制到目录 ~/.arduinoIDE/plugins/（Windows 上为 C:\Users\<name>\.arduinoIDE\plugins\），重启 Arduino IDE，按 Ctrl+Shift+P 并选择“Upload LittleFS to Pico/ESP8266/ESP32”。
 
说明。
在某些 ESP32 版本上，使用 ESP32 LittleFS Data Upload烧录 6.0 及更高版本时，界面仍然无法安装。原因至今是个谜。遇到这种情况，请交替 多次尝试，分别用 ESP32 LittleFS Data Upload 和 ESP32 Sketch Data Upload 烧录 ESP32。每次烧录后检查界面是否出现。
 
 
上传草图和网页界面后，断电重启 Samovar，然后 把 Samovar 连接到您的 Wi-Fi 网络。
  Samovar 连接到您的 WI-FI 网络后，在电脑浏览器的地址栏中输入分配给它的 IP 地址或名称 http://samovar.local，打开 Samovar 界面。
 
推荐的默认值无需手动加载。
Samovar 7.00: 如果还没有保存的配置，固件会自行创建并保存默认设置。tools 目录中的文件 Samovar_default_settings.txt 可用于手动恢复，但首次启动时不需要。
要手动恢复之前保存的配置，打开“设置 → 其他”（«Настройки → Прочие»），点击“上传设置文件”（«Загрузить файл настроек»），选择文件，点击“保存”（«Сохранить»）并重启 Samovar。可以用同一选项卡上的“下载设置文件”（«Скачать файл настроек»）按钮保存自己的配置。
说明。
如果草图 或 Samovar 界面上传出错，需要擦除 ESP32 模块的闪存，然后重新上传。
 
Samovar 的初始设置完成——可以根据自己的设备设置文件 Samovar_ini.h 了。