Файлы страниц
Исходные файлы страниц хранятся в папке arduino_serial_commander
. Это именно исходные файлы, которые не участвуют в работе системы, они нужны для того, чтобы вы могли внести в них изменения и затем отправить на сервер (на его microSD карту). Отправлять файлы можно либо с помощью утилиты Arduino Serial Commander, либо обычным способом — просто записав файлы на карту памяти (и затем вставив её в сервер AMS).
Наименование файлов
Наименование файлов подчиняется правилу 8.3, то есть имя файла должно содержать не более восьми символов, а расширение — не более трёх. Допустимы буквы английского алфавита, цифры и знаки «-» и «_». Это ограничения библиотеки работы с SD картами памяти.
Файлы страниц делятся на несколько типов: HTM, CSS, JS, PDE.
HTM
Это основные файлы веб-страниц, содержащие разметку на языке HTML. Эти файлы, в свою очередь, делятся на два типа: основные, содержащие контент и вспомогательные, содержащие структурные блоки веб-страниц, такие, как хедер, меню, футер и т. п. Для того, чтобы вспомогательные файлы можно было отличить от основных, их названия начинаются с символа подчёркивания.
Основные HTM файлы
- index.htm — главный файл, загружаемый по умолчанию
- index-p1.htm — главный файл партнёрского сайта 1
- index-p2.htm — главный файл партнёрского сайта 2
- index-p3.htm — главный файл партнёрского сайта 3
- index-p4.htm — главный файл партнёрского сайта 4
- sample1.htm — пример индикаторов
- sample2.htm — пример Ajax
- control.htm — управление светом
- noo.htm — управление оборудованием nooLite
- solder.htm — паяльная станция
- network.htm — сетевые настройки
- electro.htm — работа с Power Monitor
- ports.htm — информация о состоянии портов
- sdcard.htm — информация о microSD карте памяти
- sensors.htm — информация о сенсорах
- subsys.htm — информация о подсистемах
- supply.htm — информация об электропитании
- system.htm — информация о системе
- settings.htm — установки
- themes.htm — выбор темы (сайта) AMS
- full.htm — полноэкранный осциллограф
- full2.htm — полноэкранный ваттметр
- full-am1.htm — брендированный ваттметр
- help.htm — помощь
- about.htm — о системе Arduino Mega Server
- refer.htm — справочник
- tech.htm — описание технологии
- coop.htm — предложение о сотрудничестве
- under.htm — «страница в разработке»
- 404.htm — «страница не найдена»
CSS
Интерфейс Arduino Mega Server сделан с применением стандартных веб-технологий и внешний вид страниц задаётся с помощью CSS файлов стандартным способом, т. е. в веб-страницах находятся ссылки на соответствующие CSS файлы. Каждой теме оформления (сайту внутри системы AMS) соответствует свой CSS файл.
- style.css — CSS файл темы по умолчанию («Гик моде»)
- style_hm.css — CSS файл темы «Домашняя»
- style_md.css — CSS файл темы «Модерн»
- style_hk.css — CSS файл тёмной темы «Хакер дизайн»
- style_p1.css — CSS файл партнёрского сайта 1
- style_p2.css — CSS файл партнёрского сайта 2
- style_p3.css — CSS файл партнёрского сайта 3
- style_p4.css — CSS файл партнёрского сайта 4
JS
Файлы JavaScript обеспечивают всю динамическую и интерактивную функциональность веб-страниц. Эти файлы тоже подключаются к веб-страницам стандартным способом, при помощи соответствующих ссылок.
Общий принцип формирования JavaScript файлов такой: каждая динамическая и интерактивная веб-страница имеет свой JavaScript файл-спутник с таким же названием, например, страница settings.htm
имеет спутник settings.js
, в котором находится функционал этой страницы.
Это нестрогое правило — страница может не иметь JavaScript файла или иметь несколько подключённых файлов, но к большинству страниц подключается один JS файл (кроме общего scripts.js
).
scripts.js
Это системный JavaScript файл в котором содержится большинство функций, необходимых для роботы интерфейса Arduino Mega Server, поэтому он подключается ко всем веб-страницам. Этот файл содержит функции обслуживания dash-панели, графическую библиотеку AMS и прочие важные компоненты системы.
PDE
Файлы с расширение PDE содержат скрипты на языке Processing, которые используются для визуального представления информации, например, в dash-панели.
Внимание! Не путайте файлы PDE, относящиеся к утилите Arduino Serial Commander и файлы PDE скриптов на языке Processing, оба эти типа файлов имеют одно и то же расширение. Список файлов, относящихся к Arduino Serial Commander вы можете найти в документации к этой утилите.
Использование скриптов на языке Processing требует загрузки соответствующей библиотеки, а это, в свою очередь, замедляет загрузку веб-страниц, поэтому в текущей версии системы PDE скрипты не используются, но вы можете их задействовать, если они вам нужны. Посмотреть пример работы с этими скриптами вы можете в архивной 0.11 версии системы.
Обратите внимание. Система Arduino Mega Server непрерывно развивается и в код проекта постоянно вносятся изменения и улучшения, поэтому, описание и документация может не соответствовать вашей конкретной версии системы. Последняя правка этой страницы относится к 0.14 версии системы.