САМОВАР 
×
Меню
Поиск
 
   
   
   
 
  Руководство пользователя    

Первичная загрузка скетча

 
Перед первой загрузкой скетча Самовара в ESP32 компьютер и плату нужно подготовить, об этом читайте в "Подготовка ESP32 к загрузке"
 
 
При установке Arduino IDE, программа создаст новый каталог с именем Arduino в ваших документах. Путь по умолчанию C:\User\Documents\Arduino
Этот каталог нужно подготовить.
При установке Arduino IDE может поместить в ...Documents\Arduino вложенные каталоги, в том числе и с именами libraries и tools. Эти каталоги нужно убрать.
 
Внимание, это важно!
Для корректной  установки скетча Самовара нужно использовать  libraries (библиотеки) и tools (инструменты) которые идут в архиве с каждым релизом Самовара. Использование  библиотек прежних релизов или полученных из других источников, будет приводить к ошибке загрузки скетча Самовара в ESP32.
 
Данные далее рекомендации помогут не совершать ошибок на первых порах по невнимательности и пр. В дальнейшем вы сможете выработать свой собственный метод.
 
Создадим в каталоге ...Documents\Arduino вложенный каталог OLD и перетащим (или вырезаем и вставляем)  в каталог OLD  каталоги libraries и tools, созданные Arduino IDE при установке.
Если все сделано правильно, то в каталоге C:\User\Documents\Arduino\ не должно быть каталогов с именами  libraries и tools. Любые другие имена каталогов допускаются.
 
Теперь нужно скачать архив с последней прошивкой по ссылке .

  Внимание!
Рекомендуется скачивать архив именно по выше приведенной ссылке. Это будет законченная и протестированная версия .  На ресурсе так же  присутствует Мастер-версия. Это будущая версия, которая находится в стадии разработки. Она может работать не корректно или вообще не работать.
 
 
Первичная загрузка скетча
1

ZIP

Скачать архив в формате ZIP
2

TAR

Скачать архив в формате TAR (RAR, GZ)
 
Как правило архив сохраняется в каталог "Загрузки" вашего браузера.
Имя скачанного архива:  Samovar-X.XX, где X.XX будет соответствовать номеру версии (далее все примеры будут на версии Samovar-6.17). 
 
Копируем (или вырезаем и вставляем) скачанный архив в каталог C:\User\Documents\Arduino\ (у вас может быть другой путь)
 
Таким образом в ...Documents\Arduino\ должна образоваться следующая структура каталогов:
 
 
 
Теперь скетч готов для загрузки в ESP32.
При нажатии на стрелку начнется загрузка релиза в Самовар
 
Примечание.
 
Внимание!
Некоторые клоны  платы ESP32, не позволяют произвести загрузку скетча на ESP без нажатия кнопки BOOT.
Существует два варианта загрузки с использованием кнопки   BOOT.
- Если перед подачей питания на ESP зажать кнопку BOOT, подать питание, 3 секунды удерживать кнопку, а затем отпустить, можно прошивать ESP  и при этом все сделанные ранее настройки сохранятся. В частности настройки подключения к WiFi.
- Если сразу подать питание и дать команду "Загрузить релиз", после компиляции скетча и старте загрузки в ESP32, в консоли Arduino IDE,  после вывода нескольких красных строк появится сообщение:
"Connecting ....."  после которого начнут появляться точки.
В этот момент нужно нажать кнопку BOOT на плате ESP32, когда вывод точек приостановится, кнопку отпустить.
При этом сотрутся настройки подключения к WiFi
 
 
Установка Web-интерфейса.
Внимание!
С версии 6.0 изменилась используемая файловая система.  Переход на другую файловую систему был сделан для оптимизации скорости работы Самовара.
 
После установки скетча нужно локально установить web-интерфейс.
 
 Не отключая ESP32 от компьютера, в меню “Инструменты” выберите пункт:
- ESP32 LittleFS Data Upload -  для версий 6.0 и выше
- ESP32 Sketch Data Upload -  для версий ниже 6.0.
 
Вновь нажмите в Arduino IDE кнопку "Загрузка", дождитесь окончания установки. На некоторых версиях ESP32, нужно так же использовать кнопку BOOT для загрузки интерфейса (см выше).
 
 
 
Внимание! Важно!
Последнее время появились вполне работоспособные клоны  платы ESP32, но при выборе в  в меню “Инструменты” > Плата > ESP32 Arduino>DOIT ESP32 DEVKIT V1 не устанавливается  web-интерфейс. При выборе платы ESP32 Dev Module загрузка интерфейса проходит нормально.
 
Внимание! Важно!
С версии 6.0 При условии, что Самовар подключен к интернету,  интерфейс будет автоматически скачиваться и устанавливаться без вашего участия.
В случае необходимости отката на старую версию скетча (для версий 6.0 и выше), интерфейс так же откатится на соответствующую версию сам.
Если подключения к интернету нет, то интерфейс необходимо устанавливать, для каждой версии самостоятельно - т.е. локально.
Дополнено.
Но, как выяснилось, что-то изменилось и это работает не для всех.
С версии 6.20 в файл Samovar_ini.h добавлен параметр:
//#define NOT_USE_INTERFACE_UPDATE              //не использовать обновление интерфейса при загрузке
При первой загрузке скетча его нужно  раскомментировать:
#define NOT_USE_INTERFACE_UPDATE              //не использовать обновление интерфейса при загрузке
При этом интерфейс не будет обновляться через интернет. Обновить можно будет только вручную.  В последствии, при настройке скетча строку можно вернуть к первоначальному виду (закомментировать) и посмотреть будет ли обновление через интернет проходить корректно.
 
Совет
Рекомендуется первичную установку интерфейса производить локально, через USB.  Дело в том, что если включена опция обновления интерфейса через интернет, скачивание и обновление интерфейса может занимать продолжительное время. При этом интерфейс не отображается.
 
Внимание.
Локальная загрузка интерфейса возможна только в версиях Arduino IDE ниже чем 2.9.9.  Именно поэтому  нужно сначала использовать версию 1.8.х.
Дополнено.
На версиях Arduino IDE 3.0.0 и выше, появилась возможность локальной установки интерфейса с помощью плагина. Инструкция здесь
 
Примечание.
На некоторых версиях ESP32 при прошивке версий от 6.0 и выше, при использовании  ESP32 LittleFS Data Upload интерфейс все равно не устанавливается. Почему это происходит остается загадкой. Если такая ситуация имеет место попробуйте несколько раз, попеременно,  прошить ESP32 как с использованием ESP32 LittleFS Data Upload  так и с использованием  ESP32 Sketch Data Upload. После каждой прошивки проверяйте появился ли интерфейс.
 
 
После загрузки скетча и web-интерфейса нужно перезагрузить Самовар с отключением питания, а затем  подключить Самовар к вашей Wi-Fi сети.
  Когда Самовар будет подключен к вашей WI-FI сети, откройте на компьютере интерфейс Самовара, введя в адресной строке браузера присвоенный ему IP-адрес.
 
Далее,  необходимо обязательно загрузить в Самовар рекомендованные значения по умолчанию.

Пояснение
Файл с начальными настройками Samovar_default_settings.txt содержит значения по умолчанию. При первом, после сборки,, запуске Самовара - в обязательном порядке загружать значения по умолчанию. которые позволят получить работающий без ошибок Самовар. Потом  нужно будет настроить Самовар под себя и свое оборудование.
 
Для загрузки настроек нужно перейти на вкладку Настройки-Прочие, внизу страницы выбрать команду "Восстановить" (п.3), На компьютере откроется Проводник,  выбрать для загрузки файл Samovar_default_settings.txt из каталога ... \Documents\Arduino\tools\.
После загрузки значений по умолчанию нужно  нажать "Сохранить" и перезагрузить Самовар с отключением питания.
Это делается 1 раз. Только при первой загрузке скетча в ESP32. При последующих обновлениях релизов загружать настройки по умолчанию не нужно.
 
Примечание.
Если загрузка скетча  или интерфейса Самовара  происходит не корректно нужно стереть флэш-память модуля ESP32 и выполнить загрузку заново.
 
Первичная настройка Самовара закончена - можно приступать к настройкам файла Samovar_ini.h под собственное оборудование.