En el primer arranque, Samovar crea por sí mismo un perfil con valores predeterminados si aún no hay ajustes guardados. No hace falta restaurar manualmente Samovar_default_settings.txt.
A continuación se describe la instalación inicial mediante el Arduino IDE. Otra forma es elegir la placa y los parámetros en el configurador, pulsar «Grabar» («Прошить») y después, para una placa nueva, por separado «Cargar LittleFS» («Загрузить LittleFS») (véase
Compilación y flasheo con PlatformIO).
El idioma del firmware y de la interfaz web se elige al grabar; por defecto es el ruso. En el configurador es el campo «Idioma del firmware y de la interfaz web» («Язык прошивки и веб-интерфейса») de la sección «Básicos» («Основные»). En el Arduino IDE, descomente en Samovar_ini.h la línea
#define SAMOVAR_LANG en e indique el código de idioma (en, de, fr, es o zh); más detalles en
Configuración del sketch.
Al instalar el Arduino IDE, el programa crea una carpeta nueva llamada Arduino en sus documentos. La ruta predeterminada es C:\User\Documents\Arduino
Hay que preparar esta carpeta.
Al instalarse, el Arduino IDE puede crear subcarpetas en ...Documents\Arduino, entre ellas las llamadas libraries y tools. Hay que quitar estas carpetas.
¡Atención, esto es importante!
Para instalar correctamente el sketch de Samovar, debe usar las bibliotecas y herramientas que vienen en el archivo con cada versión de Samovar. Usar bibliotecas de versiones anteriores o de otras fuentes provocará un error al cargar el sketch de Samovar en el ESP32.
Las recomendaciones siguientes le ayudarán a evitar al principio errores por descuido y similares. Más adelante podrá desarrollar su propio método.
Cree una subcarpeta OLD en ...Documents\Arduino y arrastre (o corte y pegue) las carpetas libraries y tools creadas por el Arduino IDE durante la instalación a la carpeta OLD .
Si todo se ha hecho correctamente, en C:\User\Documents\Arduino\ no debe haber carpetas llamadas libraries y tools. Se admite cualquier otro nombre de carpeta.
Ahora descargue el archivo con el firmware más reciente desde este
enlace .
¡Atención!
Se recomienda descargar el archivo desde el enlace de arriba. Es una versión terminada y probada . El recurso también tiene la versión Master. Es una versión futura que está en desarrollo. Puede no funcionar correctamente o no funcionar en absoluto.
 ZIP
Descargar el archivo en formato ZIP
|
 TAR
Descargar el archivo en formato TAR (RAR, GZ)
|
Por lo general, el archivo se guarda en la carpeta «Descargas» de su navegador.
El nombre del archivo descargado: Samovar-X.XX, donde X.XX corresponde al número de versión (todos los ejemplos de abajo usan la versión Samovar-7.00).
Copie (o corte y pegue) el archivo descargado en la carpeta C:\User\Documents\Arduino\ (su ruta puede ser distinta)
-
Descomprima el archivo. Aparece una carpeta Samovar-7.00.
-
Entre en ella: habrá otra carpeta Samovar-7.00. Cámbiele el nombre a Samovar.
-
Mueva precisamente esta carpeta Samovar, arrastrándola (o cortando y pegando), un nivel más arriba, a C:\User\Documents\Arduino\
-
Entre en la carpeta Samovar. Dentro hay carpetas y archivos. Mueva las dos carpetas libraries y tools arrastrándolas un nivel más arriba, a C:\User\Documents\Arduino\
Como resultado, en ...Documents\Arduino\ debe quedar la siguiente estructura de carpetas:
Ahora el sketch está listo para cargarse en el ESP32.
-
Conecte el ESP32 a un puerto USB.
-
-
En el Arduino IDE abra el archivo Samovar.ino de la carpeta ...\Documents\Arduino
\Samovar\.
-
Al hacer clic en la flecha empieza la carga de la versión en Samovar
Nota.
-
La compilación del código puede tardar bastante: no se preocupe, tenga paciencia.
-
No haga caso de las líneas marcadas en rojo en el monitor de carga: es normal. Si se produce un error crítico, la carga se detiene y aparece una barra naranja con el mensaje de error.
¡Atención!
Algunos clones de la placa ESP32 no permiten cargar el sketch en el ESP sin pulsar el botón BOOT.
Hay dos formas de cargar usando el botón BOOT.
- Si mantiene pulsado el botón BOOT antes de alimentar el ESP, conecta la alimentación, sigue manteniendo el botón 3 segundos y luego lo suelta, puede grabar el ESP y se conservan todos los ajustes hechos antes. En particular, los ajustes de conexión WiFi.
- Si conecta la alimentación directamente y da la orden «Subir», después de compilar el sketch y empezar la carga en el ESP32, la consola del Arduino IDE, tras varias líneas rojas, muestra el mensaje:
«Connecting .....» tras el cual empiezan a aparecer puntos.
En ese momento pulse el botón BOOT de la placa ESP32 y suéltelo cuando dejen de aparecer los puntos.
Pulsar BOOT solo pone la placa en modo de cargador de arranque y por sí mismo no borra los ajustes de Wi-Fi.
Instalación de la interfaz web.
Después de instalar el sketch, hay que instalar la interfaz web de forma local.
Sin desconectar el ESP32 del ordenador, en el menú «Herramientas» seleccione:
- ESP32 LittleFS Data Upload.
Vuelva a pulsar el botón «Subir» del Arduino IDE y espere a que termine la instalación. En algunas versiones del ESP32 también hay que usar el botón BOOT para cargar la interfaz (véase más arriba).
La carpeta data del archivo contiene la interfaz web en ruso. Si el firmware se ha compilado en otro idioma y Samovar está conectado a internet, él mismo sustituirá la interfaz por la del idioma correcto en el siguiente encendido (véase más abajo). Sin internet, compile la interfaz en su idioma con el comando python3 tools/build_web_assets.py --image en --out <carpeta> (una carpeta fuera de la carpeta del sketch, vacía o aún no creada), sustituya con su contenido el de la carpeta data y cargue LittleFS.
¡Atención! ¡Importante!
Últimamente han aparecido clones de la placa ESP32 que funcionan perfectamente, pero si se selecciona en el menú «Herramientas» > Placa > ESP32 Arduino>DOIT ESP32 DEVKIT V1, la interfaz web no se instala. Si se selecciona la placa ESP32 Dev Module, la interfaz se carga con normalidad.
¡Atención! ¡Importante!
Siempre que Samovar esté conectado a internet, la interfaz se descarga e instala automáticamente sin su intervención.
Si necesita volver a una versión anterior del sketch, la interfaz también vuelve por sí misma a la versión correspondiente.
Si no hay conexión a internet, la interfaz hay que instalarla usted mismo para cada versión, es decir, de forma local.
El firmware compara la versión de la interfaz en el servidor (web.samovar-tool.ru, la carpeta de su propia versión) con el archivo local version.txt y descarga los archivos solo si difieren; para un firmware en un idioma distinto del ruso se descargan los archivos de la interfaz en su idioma. El monitor serie muestra entonces las líneas WEB interface version y Local interface version. Si en LittleFS quedan menos de 64 KB libres, la actualización se cancela con el mensaje «Actualización de la interfaz web cancelada: poco espacio en disco» («Обновление веб-интерфейса отменено: мало места на диске»). Si el sistema de archivos no se montó (una placa nueva, una flash borrada), el firmware lo formatea por sí mismo, con el mensaje «No se pudo conectar al sistema de archivos, formateando...» («Не удалось подключиться к файловой системе, форматируем...»).
Si la actualización automática no le funciona, puede desactivarla con un parámetro en el archivo Samovar_ini.h:
//#define NOT_USE_INTERFACE_UPDATE //no usar la actualización de la interfaz al arrancar
Para ello, tiene que descomentar la línea:
#define NOT_USE_INTERFACE_UPDATE //no usar la actualización de la interfaz al arrancar
Entonces la interfaz no se actualizará por internet. Solo se podrá actualizar manualmente. Más adelante, al configurar el sketch, puede devolver la línea a su forma original (comentarla) y ver si la actualización por internet funciona correctamente.
Consejo
Se recomienda hacer la instalación inicial de la interfaz de forma local, por USB. El motivo es que, si está activada la opción de actualizar la interfaz por internet, la descarga y actualización de la interfaz puede tardar mucho. Durante ese tiempo la interfaz no se muestra.
Atención.
La carga local de LittleFS se admite en el Arduino IDE 1.8.x con el cargador clásico y en el Arduino IDE 2.x con el plugin ESP32 LittleFS Data Upload.
En el Arduino IDE 2 la interfaz se instala de forma local con un plugin. Las instrucciones están aquí. El propio plugin (el archivo arduino-littlefs-upload-1.1.7.vsix) está en el archivo de Samovar, en la carpeta tools\ESP32LittleFS_Arduino IDE 2.X: cópielo a la carpeta ~/.arduinoIDE/plugins/ (en Windows, C:\Users\<name>\.arduinoIDE\plugins\), reinicie el Arduino IDE, pulse Ctrl+Shift+P y seleccione «Upload LittleFS to Pico/ESP8266/ESP32».
Nota.
En algunas versiones del ESP32, al usar ESP32 LittleFS Data Upload la interfaz sigue sin instalarse. Por qué ocurre sigue siendo un misterio. Si es su caso, pruebe varias veces a grabar el ESP32, alternando, con ESP32 LittleFS Data Upload y con ESP32 Sketch Data Upload. Después de cada grabación, compruebe si ha aparecido la interfaz.
Después de cargar el sketch y la
interfaz web, reinicie Samovar desconectando la alimentación y después
conecte Samovar a su red Wi-Fi. Cuando Samovar esté conectado a su red WI-FI, abra la interfaz de Samovar en un ordenador escribiendo en la barra de direcciones del navegador la dirección IP que se le ha asignado o el nombre http://samovar.local.
No hace falta cargar manualmente los valores predeterminados recomendados.
Si aún no hay un perfil guardado, el firmware crea y guarda por sí mismo los ajustes predeterminados. El archivo Samovar_default_settings.txt de la carpeta tools se puede usar para restaurarlos manualmente, pero no es necesario para el primer arranque.
Para restaurar manualmente un perfil guardado anteriormente, abra «Ajustes → Otros» («Настройки → Прочие»), pulse «Cargar archivo de ajustes» («Загрузить файл настроек»), seleccione el archivo, pulse «Guardar» («Сохранить») y reinicie Samovar. Puede guardar su propio perfil con el botón «Descargar archivo de ajustes» («Скачать файл настроек») de la misma pestaña.
Nota.
Si la carga del sketch o de la interfaz de Samovar sale mal, hay que borrar la memoria flash del módulo ESP32 y repetir la carga.